Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
93 changes: 70 additions & 23 deletions src/lib/Metadata/Finalizers/BaseMembersFinalizer.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -37,46 +37,47 @@ inheritBaseMembers(
// members of the derived class and all protected members of the base
// class are accessible as protected members of the derived class.
// Private members of the base are never accessible unless friended.
inheritBaseMembers(derivedId, derived.Public, base.Public);
inheritBaseMembers(derivedId, derived.Protected, base.Protected);
inheritBaseMembers(derivedId, derived, AccessKind::Public, base.Public);
inheritBaseMembers(derivedId, derived, AccessKind::Protected, base.Protected);
}
else if (A == AccessKind::Protected)
{
// When a class uses protected member access specifier to derive from a
// base, all public and protected members of the base class are
// accessible as protected members of the derived class (private members
// of the base are never accessible unless friended).
inheritBaseMembers(derivedId, derived.Protected, base.Public);
inheritBaseMembers(derivedId, derived.Protected, base.Protected);
inheritBaseMembers(derivedId, derived, AccessKind::Protected, base.Public);
inheritBaseMembers(derivedId, derived, AccessKind::Protected, base.Protected);
}
else if (A == AccessKind::Private && corpus_.config->extractPrivate)
{
// When a class uses private member access specifier to derive from a
// base, all public and protected members of the base class are
// accessible as private members of the derived class (private members
// of the base are never accessible unless friended).
inheritBaseMembers(derivedId, derived.Private, base.Public);
inheritBaseMembers(derivedId, derived.Private, base.Protected);
inheritBaseMembers(derivedId, derived, AccessKind::Private, base.Public);
inheritBaseMembers(derivedId, derived, AccessKind::Private, base.Protected);
}
}

void
BaseMembersFinalizer::
inheritBaseMembers(
SymbolID const& derivedId,
RecordTranche& derived,
RecordInterface& derived,
AccessKind const A,
RecordTranche const& base)
{
inheritBaseMembers(derivedId, derived.NamespaceAliases, base.NamespaceAliases);
inheritBaseMembers(derivedId, derived.Typedefs, base.Typedefs);
inheritBaseMembers(derivedId, derived.Records, base.Records);
inheritBaseMembers(derivedId, derived.Enums, base.Enums);
inheritBaseMembers(derivedId, derived.Functions, base.Functions);
inheritBaseMembers(derivedId, derived.StaticFunctions, base.StaticFunctions);
inheritBaseMembers(derivedId, derived.Variables, base.Variables);
inheritBaseMembers(derivedId, derived.StaticVariables, base.StaticVariables);
inheritBaseMembers(derivedId, derived.Concepts, base.Concepts);
inheritBaseMembers(derivedId, derived.Guides, base.Guides);
inheritBaseMembers<&RecordTranche::NamespaceAliases>(derivedId, derived, A, base.NamespaceAliases);
inheritBaseMembers<&RecordTranche::Typedefs>(derivedId, derived, A, base.Typedefs);
inheritBaseMembers<&RecordTranche::Records>(derivedId, derived, A, base.Records);
inheritBaseMembers<&RecordTranche::Enums>(derivedId, derived, A, base.Enums);
inheritBaseMembers<&RecordTranche::Functions>(derivedId, derived, A, base.Functions);
inheritBaseMembers<&RecordTranche::StaticFunctions>(derivedId, derived, A, base.StaticFunctions);
inheritBaseMembers<&RecordTranche::Variables>(derivedId, derived, A, base.Variables);
inheritBaseMembers<&RecordTranche::StaticVariables>(derivedId, derived, A, base.StaticVariables);
inheritBaseMembers<&RecordTranche::Concepts>(derivedId, derived, A, base.Concepts);
inheritBaseMembers<&RecordTranche::Guides>(derivedId, derived, A, base.Guides);
}

namespace {
Expand All @@ -89,19 +90,65 @@ shouldCopy(Config const& config, Info const& M)
}
return config->inheritBaseMembers == PublicSettings::BaseMemberInheritance::CopyAll;
}

bool isShadowed(SymbolID const& otherID, std::vector<SymbolID> const& Usings, CorpusImpl& corpus_)
{
for (SymbolID const& usingId: Usings)
{
Info* usingInfoPtr = corpus_.find(usingId);
MRDOCS_CHECK_OR_CONTINUE(usingInfoPtr);

UsingInfo const& using_ = usingInfoPtr->asUsing();
if (contains(using_.ShadowDeclarations, otherID))
{
return true;
}
}
return false;
}

RecordTranche& get(RecordInterface& derived, AccessKind const A)
{
switch (A)
{
case AccessKind::Public: return derived.Public;
case AccessKind::Protected: return derived.Protected;
case AccessKind::Private: return derived.Private;
default: MRDOCS_UNREACHABLE();
}
}
}

template <std::vector<SymbolID> RecordTranche::* Symbols>
void
BaseMembersFinalizer::
inheritBaseMembers(
SymbolID const& derivedId,
std::vector<SymbolID>& derived,
RecordInterface& derived,
AccessKind const A,
std::vector<SymbolID> const& base)
{
for (SymbolID const& otherID: base)
{
AccessKind effectiveA = A;
if (isShadowed(otherID, derived.Public.Usings, corpus_))
{
effectiveA = AccessKind::Public;
}
else if (isShadowed(otherID, derived.Protected.Usings, corpus_))
{
effectiveA = AccessKind::Protected;
}
else if (isShadowed(otherID, derived.Private.Usings, corpus_))
{
effectiveA = AccessKind::Private;
}

auto& tranche = get(derived, effectiveA);
auto& symbols = tranche.*Symbols;

// Find the info from the base class
MRDOCS_CHECK_OR_CONTINUE(!contains(derived, otherID));
MRDOCS_CHECK_OR_CONTINUE(!contains(symbols, otherID));
Info* otherInfoPtr = corpus_.find(otherID);
MRDOCS_CHECK_OR_CONTINUE(otherInfoPtr);
Info& otherInfo = *otherInfoPtr;
Expand All @@ -116,7 +163,7 @@ inheritBaseMembers(

// Check if derived class has a member that shadows the base member
auto shadowIt = std::ranges::find_if(
derived,
symbols,
[&](SymbolID const& id)
{
Info* infoPtr = corpus_.find(id);
Expand All @@ -135,7 +182,7 @@ inheritBaseMembers(
// are the same
return info.Name == otherInfo.Name;
});
MRDOCS_CHECK_OR_CONTINUE(shadowIt == derived.end());
MRDOCS_CHECK_OR_CONTINUE(shadowIt == symbols.end());

// Not a shadow, so inherit the base member
if (!shouldCopy(corpus_.config, otherInfo))
Expand All @@ -148,7 +195,7 @@ inheritBaseMembers(
// extraction mode to be regular, but that is controversial.
if (otherInfo.Extraction != ExtractionMode::Dependency)
{
derived.push_back(otherID);
symbols.push_back(otherID);
}
}
else
Expand All @@ -163,7 +210,7 @@ inheritBaseMembers(
otherCopy->id = SymbolID::createFromString(
std::format("{}-{}", toBase16Str(otherCopy->Parent),
toBase16Str(otherInfo.id)));
derived.push_back(otherCopy->id);
symbols.push_back(otherCopy->id);
// Get the extraction mode from the derived class
if (otherCopy->Extraction == ExtractionMode::Dependency)
{
Expand Down
7 changes: 5 additions & 2 deletions src/lib/Metadata/Finalizers/BaseMembersFinalizer.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -42,13 +42,16 @@ class BaseMembersFinalizer
void
inheritBaseMembers(
SymbolID const& derivedId,
RecordTranche& derived,
RecordInterface& derived,
AccessKind const A,
RecordTranche const& base);

template <std::vector<SymbolID> RecordTranche::* Symbols>
void
inheritBaseMembers(
SymbolID const& derivedId,
std::vector<SymbolID>& derived,
RecordInterface& derived,
AccessKind const A,
std::vector<SymbolID> const& base);

void
Expand Down
Loading