Reference

Namespaces

Name	Description
`mrdocs`	Core MrDocs support utilities.

mrdocs namespace

Namespaces

Name	Description
`doc`	Doc-comment enums and helpers that describe admonition kinds.
`dom`	Objects representing JSON-like values.
`files`	Filesystem helpers (join, temp, real-path resolution) used throughout MrDocs.
`helpers`	Handlebars helper registry for templates.
`js`	JavaScript interop helpers for the embedded runtime.
`lua`	Lua interop helpers for the optional scripting/backend integration.
`report`	Reporting utilities (messages, statistics, sinks).

Types

Name	Description
`AnyFileVisitor`	Polymorphic visitor for files discovered during traversal.
`ArrayType`	C++ array type (bounded or unbounded).
`ArrayView`	A non-owning, read-only view over a contiguous array of T.
`AutoType`	Represents `auto` or `decltype(auto)` placeholder type.
`BadExpectedAccess`	Base class for accessing an empty Expected.
`BadExpectedAccess<void>`	Exception thrown when reading the value of an empty Expected.
`BaseInfo`	Metadata for a direct base.
`ConceptSymbol`	Info for concepts.
`Config`	Configuration used to generate the Corpus and Docs
`ConstantExprInfo`	Represents an expression with a (possibly known) value
`ConstantTArg`	Non-type template argument.
`ConstantTParam`	A constant template parameter
`Corpus`	The collection of declarations in extracted form.
`DecltypeType`	`decltype(expr)` type wrapper.
`DocComment`	A processed documentation comment attached to a declaration.
`DomCorpus`	Front-end factory for producing Dom nodes.
`EnumConstantSymbol`	Info for enum constants.
`EnumSymbol`	Metadata for an enumeration declaration.
`Error`	Holds the description of an error, or success.
`Exception`	Type of all exceptions thrown by the API.
`ExecutorGroup`	A set of execution agents for performing concurrent work.
`ExecutorGroupBase`	Base class that owns a pool of execution agents and a shared work queue.
`Expected`	A container holding an error or a value.
`Expected<T, E>`	Expected specialization for `void` values. Holds either success (no payload) or an unexpected error `E`.
`Expected<T&, E>`	Expected specialization for lvalue references. Holds either a bound reference to `T` or an unexpected error `E`.
`ExplicitInfo`	Stores only the operand of the explicit-specifier or noexcept-specifier as a string. The complete expression is not preserved at this time. This is a temporary design and may be improved in the future.
`ExprInfo`	Represents an expression
`FormatString`	A format string with source location.
`FriendInfo`	Info for friend declarations.
`FunctionSymbol`	Metadata for a function or method.
`FunctionType`	Function type with parameters, qualifiers, and noexcept info.
`Generator`	Base class for documentation generators.
`GlobPattern`	A glob pattern matcher
`GuideSymbol`	Info for deduction guides.
`Handlebars`	A handlebars environment
`HandlebarsError`	An error thrown or returned by Handlebars
`HandlebarsOptions`	Options for handlebars
`IdentifierName`	Represents an identifier
`LValueReferenceType`	An lvalue reference type.
`Location`	Source location of a symbol or entity.
`MemberPointerType`	Pointer-to-member type (object or function).
`Name`	Represents a name for a named `Type`
`NamedType`	A type identified by name (possibly fundamental).
`NamespaceAliasSymbol`	Info for namespace aliases.
`NamespaceSymbol`	Describes a namespace and its members.
`NamespaceTranche`	Buckets the members that appear inside a namespace.
`NoexceptInfo`	Captures a `noexcept` specification and its evaluated form.
`Optional`	A compact optional that automatically uses nullable_traits<T> when available.
`Optional<T&>`	Optional reference wrapper that never owns storage.
`OutputRef`	Reference to output stream used by handlebars
`Overload`	Combines multiple callable types into a single overloaded function object.
`OverloadsSymbol`	Represents a set of function overloads.
`Param`	Represents a single function parameter
`ParseResult`	The result of a parse operation.
`PathGlobPattern`	A glob pattern matcher for paths
`PointerType`	Pointer type wrapper.
`Polymorphic`	A polymorphic value-type.
`RValueReferenceType`	An rvalue reference type.
`RangeFor`	Range adapter to expose first/last flags inside range-for loops.
`RecordInterface`	The aggregated interface for a given struct, class, or union.
`RecordSymbol`	Metadata for struct, class, or union.
`RecordTranche`	A group of members that have the same access specifier.
`ReferenceDirectories`	Reference directories used to resolve paths
`ScopeExit`	Execute a callable when the enclosing scope exits unless dismissed.
`ScopeExitRestore`	RAII helper that restores a referenced value on scope exit.
`SourceInfo`	Stores source information for a declaration.
`SourceLocation`	A source location with filename prettification.
`SpecializationName`	Represents a (possibly qualified) symbol name with template arguments.
`SplitLinesView`	A lazy input range of std::string_view lines split on all known line breaks.
`StringHash`	Transparent hash functor for string-like keys.
`StringList`	A list of strings that accepts several input forms.
`Symbol`	Base class with common properties of all symbols
`SymbolCommonBase`	Base class for providing variant discriminator functions.
`SymbolGlobPattern`	A glob pattern matcher for C++ symbols
`SymbolID`	A unique identifier for a symbol.
`TArg`	Base class for any template argument.
`TArgCommonBase`	CRTP base that fixes the argument kind.
`TParam`	Base class for a template parameter declaration.
`TParamCommonBase`	CRTP base that fixes the parameter kind.
`TaskGroup`	A subset of possible work in a thread pool.
`TemplateInfo`	Information about templates and specializations thereof.
`TemplateTArg`	Template template argument.
`TemplateTParam`	Template template parameter.
`ThreadPool`	A pool of threads for executing work concurrently.
`Type`	A possibly qualified type.
`TypeCommonBase`	CRTP base that ties a concrete type to a fixed TypeKind.
`TypeTArg`	Type template argument.
`TypeTParam`	Type template parameter.
`TypedefSymbol`	Info for typedef and using declarations.
`Unexpected`	Holds an unexpected error value for Expected.
`UsingSymbol`	Info for using declarations.
`VariableSymbol`	A variable.
`Visitor`	A visitor for a type
`YCombinator`	Enables recursive lambdas by passing a self-reference as the first argument.
`add_const_from`	Propagate const qualification from `From` to `To`, keeping references.
`add_cv_from`	Propagate both const and volatile qualifiers from `From` to `To`.
`add_cvref_from`	Propagate cv-qualification and reference category from `From` to `To`.
`add_lvalue_reference_from`	Propagate lvalue-reference from `From` to `To` if present.
`add_reference_from`	Propagate reference qualification from `From` to `To`.
`add_rvalue_reference_from`	Propagate rvalue-reference from `From` to `To` if present.
`add_volatile_from`	Propagate volatile qualification from `From` to `To`, keeping references.
`any_callable`	A movable, type-erased function object.
`any_callable<R(Args...)>`	Type-erased callable wrapper for signature `R(Args...)`.
`make_dependent`	Dependent alias of `T`, useful for delaying instantiation.
`nullable_traits`	nullable_traits<T> defines how to treat a T as “nullable” without an external engaged bit.
`nullable_traits<Location>`	nullable_traits specialization for Location.
`nullable_traits<T>`	nullable_traits for types with a sentinel.
`nullable_traits<Polymorphic<T>>`	nullable_traits for Polymorphic<T>.
`sentinel_traits`	Defines a customization point for types that have an intrinsic sentinel value denoting “null”.
`sentinel_traits<std::nullptr_t>`	sentinel_traits specialization for std::nullptr_t.
`sentinel_traits<T>`	sentinel_traits specialization for unsigned integral types.
`sentinel_traits<T*>`	sentinel_traits specialization for raw pointers.
`unexpect_t`	Tag type used to select unexpected construction.
`unlock_guard`	A scoped guard which unlocks a mutex.

Type Aliases

Name	Description
`UnorderedStringMap`	unordered_map keyed by std::string with transparent hashing.
`UnorderedStringMultiMap`	unordered_multimap keyed by std::string with transparent hashing.
`add_const_from_t`	Alias for `add_const_from<From, To>::type`.
`add_cv_from_t`	Alias for `add_cv_from<From, To>::type`.
`add_cvref_from_t`	Alias for `add_cvref_from<From, To>::type`.
`add_lvalue_reference_from_t`	Alias for `add_lvalue_reference_from<From, To>::type`.
`add_reference_from_t`	Alias for `add_reference_from<From, To>::type`.
`add_rvalue_reference_from_t`	Alias for `add_rvalue_reference_from<From, To>::type`.
`add_volatile_from_t`	Alias for `add_volatile_from<From, To>::type`.
`make_dependent_t`	Alias for `make_dependent<T, U>::type`.

Enums

Name	Description
`AccessKind`	Access specifier.
`AutoKind`	The kind of `auto` keyword used in a declaration.
`ConstexprKind`	`constexpr`/`consteval` specifier kinds
`ExplicitKind`	Explicit specifier kinds
`ExtractionMode`	Determine why a symbol is extracted
`FileKind`	Classifies where a file originates from.
`FunctionClass`	Function classifications
`FundamentalTypeKind`	Categorically describes a fundamental type.
`ListKind`	Classification of list ordering.
`NameKind`	Kinds of names that appear in type and symbol metadata.
`NoexceptKind`	Exception specification kinds
`OperatorKind`	Operator kinds
`QualifierKind`	Type qualifiers
`RecordKeyKind`	The kind of record: struct, class, or union.
`ReferenceKind`	Reference type kinds
`StorageClassKind`	Storage class kinds
`SymbolKind`	Info variant discriminator
`TArgKind`	The kind of template argument.
`TParamKeyKind`	The keyword a template parameter was declared with
`TParamKind`	Discriminates the different template parameter categories.
`TableAlignmentKind`	Horizontal alignment for table columns.
`TemplateSpecKind`	The kind of template or specialization.
`TypeKind`	Variants of C++ types captured in metadata.
`UsingClass`	The class of using declaration.

Functions

Name	Description
`CompareDerived`	Compares two polymorphic objects that have visit functions
`HTMLEscape`	`HTMLEscape` overloads
`addMember`	Append a new function overload to the set.
`addMetaObject`	Add a $meta object with type information.
`allMembers`	`allMembers` overloads
`assert_failed`	Handler invoked when `MRDOCS_ASSERT` fails.
`bottomUpTraverse`	Traverse a DocComment tree bottom-up (post-order).
`canMerge`	Check whether two symbols may be merged.
`cast`	`cast` overloads
`cast_or_null`	`cast_or_null` overloads
`compareSymbolNames`	Return the result of comparing s0 to s1.
`contains`	Determine if a range contains a specific element.
`contains_any`	Determine if a range contains any of the specified elements.
`contains_n`	Determine if a range contains at least N instances of the specified element.
`contains_n_any`	Determine if a range contains at least N instances of any of the specified elements.
`countSymbolKind`	Count the number of SymbolKind enumerators.
`createFrame`	Create child data objects.
`dyn_cast`	`dyn_cast` overloads
`dyn_cast_or_null`	`dyn_cast_or_null` overloads
`endsWithOneOf`	Determine if a string ends with one of the specified characters
`escapeExpression`
`findGenerator`	Find a generator by its id.
`find_last_of`	Find the last element in a range that matches an element in the specified range.
`forEachFile`	`forEachFile` overloads
`formatError`	Return a formatted error.
`fromString`	Convert a string to a FundamentalTypeKind.
`getDefaultAccessString`	Return the default accessibility for a record key kind.
`getOperatorKind`	Return the short name of an operator as a string.
`getOperatorKindFromSuffix`	Return the short name of an operator as a string.
`getOperatorName`	Return the name of an operator as a string.
`getOperatorReadableName`	Return the human-readable name of the operator
`getParents`	`getParents` overloads
`getPrimaryLocation`	`getPrimaryLocation` overloads
`getSafeOperatorName`	Return the safe name of an operator as a string.
`getShortOperatorName`	Return the short name of an operator as a string.
`getSinglePageFullPath`	Return the full path for single page output.
`innerType`	Return the inner type.
`innerTypePtr`	Return the inner type.
`innermostType`	`innermostType` overloads
`installGenerator`	Install a custom generator.
`isAlphaNumeric`	`isAlphaNumeric` overloads
`isAlphabetic`	`isAlphabetic` overloads
`isBinaryOperator`	Determines whether the operator is potentially binary.
`isCopyAssignment`	Check whether a function is a copy assignment operator.
`isCopyConstructor`	Check whether a function is a copy constructor.
`isDefaultConstructor`	Check whether a function is a default constructor.
`isDigit`	`isDigit` overloads
`isEmpty`	Determine if a value is empty
`isLowerCase`	`isLowerCase` overloads
`isMoveAssignment`	Check whether a function is a move assignment operator.
`isMoveConstructor`	Check whether a function is a move constructor.
`isSpecialMemberFunction`	Check whether a function is a special member function.
`isUnaryOperator`	Determines whether the operator is potentially unary.
`isUpperCase`	`isUpperCase` overloads
`isWhitespace`	`isWhitespace` overloads
`is_null`	is_null helper that uses nullable_traits<T> if available.
`is_one_of`	Determine if an element is equal to any of the elements in the specified range.
`isa`	Return true if the polymorphic object holds a value of type To.
`isa_or_null`	Return true if pointer is non-null and referent is of type To.
`leastSpecific`	Compare ExtractionModes and returns the least specific
`ltrim`	`ltrim` overloads
`makeChar`	Apply the "char" specifier to the type
`makeLong`	Apply the "long" specifier to the type
`makeOverload`	Factory function that creates an Overload from the given callables.
`makeShort`	Apply the "short" specifier to the type
`makeSigned`	Apply the "signed" specifier to the type
`makeUnsigned`	Apply the "unsigned" specifier to the type
`makeVisitor`	Make a visitor for a base type
`make_array_view`	`make_array_view` overloads
`make_null`	make_null helper that uses nullable_traits<T> if available.
`mapReflectedType`	`mapReflectedType` overloads
`match`	Applies a set of callables to a std::variant using std::visit and Overload.
`merge`	`merge` overloads
`mostSpecific`	Compare ExtractionModes and returns the most specific
`null_of`	null_of helper that constructs a null T using nullable_traits<T>.
`operator\|`	Pipe a contiguous character range into the adaptor.
`overrides`	Determine if one function would override the other
`parse`	Parse a string view
`readableTypeName`	Get the unqualified name of a type.
`reindentCode`	Reindent code by removing the common leading spaces and adding the specified indent.
`replace`	Return the substring without leading and trailing horizontal whitespace.
`rtrim`	`rtrim` overloads
`safeString`	`safeString` overloads
`splitLines`	`splitLines` overloads
`startsWithOneOf`	Determine if a string starts with one of the specified characters
`swap`	`swap` overloads
`tag_invoke`	`tag_invoke` overloads
`toBase16Str`	Convert a SymbolID to a string
`toCamelCase`	Convert a string to `camelCase` using ASCII letter rules.
`toKebabCase`	Convert a string to `kebab-case` using ASCII letter rules.
`toLowerCase`	`toLowerCase` overloads
`toPascalCase`	Convert a string to `PascalCase` using ASCII letter rules.
`toSnakeCase`	Convert a string to `snake_case` using ASCII letter rules.
`toString`	`toString` overloads
`toUpperCase`	`toUpperCase` overloads
`to_underlying`	Return the value as its underlying type.
`topDownTraverse`	Traverse a DocComment tree top-down (pre-order).
`trim`	`trim` overloads
`visit`	`visit` overloads
`visitIndexed`	Visits a std::variant and calls the combined callable with the active index and the value.
`yCombinator`	Factory that creates a YCombinator from a callable.
`operator<<`	Write to output
`operator==`	Equality operators
`operator!=`	Inequality operators
`operator<`	Less-than operators
`operator<=`	Less-than-or-equal operators
`operator>`	Greater-than operators
`operator>=`	Greater-than-or-equal operators
`operator<=>`	Three-way comparison operators

Variables

Name	Description
`htmlEscapeEntities`	Character-to-entity table used by `HTMLEscape`.
`unexpect`	Tag object to request unexpected construction.

Concepts

Name	Description
`ClearableContainerLike`	Internal concept that matches “empty-clear default-constructible” types.
`DescribedComparable`	True if T has described members (for comparison).
`DocCommentNode`	Concept to check if a type represents a DocComment node.
`DocCommentNodeTraversable`	Types that can be traversed by DocComment helpers.
`HasParse`	Concept to determine if there's a parse function for a type.
`HasSentinel`	Concept that is satisfied when sentinel_traits<T> declares a usable sentinel.
`SymbolParent`	A concept for types that have `Symbol` members.
`dereferenceable`	Determine if a type is dereferenceable
`has_nullable_traits_v`	Utility concept that returns true if T has a nullable_traits specialization enabled.
`pair_like`	Concept to check if a type is pair-like
`polymorphic_storage_for`	Concept to check if a type is representing a polymorphic storage
`range_of`	Concept to check if a type is a range of T
`range_of_tuple_like`	Concept to check if a range is a range of tuple-like elements
`tuple_like`	Concept to check if a type is tuple-like

Deduction Guides

Name	Description
`ArrayView<T>`	Deduce ArrayView element type from C-style array.
`ArrayView<T>`	Deduce ArrayView element type from pointer and count.
`Overload<Ts...>`	Class template argument deduction guide for Overload.
`RangeFor<Container>`	Deduction guide for RangeFor.
`ScopeExit<F>`	Deduction guide for ScopeExit.
`ScopeExitRestore<T>`	Deduction guide for ScopeExitRestore taking a reference.
`ScopeExitRestore<T>`	Deduction guide for ScopeExitRestore taking a reference and new value.
`Unexpected<E>`	Deduction guide for Unexpected, forwarding the error type.

Using Declarations

Name	Description
`reference_constructs_from_temporary_v`	True when binding `To` from `From` would require a temporary conversion.
`reference_converts_from_temporary_v`	Like `reference_converts_from_temporary_v`, but for construction.
`source_location`	Alias to `std::source_location` when available.

mrdocs::doc namespace

Types

Name	Description
`AdmonitionBlock`	A block for side-notes like tips, warnings, notes
`Block`	A piece of block content
`BlockCommonBase`	Base class for providing variant discriminator functions.
`BlockContainer`	A composite block that stores a sequence of child blocks.
`BriefBlock`	The brief description
`CodeBlock`	Preformatted source code.
`CodeInline`	Inline code (monospaced) used for short snippets within text.
`CopyDetailsInline`	Documentation copied from another symbol.
`DefinitionListBlock`	A list of terms paired with definitions.
`DefinitionListItem`	An item in a definition list
`EmphInline`	Emphasized text (typically rendered in italics).
`FootnoteDefinitionBlock`	Text defining the content of a footnote reference.
`FootnoteReferenceInline`	A reference to a symbol.
`HeadingBlock`	A manually specified section heading.
`HighlightInline`	Highlighted text span used to call out important words.
`ImageInline`	An image.
`Inline`	A Node containing a string of text.
`InlineCommonBase`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.
`InlineTextLeaf`	A leaf node that stores a string of text.
`LineBreakInline`	A hard line break that renders as ""
`LinkInline`	A hyperlink.
`ListBlock`	A list of list items
`ListItem`	An item in a `ListBlock`
`MathBlock`	A block of LaTeX math
`MathInline`	An inline LaTeX math expression
`ParagraphBlock`	A sequence of text nodes.
`ParamBlock`	Documentation for a function parameter
`PostconditionBlock`	Text describing conditions guaranteed on successful exit.
`PreconditionBlock`	Text describing required conditions before entry.
`QuoteBlock`	A quoted block of text.
`ReferenceInline`	A reference to a symbol.
`ReturnsBlock`	Documentation for a function return type
`SeeBlock`	A
`SoftBreakInline`	A line break that may render as a space
`StrikethroughInline`	Strikethrough span to show removed or deprecated text.
`StrongInline`	Strong emphasis span (typically rendered in bold).
`SubscriptInline`	Subscript text fragment (lowered baseline).
`SuperscriptInline`	Superscript text fragment (raised baseline).
`TParamBlock`	Documentation for a template parameter
`TableBlock`	A table block
`TableCell`	A cell in a table
`TableRow`	An item in a list
`TextInline`	A Node containing a string of text.
`ThematicBreakBlock`	A horizontal thematic break separating sections.
`ThrowsBlock`	Documentation for a function exception clause

Enums

Name	Description
`AdmonitionKind`	An admonishment style.
`BlockKind`	Enumerates the different kinds of DocComment blocks.
`InlineKind`	Enumerates the different kinds of inline nodes.
`ParamDirection`	Parameter pass direction.
`Parts`	Which parts of the documentation to copy.

Functions

Name	Description
`getAsPlainText`	`getAsPlainText` overloads
`isBlockCommand`	Return true if the given block kind represents a command block.
`isEmpty`	Determine if the inline is empty
`ltrim`	`ltrim` overloads
`rtrim`	`rtrim` overloads
`tag_invoke`	`tag_invoke` overloads
`toString`	`toString` overloads
`traverse`	Traverse a list of inlines.
`trim`	`trim` overloads
`visit`	`visit` overloads
`operator==`	Equality delegates to the three-way comparison.
`operator<=>`	Three-way comparison operators

Using Declarations

Name	Description
`operator<=>`	Three-way comparison for any described type.
`operator==`	Equality for any described type.

mrdocs::dom namespace

Namespaces

Name	Description
`JSON`	JSON serialization helpers for DOM values.

Types

Name	Description
`Array`	An array of values
`ArrayImpl`	Abstract array interface.
`DefaultArrayImpl`	The default array implementation.
`DefaultFunctionImpl`	Function implementation that wraps a fixed-arity callable.
`DefaultObjectImpl`	The default Object implementation.
`Function`	Value-semantic wrapper over a callable exposed to the DOM layer.
`FunctionImpl`	Value-semantic wrapper over a callable exposed to the DOM layer.
`LazyArrayImpl`	Lazy array implementation
`LazyArrayImpl`	Lazy array implementation
`LazyObjectImpl`	Lazy object implementation.
`LazyObjectImpl`	Lazy object implementation.
`LazyObjectMapTag`	Customization point tag.
`Object`	A container of key and value pairs.
`ObjectImpl`	Abstract object interface.
`String`	UTF-8 string value used by the DOM.
`Value`	A variant container for any kind of Dom value.
`ValueFromTag`	Customization point tag.
`VariadicFunctionImpl`	Function implementation that forwards the entire Array to a callable.
`function_traits`	Helper traits to extract return and argument types from callables.
`function_traits<F>`	Traits specialization for functors/lambdas.
`function_traits<R(*)(Args...)>`	Traits specialization for function pointers.
`function_traits<R(Args...)>`	Traits specialization for free functions.
`function_traits<R const volatile(C::*)(Args...)>`	Traits specialization for member functions.

Enums

Name	Description
`Kind`	The type of data in a Value.

Functions

Name	Description
`LazyArray`	`LazyArray` overloads
`LazyObject`	`LazyObject` overloads
`TransformArray`	Return a new dom::Array based on a transformed lazy array implementation.
`ValueFrom`	`ValueFrom` overloads
`makeInvocable`	Create a Function from a fixed-arity invocable.
`makeVariadicInvocable`	Create a Function that receives the argument Array directly.
`newArray`	Return a new array using a custom implementation.
`newFunction`	Return a diagnostic string.
`newObject`	Return a new object using a custom implementation.
`operator&&`	Return the first dom::Value that is not truthy, or the last one.
`operator+`	Addition operators
`operator\|\|`	Return the first dom::Value that is truthy, or the last one.
`stringOrNull`	Return a non-empty string, or a null.
`swap`	`swap` overloads
`toString`	`toString` overloads
`operator==`	Equality operators
`operator!=`	Return the result of comparing two strings.
`operator<=>`	Three-way comparison operators

Concepts

Name	Description
`HasLazyObjectMap`	Determine if `T` can be converted to `dom::Value`.
`HasLazyObjectMapWithContext`	Concept to determine if a type can be mapped to a `dom::LazyObjectImpl` with a user-provided conversion.
`HasLazyObjectMapWithoutContext`	Concept to determine if a type can be mapped to a `dom::LazyObjectImpl` with a user-provided conversion.
`HasStandaloneValueFrom`	Determine if `T` can be converted to `dom::Value` without a context.
`HasValueFrom`	Determine if `T` can be converted to `dom::Value`.
`HasValueFromWithContext`	Concept to determine if a type can be converted to a `dom::Value` with a user-provided conversion.
`HasValueFromWithoutContext`	Concept to determine if a type can be converted to a `dom::Value` with a user-provided conversion.
`StringLikeTy`	Satisfied if StringTy is convertible to String but not a String.
`function_traits_convertible_to_value`	Concept selecting callables convertible to dom::Value.
`has_function_args_for_default_function_impl`	Concept requiring all arguments be convertible to dom::Value.
`has_function_traits`	Concept true when function_traits is defined for F.
`has_function_traits_for_default_function_impl`	Concept combining argument and return constraints for default wrapper.
`has_invoke_expected_result_convertible_to_dom_value`	Concept true when F returns Expected<dom::Value> or Expected<void>.
`has_invoke_result_convertible_to_dom_value`	Concept true when F returns a dom::Value or void.
`has_invoke_result_for_default_function_impl`	Concept enabling default function wrapper for supported return types.

mrdocs::dom::JSON namespace

Functions

Name	Description
`stringify`	Stringify a value as JSON

mrdocs::files namespace

Enums

Name	Description
`FileType`	The type of a file.

Functions

Name	Description
`appendPath`	`appendPath` overloads
`createDirectory`	Create a directory.
`exists`	Determine if a path exists
`getFileName`	Return the filename part of the path.
`getFileText`	Return the contents of a file as a string.
`getFileType`	Return the file type or an error
`getParentDir`	Return the parent directory.
`getSourceFilename`	Return the relevant suffix of a source file path.
`isAbsolute`	Return true if pathName is absolute.
`isDirectory`	Determine if a path is a directory.
`isDirsy`	Return true if pathName ends in a separator.
`isLexicalDirectory`	Determine lexically if a path is a directory.
`isPosixStyle`	Check if the path is posix style.
`isResolvedSubpathOf`	Checks whether the given path lies within the specified prefix, tolerating symlinks.
`isSubpathOf`	Checks whether the given path lies within the specified prefix.
`makeAbsolute`	Return an absolute path from a possibly relative path.
`makeDirsy`	Append a trailing native separator if not already present.
`makePosixStyle`	Convert all backward slashes to forward slashes.
`makeRealPath`	Return the real, symlink-resolved form of a path.
`normalizeDir`	Return a normalized directory.
`normalizePath`	Return a normalized path.
`requireAbsolute`	Return an error if pathName is not absolute.
`requireDirectory`	Return an error if the path is not a directory.
`withExtension`	Return the filename with a new or different extension.

mrdocs::helpers namespace

Functions

Name	Description
`and_fn`	"and" helper function
`detag_fn`	"detag" helper function
`eq_fn`	"eq" helper function
`increment_fn`	"increment" helper function
`ne_fn`	"ne" helper function
`not_fn`	"not" helper function
`or_fn`	"or" helper function
`registerAntoraHelpers`	Register all the Antora helpers into a Handlebars instance
`registerBuiltinHelpers`	Register all the built-in helpers into a Handlebars instance
`registerConstructorHelpers`	Register contructor helpers into a Handlebars instance
`registerContainerHelpers`	Register helpers to manipulate composite data types
`registerLogicalHelpers`	Register logical helpers into a Handlebars instance
`registerMathHelpers`	Register math helpers into a Handlebars instance
`registerStringHelpers`	Register string helpers into a Handlebars instance
`registerTypeHelpers`	Register type helpers into a Handlebars instance
`relativize_fn`	"relativize" helper function
`select_fn`	"select" helper function
`year_fn`	"year" helper function

mrdocs::js namespace

Types

Name	Description
`Array`	Lightweight handle to a JavaScript array.
`Boolean`	Boolean wrapper for JavaScript values.
`Context`	An isolated JavaScript interpreter instance.
`Object`	Object wrapper for JavaScript values.
`Scope`	A JavaScript scope for value lifetime management.
`String`	String wrapper for JavaScript values.
`Value`	An ECMAScript value.

Enums

Name	Description
`Type`	Types of values.

Functions

Name	Description
`operator&&`	Return the first Value that is not truthy, or the last one.
`operator\|\|`	Return the first Value that is truthy, or the last one.
`registerHelper`	Register a JavaScript helper function
`swap`	Swap two values.
`toString`	Return value as a string.
`operator==`	Compare two values for equality.
`operator!=`	Inequality operators
`operator<=>`	Compare two values for inequality.

mrdocs::lua namespace

Types

Name	Description
`Access`	Internal tag granting access to lua internals.
`Context`	A reference to an instance of a Lua interpreter.
`Function`	A Lua function.
`Param`	A lazy container to push values to the Lua stack.
`Scope`	Stack scope guard for Lua calls.
`String`	A Lua string.
`Table`	A Lua table.
`Value`	A Lua value.
`zstring`	A null-terminated string.

Type Aliases

Name	Description
`FunctionPtr`	Pointer to a Lua-callable function returning Value.

Enums

Name	Description
`Type`	Types of values.

Functions

Name	Description
`registerHelper`	Register a Lua helper function

mrdocs::report namespace

Types

Name	Description
`Located`	Parameter type that adds a source location to a value.
`Results`	Provides statistics on the number of reported messages.

Enums

Name	Description
`Level`	Severity levels attached to reported messags.

Functions

Name	Description
`debug`	Emit a debug-level diagnostic for troubleshooting.
`error`	Emit an error that indicates failure but allows continuation.
`fatal`	Emit a fatal error and mark the report as the highest severity.
`getMinimumLevel`	Get the minimum threshold level for reporting.
`info`	Emit an informational message for users.
`log`	Format a message to the console.
`print`	Report a message to the console.
`setMinimumLevel`	Set the minimum threshold level for reporting.
`setSourceLocationWarnings`	If true, source location information will be printed with warnings, errors, and fatal messages.
`trace`	Emit a trace-level diagnostic (verbose, off by default).
`warn`	Emit a warning that does not stop execution.

Variables

Name	Description
`results`	Holds current statistics on reported messages.

Description

The public mrdocs namespace here centralizes assert/assume hooks so we can swap behavior (terminate, throw, debugbreak) in one place without leaking platform specifics into the rest of the codebase.

Doc-comment enums and helpers that describe admonition kinds.

Reporting utilities (messages, statistics, sinks).

The report namespace owns severity enums, message structs, and output sinks so tooling and libraries emit diagnostics in a uniform, testable format regardless of UI.

Namespaces

Name	Description
`doc`	Doc-comment enums and helpers that describe admonition kinds.
`dom`	Objects representing JSON-like values.
`files`	Filesystem helpers (join, temp, real-path resolution) used throughout MrDocs.
`helpers`	Handlebars helper registry for templates.
`js`	JavaScript interop helpers for the embedded runtime.
`lua`	Lua interop helpers for the optional scripting/backend integration.
`report`	Reporting utilities (messages, statistics, sinks).

Types

Name	Description
`AnyFileVisitor`	Polymorphic visitor for files discovered during traversal.
`ArrayType`	C++ array type (bounded or unbounded).
`ArrayView`	A non-owning, read-only view over a contiguous array of T.
`AutoType`	Represents `auto` or `decltype(auto)` placeholder type.
`BadExpectedAccess`	Base class for accessing an empty Expected.
`BadExpectedAccess<void>`	Exception thrown when reading the value of an empty Expected.
`BaseInfo`	Metadata for a direct base.
`ConceptSymbol`	Info for concepts.
`Config`	Configuration used to generate the Corpus and Docs
`ConstantExprInfo`	Represents an expression with a (possibly known) value
`ConstantTArg`	Non-type template argument.
`ConstantTParam`	A constant template parameter
`Corpus`	The collection of declarations in extracted form.
`DecltypeType`	`decltype(expr)` type wrapper.
`DocComment`	A processed documentation comment attached to a declaration.
`DomCorpus`	Front-end factory for producing Dom nodes.
`EnumConstantSymbol`	Info for enum constants.
`EnumSymbol`	Metadata for an enumeration declaration.
`Error`	Holds the description of an error, or success.
`Exception`	Type of all exceptions thrown by the API.
`ExecutorGroup`	A set of execution agents for performing concurrent work.
`ExecutorGroupBase`	Base class that owns a pool of execution agents and a shared work queue.
`Expected`	A container holding an error or a value.
`Expected<T, E>`	Expected specialization for `void` values. Holds either success (no payload) or an unexpected error `E`.
`Expected<T&, E>`	Expected specialization for lvalue references. Holds either a bound reference to `T` or an unexpected error `E`.
`ExplicitInfo`	Stores only the operand of the explicit-specifier or noexcept-specifier as a string. The complete expression is not preserved at this time. This is a temporary design and may be improved in the future.
`ExprInfo`	Represents an expression
`FormatString`	A format string with source location.
`FriendInfo`	Info for friend declarations.
`FunctionSymbol`	Metadata for a function or method.
`FunctionType`	Function type with parameters, qualifiers, and noexcept info.
`Generator`	Base class for documentation generators.
`GlobPattern`	A glob pattern matcher
`GuideSymbol`	Info for deduction guides.
`Handlebars`	A handlebars environment
`HandlebarsError`	An error thrown or returned by Handlebars
`HandlebarsOptions`	Options for handlebars
`IdentifierName`	Represents an identifier
`LValueReferenceType`	An lvalue reference type.
`Location`	Source location of a symbol or entity.
`MemberPointerType`	Pointer-to-member type (object or function).
`Name`	Represents a name for a named `Type`
`NamedType`	A type identified by name (possibly fundamental).
`NamespaceAliasSymbol`	Info for namespace aliases.
`NamespaceSymbol`	Describes a namespace and its members.
`NamespaceTranche`	Buckets the members that appear inside a namespace.
`NoexceptInfo`	Captures a `noexcept` specification and its evaluated form.
`Optional`	A compact optional that automatically uses nullable_traits<T> when available.
`Optional<T&>`	Optional reference wrapper that never owns storage.
`OutputRef`	Reference to output stream used by handlebars
`Overload`	Combines multiple callable types into a single overloaded function object.
`OverloadsSymbol`	Represents a set of function overloads.
`Param`	Represents a single function parameter
`ParseResult`	The result of a parse operation.
`PathGlobPattern`	A glob pattern matcher for paths
`PointerType`	Pointer type wrapper.
`Polymorphic`	A polymorphic value-type.
`RValueReferenceType`	An rvalue reference type.
`RangeFor`	Range adapter to expose first/last flags inside range-for loops.
`RecordInterface`	The aggregated interface for a given struct, class, or union.
`RecordSymbol`	Metadata for struct, class, or union.
`RecordTranche`	A group of members that have the same access specifier.
`ReferenceDirectories`	Reference directories used to resolve paths
`ScopeExit`	Execute a callable when the enclosing scope exits unless dismissed.
`ScopeExitRestore`	RAII helper that restores a referenced value on scope exit.
`SourceInfo`	Stores source information for a declaration.
`SourceLocation`	A source location with filename prettification.
`SpecializationName`	Represents a (possibly qualified) symbol name with template arguments.
`SplitLinesView`	A lazy input range of std::string_view lines split on all known line breaks.
`StringHash`	Transparent hash functor for string-like keys.
`StringList`	A list of strings that accepts several input forms.
`Symbol`	Base class with common properties of all symbols
`SymbolCommonBase`	Base class for providing variant discriminator functions.
`SymbolGlobPattern`	A glob pattern matcher for C++ symbols
`SymbolID`	A unique identifier for a symbol.
`TArg`	Base class for any template argument.
`TArgCommonBase`	CRTP base that fixes the argument kind.
`TParam`	Base class for a template parameter declaration.
`TParamCommonBase`	CRTP base that fixes the parameter kind.
`TaskGroup`	A subset of possible work in a thread pool.
`TemplateInfo`	Information about templates and specializations thereof.
`TemplateTArg`	Template template argument.
`TemplateTParam`	Template template parameter.
`ThreadPool`	A pool of threads for executing work concurrently.
`Type`	A possibly qualified type.
`TypeCommonBase`	CRTP base that ties a concrete type to a fixed TypeKind.
`TypeTArg`	Type template argument.
`TypeTParam`	Type template parameter.
`TypedefSymbol`	Info for typedef and using declarations.
`Unexpected`	Holds an unexpected error value for Expected.
`UsingSymbol`	Info for using declarations.
`VariableSymbol`	A variable.
`Visitor`	A visitor for a type
`YCombinator`	Enables recursive lambdas by passing a self-reference as the first argument.
`add_const_from`	Propagate const qualification from `From` to `To`, keeping references.
`add_cv_from`	Propagate both const and volatile qualifiers from `From` to `To`.
`add_cvref_from`	Propagate cv-qualification and reference category from `From` to `To`.
`add_lvalue_reference_from`	Propagate lvalue-reference from `From` to `To` if present.
`add_reference_from`	Propagate reference qualification from `From` to `To`.
`add_rvalue_reference_from`	Propagate rvalue-reference from `From` to `To` if present.
`add_volatile_from`	Propagate volatile qualification from `From` to `To`, keeping references.
`any_callable`	A movable, type-erased function object.
`any_callable<R(Args...)>`	Type-erased callable wrapper for signature `R(Args...)`.
`make_dependent`	Dependent alias of `T`, useful for delaying instantiation.
`nullable_traits`	nullable_traits<T> defines how to treat a T as “nullable” without an external engaged bit.
`nullable_traits<Location>`	nullable_traits specialization for Location.
`nullable_traits<T>`	nullable_traits for types with a sentinel.
`nullable_traits<Polymorphic<T>>`	nullable_traits for Polymorphic<T>.
`sentinel_traits`	Defines a customization point for types that have an intrinsic sentinel value denoting “null”.
`sentinel_traits<std::nullptr_t>`	sentinel_traits specialization for std::nullptr_t.
`sentinel_traits<T>`	sentinel_traits specialization for unsigned integral types.
`sentinel_traits<T*>`	sentinel_traits specialization for raw pointers.
`unexpect_t`	Tag type used to select unexpected construction.
`unlock_guard`	A scoped guard which unlocks a mutex.

Type Aliases

Name	Description
`UnorderedStringMap`	unordered_map keyed by std::string with transparent hashing.
`UnorderedStringMultiMap`	unordered_multimap keyed by std::string with transparent hashing.
`add_const_from_t`	Alias for `add_const_from<From, To>::type`.
`add_cv_from_t`	Alias for `add_cv_from<From, To>::type`.
`add_cvref_from_t`	Alias for `add_cvref_from<From, To>::type`.
`add_lvalue_reference_from_t`	Alias for `add_lvalue_reference_from<From, To>::type`.
`add_reference_from_t`	Alias for `add_reference_from<From, To>::type`.
`add_rvalue_reference_from_t`	Alias for `add_rvalue_reference_from<From, To>::type`.
`add_volatile_from_t`	Alias for `add_volatile_from<From, To>::type`.
`make_dependent_t`	Alias for `make_dependent<T, U>::type`.

Enums

Name	Description
`AccessKind`	Access specifier.
`AutoKind`	The kind of `auto` keyword used in a declaration.
`ConstexprKind`	`constexpr`/`consteval` specifier kinds
`ExplicitKind`	Explicit specifier kinds
`ExtractionMode`	Determine why a symbol is extracted
`FileKind`	Classifies where a file originates from.
`FunctionClass`	Function classifications
`FundamentalTypeKind`	Categorically describes a fundamental type.
`ListKind`	Classification of list ordering.
`NameKind`	Kinds of names that appear in type and symbol metadata.
`NoexceptKind`	Exception specification kinds
`OperatorKind`	Operator kinds
`QualifierKind`	Type qualifiers
`RecordKeyKind`	The kind of record: struct, class, or union.
`ReferenceKind`	Reference type kinds
`StorageClassKind`	Storage class kinds
`SymbolKind`	Info variant discriminator
`TArgKind`	The kind of template argument.
`TParamKeyKind`	The keyword a template parameter was declared with
`TParamKind`	Discriminates the different template parameter categories.
`TableAlignmentKind`	Horizontal alignment for table columns.
`TemplateSpecKind`	The kind of template or specialization.
`TypeKind`	Variants of C++ types captured in metadata.
`UsingClass`	The class of using declaration.

Functions

Name	Description
`CompareDerived`	Compares two polymorphic objects that have visit functions
`HTMLEscape`	`HTMLEscape` overloads
`addMember`	Append a new function overload to the set.
`addMetaObject`	Add a $meta object with type information.
`allMembers`	`allMembers` overloads
`assert_failed`	Handler invoked when `MRDOCS_ASSERT` fails.
`bottomUpTraverse`	Traverse a DocComment tree bottom-up (post-order).
`canMerge`	Check whether two symbols may be merged.
`cast`	`cast` overloads
`cast_or_null`	`cast_or_null` overloads
`compareSymbolNames`	Return the result of comparing s0 to s1.
`contains`	Determine if a range contains a specific element.
`contains_any`	Determine if a range contains any of the specified elements.
`contains_n`	Determine if a range contains at least N instances of the specified element.
`contains_n_any`	Determine if a range contains at least N instances of any of the specified elements.
`countSymbolKind`	Count the number of SymbolKind enumerators.
`createFrame`	Create child data objects.
`dyn_cast`	`dyn_cast` overloads
`dyn_cast_or_null`	`dyn_cast_or_null` overloads
`endsWithOneOf`	Determine if a string ends with one of the specified characters
`escapeExpression`
`findGenerator`	Find a generator by its id.
`find_last_of`	Find the last element in a range that matches an element in the specified range.
`forEachFile`	`forEachFile` overloads
`formatError`	Return a formatted error.
`fromString`	Convert a string to a FundamentalTypeKind.
`getDefaultAccessString`	Return the default accessibility for a record key kind.
`getOperatorKind`	Return the short name of an operator as a string.
`getOperatorKindFromSuffix`	Return the short name of an operator as a string.
`getOperatorName`	Return the name of an operator as a string.
`getOperatorReadableName`	Return the human-readable name of the operator
`getParents`	`getParents` overloads
`getPrimaryLocation`	`getPrimaryLocation` overloads
`getSafeOperatorName`	Return the safe name of an operator as a string.
`getShortOperatorName`	Return the short name of an operator as a string.
`getSinglePageFullPath`	Return the full path for single page output.
`innerType`	Return the inner type.
`innerTypePtr`	Return the inner type.
`innermostType`	`innermostType` overloads
`installGenerator`	Install a custom generator.
`isAlphaNumeric`	`isAlphaNumeric` overloads
`isAlphabetic`	`isAlphabetic` overloads
`isBinaryOperator`	Determines whether the operator is potentially binary.
`isCopyAssignment`	Check whether a function is a copy assignment operator.
`isCopyConstructor`	Check whether a function is a copy constructor.
`isDefaultConstructor`	Check whether a function is a default constructor.
`isDigit`	`isDigit` overloads
`isEmpty`	Determine if a value is empty
`isLowerCase`	`isLowerCase` overloads
`isMoveAssignment`	Check whether a function is a move assignment operator.
`isMoveConstructor`	Check whether a function is a move constructor.
`isSpecialMemberFunction`	Check whether a function is a special member function.
`isUnaryOperator`	Determines whether the operator is potentially unary.
`isUpperCase`	`isUpperCase` overloads
`isWhitespace`	`isWhitespace` overloads
`is_null`	is_null helper that uses nullable_traits<T> if available.
`is_one_of`	Determine if an element is equal to any of the elements in the specified range.
`isa`	Return true if the polymorphic object holds a value of type To.
`isa_or_null`	Return true if pointer is non-null and referent is of type To.
`leastSpecific`	Compare ExtractionModes and returns the least specific
`ltrim`	`ltrim` overloads
`makeChar`	Apply the "char" specifier to the type
`makeLong`	Apply the "long" specifier to the type
`makeOverload`	Factory function that creates an Overload from the given callables.
`makeShort`	Apply the "short" specifier to the type
`makeSigned`	Apply the "signed" specifier to the type
`makeUnsigned`	Apply the "unsigned" specifier to the type
`makeVisitor`	Make a visitor for a base type
`make_array_view`	`make_array_view` overloads
`make_null`	make_null helper that uses nullable_traits<T> if available.
`mapReflectedType`	`mapReflectedType` overloads
`match`	Applies a set of callables to a std::variant using std::visit and Overload.
`merge`	`merge` overloads
`mostSpecific`	Compare ExtractionModes and returns the most specific
`null_of`	null_of helper that constructs a null T using nullable_traits<T>.
`operator\|`	Pipe a contiguous character range into the adaptor.
`overrides`	Determine if one function would override the other
`parse`	Parse a string view
`readableTypeName`	Get the unqualified name of a type.
`reindentCode`	Reindent code by removing the common leading spaces and adding the specified indent.
`replace`	Return the substring without leading and trailing horizontal whitespace.
`rtrim`	`rtrim` overloads
`safeString`	`safeString` overloads
`splitLines`	`splitLines` overloads
`startsWithOneOf`	Determine if a string starts with one of the specified characters
`swap`	`swap` overloads
`tag_invoke`	`tag_invoke` overloads
`toBase16Str`	Convert a SymbolID to a string
`toCamelCase`	Convert a string to `camelCase` using ASCII letter rules.
`toKebabCase`	Convert a string to `kebab-case` using ASCII letter rules.
`toLowerCase`	`toLowerCase` overloads
`toPascalCase`	Convert a string to `PascalCase` using ASCII letter rules.
`toSnakeCase`	Convert a string to `snake_case` using ASCII letter rules.
`toString`	`toString` overloads
`toUpperCase`	`toUpperCase` overloads
`to_underlying`	Return the value as its underlying type.
`topDownTraverse`	Traverse a DocComment tree top-down (pre-order).
`trim`	`trim` overloads
`visit`	`visit` overloads
`visitIndexed`	Visits a std::variant and calls the combined callable with the active index and the value.
`yCombinator`	Factory that creates a YCombinator from a callable.
`operator<<`	Write to output
`operator==`	Equality operators
`operator!=`	Inequality operators
`operator<`	Less-than operators
`operator<=`	Less-than-or-equal operators
`operator>`	Greater-than operators
`operator>=`	Greater-than-or-equal operators
`operator<=>`	Three-way comparison operators

Variables

Name	Description
`htmlEscapeEntities`	Character-to-entity table used by `HTMLEscape`.
`unexpect`	Tag object to request unexpected construction.

Concepts

Name	Description
`ClearableContainerLike`	Internal concept that matches “empty-clear default-constructible” types.
`DescribedComparable`	True if T has described members (for comparison).
`DocCommentNode`	Concept to check if a type represents a DocComment node.
`DocCommentNodeTraversable`	Types that can be traversed by DocComment helpers.
`HasParse`	Concept to determine if there's a parse function for a type.
`HasSentinel`	Concept that is satisfied when sentinel_traits<T> declares a usable sentinel.
`SymbolParent`	A concept for types that have `Symbol` members.
`dereferenceable`	Determine if a type is dereferenceable
`has_nullable_traits_v`	Utility concept that returns true if T has a nullable_traits specialization enabled.
`pair_like`	Concept to check if a type is pair-like
`polymorphic_storage_for`	Concept to check if a type is representing a polymorphic storage
`range_of`	Concept to check if a type is a range of T
`range_of_tuple_like`	Concept to check if a range is a range of tuple-like elements
`tuple_like`	Concept to check if a type is tuple-like

Deduction Guides

Name	Description
`ArrayView<T>`	Deduce ArrayView element type from C-style array.
`ArrayView<T>`	Deduce ArrayView element type from pointer and count.
`Overload<Ts...>`	Class template argument deduction guide for Overload.
`RangeFor<Container>`	Deduction guide for RangeFor.
`ScopeExit<F>`	Deduction guide for ScopeExit.
`ScopeExitRestore<T>`	Deduction guide for ScopeExitRestore taking a reference.
`ScopeExitRestore<T>`	Deduction guide for ScopeExitRestore taking a reference and new value.
`Unexpected<E>`	Deduction guide for Unexpected, forwarding the error type.

Using Declarations

Name	Description
`reference_constructs_from_temporary_v`	True when binding `To` from `From` would require a temporary conversion.
`reference_converts_from_temporary_v`	Like `reference_converts_from_temporary_v`, but for construction.
`source_location`	Alias to `std::source_location` when available.

Types

Name	Description
`AdmonitionBlock`	A block for side-notes like tips, warnings, notes
`Block`	A piece of block content
`BlockCommonBase`	Base class for providing variant discriminator functions.
`BlockContainer`	A composite block that stores a sequence of child blocks.
`BriefBlock`	The brief description
`CodeBlock`	Preformatted source code.
`CodeInline`	Inline code (monospaced) used for short snippets within text.
`CopyDetailsInline`	Documentation copied from another symbol.
`DefinitionListBlock`	A list of terms paired with definitions.
`DefinitionListItem`	An item in a definition list
`EmphInline`	Emphasized text (typically rendered in italics).
`FootnoteDefinitionBlock`	Text defining the content of a footnote reference.
`FootnoteReferenceInline`	A reference to a symbol.
`HeadingBlock`	A manually specified section heading.
`HighlightInline`	Highlighted text span used to call out important words.
`ImageInline`	An image.
`Inline`	A Node containing a string of text.
`InlineCommonBase`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.
`InlineTextLeaf`	A leaf node that stores a string of text.
`LineBreakInline`	A hard line break that renders as ""
`LinkInline`	A hyperlink.
`ListBlock`	A list of list items
`ListItem`	An item in a `ListBlock`
`MathBlock`	A block of LaTeX math
`MathInline`	An inline LaTeX math expression
`ParagraphBlock`	A sequence of text nodes.
`ParamBlock`	Documentation for a function parameter
`PostconditionBlock`	Text describing conditions guaranteed on successful exit.
`PreconditionBlock`	Text describing required conditions before entry.
`QuoteBlock`	A quoted block of text.
`ReferenceInline`	A reference to a symbol.
`ReturnsBlock`	Documentation for a function return type
`SeeBlock`	A
`SoftBreakInline`	A line break that may render as a space
`StrikethroughInline`	Strikethrough span to show removed or deprecated text.
`StrongInline`	Strong emphasis span (typically rendered in bold).
`SubscriptInline`	Subscript text fragment (lowered baseline).
`SuperscriptInline`	Superscript text fragment (raised baseline).
`TParamBlock`	Documentation for a template parameter
`TableBlock`	A table block
`TableCell`	A cell in a table
`TableRow`	An item in a list
`TextInline`	A Node containing a string of text.
`ThematicBreakBlock`	A horizontal thematic break separating sections.
`ThrowsBlock`	Documentation for a function exception clause

Enums

Name	Description
`AdmonitionKind`	An admonishment style.
`BlockKind`	Enumerates the different kinds of DocComment blocks.
`InlineKind`	Enumerates the different kinds of inline nodes.
`ParamDirection`	Parameter pass direction.
`Parts`	Which parts of the documentation to copy.

Functions

Name	Description
`getAsPlainText`	`getAsPlainText` overloads
`isBlockCommand`	Return true if the given block kind represents a command block.
`isEmpty`	Determine if the inline is empty
`ltrim`	`ltrim` overloads
`rtrim`	`rtrim` overloads
`tag_invoke`	`tag_invoke` overloads
`toString`	`toString` overloads
`traverse`	Traverse a list of inlines.
`trim`	`trim` overloads
`visit`	`visit` overloads
`operator==`	Equality delegates to the three-way comparison.
`operator<=>`	Three-way comparison operators

Using Declarations

Name	Description
`operator<=>`	Three-way comparison for any described type.
`operator==`	Equality for any described type.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/AdmonitionBlock.hpp>

struct AdmonitionBlock final
    : BlockCommonBase<BlockKind::Admonition>
    , BlockContainer

Description

This paragraph represents an admonition, such as a note, tip, important, caution, or warning.

Syntax:


@note text

Base Classes

Name	Description
`BlockCommonBase<BlockKind::Admonition>`	Base class for providing variant discriminator functions.
`BlockContainer`	A composite block that stores a sequence of child blocks.

Member Functions

Name	Description
`AdmonitionBlock` [constructor]	Construct an admonition with the given kind.
`asBlockContainer`	`asBlockContainer` overloads

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Data Members

Name	Description
`Title`	Optional title for the admonition
`admonish`	The kind of admonition
`blocks`	Child blocks contained within this composite block.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the first text elements
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the last text elements
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the text elements

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/AdmonitionBlock.hpp>

explicit
AdmonitionBlock(AdmonitionKind const admonish_ = AdmonitionKind::none) noexcept;

Parameters

Name	Description
admonish_	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/AdmonitionBlock.hpp>

Optional<Polymorphic<Inline>> Title;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/AdmonitionBlock.hpp>

AdmonitionKind admonish;

Description

This is typically a string in other implementations.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

struct Block;

Description

The top level is a list of blocks.

There are two types of blocks: headings and paragraphs.

Member Functions

Name	Description
`~Block` [destructor] [virtual]	Virtual to allow deleting through a base pointer.
`asBlock`	`asBlock` overloads

Data Members

Name	Description
`Kind`	Discriminator identifying which concrete block this instance holds.

Protected Member Functions

Name	Description
`Block` [constructor]	Constructors

Non-Member Functions

Name	Description
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.

Derived Classes

Name	Description
`BlockCommonBase`	Base class for providing variant discriminator functions.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr
virtual
~Block() = default;

Synopses

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

View this object as a Block reference.

constexpr
Block const&
asBlock() const noexcept;

» more...

View this object as a mutable Block reference.

constexpr
Block&
asBlock() noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr
Block const&
asBlock() const noexcept;

Return Value

A piece of block content

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr
Block&
asBlock() noexcept;

Return Value

A piece of block content

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

BlockKind Kind = BlockKind::Paragraph;

Synopses

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

Default-construct a paragraph block.

constexpr
Block() = default;

» more...

Construct a block with the specified discriminant.

explicit
Block(BlockKind const kind_) noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr
Block() = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

explicit
Block(BlockKind const kind_) noexcept;

Parameters

Name	Description
kind_	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

template<BlockKind K>
struct BlockCommonBase
    : Block

Description

This offers functions that return a boolean at compile-time, indicating if the most-derived class is a certain type.

Base Classes

Name	Description
`Block`	A piece of block content

Member Functions

Name	Description
`~BlockCommonBase` [destructor] [virtual]	Virtual to keep dynamic dispatch working for block hierarchies.
`asBlock`	`asBlock` overloads

Data Members

Name	Description
`Kind`	Discriminator identifying which concrete block this instance holds.

Static Data Members

Name	Description
`kind_id`	The variant discriminator constant of the most-derived class.

Protected Member Functions

Name	Description
`BlockCommonBase` [constructor]	Construct with the fixed block kind.

Friends

Name	Description
`mrdocs::doc::mrdocs_member_descriptor_fn`
`mrdocs::doc::mrdocs_base_descriptor_fn`

Non-Member Functions

Name	Description
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.

Derived Classes

Name	Description
`AdmonitionBlock`	A block for side-notes like tips, warnings, notes
`BriefBlock`	The brief description
`CodeBlock`	Preformatted source code.
`DefinitionListBlock`	A list of terms paired with definitions.
`FootnoteDefinitionBlock`	Text defining the content of a footnote reference.
`HeadingBlock`	A manually specified section heading.
`ListBlock`	A list of list items
`MathBlock`	A block of LaTeX math
`ParagraphBlock`	A sequence of text nodes.
`ParamBlock`	Documentation for a function parameter
`PostconditionBlock`	Text describing conditions guaranteed on successful exit.
`PreconditionBlock`	Text describing required conditions before entry.
`QuoteBlock`	A quoted block of text.
`ReturnsBlock`	Documentation for a function return type
`SeeBlock`	A
`TParamBlock`	Documentation for a template parameter
`TableBlock`	A table block
`ThematicBreakBlock`	A horizontal thematic break separating sections.
`ThrowsBlock`	Documentation for a function exception clause

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

virtual
~BlockCommonBase() override = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

inline constexpr static
BlockKind kind_id = K;

Description

It only distinguishes from Block::kind in that it is a constant.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr
explicit
BlockCommonBase();

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

struct BlockContainer;

Member Functions

Name	Description
`asBlockContainer`	`asBlockContainer` overloads

Data Members

Name	Description
`blocks`	Child blocks contained within this composite block.

Non-Member Functions

Name	Description
`ltrim`	Removes leading whitespace from the first text elements
`rtrim`	Removes trailing whitespace from the last text elements
`trim`	Removes leading and trailing whitespace from the text elements

Derived Classes

Name	Description
`AdmonitionBlock`	A block for side-notes like tips, warnings, notes
`DefinitionListItem`	An item in a definition list
`FootnoteDefinitionBlock`	Text defining the content of a footnote reference.
`ListItem`	An item in a `ListBlock`
`QuoteBlock`	A quoted block of text.

Synopses

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

Access the container as a mutable view.

BlockContainer&
asBlockContainer();

» more...

Access the container as a const view.

BlockContainer const&
asBlockContainer() const;

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

BlockContainer&
asBlockContainer();

Return Value

A composite block that stores a sequence of child blocks.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

BlockContainer const&
asBlockContainer() const;

Return Value

A composite block that stores a sequence of child blocks.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

std::vector<Polymorphic<Block>> blocks;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BriefBlock.hpp>

struct BriefBlock final
    : BlockCommonBase<BlockKind::Brief>
    , InlineContainer

Description

Syntax:


@brief summary

Base Classes

Name	Description
`BlockCommonBase<BlockKind::Brief>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`BriefBlock` [constructor]	Constructors
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Data Members

Name	Description
`children`	Child inline elements contained here.
`copiedFrom`	Names of declarations whose brief text was reused.

Static Data Members

Name
`kind_id`

Using Declarations

Name	Description
`BriefBlock`	Inherit inline container constructors.
`operator=`	Reuse inline container assignment operators.

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopses

Declared in <mrdocs/Metadata/DocComment/Block/BriefBlock.hpp>

Create an empty brief.

constexpr
BriefBlock() = default;

» more...

Copy-construct from another brief.

constexpr
BriefBlock(BriefBlock const& other) = default;

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BriefBlock.hpp>

constexpr
BriefBlock() = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BriefBlock.hpp>

constexpr
BriefBlock(BriefBlock const& other) = default;

Parameters

Name	Description
other	The object to copy construct from

Synopses

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

Copy-assign another brief.

constexpr
BriefBlock&
operator=(BriefBlock const& other) = default;

» more...

Copy-assign child nodes.

constexpr
InlineContainer&
operator=(InlineContainer const& other) = default;

» more...

Move-assign child nodes.

constexpr
InlineContainer&
operator=(InlineContainer&& other) noexcept = default;

» more...

Assign an InlineContainer with a single TextInline child.

InlineContainer&
operator=(std::string_view text);

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BriefBlock.hpp>

constexpr
BriefBlock&
operator=(BriefBlock const& other) = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr
InlineContainer&
operator=(InlineContainer const& other) = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr
InlineContainer&
operator=(InlineContainer&& other) noexcept = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to move assign from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

InlineContainer&
operator=(std::string_view text);

Return Value

Reference to the current object

Parameters

Name	Description
text	The object to assign from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BriefBlock.hpp>

std::vector<std::string> copiedFrom;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BriefBlock.hpp>

using InlineContainer::BriefBlock;

Introduced Symbols

Name	Description
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Move-construct child nodes.
`InlineContainer` [constructor]	Copy-construct all child nodes.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BriefBlock.hpp>

using InlineContainer::operator=;

Introduced Symbols

Name	Description
`operator=`	Assign an InlineContainer with a single TextInline child.
`operator=`	Move-assign child nodes.
`operator=`	Copy-assign child nodes.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/CodeBlock.hpp>

struct CodeBlock final
    : BlockCommonBase<BlockKind::Code>

Base Classes

Name	Description
`BlockCommonBase<BlockKind::Code>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`CodeBlock` [constructor]	Construct an empty code block.

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Data Members

Name	Description
`info`	Fence info string, e.g. "cpp"
`literal`	Raw code text inside the fenced block.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/CodeBlock.hpp>

constexpr
CodeBlock() noexcept = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/CodeBlock.hpp>

std::string info;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/CodeBlock.hpp>

std::string literal;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/CodeInline.hpp>

struct CodeInline final
    : InlineCommonBase<InlineKind::Code>
    , InlineContainer

Description

Syntax:


@c inline_code

or


`inline_code`

Base Classes

Name	Description
`InlineCommonBase<InlineKind::Code>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isCode`
`isCopyDetails`
`isEmph`
`isFootnoteReference`
`isHighlight`
`isImage`
`isLineBreak`
`isLink`
`isMath`
`isReference`
`isSoftBreak`
`isStrikethrough`
`isStrong`
`isSubscript`
`isSuperscript`
`isText`

Data Members

Name	Description
`children`	Child inline elements contained here.

Static Data Members

Name
`kind_id`

Using Declarations

Name	Description
`CodeInline`	Inherit inline container constructors.

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Get the plain text representation of an inline element tree.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Get the plain text representation of an inline element tree.
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCopyDetails() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isEmph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isFootnoteReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isHighlight() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isImage() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLineBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLink() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSoftBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrikethrough() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrong() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSubscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSuperscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isText() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr static
InlineKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/CodeInline.hpp>

using InlineContainer::CodeInline;

Introduced Symbols

Name	Description
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Move-construct child nodes.
`InlineContainer` [constructor]	Copy-construct all child nodes.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/CopyDetailsInline.hpp>

struct CopyDetailsInline final
    : InlineCommonBase<InlineKind::CopyDetails>

Description

Syntax:


@copydetails other_symbol

Base Classes

Name	Description
`InlineCommonBase<InlineKind::CopyDetails>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`CopyDetailsInline` [constructor]	Construct with optional text payload.

Static Member Functions

Name
`isCode`
`isCopyDetails`
`isEmph`
`isFootnoteReference`
`isHighlight`
`isImage`
`isLineBreak`
`isLink`
`isMath`
`isReference`
`isSoftBreak`
`isStrikethrough`
`isStrong`
`isSubscript`
`isSuperscript`
`isText`

Data Members

Name	Description
`id`	Symbol to copy details from.
`string`	Element to copy the details from

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`getAsPlainText`	Get the plain text representation of an inline element tree.
`getAsPlainText`	Get the plain text representation of an inline element tree.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/CopyDetailsInline.hpp>

CopyDetailsInline(std::string string_ = std::string()) noexcept;

Parameters

Name	Description
string_	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCopyDetails() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isEmph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isFootnoteReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isHighlight() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isImage() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLineBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLink() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSoftBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrikethrough() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrong() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSubscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSuperscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isText() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/CopyDetailsInline.hpp>

SymbolID id = = SymbolID::invalid;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/CopyDetailsInline.hpp>

std::string string;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr static
InlineKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/DefinitionListBlock.hpp>

struct DefinitionListBlock final
    : BlockCommonBase<BlockKind::List>

Description

Syntax:


Markdown
: A lightweight markup language
: Created by John Gruber in 2004

HTML
: A standard markup language used to create web pages
: Used for structuring content on the internet

In HTML, it looks like:


<dl>
    <dt>First Term</dt>
    <dd>This is the definition of the first term.</dd>
    <dt>Second Term</dt>
    <dd>This is one definition of the second term. </dd>
    <dd>This is another definition of the second term.</dd>
</dl>

Base Classes

Name	Description
`BlockCommonBase<BlockKind::List>`	Base class for providing variant discriminator functions.

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Data Members

Name	Description
`items`	Sequence of definition list items.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/DefinitionListBlock.hpp>

std::vector<DefinitionListItem> items;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/DefinitionListItem.hpp>

struct DefinitionListItem final
    : BlockContainer

Base Classes

Name	Description
`BlockContainer`	A composite block that stores a sequence of child blocks.

Member Functions

Name	Description
`asBlockContainer`	`asBlockContainer` overloads

Data Members

Name	Description
`blocks`	Child blocks contained within this composite block.
`term`	The term being defined.

Non-Member Functions

Name	Description
`ltrim`	Removes leading whitespace from the first text elements
`rtrim`	Removes trailing whitespace from the last text elements
`trim`	Removes leading and trailing whitespace from the text elements

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/DefinitionListItem.hpp>

InlineContainer term;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/EmphInline.hpp>

struct EmphInline final
    : InlineCommonBase<InlineKind::Emph>
    , InlineContainer

Description

Syntax:


@e emphasized or *italic text* or _italic text_

Base Classes

Name	Description
`InlineCommonBase<InlineKind::Emph>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isCode`
`isCopyDetails`
`isEmph`
`isFootnoteReference`
`isHighlight`
`isImage`
`isLineBreak`
`isLink`
`isMath`
`isReference`
`isSoftBreak`
`isStrikethrough`
`isStrong`
`isSubscript`
`isSuperscript`
`isText`

Data Members

Name	Description
`children`	Child inline elements contained here.

Static Data Members

Name
`kind_id`

Using Declarations

Name	Description
`EmphInline`	Inherit inline container constructors.

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Get the plain text representation of an inline element tree.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Get the plain text representation of an inline element tree.
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCopyDetails() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isEmph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isFootnoteReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isHighlight() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isImage() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLineBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLink() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSoftBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrikethrough() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrong() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSubscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSuperscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isText() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr static
InlineKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/EmphInline.hpp>

using InlineContainer::EmphInline;

Introduced Symbols

Name	Description
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Move-construct child nodes.
`InlineContainer` [constructor]	Copy-construct all child nodes.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/FootnoteDefinitionBlock.hpp>

struct FootnoteDefinitionBlock final
    : BlockCommonBase<BlockKind::FootnoteDefinition>
    , BlockContainer

Description

Syntax:


This is a sentence with a footnote[^1].

[^1]: This is the content of the footnote. It can also have multiple paragraphs.
      Here is the second paragraph, which needs to be indented.

Base Classes

Name	Description
`BlockCommonBase<BlockKind::FootnoteDefinition>`	Base class for providing variant discriminator functions.
`BlockContainer`	A composite block that stores a sequence of child blocks.

Member Functions

Name	Description
`FootnoteDefinitionBlock` [constructor]	Construct an empty footnote definition.
`asBlockContainer`	`asBlockContainer` overloads

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Data Members

Name	Description
`blocks`	Child blocks contained within this composite block.
`label`	Footnote label identifier.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the first text elements
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the last text elements
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the text elements

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/FootnoteDefinitionBlock.hpp>

constexpr
FootnoteDefinitionBlock() noexcept = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/FootnoteDefinitionBlock.hpp>

std::string label;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/FootnoteReferenceInline.hpp>

struct FootnoteReferenceInline
    : InlineCommonBase<InlineKind::FootnoteReference>

Description

In markdown, this is represented as "[]".

Syntax:


[^footnote-id]

Base Classes

Name	Description
`InlineCommonBase<InlineKind::FootnoteReference>`	Base class for providing variant discriminator functions.

Static Member Functions

Name
`isCode`
`isCopyDetails`
`isEmph`
`isFootnoteReference`
`isHighlight`
`isImage`
`isLineBreak`
`isLink`
`isMath`
`isReference`
`isSoftBreak`
`isStrikethrough`
`isStrong`
`isSubscript`
`isSuperscript`
`isText`

Data Members

Name	Description
`label`	Footnote label that the reference points to.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`getAsPlainText`	Get the plain text representation of an inline element tree.
`getAsPlainText`	Get the plain text representation of an inline element tree.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCopyDetails() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isEmph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isFootnoteReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isHighlight() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isImage() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLineBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLink() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSoftBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrikethrough() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrong() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSubscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSuperscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isText() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/FootnoteReferenceInline.hpp>

std::string label;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr static
InlineKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/HeadingBlock.hpp>

struct HeadingBlock final
    : BlockCommonBase<BlockKind::Heading>
    , InlineContainer

Description

Syntax:


@par Heading

or in Markdown:


# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6

Base Classes

Name	Description
`BlockCommonBase<BlockKind::Heading>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Data Members

Name	Description
`children`	Child inline elements contained here.
`level`	Heading depth (1..6).

Static Data Members

Name
`kind_id`

Using Declarations

Name	Description
`HeadingBlock`	Inherit inline container constructors.

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/HeadingBlock.hpp>

unsigned int level = 1;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/HeadingBlock.hpp>

using InlineContainer::HeadingBlock;

Introduced Symbols

Name	Description
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Move-construct child nodes.
`InlineContainer` [constructor]	Copy-construct all child nodes.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/HighlightInline.hpp>

struct HighlightInline final
    : InlineCommonBase<InlineKind::Highlight>
    , InlineContainer

Description

Syntax:


==highlight== or <mark>highlighted</mark>

Base Classes

Name	Description
`InlineCommonBase<InlineKind::Highlight>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isCode`
`isCopyDetails`
`isEmph`
`isFootnoteReference`
`isHighlight`
`isImage`
`isLineBreak`
`isLink`
`isMath`
`isReference`
`isSoftBreak`
`isStrikethrough`
`isStrong`
`isSubscript`
`isSuperscript`
`isText`

Data Members

Name	Description
`children`	Child inline elements contained here.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Get the plain text representation of an inline element tree.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Get the plain text representation of an inline element tree.
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCopyDetails() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isEmph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isFootnoteReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isHighlight() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isImage() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLineBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLink() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSoftBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrikethrough() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrong() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSubscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSuperscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isText() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr static
InlineKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/ImageInline.hpp>

struct ImageInline final
    : InlineCommonBase<InlineKind::Image>
    , InlineContainer

Description

Syntax:


@image html path/to/img "alt text"

or


![Alt text](image_url "Optional title text")

Base Classes

Name	Description
`InlineCommonBase<InlineKind::Image>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isCode`
`isCopyDetails`
`isEmph`
`isFootnoteReference`
`isHighlight`
`isImage`
`isLineBreak`
`isLink`
`isMath`
`isReference`
`isSoftBreak`
`isStrikethrough`
`isStrong`
`isSubscript`
`isSuperscript`
`isText`

Data Members

Name	Description
`alt`	Alternate text when the image cannot be shown.
`children`	Child inline elements contained here.
`src`	Image source URL or path.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Get the plain text representation of an inline element tree.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Get the plain text representation of an inline element tree.
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCopyDetails() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isEmph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isFootnoteReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isHighlight() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isImage() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLineBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLink() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSoftBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrikethrough() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrong() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSubscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSuperscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isText() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/ImageInline.hpp>

std::string alt;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/ImageInline.hpp>

std::string src;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr static
InlineKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

struct Inline;

Description

There will be no newlines in the text. Otherwise, this would be represented as multiple text nodes within a Paragraph node.

Member Functions

Name	Description
`~Inline` [destructor] [virtual]	Virtual destructor to enable polymorphic deletion.
`asInline`	`asInline` overloads

Data Members

Name	Description
`Kind`	Discriminator identifying which inline variant is active.

Protected Member Functions

Name	Description
`Inline` [constructor]	Constructors

Non-Member Functions

Name	Description
`getAsPlainText`	Get the plain text representation of an inline element tree.
`getAsPlainText`	Get the plain text representation of an inline element tree.

Derived Classes

Name	Description
`InlineCommonBase`	Base class for providing variant discriminator functions.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr
virtual
~Inline() = default;

Synopses

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

View as const Inline reference.

constexpr
Inline const&
asInline() const noexcept;

» more...

View as mutable Inline reference.

constexpr
Inline&
asInline() noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr
Inline const&
asInline() const noexcept;

Return Value

A Node containing a string of text.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr
Inline&
asInline() noexcept;

Return Value

A Node containing a string of text.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

InlineKind Kind = InlineKind::Text;

Synopses

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

Default-construct a text inline.

constexpr
Inline() noexcept = default;

» more...

Construct with a specific inline kind.

Inline(InlineKind kind_);

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr
Inline() noexcept = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

Inline(InlineKind kind_);

Parameters

Name	Description
kind_	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

template<InlineKind K>
struct InlineCommonBase
    : Inline

Description

This offers functions that return a boolean at compile-time, indicating if the most-derived class is a certain type.

Base Classes

Name	Description
`Inline`	A Node containing a string of text.

Member Functions

Name	Description
`~InlineCommonBase` [destructor] [virtual]	Virtual destructor to preserve polymorphic cleanup.
`asInline`	`asInline` overloads

Data Members

Name	Description
`Kind`	Discriminator identifying which inline variant is active.

Static Data Members

Name	Description
`kind_id`	The variant discriminator constant of the most-derived class.

Protected Member Functions

Name	Description
`InlineCommonBase` [constructor]	Default-construct with the fixed inline kind.

Friends

Name	Description
`mrdocs::doc::mrdocs_member_descriptor_fn`
`mrdocs::doc::mrdocs_base_descriptor_fn`

Non-Member Functions

Name	Description
`getAsPlainText`	Get the plain text representation of an inline element tree.
`getAsPlainText`	Get the plain text representation of an inline element tree.

Derived Classes

Name	Description
`CodeInline`	Inline code (monospaced) used for short snippets within text.
`CopyDetailsInline`	Documentation copied from another symbol.
`EmphInline`	Emphasized text (typically rendered in italics).
`FootnoteReferenceInline`	A reference to a symbol.
`HighlightInline`	Highlighted text span used to call out important words.
`ImageInline`	An image.
`LineBreakInline`	A hard line break that renders as ""
`LinkInline`	A hyperlink.
`MathInline`	An inline LaTeX math expression
`ReferenceInline`	A reference to a symbol.
`SoftBreakInline`	A line break that may render as a space
`StrikethroughInline`	Strikethrough span to show removed or deprecated text.
`StrongInline`	Strong emphasis span (typically rendered in bold).
`SubscriptInline`	Subscript text fragment (lowered baseline).
`SuperscriptInline`	Superscript text fragment (raised baseline).
`TextInline`	A Node containing a string of text.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

virtual
~InlineCommonBase() override = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

inline constexpr static
InlineKind kind_id = K;

Description

It only distinguishes from Inline::kind in that it is a constant.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr
explicit
InlineCommonBase();

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

struct InlineContainer;

Member Functions

Name	Description
`InlineContainer` [constructor]	Constructors
`~InlineContainer` [destructor] [virtual]	Virtual destructor for derived containers.
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Data Members

Name	Description
`children`	Child inline elements contained here.

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Derived Classes

Name	Description
`BriefBlock`	The brief description
`CodeInline`	Inline code (monospaced) used for short snippets within text.
`EmphInline`	Emphasized text (typically rendered in italics).
`HeadingBlock`	A manually specified section heading.
`HighlightInline`	Highlighted text span used to call out important words.
`ImageInline`	An image.
`LinkInline`	A hyperlink.
`ParagraphBlock`	A sequence of text nodes.
`ParamBlock`	Documentation for a function parameter
`PostconditionBlock`	Text describing conditions guaranteed on successful exit.
`PreconditionBlock`	Text describing required conditions before entry.
`ReturnsBlock`	Documentation for a function return type
`SeeBlock`	A
`StrikethroughInline`	Strikethrough span to show removed or deprecated text.
`StrongInline`	Strong emphasis span (typically rendered in bold).
`SubscriptInline`	Subscript text fragment (lowered baseline).
`SuperscriptInline`	Superscript text fragment (raised baseline).
`TParamBlock`	Documentation for a template parameter
`TableCell`	A cell in a table
`ThrowsBlock`	Documentation for a function exception clause

Synopses

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

Default-construct an empty container.

constexpr
InlineContainer() = default;

» more...

Copy-construct all child nodes.

constexpr
InlineContainer(InlineContainer const& other) = default;

» more...

Move-construct child nodes.

constexpr
InlineContainer(InlineContainer&& other) noexcept = default;

» more...

Construct an InlineContainer with a single TextInline child.

explicit
InlineContainer(std::string_view text);

» more...

Construct an InlineContainer with a single TextInline child.

explicit
InlineContainer(std::string const& text);

» more...

Construct an InlineContainer with a single TextInline child.

explicit
InlineContainer(std::string&& text);

» more...

Construct an InlineContainer with a single TextInline child.

explicit
InlineContainer(char const* text);

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr
InlineContainer() = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr
InlineContainer(InlineContainer const& other) = default;

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr
InlineContainer(InlineContainer&& other) noexcept = default;

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

explicit
InlineContainer(std::string_view text);

Parameters

Name	Description
text	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

explicit
InlineContainer(std::string const& text);

Parameters

Name	Description
text	The object to copy construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

explicit
InlineContainer(std::string&& text);

Parameters

Name	Description
text	The object to move construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

explicit
InlineContainer(char const* text);

Parameters

Name	Description
text	The value to construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr
virtual
~InlineContainer() = default;

Synopses

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

Copy-assign child nodes.

constexpr
InlineContainer&
operator=(InlineContainer const& other) = default;

» more...

Move-assign child nodes.

constexpr
InlineContainer&
operator=(InlineContainer&& other) noexcept = default;

» more...

Assign an InlineContainer with a single TextInline child.

InlineContainer&
operator=(std::string_view text);

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr
InlineContainer&
operator=(InlineContainer const& other) = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr
InlineContainer&
operator=(InlineContainer&& other) noexcept = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to move assign from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

InlineContainer&
operator=(std::string_view text);

Return Value

Reference to the current object

Parameters

Name	Description
text	The object to assign from

Synopses

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

Append a TextInline child.

InlineContainer&
append(std::string_view text);

» more...

Append a child of the specified type.

template<
    std::derived_from<Inline> InlineTy,
    class... Args>
InlineContainer&
append(Args&&... args);

» more...

Return Value

A reference to this container.

Template Parameters

Name	Description
InlineTy	The Inline-derived type to add.

Parameters

Name	Description
text	The text to append.
args	Constructor arguments forwarded to the child.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

InlineContainer&
append(std::string_view text);

Return Value

A reference to this container.

Parameters

Name	Description
text	The text to append.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

template<
    std::derived_from<Inline> InlineTy,
    class... Args>
InlineContainer&
append(Args&&... args);

Return Value

A reference to this container.

Template Parameters

Name	Description
InlineTy	The Inline-derived type to add.

Parameters

Name	Description
args	Constructor arguments forwarded to the child.

Synopses

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

Return this container as a base-class reference.

InlineContainer&
asInlineContainer();

» more...

Return this container as a base-class reference.

InlineContainer const&
asInlineContainer() const;

Get the last inline child.

Polymorphic<Inline> const&
back() const;

» more...

Get the last inline child.

Polymorphic<Inline>&
back();

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

Polymorphic<Inline> const&
back() const;

Return Value

the last inline child.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

Polymorphic<Inline>&
back();

Return Value

the last inline child.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

decltype(auto)
begin(this auto&& self) noexcept;

Return Value

Iterator to the first child.

Parameters

Name	Description
self	The container instance.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

void
clear();

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

template<
    std::derived_from<Inline> InlineTy,
    class... Args>
InlineContainer&
emplace_back(Args&&... args);

Return Value

A reference to this container.

Template Parameters

Name	Description
InlineTy	The Inline-derived type to emplace.

Parameters

Name	Description
args	Constructor arguments forwarded to the child.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

bool
empty() const noexcept;

Return Value

if there are no inline children.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

decltype(auto)
end(this auto&& self) noexcept;

Return Value

Iterator past the last child.

Parameters

Name	Description
self	The container instance.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

decltype(auto)
erase(this 
    auto&& self,
    auto&&... args);

Return Value

The iterator returned by erase.

Parameters

Name	Description
self	The container instance.
args	Arguments forwarded to `std::vector::erase`.

Synopses

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

Get the first inline child.

Polymorphic<Inline> const&
front() const;

» more...

Get the first inline child.

Polymorphic<Inline>&
front();

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

Polymorphic<Inline> const&
front() const;

Return Value

the first inline child.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

Polymorphic<Inline>&
front();

Return Value

the first inline child.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

decltype(auto)
insert(this 
    auto&& self,
    auto&&... args);

Return Value

The iterator returned by insert.

Parameters

Name	Description
self	The container instance.
args	Arguments forwarded to `std::vector::insert`.

Synopses

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

Append a TextInline child.

InlineContainer&
operator+=(std::string_view text);

» more...

Append an inline child.

template<std::derived_from<Inline> InlineTy>
InlineContainer&
operator+=(InlineTy&& inlineChild);

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

InlineContainer&
operator+=(std::string_view text);

Return Value

Reference to the current object

Parameters

Name	Description
text	The right operand

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

template<std::derived_from<Inline> InlineTy>
InlineContainer&
operator+=(InlineTy&& inlineChild);

Return Value

Reference to the current object

Parameters

Name	Description
inlineChild	The right operand

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

std::size_t
size() const noexcept;

Return Value

the number of inline children.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

std::vector<Polymorphic<Inline>> children;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

struct InlineTextLeaf;

Member Functions

Name	Description
`InlineTextLeaf` [constructor]	Constructors

Data Members

Name	Description
`literal`	Raw literal text stored in this leaf node.

Synopses

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

Construct from a string view.

explicit
InlineTextLeaf(std::string_view literal_);

» more...

Construct from a string copy.

explicit
InlineTextLeaf(std::string const& literal_);

» more...

Construct by moving a string.

explicit
InlineTextLeaf(std::string&& literal_) noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

explicit
InlineTextLeaf(std::string_view literal_);

Parameters

Name	Description
literal_	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

explicit
InlineTextLeaf(std::string const& literal_);

Parameters

Name	Description
literal_	The object to copy construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

explicit
InlineTextLeaf(std::string&& literal_) noexcept;

Parameters

Name	Description
literal_	The object to move construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

std::string literal;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/LineBreakInline.hpp>

struct LineBreakInline
    : InlineCommonBase<InlineKind::LineBreak>

Description

Syntax:


first line\
second line

or


first line<br>second line

Base Classes

Name	Description
`InlineCommonBase<InlineKind::LineBreak>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`LineBreakInline` [constructor]	Construct a line break node.
`~LineBreakInline` [destructor] [virtual]	Virtual destructor for the inline hierarchy.

Static Member Functions

Name
`isCode`
`isCopyDetails`
`isEmph`
`isFootnoteReference`
`isHighlight`
`isImage`
`isLineBreak`
`isLink`
`isMath`
`isReference`
`isSoftBreak`
`isStrikethrough`
`isStrong`
`isSubscript`
`isSuperscript`
`isText`

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`getAsPlainText`	Get the plain text representation of an inline element tree.
`getAsPlainText`	Get the plain text representation of an inline element tree.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/LineBreakInline.hpp>

constexpr
LineBreakInline() noexcept = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/LineBreakInline.hpp>

constexpr
virtual
~LineBreakInline() override = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCopyDetails() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isEmph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isFootnoteReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isHighlight() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isImage() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLineBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLink() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSoftBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrikethrough() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrong() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSubscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSuperscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isText() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr static
InlineKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/LinkInline.hpp>

struct LinkInline final
    : InlineCommonBase<InlineKind::Link>
    , InlineContainer

Description

Syntax:


@link https://example.com label @endlink

Or with markdown syntax:


[link text](URL)
[link text](URL "title")

Or:


<a href="https://www.example.com">Visit Example.com</a>

Base Classes

Name	Description
`InlineCommonBase<InlineKind::Link>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`LinkInline` [constructor]	Constructors
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isCode`
`isCopyDetails`
`isEmph`
`isFootnoteReference`
`isHighlight`
`isImage`
`isLineBreak`
`isLink`
`isMath`
`isReference`
`isSoftBreak`
`isStrikethrough`
`isStrong`
`isSubscript`
`isSuperscript`
`isText`

Data Members

Name	Description
`children`	Child inline elements contained here.
`href`	Destination of the hyperlink.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Get the plain text representation of an inline element tree.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Get the plain text representation of an inline element tree.
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopses

Declared in <mrdocs/Metadata/DocComment/Inline/LinkInline.hpp>

Construct an empty link.

constexpr
LinkInline() = default;

» more...

Construct a link with display text and target.

LinkInline(
    std::string_view text,
    std::string_view href);

» more...

Parameters

Name	Description
text	Link text to display.
href	Destination URI.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/LinkInline.hpp>

constexpr
LinkInline() = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/LinkInline.hpp>

LinkInline(
    std::string_view text,
    std::string_view href);

Parameters

Name	Description
text	Link text to display.
href	Destination URI.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCopyDetails() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isEmph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isFootnoteReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isHighlight() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isImage() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLineBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLink() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSoftBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrikethrough() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrong() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSubscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSuperscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isText() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/LinkInline.hpp>

std::string href;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr static
InlineKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ListBlock.hpp>

struct ListBlock final
    : BlockCommonBase<BlockKind::List>

Description

Syntax:


- item one
- item two

Unordered list:


   - Item 1
   - Item 2
     - Nested item 2.1
     - Nested item 2.2
Item 3
   + Item 4

Ordered list:


1. First item
2. Second item
    1. Nested ordered item 2.1
    2. Nested ordered item 2.2
3. Third item

Task lists (Checklists):


- [x] Completed task
- [ ] Pending task
- [x] Another completed task

Definition Lists (DefinitionListBlock)


Term 1
: Definition of Term 1

Term 2
: Definition of Term 2
: Another definition for Term 2

Base Classes

Name	Description
`BlockCommonBase<BlockKind::List>`	Base class for providing variant discriminator functions.

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Data Members

Name	Description
`items`	Items contained in the list.
`listKind`	Display style for the list.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ListBlock.hpp>

std::vector<ListItem> items;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ListBlock.hpp>

ListKind listKind = ListKind::Unordered;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ListItem.hpp>

struct ListItem final
    : BlockContainer

Base Classes

Name	Description
`BlockContainer`	A composite block that stores a sequence of child blocks.

Member Functions

Name	Description
`asBlockContainer`	`asBlockContainer` overloads

Data Members

Name	Description
`blocks`	Child blocks contained within this composite block.

Non-Member Functions

Name	Description
`ltrim`	Removes leading whitespace from the first text elements
`rtrim`	Removes trailing whitespace from the last text elements
`trim`	Removes leading and trailing whitespace from the text elements

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/MathBlock.hpp>

struct MathBlock final
    : BlockCommonBase<BlockKind::Math>

Description

A block of LaTeX math, typically between or fenced with "math".

On a new line:


$$ \int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi} $$

Or as a code block:


```math
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
```

Base Classes

Name	Description
`BlockCommonBase<BlockKind::Math>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`MathBlock` [constructor]	Copy-construct a math block.
`operator=`	Copy-assign a math block.

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Data Members

Name	Description
`literal`	Raw TeX math source

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/MathBlock.hpp>

constexpr
MathBlock(MathBlock const& other) = default;

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/MathBlock.hpp>

constexpr
MathBlock&
operator=(MathBlock const& other) = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/MathBlock.hpp>

std::string literal;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/MathInline.hpp>

struct MathInline
    : InlineCommonBase<InlineKind::Math>

Description

Inline LaTeX math, typically between .

Syntax:


$2 + 2 = 4$ or $x_{i+1}^2$

Base Classes

Name	Description
`InlineCommonBase<InlineKind::Math>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`MathInline` [constructor]	Constructors
`~MathInline` [destructor] [virtual]	Virtual destructor for inline hierarchy.

Static Member Functions

Name
`isCode`
`isCopyDetails`
`isEmph`
`isFootnoteReference`
`isHighlight`
`isImage`
`isLineBreak`
`isLink`
`isMath`
`isReference`
`isSoftBreak`
`isStrikethrough`
`isStrong`
`isSubscript`
`isSuperscript`
`isText`

Data Members

Name	Description
`literal`	Raw LaTeX/TeX math content.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`getAsPlainText`	Get the plain text representation of an inline element tree.
`getAsPlainText`	Get the plain text representation of an inline element tree.

Synopses

Declared in <mrdocs/Metadata/DocComment/Inline/MathInline.hpp>

Construct an empty math inline.

constexpr
MathInline() noexcept = default;

» more...

Construct a math inline from source text.

explicit
MathInline(std::string string_) noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/MathInline.hpp>

constexpr
MathInline() noexcept = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/MathInline.hpp>

explicit
MathInline(std::string string_) noexcept;

Parameters

Name	Description
string_	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/MathInline.hpp>

constexpr
virtual
~MathInline() override = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCopyDetails() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isEmph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isFootnoteReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isHighlight() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isImage() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLineBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLink() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSoftBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrikethrough() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrong() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSubscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSuperscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isText() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/MathInline.hpp>

std::string literal;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr static
InlineKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ParagraphBlock.hpp>

struct ParagraphBlock
    : BlockCommonBase<BlockKind::Paragraph>
    , InlineContainer

Description

Syntax:


Plain paragraph text.

Another paragraph.

Base Classes

Name	Description
`BlockCommonBase<BlockKind::Paragraph>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`ParagraphBlock` [constructor]	Construct an empty paragraph.
`~ParagraphBlock` [destructor] [virtual]	Virtual destructor for the polymorphic block hierarchy.
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Data Members

Name	Description
`children`	Child inline elements contained here.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ParagraphBlock.hpp>

constexpr
ParagraphBlock() noexcept = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ParagraphBlock.hpp>

constexpr
virtual
~ParagraphBlock() override = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ParamBlock.hpp>

struct ParamBlock final
    : BlockCommonBase<BlockKind::Param>
    , InlineContainer

Description

Syntax:


@param name description

Base Classes

Name	Description
`BlockCommonBase<BlockKind::Param>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`ParamBlock` [constructor]	Constructors
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Data Members

Name	Description
`children`	Child inline elements contained here.
`direction`	Direction (in/out/inout) of the parameter.
`name`	Name of the parameter being documented.

Static Data Members

Name
`kind_id`

Using Declarations

Name	Description
`ParamBlock`	Inherit inline container constructors.

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopses

Declared in <mrdocs/Metadata/DocComment/Block/ParamBlock.hpp>

Build from an existing inline container.

ParamBlock(InlineContainer const& other);

» more...

Build from an rvalue inline container.

ParamBlock(InlineContainer&& other) noexcept;

» more...

Construct from name, text, and direction.

ParamBlock(
    std::string_view name,
    std::string_view text,
    ParamDirection direction = ParamDirection::none);

» more...

Parameters

Name	Description
name	Parameter identifier.
text	Description text.
direction	Flow direction of the parameter.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ParamBlock.hpp>

ParamBlock(InlineContainer const& other);

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ParamBlock.hpp>

ParamBlock(InlineContainer&& other) noexcept;

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ParamBlock.hpp>

ParamBlock(
    std::string_view name,
    std::string_view text,
    ParamDirection direction = ParamDirection::none);

Parameters

Name	Description
name	Parameter identifier.
text	Description text.
direction	Flow direction of the parameter.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ParamBlock.hpp>

ParamDirection direction = ParamDirection::none;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ParamBlock.hpp>

std::string name;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ParamBlock.hpp>

using InlineContainer::ParamBlock;

Introduced Symbols

Name	Description
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/PostconditionBlock.hpp>

struct PostconditionBlock
    : BlockCommonBase<BlockKind::Postcondition>
    , InlineContainer

Description

Syntax:


@post condition

Base Classes

Name	Description
`BlockCommonBase<BlockKind::Postcondition>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Data Members

Name	Description
`children`	Child inline elements contained here.

Static Data Members

Name
`kind_id`

Using Declarations

Name	Description
`PostconditionBlock`	Inherit inline container constructors.

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/PostconditionBlock.hpp>

using InlineContainer::PostconditionBlock;

Introduced Symbols

Name	Description
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Move-construct child nodes.
`InlineContainer` [constructor]	Copy-construct all child nodes.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/PreconditionBlock.hpp>

struct PreconditionBlock final
    : BlockCommonBase<BlockKind::Precondition>
    , InlineContainer

Description

Syntax:


@pre condition

Base Classes

Name	Description
`BlockCommonBase<BlockKind::Precondition>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Data Members

Name	Description
`children`	Child inline elements contained here.

Static Data Members

Name
`kind_id`

Using Declarations

Name	Description
`PreconditionBlock`	Inherit inline container constructors.

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/PreconditionBlock.hpp>

using InlineContainer::PreconditionBlock;

Introduced Symbols

Name	Description
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Move-construct child nodes.
`InlineContainer` [constructor]	Copy-construct all child nodes.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/QuoteBlock.hpp>

struct QuoteBlock final
    : BlockCommonBase<BlockKind::Quote>
    , BlockContainer

Description

Syntax:


> quoted text

Multi-line quotes:


> This is the first line of a multi-line quote.
> This is the second line.
> And this is the third.

Nested quotes:


> This is the outer quote.
>
> > This is a nested quote within the outer quote.
> >
> > > This is a further nested quote.

Quotes with other markdown elements:


> ### Important Note
>
> - This blockquote contains a heading.
> - And a list item.
>
> *Emphasis* and **strong emphasis** also work within blockquotes.

Base Classes

Name	Description
`BlockCommonBase<BlockKind::Quote>`	Base class for providing variant discriminator functions.
`BlockContainer`	A composite block that stores a sequence of child blocks.

Member Functions

Name	Description
`asBlockContainer`	`asBlockContainer` overloads

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Data Members

Name	Description
`blocks`	Child blocks contained within this composite block.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the first text elements
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the last text elements
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the text elements

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/ReferenceInline.hpp>

struct ReferenceInline
    : InlineCommonBase<InlineKind::Reference>

Description

Syntax:


@ref target "label"

Base Classes

Name	Description
`InlineCommonBase<InlineKind::Reference>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`ReferenceInline` [constructor]	Construct a reference with optional display text.

Static Member Functions

Name
`isCode`
`isCopyDetails`
`isEmph`
`isFootnoteReference`
`isHighlight`
`isImage`
`isLineBreak`
`isLink`
`isMath`
`isReference`
`isSoftBreak`
`isStrikethrough`
`isStrong`
`isSubscript`
`isSuperscript`
`isText`

Data Members

Name	Description
`id`	Symbol being referenced.
`literal`	Display text of the reference.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`getAsPlainText`	Get the plain text representation of an inline element tree.
`getAsPlainText`	Get the plain text representation of an inline element tree.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/ReferenceInline.hpp>

explicit
ReferenceInline(std::string str = {}) noexcept;

Parameters

Name	Description
str	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCopyDetails() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isEmph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isFootnoteReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isHighlight() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isImage() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLineBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLink() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSoftBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrikethrough() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrong() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSubscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSuperscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isText() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/ReferenceInline.hpp>

SymbolID id = = SymbolID::invalid;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/ReferenceInline.hpp>

std::string literal;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr static
InlineKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ReturnsBlock.hpp>

struct ReturnsBlock final
    : BlockCommonBase<BlockKind::Returns>
    , InlineContainer

Description

Syntax:


@return description

Base Classes

Name	Description
`BlockCommonBase<BlockKind::Returns>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`ReturnsBlock` [constructor]	Constructors
`~ReturnsBlock` [destructor] [virtual]	Virtual destructor for polymorphic base.
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Data Members

Name	Description
`children`	Child inline elements contained here.

Static Data Members

Name
`kind_id`

Using Declarations

Name	Description
`ReturnsBlock`	Inherit inline container constructors.

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopses

Declared in <mrdocs/Metadata/DocComment/Block/ReturnsBlock.hpp>

Copy constructor.

constexpr
ReturnsBlock(ReturnsBlock const& other) = default;

» more...

Move constructor.

constexpr
ReturnsBlock(ReturnsBlock&& other) noexcept = default;

» more...

Construct from inline content (copy).

ReturnsBlock(InlineContainer const& other);

» more...

Construct from inline content (move).

ReturnsBlock(InlineContainer&& other) noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ReturnsBlock.hpp>

constexpr
ReturnsBlock(ReturnsBlock const& other) = default;

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ReturnsBlock.hpp>

constexpr
ReturnsBlock(ReturnsBlock&& other) noexcept = default;

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ReturnsBlock.hpp>

ReturnsBlock(InlineContainer const& other);

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ReturnsBlock.hpp>

ReturnsBlock(InlineContainer&& other) noexcept;

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ReturnsBlock.hpp>

constexpr
virtual
~ReturnsBlock() override = default;

Synopses

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

Copy-assign child nodes.

constexpr
InlineContainer&
operator=(InlineContainer const& other) = default;

» more...

Copy assignment.

constexpr
ReturnsBlock&
operator=(ReturnsBlock const& other) = default;

» more...

Move-assign child nodes.

constexpr
InlineContainer&
operator=(InlineContainer&& other) noexcept = default;

» more...

Move assignment.

constexpr
ReturnsBlock&
operator=(ReturnsBlock&& other) noexcept = default;

» more...

Assign an InlineContainer with a single TextInline child.

InlineContainer&
operator=(std::string_view text);

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr
InlineContainer&
operator=(InlineContainer const& other) = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ReturnsBlock.hpp>

constexpr
ReturnsBlock&
operator=(ReturnsBlock const& other) = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr
InlineContainer&
operator=(InlineContainer&& other) noexcept = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to move assign from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ReturnsBlock.hpp>

constexpr
ReturnsBlock&
operator=(ReturnsBlock&& other) noexcept = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to move assign from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

InlineContainer&
operator=(std::string_view text);

Return Value

Reference to the current object

Parameters

Name	Description
text	The object to assign from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ReturnsBlock.hpp>

using InlineContainer::ReturnsBlock;

Introduced Symbols

Name	Description
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/SeeBlock.hpp>

struct SeeBlock final
    : BlockCommonBase<BlockKind::See>
    , InlineContainer

Description

Syntax:


@see other_symbol

or


@see AnotherFunction()
@see MyClass::calculateSomething()
@see MyFile.h
@see "The Doxygen Manual"

Base Classes

Name	Description
`BlockCommonBase<BlockKind::See>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Data Members

Name	Description
`children`	Child inline elements contained here.

Static Data Members

Name
`kind_id`

Using Declarations

Name	Description
`SeeBlock`	Inherit inline container constructors.

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/SeeBlock.hpp>

using InlineContainer::SeeBlock;

Introduced Symbols

Name	Description
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Move-construct child nodes.
`InlineContainer` [constructor]	Copy-construct all child nodes.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/SoftBreakInline.hpp>

struct SoftBreakInline
    : InlineCommonBase<InlineKind::SoftBreak>

Description

Syntax:


This is the first part of a line,
and this is the continuation on the next line.

Placing a backslash () at the end of a line, followed by a new line, can also create a soft line break. This method is often preferred because it is less susceptible to space-trimming issues.


This is the first part of a line,\
and this is the continuation on the next line.

Base Classes

Name	Description
`InlineCommonBase<InlineKind::SoftBreak>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`SoftBreakInline` [constructor]	Construct a soft line break node.
`~SoftBreakInline` [destructor] [virtual]	Virtual destructor for inline hierarchy.

Static Member Functions

Name
`isCode`
`isCopyDetails`
`isEmph`
`isFootnoteReference`
`isHighlight`
`isImage`
`isLineBreak`
`isLink`
`isMath`
`isReference`
`isSoftBreak`
`isStrikethrough`
`isStrong`
`isSubscript`
`isSuperscript`
`isText`

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`getAsPlainText`	Get the plain text representation of an inline element tree.
`getAsPlainText`	Get the plain text representation of an inline element tree.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/SoftBreakInline.hpp>

constexpr
SoftBreakInline() noexcept = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/SoftBreakInline.hpp>

constexpr
virtual
~SoftBreakInline() override = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCopyDetails() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isEmph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isFootnoteReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isHighlight() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isImage() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLineBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLink() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSoftBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrikethrough() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrong() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSubscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSuperscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isText() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr static
InlineKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/StrikethroughInline.hpp>

struct StrikethroughInline final
    : InlineCommonBase<InlineKind::Strikethrough>
    , InlineContainer

Description

Syntax:


~~crossed out~~

When rendered to HTML, the Markdown syntax above typically translates into the del tag, which represents content that has been deleted or is no longer accurate.


<del>This text is struck through.</del>

Base Classes

Name	Description
`InlineCommonBase<InlineKind::Strikethrough>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isCode`
`isCopyDetails`
`isEmph`
`isFootnoteReference`
`isHighlight`
`isImage`
`isLineBreak`
`isLink`
`isMath`
`isReference`
`isSoftBreak`
`isStrikethrough`
`isStrong`
`isSubscript`
`isSuperscript`
`isText`

Data Members

Name	Description
`children`	Child inline elements contained here.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Get the plain text representation of an inline element tree.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Get the plain text representation of an inline element tree.
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCopyDetails() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isEmph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isFootnoteReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isHighlight() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isImage() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLineBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLink() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSoftBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrikethrough() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrong() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSubscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSuperscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isText() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr static
InlineKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/StrongInline.hpp>

struct StrongInline final
    : InlineCommonBase<InlineKind::Strong>
    , InlineContainer

Description

Syntax:


@b bold

Base Classes

Name	Description
`InlineCommonBase<InlineKind::Strong>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isCode`
`isCopyDetails`
`isEmph`
`isFootnoteReference`
`isHighlight`
`isImage`
`isLineBreak`
`isLink`
`isMath`
`isReference`
`isSoftBreak`
`isStrikethrough`
`isStrong`
`isSubscript`
`isSuperscript`
`isText`

Data Members

Name	Description
`children`	Child inline elements contained here.

Static Data Members

Name
`kind_id`

Using Declarations

Name	Description
`StrongInline`	Inherit text container constructors.

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Get the plain text representation of an inline element tree.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Get the plain text representation of an inline element tree.
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCopyDetails() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isEmph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isFootnoteReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isHighlight() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isImage() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLineBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLink() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSoftBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrikethrough() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrong() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSubscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSuperscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isText() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr static
InlineKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/StrongInline.hpp>

using InlineContainer::StrongInline;

Introduced Symbols

Name	Description
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Move-construct child nodes.
`InlineContainer` [constructor]	Copy-construct all child nodes.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/SubscriptInline.hpp>

struct SubscriptInline final
    : InlineCommonBase<InlineKind::Subscript>
    , InlineContainer

Description

Syntax:


H~2~O

Base Classes

Name	Description
`InlineCommonBase<InlineKind::Subscript>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isCode`
`isCopyDetails`
`isEmph`
`isFootnoteReference`
`isHighlight`
`isImage`
`isLineBreak`
`isLink`
`isMath`
`isReference`
`isSoftBreak`
`isStrikethrough`
`isStrong`
`isSubscript`
`isSuperscript`
`isText`

Data Members

Name	Description
`children`	Child inline elements contained here.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Get the plain text representation of an inline element tree.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Get the plain text representation of an inline element tree.
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCopyDetails() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isEmph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isFootnoteReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isHighlight() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isImage() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLineBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLink() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSoftBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrikethrough() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrong() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSubscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSuperscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isText() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr static
InlineKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/SuperscriptInline.hpp>

struct SuperscriptInline final
    : InlineCommonBase<InlineKind::Superscript>
    , InlineContainer

Description

Syntax:


x^2^

Base Classes

Name	Description
`InlineCommonBase<InlineKind::Superscript>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isCode`
`isCopyDetails`
`isEmph`
`isFootnoteReference`
`isHighlight`
`isImage`
`isLineBreak`
`isLink`
`isMath`
`isReference`
`isSoftBreak`
`isStrikethrough`
`isStrong`
`isSubscript`
`isSuperscript`
`isText`

Data Members

Name	Description
`children`	Child inline elements contained here.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Get the plain text representation of an inline element tree.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Get the plain text representation of an inline element tree.
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCopyDetails() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isEmph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isFootnoteReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isHighlight() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isImage() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLineBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLink() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSoftBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrikethrough() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrong() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSubscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSuperscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isText() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr static
InlineKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/TParamBlock.hpp>

struct TParamBlock final
    : BlockCommonBase<BlockKind::TParam>
    , InlineContainer

Description

Syntax:


@tparam T description

Base Classes

Name	Description
`BlockCommonBase<BlockKind::TParam>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Data Members

Name	Description
`children`	Child inline elements contained here.
`name`	Template parameter name.

Static Data Members

Name
`kind_id`

Using Declarations

Name	Description
`TParamBlock`	Inherit inline container constructors.

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/TParamBlock.hpp>

std::string name;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/TParamBlock.hpp>

using InlineContainer::TParamBlock;

Introduced Symbols

Name	Description
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Move-construct child nodes.
`InlineContainer` [constructor]	Copy-construct all child nodes.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/TableBlock.hpp>

struct TableBlock final
    : BlockCommonBase<BlockKind::Table>

Description

Syntax:


| Header 1 | Header 2 | Header 3 |
| :------- | :------: | -------: |
| Left     | Center   | Right    |
| Cell 1A  | Cell 1B  | Cell 1C  |
| Cell 2A  | Cell 2B  | Cell 2C  |

Base Classes

Name	Description
`BlockCommonBase<BlockKind::Table>`	Base class for providing variant discriminator functions.

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Data Members

Name	Description
`Alignments`	Column alignments for each table column.
`items`	Rows that make up the table body (header first when present).

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/TableBlock.hpp>

std::vector<TableAlignmentKind> Alignments;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/TableBlock.hpp>

std::vector<TableRow> items;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/TableCell.hpp>

struct TableCell final
    : InlineContainer

Base Classes

Name	Description
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Data Members

Name	Description
`children`	Child inline elements contained here.

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/TableRow.hpp>

struct TableRow final

Data Members

Name	Description
`Cells`	Cells contained in the row.
`is_header`	True if this row represents a header.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/TableRow.hpp>

std::vector<TableCell> Cells;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/TableRow.hpp>

bool is_header = false;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/TextInline.hpp>

struct TextInline
    : InlineCommonBase<InlineKind::Text>

Description

There will be no newlines in the text. Otherwise, this would be represented as multiple text nodes within a Paragraph node.

Syntax:


plain text

Base Classes

Name	Description
`InlineCommonBase<InlineKind::Text>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`TextInline` [constructor]	Constructors
`~TextInline` [destructor] [virtual]	Virtual destructor for the inline hierarchy.

Static Member Functions

Name
`isCode`
`isCopyDetails`
`isEmph`
`isFootnoteReference`
`isHighlight`
`isImage`
`isLineBreak`
`isLink`
`isMath`
`isReference`
`isSoftBreak`
`isStrikethrough`
`isStrong`
`isSubscript`
`isSuperscript`
`isText`

Data Members

Name	Description
`literal`	Plain text carried by this inline node.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`getAsPlainText`	Get the plain text representation of an inline element tree.
`getAsPlainText`	Get the plain text representation of an inline element tree.

Synopses

Declared in <mrdocs/Metadata/DocComment/Inline/TextInline.hpp>

Construct an empty text inline.

constexpr
TextInline() noexcept = default;

» more...

Construct from a string view.

explicit
TextInline(std::string_view str) noexcept;

» more...

Construct from a string copy.

explicit
TextInline(std::string const& str) noexcept;

» more...

Construct by moving text storage.

explicit
TextInline(std::string&& str) noexcept;

» more...

Construct from a C string.

explicit
TextInline(char const* str) noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/TextInline.hpp>

constexpr
TextInline() noexcept = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/TextInline.hpp>

explicit
TextInline(std::string_view str) noexcept;

Parameters

Name	Description
str	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/TextInline.hpp>

explicit
TextInline(std::string const& str) noexcept;

Parameters

Name	Description
str	The object to copy construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/TextInline.hpp>

explicit
TextInline(std::string&& str) noexcept;

Parameters

Name	Description
str	The object to move construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/TextInline.hpp>

explicit
TextInline(char const* str) noexcept;

Parameters

Name	Description
str	The value to construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/TextInline.hpp>

constexpr
virtual
~TextInline() override = default;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isCopyDetails() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isEmph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isFootnoteReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isHighlight() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isImage() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLineBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isLink() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSoftBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrikethrough() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isStrong() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSubscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isSuperscript() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineNodes.inc>

constexpr
static
bool
isText() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/TextInline.hpp>

std::string literal;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

constexpr static
InlineKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ThematicBreakBlock.hpp>

struct ThematicBreakBlock final
    : BlockCommonBase<BlockKind::ThematicBreak>

Description

Syntax:

---

or

**

or

___

or


- - -

You can use an asterisk (), dash (-), or underscore ().
There must be at least three characters in a row.
Spaces can be used between the characters, but no other characters.
The thematic break should be on its own line, separated by blank lines above and below.
Thematic breaks can also be used inside lists, but the character used for the break must be different from the list marker.

Base Classes

Name	Description
`BlockCommonBase<BlockKind::ThematicBreak>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`ThematicBreakBlock` [constructor]	Copy constructor.
`operator=`	Copy assignment.

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ThematicBreakBlock.hpp>

constexpr
ThematicBreakBlock(ThematicBreakBlock const& other) = default;

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ThematicBreakBlock.hpp>

constexpr
ThematicBreakBlock&
operator=(ThematicBreakBlock const& other) = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ThrowsBlock.hpp>

struct ThrowsBlock final
    : BlockCommonBase<BlockKind::Throws>
    , InlineContainer

Description

Syntax:


@throws Type description

Base Classes

Name	Description
`BlockCommonBase<BlockKind::Throws>`	Base class for providing variant discriminator functions.
`InlineContainer`	An internal node in the inline element tree.

Member Functions

Name	Description
`operator=`	Assignment operators
`append`	`append` overloads
`asInlineContainer`	Return this container as a base-class reference.
`back`	Get the last inline child.
`begin`	Begin iterator forwarding to children.
`clear`	Clear all inline children.
`emplace_back`	Append a child of the specified type in-place.
`empty`	Determine if there are no inline children.
`end`	End iterator forwarding to children.
`erase`	Erase inline children.
`front`	Get the first inline child.
`insert`	Insert inline children.
`operator+=`	Addition assignment operators
`size`	Get the number of inline children.

Static Member Functions

Name
`isAdmonition`
`isBrief`
`isCode`
`isDefinitionList`
`isFootnoteDefinition`
`isHeading`
`isList`
`isMath`
`isParagraph`
`isParam`
`isPostcondition`
`isPrecondition`
`isQuote`
`isReturns`
`isSee`
`isTParam`
`isTable`
`isThematicBreak`
`isThrows`

Data Members

Name	Description
`children`	Child inline elements contained here.
`exception`	Exception type being described.

Static Data Members

Name
`kind_id`

Using Declarations

Name	Description
`ThrowsBlock`	Inherit inline container constructors.

Non-Member Functions

Name	Description
`getAsPlainText`	Flatten an InlineContainer to plain text.
`getAsPlainText`	Flatten an InlineContainer to plain text.
`isEmpty`	Determine if the inline is empty
`ltrim`	Removes leading whitespace from the first text element in the given InlineContainer.
`ltrim`	Removes leading whitespace from the block.
`rtrim`	Removes trailing whitespace from the last text element in the given InlineContainer.
`rtrim`	Removes trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the block.
`trim`	Removes leading and trailing whitespace from the text elements in the given InlineContainer.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isAdmonition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isBrief() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isCode() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isDefinitionList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isFootnoteDefinition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isHeading() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isList() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isMath() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isParagraph() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPostcondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isPrecondition() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isQuote() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isReturns() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isSee() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isTParam() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isTable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockNodes.inc>

constexpr
static
bool
isThematicBreak() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockCommandNodes.inc>

constexpr
static
bool
isThrows() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ThrowsBlock.hpp>

ReferenceInline exception;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

constexpr static
BlockKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ThrowsBlock.hpp>

using InlineContainer::ThrowsBlock;

Introduced Symbols

Name	Description
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Construct an InlineContainer with a single TextInline child.
`InlineContainer` [constructor]	Move-construct child nodes.
`InlineContainer` [constructor]	Copy-construct all child nodes.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/AdmonitionKind.hpp>

enum class AdmonitionKind : int;

Members

Name	Description
`none`	No admonishment
`note`	A general note
`tip`	A tip to the reader
`important`	Something important
`caution`	A caution admonishment
`warning`	A warning admonishment

Non-Member Functions

Name	Description
`toString`	Return the name of the Admonish as a string.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockKind.hpp>

enum class BlockKind : int;

Non-Member Functions

Name	Description
`isBlockCommand`	Return true if the given block kind represents a command block.
`toString`	Convert a block kind to its kebab-case string name.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineKind.hpp>

enum class InlineKind : int;

Non-Member Functions

Name	Description
`toString`	Convert an inline kind to its kebab-case string.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ParamDirection.hpp>

enum class ParamDirection : int;

Members

Name	Description
`none`	No direction specified
`in`	Parameter is passed
`out`	Parameter is passed back to the caller
`inout`	Parameter is passed and passed back to the caller

Non-Member Functions

Name	Description
`toString`	Return the name of the ParamDirection as a string.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/Parts.hpp>

enum class Parts : int;

Description

all: copy the brief and the description.
brief: only copy the brief.
description: only copy the description.

Members

Name	Description
`all`	Copy the brief and the description
`brief`	Copy the brief
`description`	Copy the description

Non-Member Functions

Name	Description
`toString`	Return the name of the Parts as a string.

Synopses

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

Get the plain text representation of an inline element tree.

std::string
getAsPlainText(doc::Inline const& in);

» more...

Flatten an InlineContainer to plain text.

std::string
getAsPlainText(doc::InlineContainer const& in);

» more...

Get the plain text representation of an inline element tree.

void
getAsPlainText(
    doc::Inline const& in,
    std::string& dst);

» more...

Flatten an InlineContainer to plain text.

void
getAsPlainText(
    doc::InlineContainer const& in,
    std::string& dst);

» more...

Return Value

The flattened plain text.

Parameters

Name	Description
in	The input inline element.
dst	The output string to append to.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

std::string
getAsPlainText(doc::Inline const& in);

Description

This strips all formatting and returns just the text content.

Return Value

The flattened plain text.

Parameters

Name	Description
in	The input inline element.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

std::string
getAsPlainText(doc::InlineContainer const& in);

Description

This concatenates all text nodes, ignoring formatting.

Return Value

The flattened plain text.

Parameters

Name	Description
in	The InlineContainer to flatten.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

void
getAsPlainText(
    doc::Inline const& in,
    std::string& dst);

Description

This strips all formatting and returns just the text content.

Return Value

the plain text representation of an inline element tree.

Parameters

Name	Description
in	The input inline element.
dst	The output string to append to.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

void
getAsPlainText(
    doc::InlineContainer const& in,
    std::string& dst);

Description

This concatenates all text nodes, ignoring formatting.

Parameters

Name	Description
in	The InlineContainer to flatten.
dst	The output string to append to.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockKind.hpp>

constexpr
bool
isBlockCommand(BlockKind k) noexcept;

Return Value

true if the given block kind represents a command block.

Parameters

Name	Description
k	Enumerates the different kinds of DocComment blocks.

Synopses

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

Determine if the inline is empty

bool
isEmpty(Block const& el);

» more...

Determine if the inline is empty

bool
isEmpty(Polymorphic<Block> const& el);

» more...

Determine if the inline is empty

bool
isEmpty(Polymorphic<Inline> const& el);

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

bool
isEmpty(Block const& el);

Return Value

if the inline is empty

Parameters

Name	Description
el	A piece of block content

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block.hpp>

bool
isEmpty(Polymorphic<Block> const& el);

Return Value

if the inline is empty

Parameters

Name	Description
el	A polymorphic value-type.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline.hpp>

bool
isEmpty(Polymorphic<Inline> const& el);

Description

This determines if the inline is considered to have no content for the purposes of trimming.

Return Value

if the inline is empty

Parameters

Name	Description
el	A polymorphic value-type.

Synopses

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

Removes leading whitespace from the block.

void
ltrim(Block& el);

» more...

Removes leading whitespace from the first text elements

void
ltrim(BlockContainer& blocks);

» more...

Removes leading whitespace from the first text element in the given InlineContainer.

void
ltrim(InlineContainer& inlines);

» more...

Removes leading whitespace from the block.

void
ltrim(Polymorphic<Block>& el);

» more...

Removes leading whitespace from the inline element.

void
ltrim(Polymorphic<Inline>& el);

» more...

Return Value

void

Parameters

Name	Description
el	The Block to trim.
blocks	The BlockContainer to trim.
inlines	The InlineContainer to trim.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

void
ltrim(Block& el);

Return Value

void

Parameters

Name	Description
el	The Block to trim.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

void
ltrim(BlockContainer& blocks);

Return Value

void

Parameters

Name	Description
blocks	The BlockContainer to trim.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

void
ltrim(InlineContainer& inlines);

Return Value

void

Parameters

Name	Description
inlines	The InlineContainer to trim.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block.hpp>

void
ltrim(Polymorphic<Block>& el);

Return Value

void

Parameters

Name	Description
el	The Polymorphic<Block> to trim.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline.hpp>

void
ltrim(Polymorphic<Inline>& el);

Return Value

void

Parameters

Name	Description
el	The Polymorphic<Inline> to trim.

Synopses

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

Removes trailing whitespace from the block.

void
rtrim(Block& el);

» more...

Removes trailing whitespace from the last text elements

void
rtrim(BlockContainer& blocks);

» more...

Removes trailing whitespace from the last text element in the given InlineContainer.

void
rtrim(InlineContainer& inlines);

» more...

Removes trailing whitespace from the block.

void
rtrim(Polymorphic<Block>& el);

» more...

Removes trailing whitespace from the inline element.

void
rtrim(Polymorphic<Inline>& el);

» more...

Return Value

void

Parameters

Name	Description
el	The Block to trim.
blocks	The BlockContainer to trim.
inlines	The InlineContainer to trim.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

void
rtrim(Block& el);

Return Value

void

Parameters

Name	Description
el	The Block to trim.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

void
rtrim(BlockContainer& blocks);

Return Value

void

Parameters

Name	Description
blocks	The BlockContainer to trim.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

void
rtrim(InlineContainer& inlines);

Return Value

void

Parameters

Name	Description
inlines	The InlineContainer to trim.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block.hpp>

void
rtrim(Polymorphic<Block>& el);

Return Value

void

Parameters

Name	Description
el	The Polymorphic<Block> to trim.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline.hpp>

void
rtrim(Polymorphic<Inline>& el);

Return Value

void

Parameters

Name	Description
el	The Polymorphic<Inline> to trim.

Synopses

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

Return the ParamDirection from a dom::Value string.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    ParamDirection const kind);

» more...

Return the Parts from a dom::Value string.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Parts const kind);

» more...

Map an optional polymorphic block into a DOM value, producing null when empty.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Optional<Polymorphic<Block>> const& I,
    DomCorpus const* domCorpus);

» more...

Map the Polymorphic Block as a dom::Value object.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Polymorphic<Block> const& I,
    DomCorpus const* domCorpus);

» more...

Map an optional brief block to a DOM value, yielding null when absent.

void
tag_invoke(
    mrdocs::dom::ValueFromTag,
    mrdocs::dom::Value& v,
    Optional<BriefBlock> const& I,
    DomCorpus const* domCorpus);

» more...

Map the Polymorphic Block to a dom::Object.

template<class IO>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    Polymorphic<Block> const& I,
    DomCorpus const* domCorpus);

» more...

Serialize a polymorphic inline node into a DOM value.

template<
    class IO,
    polymorphic_storage_for<Block> InlineTy>
void
tag_invoke(
    dom::ValueFromTag,
    IO& io,
    InlineTy const& I,
    DomCorpus const* domCorpus);

» more...

Parameters

Name	Description
v	Destination value.
I	Optional block to convert.
domCorpus	Corpus context for lazy resolution.
io	The output parameter to receive the dom::Object.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ParamDirection.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    ParamDirection const kind);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
kind	Parameter pass direction.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/Parts.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Parts const kind);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
kind	Which parts of the documentation to copy.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Optional<Polymorphic<Block>> const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	Destination value.
I	Optional block to convert.
domCorpus	Corpus context for lazy resolution.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Polymorphic<Block> const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	The output parameter to receive the dom::Value.
I	The polymorphic Block to convert.
domCorpus	The DomCorpus used to resolve references.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BriefBlock.hpp>

void
tag_invoke(
    mrdocs::dom::ValueFromTag,
    mrdocs::dom::Value& v,
    Optional<BriefBlock> const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	Destination value.
I	Optional brief block to convert.
domCorpus	Corpus context for lazy references.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block.hpp>

template<class IO>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    Polymorphic<Block> const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
io	The output parameter to receive the dom::Object.
I	The polymorphic Block to convert.
domCorpus	The DomCorpus used to resolve references.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

template<
    class IO,
    polymorphic_storage_for<Block> InlineTy>
void
tag_invoke(
    dom::ValueFromTag,
    IO& io,
    InlineTy const& I,
    DomCorpus const* domCorpus);

Description

Map the Polymorphic Inline as a dom::Value object.

Convert a polymorphic block storage into a DOM value.

Parameters

Name	Description
io	Destination value.
I	Inline storage to convert.
domCorpus	Corpus context for lazy references.

Synopses

Declared in <mrdocs/Metadata/DocComment/Block/AdmonitionKind.hpp>

Return the name of the Admonish as a string.

dom::String
toString(AdmonitionKind kind) noexcept;

» more...

Convert a block kind to its kebab-case string name.

dom::String
toString(BlockKind kind) noexcept;

» more...

Convert an inline kind to its kebab-case string.

dom::String
toString(InlineKind kind) noexcept;

» more...

Return the name of the ParamDirection as a string.

dom::String
toString(ParamDirection kind) noexcept;

» more...

Return the name of the Parts as a string.

dom::String
toString(Parts kind) noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/AdmonitionKind.hpp>

dom::String
toString(AdmonitionKind kind) noexcept;

Return Value

the name of the Admonish as a string.

Parameters

Name	Description
kind	An admonishment style.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockKind.hpp>

dom::String
toString(BlockKind kind) noexcept;

Return Value

UTF-8 string value used by the DOM.

Parameters

Name	Description
kind	Enumerates the different kinds of DocComment blocks.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineKind.hpp>

dom::String
toString(InlineKind kind) noexcept;

Return Value

UTF-8 string value used by the DOM.

Parameters

Name	Description
kind	Enumerates the different kinds of inline nodes.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ParamDirection.hpp>

dom::String
toString(ParamDirection kind) noexcept;

Return Value

the name of the ParamDirection as a string.

Parameters

Name	Description
kind	Parameter pass direction.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/Parts.hpp>

dom::String
toString(Parts kind) noexcept;

Return Value

the name of the Parts as a string.

Parameters

Name	Description
kind	Which parts of the documentation to copy.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline.hpp>

template<
    class F,
    class T,
    class... Args>
requires std::derived_from<T, Inline>
void
traverse(
    std::vector<std::unique_ptr<T>> const& list,
    F&& f,
    Args&&... args);

Parameters

Name	Description
list	The list of texts to traverse.
f	The function to call for each text.
args	Additional arguments to pass to the function.

Synopses

Declared in <mrdocs/Metadata/DocComment/Block.hpp>

Removes leading and trailing whitespace from the block.

void
trim(Block& el);

» more...

Removes leading and trailing whitespace from the text elements

void
trim(BlockContainer& blocks);

» more...

Removes leading and trailing whitespace from the text elements in the given InlineContainer.

void
trim(InlineContainer& inlines);

» more...

Removes leading and trailing whitespace from the block.

void
trim(Polymorphic<Block>& el);

» more...

Removes leading and trailing whitespace from the inline element.

void
trim(Polymorphic<Inline>& el);

» more...

Return Value

void

Parameters

Name	Description
el	The Block to trim.
blocks	The BlockContainer to trim.
inlines	The InlineContainer to trim.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

void
trim(Block& el);

Return Value

void

Parameters

Name	Description
el	The Block to trim.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/BlockBase.hpp>

void
trim(BlockContainer& blocks);

Return Value

void

Parameters

Name	Description
blocks	The BlockContainer to trim.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

void
trim(InlineContainer& inlines);

Return Value

void

Parameters

Name	Description
inlines	The InlineContainer to trim.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block.hpp>

void
trim(Polymorphic<Block>& el);

Return Value

void

Parameters

Name	Description
el	The Polymorphic<Block> to trim.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline.hpp>

void
trim(Polymorphic<Inline>& el);

Return Value

void

Parameters

Name	Description
el	The Polymorphic<Inline> to trim.

Synopses

Declared in <mrdocs/Metadata/DocComment/Block.hpp>

Visit a block.

template<
    std::derived_from<Block> BlockTy,
    class Fn,
    class... Args>
decltype(auto)
visit(
    BlockTy& info,
    Fn&& fn,
    Args&&... args);

» more...

Visit an inline.

template<
    class InlineTy,
    class Fn,
    class... Args>
requires std::derived_from<InlineTy, Inline>
decltype(auto)
visit(
    InlineTy& el,
    Fn&& fn,
    Args&&... args);

» more...

Return Value

The result of calling the function.

Parameters

Name	Description
info	The block to visit.
fn	The function to call for each block.
args	Additional arguments to pass to the function.
el	The inline element to visit.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block.hpp>

template<
    std::derived_from<Block> BlockTy,
    class Fn,
    class... Args>
decltype(auto)
visit(
    BlockTy& info,
    Fn&& fn,
    Args&&... args);

Return Value

The result of calling the function.

Parameters

Name	Description
info	The block to visit.
fn	The function to call for each block.
args	Additional arguments to pass to the function.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline.hpp>

template<
    class InlineTy,
    class Fn,
    class... Args>
requires std::derived_from<InlineTy, Inline>
decltype(auto)
visit(
    InlineTy& el,
    Fn&& fn,
    Args&&... args);

Return Value

The result of calling the function.

Parameters

Name	Description
el	The inline element to visit.
fn	The function to call for each inline.
args	Additional arguments to pass to the function.

Synopses

Declared in <mrdocs/Metadata/DocComment/Block.hpp>

Equality delegates to the three-way comparison.

bool
operator==(
    Polymorphic<Inline> const& lhs,
    Polymorphic<Inline> const& rhs);

» more...

Equality delegates to the three-way comparison.

bool
operator==(
    Polymorphic<Block> const& lhs,
    Polymorphic<Block> const& rhs);

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline.hpp>

bool
operator==(
    Polymorphic<Inline> const& lhs,
    Polymorphic<Inline> const& rhs);

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block.hpp>

bool
operator==(
    Polymorphic<Block> const& lhs,
    Polymorphic<Block> const& rhs);

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopses

Declared in <mrdocs/Metadata/DocComment/Block.hpp>

Three-way comparison for polymorphic inline elements.

std::strong_ordering
operator<=>(
    Polymorphic<Inline> const& lhs,
    Polymorphic<Inline> const& rhs);

» more...

Three-way comparison between polymorphic block wrappers.

std::strong_ordering
operator<=>(
    Polymorphic<Block> const& lhs,
    Polymorphic<Block> const& rhs);

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline.hpp>

std::strong_ordering
operator<=>(
    Polymorphic<Inline> const& lhs,
    Polymorphic<Inline> const& rhs);

Return Value

The relative order of the objects

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block.hpp>

std::strong_ordering
operator<=>(
    Polymorphic<Block> const& lhs,
    Polymorphic<Block> const& rhs);

Return Value

The relative order of the objects

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

using mrdocs::operator<=>;

Description

Compares base classes first (in description order), then own members.

Introduced Symbols

Name	Description
`operator<=>`	Three-way comparison operators

Synopsis

Declared in <mrdocs/Metadata/DocComment/Inline/InlineBase.hpp>

using mrdocs::operator==;

Description

Needed because removing a defaulted member operator<=>() also removes the implicitly-generated operator==().

Introduced Symbols

Name	Description
`operator==`	Equality operators

Description

This class is a variant-like container for holding any kind of value that can be represented in JSON, with extensions for functions and "safe strings".

The class supports the following types:

Undefined
Null
Boolean
Integer
String
SafeString
Array
Object
Function

The class provides type-safe accessors for each type, as well as methods to check the type of the contained value.

Example:


{.cpp}
        dom::Value v1 = 42; // Integer
        dom::Value v2 = "Hello, World!"; // String
        dom::Value v3 = dom::Array{v1, v2}; // Array

        if (v1.isInteger())
        {
            std::cout << "v1 is an integer: " << v1.getInteger() << "\n";
        }

        if (v2.isString())
        {
            std::cout << "v2 is a string: " << v2.getString() << "\n";
        }

        if (v3.isArray())
        {
            std::cout << "v3 is an array with " << v3.getArray().size() << " elements.\n";
        }

Namespaces

Name	Description
`JSON`	JSON serialization helpers for DOM values.

Types

Name	Description
`Array`	An array of values
`ArrayImpl`	Abstract array interface.
`DefaultArrayImpl`	The default array implementation.
`DefaultFunctionImpl`	Function implementation that wraps a fixed-arity callable.
`DefaultObjectImpl`	The default Object implementation.
`Function`	Value-semantic wrapper over a callable exposed to the DOM layer.
`FunctionImpl`	Value-semantic wrapper over a callable exposed to the DOM layer.
`LazyArrayImpl`	Lazy array implementation
`LazyArrayImpl`	Lazy array implementation
`LazyObjectImpl`	Lazy object implementation.
`LazyObjectImpl`	Lazy object implementation.
`LazyObjectMapTag`	Customization point tag.
`Object`	A container of key and value pairs.
`ObjectImpl`	Abstract object interface.
`String`	UTF-8 string value used by the DOM.
`Value`	A variant container for any kind of Dom value.
`ValueFromTag`	Customization point tag.
`VariadicFunctionImpl`	Function implementation that forwards the entire Array to a callable.
`function_traits`	Helper traits to extract return and argument types from callables.
`function_traits<F>`	Traits specialization for functors/lambdas.
`function_traits<R(*)(Args...)>`	Traits specialization for function pointers.
`function_traits<R(Args...)>`	Traits specialization for free functions.
`function_traits<R const volatile(C::*)(Args...)>`	Traits specialization for member functions.

Enums

Name	Description
`Kind`	The type of data in a Value.

Functions

Name	Description
`LazyArray`	`LazyArray` overloads
`LazyObject`	`LazyObject` overloads
`TransformArray`	Return a new dom::Array based on a transformed lazy array implementation.
`ValueFrom`	`ValueFrom` overloads
`makeInvocable`	Create a Function from a fixed-arity invocable.
`makeVariadicInvocable`	Create a Function that receives the argument Array directly.
`newArray`	Return a new array using a custom implementation.
`newFunction`	Return a diagnostic string.
`newObject`	Return a new object using a custom implementation.
`operator&&`	Return the first dom::Value that is not truthy, or the last one.
`operator+`	Addition operators
`operator\|\|`	Return the first dom::Value that is truthy, or the last one.
`stringOrNull`	Return a non-empty string, or a null.
`swap`	`swap` overloads
`toString`	`toString` overloads
`operator==`	Equality operators
`operator!=`	Return the result of comparing two strings.
`operator<=>`	Three-way comparison operators

Concepts

Name	Description
`HasLazyObjectMap`	Determine if `T` can be converted to `dom::Value`.
`HasLazyObjectMapWithContext`	Concept to determine if a type can be mapped to a `dom::LazyObjectImpl` with a user-provided conversion.
`HasLazyObjectMapWithoutContext`	Concept to determine if a type can be mapped to a `dom::LazyObjectImpl` with a user-provided conversion.
`HasStandaloneValueFrom`	Determine if `T` can be converted to `dom::Value` without a context.
`HasValueFrom`	Determine if `T` can be converted to `dom::Value`.
`HasValueFromWithContext`	Concept to determine if a type can be converted to a `dom::Value` with a user-provided conversion.
`HasValueFromWithoutContext`	Concept to determine if a type can be converted to a `dom::Value` with a user-provided conversion.
`StringLikeTy`	Satisfied if StringTy is convertible to String but not a String.
`function_traits_convertible_to_value`	Concept selecting callables convertible to dom::Value.
`has_function_args_for_default_function_impl`	Concept requiring all arguments be convertible to dom::Value.
`has_function_traits`	Concept true when function_traits is defined for F.
`has_function_traits_for_default_function_impl`	Concept combining argument and return constraints for default wrapper.
`has_invoke_expected_result_convertible_to_dom_value`	Concept true when F returns Expected<dom::Value> or Expected<void>.
`has_invoke_result_convertible_to_dom_value`	Concept true when F returns a dom::Value or void.
`has_invoke_result_for_default_function_impl`	Concept enabling default function wrapper for supported return types.

Description

This namespace wraps the platform JSON encoder/decoder behavior we emulate inside MrDocs so generators can round-trip DOM Value objects to text and back with predictable spacing, escaping, and cyclic-detection rules.

Functions

Name	Description
`stringify`	Stringify a value as JSON

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

std::string
stringify(dom::Value const& value);

Description

This function serialized a Value to a string as if JSON.stringify() had been called on it.

Recursive objects are identified.

Return Value

A string containing valid JSON.

Parameters

Name	Description
value	The value to stringify.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

class Array final

Description

Arrays are a collection of indexed values. They are an extension of objects with a particular relationship between integer-keyed properties and some abstract length-property. Besides, they include convenient methods to manipulate these ordered sequences of values.

Types

Name	Description
`iterator`	A constant iterator referencing an element in an Array.

Type Aliases

Name	Description
`const_iterator`	A constant iterator referencing an element in an Array.
`const_pointer`	A pointer to an element.
`const_reference`	A reference to an element.
`difference_type`	A signed integral type.
`impl_type`	The implementation type.
`pointer`	A pointer to an element.
`reference`	A reference to an element.
`size_type`	An unsigned integral type used for indexes and sizes.
`storage_type`	The type of storage used by the default implementation.
`value_type`	The type of an element.

Member Functions

Name	Description
`Array` [constructor]	Constructor.
`~Array` [destructor]	Destructor.
`operator=`	Assignment.
`at`	Return the i-th element.
`back`	Return the last element.
`begin`	Return an iterator to the beginning of the range of elements.
`emplace_back`	Append an element to the end of the array.
`empty`	Return true if the array is empty.
`end`	Return an iterator to the end of the range of elements.
`front`	Return the first element.
`get`	Return the i-th element, without bounds checking.
`impl`	Return the implementation used by this object.
`push_back`	Append an element to the end of the array.
`set`	Set the i-th element, without bounds checking.
`size`	Return the number of elements in the array.
`swap`	Swap two arrays.
`type_key`	Return the type key of the implementation.

Friends

Name	Description
`mrdocs::dom::newArray`	Return a new array using a custom implementation.
`mrdocs::dom::toString`	Return a diagnostic string.
`mrdocs::dom::operator<=>`	Compare two arrays for precedence.
`mrdocs::dom::operator==`	Compare two arrays for equality.
`mrdocs::dom::swap`	Swap two arrays.
`mrdocs::dom::operator+`
`mrdocs::dom::operator+`
`mrdocs::dom::operator+`	Concatenate two arrays.

Non-Member Functions

Name	Description
`LazyArray`	Return a new dom::Array based on a FromValue context
`LazyArray`	Return a new `dom::Array` based on a lazy array implementation.
`TransformArray`	Return a new dom::Array based on a transformed lazy array implementation.
`::mrdocs::getParents`	Return a list of the parent symbols of the specified Info.
`::mrdocs::helpers::and_fn`	"and" helper function
`::mrdocs::helpers::eq_fn`	"eq" helper function
`::mrdocs::helpers::ne_fn`	"ne" helper function
`::mrdocs::helpers::not_fn`	"not" helper function
`::mrdocs::helpers::or_fn`	"or" helper function

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

using const_iterator = iterator;

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

using const_pointer = value_type const*;

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

using const_reference = value_type;

Description

This is a read-only reference to an element.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

using difference_type = std::ptrdiff_t;

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

using impl_type = std::shared_ptr<ArrayImpl>;

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

using pointer = value_type const*;

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

using reference = value_type;

Description

This is a read-only reference to an element.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

using size_type = std::size_t;

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

using storage_type = std::vector<value_type>;

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

using value_type = Value;

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

class iterator;

Friends

Name	Description
`mrdocs::dom::operator+`
`mrdocs::dom::Array`	An array of values

Synopses

Declared in <mrdocs/Dom/Array.hpp>

Constructor.

Array();

» more...

Constructor.

Array(Array const& other);

» more...

Constructor.

Array(Array&& other);

» more...

Constructor.

Array(impl_type impl) noexcept;

» more...

Constructor.

Array(storage_type elements);

» more...

Parameters

Name	Description
elements	The elements to acquire.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

Array();

Description

Default-constructed arrays refer to a new, empty array which is distinct from every other empty array.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

Array(Array const& other);

Description

The newly constructed array will contain copies of the scalars in other, and references to its structured data.

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

Array(Array&& other);

Description

Ownership of the contents is transferred to the new object. The moved-from array will behave as if default-constructed.

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

Array(impl_type impl) noexcept;

Description

This constructs an array from an existing implementation, with shared ownership. The pointer cannot not be null.

Parameters

Name	Description
impl	The object to construct from

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

Array(storage_type elements);

Description

Upon construction, the array will retain ownership of a shallow copy of the specified elements. In particular, dynamic objects will be acquired with shared ownership.

Parameters

Name	Description
elements	The elements to acquire.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

~Array();

Synopses

Declared in <mrdocs/Dom/Array.hpp>

Assignment.

constexpr
Array&
operator=(Array const& other) = default;

» more...

Assignment.

Array&
operator=(Array&& other);

» more...

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

constexpr
Array&
operator=(Array const& other) = default;

Description

This acquires shared ownership of the copied array, and ownership of the previous contents is released.

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

Array&
operator=(Array&& other);

Description

Ownership of the array is transferred to this, and ownership of the previous contents is released. The moved-from array behaves as if default constructed.

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to move assign from

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

value_type
at(size_type i) const;

Exceptions

Name	Thrown on
`Exception`	`i >= size()`

Return Value

the i-th element.

Parameters

Name	Description
i	An unsigned integral type used for indexes and sizes.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

value_type
back() const;

Exceptions

Name	Thrown on
`Exception`	`empty()`

Return Value

the last element.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

iterator
begin() const;

Return Value

an iterator to the beginning of the range of elements.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

template<class... Args>
void
emplace_back(Args&&... args);

Description

If the array is read-only, an exception is thrown.

Parameters

Name	Description
args	Arguments forwarded to the constructor of Value.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

bool
empty() const noexcept;

Return Value

true if the array is empty.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

iterator
end() const;

Return Value

an iterator to the end of the range of elements.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

value_type
front() const;

Exceptions

Name	Thrown on
`Exception`	`empty()`

Return Value

the first element.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

value_type
get(size_type i) const;

Return Value

the i-th element, without bounds checking.

Parameters

Name	Description
i	The zero-based index of the element.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

impl_type const&
impl() const noexcept;

Return Value

the implementation used by this object.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

void
push_back(value_type value);

Description

If the array is read-only, an exception is thrown.

Parameters

Name	Description
value	The type of an element.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

void
set(
    size_type i,
    Value v);

Parameters

Name	Description
i	The zero-based index of the element.
v	The value to set.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

size_type
size() const noexcept;

Return Value

the number of elements in the array.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

void
swap(Array& other) noexcept;

Parameters

Name	Description
other	An array of values

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

char const*
type_key() const noexcept;

Return Value

the type key of the implementation.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

class ArrayImpl;

Description

This interface is used by Array types.

Type Aliases

Name	Description
`size_type`	An unsigned integral type used for indexes and sizes.
`value_type`	The type of an element.

Member Functions

Name	Description
`~ArrayImpl` [destructor] [virtual]	Destructor.
`emplace_back` [virtual]	Append an element to the end of the array.
`get` [virtual]	Return the i-th element, without bounds checking.
`set` [virtual]	Set the i-th element, without bounds checking.
`size` [virtual]	Return the number of elements in the array.
`type_key` [virtual]	Return the type key of the implementation.

Derived Classes

Name	Description
`DefaultArrayImpl`	The default array implementation.
`LazyArrayImpl`	Lazy array implementation
`LazyArrayImpl`	Lazy array implementation

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

using size_type = Array::size_type;

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

using value_type = Array::value_type;

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

virtual
~ArrayImpl();

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

virtual
void
emplace_back(value_type value);

Description

The default implementation throws an exception, making the array effectively read-only.

Parameters

Name	Description
value	The type of an element.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

virtual
value_type
get(size_type i) const = 0;

Return Value

the i-th element, without bounds checking.

Parameters

Name	Description
i	An unsigned integral type used for indexes and sizes.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

virtual
void
set(
    size_type index,
    Value value);

Parameters

Name	Description
index	An unsigned integral type used for indexes and sizes.
value	A variant container for any kind of Dom value.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

virtual
size_type
size() const = 0;

Return Value

the number of elements in the array.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

virtual
char const*
type_key() const noexcept;

Return Value

the type key of the implementation.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

class DefaultArrayImpl
    : public ArrayImpl

Description

This implementation is backed by a simple vector and allows appending.

Base Classes

Name	Description
`ArrayImpl`	Abstract array interface.

Type Aliases

Name	Description
`size_type`	An unsigned integral type used for indexes and sizes.
`storage_type`	The type of storage used by the default implementation.
`value_type`	The type of an element.

Member Functions

Name	Description
`DefaultArrayImpl` [constructor]	Constructors
`emplace_back` [virtual]	Append a value to the array.
`get` [virtual]	Retrieve an element at the specified index.
`set` [virtual]	`set` overloads
`size` [virtual]	Return the number of stored elements.
`type_key` [virtual]	Return the type key string for this array.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

using size_type = Array::size_type;

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

using storage_type = Array::storage_type;

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

using value_type = Array::value_type;

Synopses

Declared in <mrdocs/Dom/Array.hpp>

Create an empty array implementation.

DefaultArrayImpl();

» more...

Create an array populated with the given elements.

explicit
DefaultArrayImpl(storage_type elements) noexcept;

» more...

Parameters

Name	Description
elements	Initial contents to take ownership of.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

DefaultArrayImpl();

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

explicit
DefaultArrayImpl(storage_type elements) noexcept;

Parameters

Name	Description
elements	Initial contents to take ownership of.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

virtual
void
emplace_back(value_type value) override;

Parameters

Name	Description
value	The type of an element.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

virtual
value_type
get(size_type i) const override;

Return Value

The type of an element.

Parameters

Name	Description
i	Index of the element to fetch.

Synopses

Declared in <mrdocs/Dom/Array.hpp>

Replace the element at the specified index.

virtual
void
set(
    size_type i,
    Value v) override;

» more...

Set the i-th element, without bounds checking.

virtual
void
set(
    size_type index,
    Value value);

» more...

Parameters

Name	Description
i	Index to update.
v	New value to store.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

virtual
void
set(
    size_type i,
    Value v) override;

Parameters

Name	Description
i	Index to update.
v	New value to store.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

virtual
void
set(
    size_type index,
    Value value);

Parameters

Name	Description
index	An unsigned integral type used for indexes and sizes.
value	A variant container for any kind of Dom value.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

virtual
size_type
size() const override;

Return Value

the number of stored elements.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

virtual
char const*
type_key() const noexcept override;

Return Value

the type key string for this array.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<class F>
class DefaultFunctionImpl
    : public FunctionImpl

Base Classes

Name	Description
`FunctionImpl`	Value-semantic wrapper over a callable exposed to the DOM layer.

Type Aliases

Name	Description
`args_type`	Argument tuple type accepted by the callable.
`return_type`	Result type produced by the callable.

Member Functions

Name	Description
`DefaultFunctionImpl` [constructor]	Construct from any callable convertible to `F`.
`call` [virtual]	Invoke the wrapped callable with the given arguments.
`type_key` [virtual]	Return the type key of the implementation.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

using args_type = function_traits<F>::args_type;

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

using return_type = function_traits<F>::return_type;

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<class U>
DefaultFunctionImpl(U&& u);

Parameters

Name	Description
u	Callable to wrap.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

virtual
Expected<Value>
call(Array const& args) const override;

Return Value

A container holding an error or a value.

Parameters

Name	Description
args	An array of values

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

virtual
char const*
type_key() const noexcept override;

Return Value

the type key of the implementation.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

class DefaultObjectImpl
    : public ObjectImpl

Base Classes

Name	Description
`ObjectImpl`	Abstract object interface.

Type Aliases

Name	Description
`reference`	A reference to an element.
`storage_type`	The type of storage used by the default implementation.

Member Functions

Name	Description
`DefaultObjectImpl` [constructor]	Constructors
`exists` [virtual]	Check whether a key exists in the object.
`get` [virtual]	Retrieve a value by key.
`set` [virtual]	Set a value by key.
`size` [virtual]	Return number of elements stored.
`type_key` [virtual]	Return the type key of the implementation.
`visit` [virtual]	`visit` overloads

Synopses

Declared in <mrdocs/Dom/Object.hpp>

Create an empty object implementation.

DefaultObjectImpl() noexcept;

» more...

Create an object pre-populated with entries.

explicit
DefaultObjectImpl(storage_type entries) noexcept;

» more...

Parameters

Name	Description
entries	Key/value storage to take ownership of.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

DefaultObjectImpl() noexcept;

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

explicit
DefaultObjectImpl(storage_type entries) noexcept;

Parameters

Name	Description
entries	Key/value storage to take ownership of.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

virtual
bool
exists(std::string_view key) const override;

Return Value

True if the key exists.

Parameters

Name	Description
key	Key to test.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

virtual
Value
get(std::string_view key) const override;

Return Value

Stored value or undefined if absent.

Parameters

Name	Description
key	Key to search for.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

virtual
void
set(
    String key,
    Value value) override;

Parameters

Name	Description
key	Key to set.
value	New value.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

virtual
std::size_t
size() const override;

Return Value

number of elements stored.

Synopses

Declared in <mrdocs/Dom/Object.hpp>

Invoke the visitor for each key/value pair.

virtual
bool
visit(std::function<bool(String, Value)> fn) const = 0;

» more...

Visit each key/value pair until the visitor returns false.

virtual
bool
visit(std::function<bool(String, Value)> visitor) const override;

» more...

Return Value

true if the visitor returned true for all elements, otherwise false.
False if visitor requested stop, otherwise true.

Parameters

Name	Description
fn	The visitor function.
visitor	Callback receiving key and value.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

virtual
bool
visit(std::function<bool(String, Value)> fn) const = 0;

Description

The visitor function must return true to continue iteration, or false to stop.

The visit function returns true if the visitor returned true for all elements, otherwise false.

Return Value

true if the visitor returned true for all elements, otherwise false.

Parameters

Name	Description
fn	The visitor function.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

virtual
bool
visit(std::function<bool(String, Value)> visitor) const override;

Return Value

False if visitor requested stop, otherwise true.

Parameters

Name	Description
visitor	Callback receiving key and value.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

class Function;

Member Functions

Name	Description
`Function` [constructor]	Constructors
`~Function` [destructor]	Destructor.
`operator=`	Assignment.
`call`	Invoke the function.
`impl`	Return the implementation used by this object.
`operator()`	Invoke the function.
`swap`	Swap two objects.
`try_invoke`	Invoke the function.
`type_key`	Return the type key.

Friends

Name	Description
`mrdocs::dom::newFunction`	Return a diagnostic string.
`mrdocs::dom::swap`	Swap two objects.

Non-Member Functions

Name	Description
`makeInvocable`	Create a Function from a fixed-arity invocable.
`makeVariadicInvocable`	Create a Function that receives the argument Array directly.

Synopses

Declared in <mrdocs/Dom/Function.hpp>

Constructor.

Function() noexcept;

» more...

Constructor.

Function(Function const& other) noexcept;

» more...

Constructor.

Function(Function&& other) noexcept;

» more...

Construct a Function from any supported callable.

template<class F>
requires function_traits_convertible_to_value<std::decay_t<F>>
Function(F const& f);

» more...

Parameters

Name	Description
f	Callable to wrap.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

Function() noexcept;

Description

A default-constructed function has this equivalent implementation:


Value f()
{
    return nullptr;
}

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

Function(Function const& other) noexcept;

Description

The newly constructed object acquires shared ownership of the function.

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

Function(Function&& other) noexcept;

Description

Ownership of the function is tranferred. The moved-from object behaves as if default constructed.

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<class F>
requires function_traits_convertible_to_value<std::decay_t<F>>
Function(F const& f);

Parameters

Name	Description
f	Callable to wrap.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

~Function();

Synopses

Declared in <mrdocs/Dom/Function.hpp>

Assignment.

Function&
operator=(Function const& other) noexcept;

» more...

Assignment.

Function&
operator=(Function&& other) noexcept;

» more...

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

Function&
operator=(Function const& other) noexcept;

Description

This acquires shared ownership of the function. Ownership of the previous function is removed.

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

Function&
operator=(Function&& other) noexcept;

Description

Ownership of the function is tranferred, and ownership of the previous function is released. The moved-from object behaves as if default constructed.

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to move assign from

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

Expected<Value>
call(Array const& args) const;

Return Value

A container holding an error or a value.

Parameters

Name	Description
args	An array of values

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

impl_type const&
impl() const noexcept;

Return Value

the implementation used by this object.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<class... Args>
Value
operator()(Args&&... args) const;

Return Value

The return value of the function.

Parameters

Name	Description
args	The arguments to the function.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

void
swap(Function& other) noexcept;

Parameters

Name	Description
other	The other object.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<class... Args>
Expected<Value>
try_invoke(Args&&... args) const;

Return Value

A container holding an error or a value.

Parameters

Name	Description
args	The arguments to the function.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

char const*
type_key() const noexcept;

Return Value

the type key.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

class FunctionImpl;

Description

Abstract base for function implementations.

Member Functions

Name	Description
`~FunctionImpl` [destructor] [virtual]	Destructor.
`call` [virtual]	Invoke the function.
`type_key` [virtual]	Return the type key of the implementation.

Derived Classes

Name	Description
`DefaultFunctionImpl`	Function implementation that wraps a fixed-arity callable.
`VariadicFunctionImpl`	Function implementation that forwards the entire Array to a callable.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

constexpr
virtual
~FunctionImpl() = default;

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

virtual
Expected<Value>
call(Array const& args) const = 0;

Return Value

A container holding an error or a value.

Parameters

Name	Description
args	An array of values

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

virtual
char const*
type_key() const noexcept;

Return Value

the type key of the implementation.

Synopsis

Declared in <mrdocs/Dom/LazyArray.hpp>

class LazyArrayImpl
    : public ArrayImpl

Description

This array type is used to define a dom::Array whose members are evaluated on demand as they are accessed.

Each member can goes through a transform function before being returned as a Value so that all types can be converted to dom::Value.

The underlying representation of the array is a range from where the elements are extracted. Elements in this range should be convertible to dom::Value.

This class is typically useful for implementing arrays that are expensive and have recursive dependencies, as these recursive dependencies can also be deferred.

Unlike a LazyObjectImpl, which contains an overlay object, this implementation is read-only. The set and emplace_back methods are not implemented.

Base Classes

Name	Description
`ArrayImpl`	Abstract array interface.

Type Aliases

Name	Description
`size_type`	An unsigned integral type used for indexes and sizes.
`value_type`	The type of an element.

Member Functions

Name	Description
`LazyArrayImpl` [constructor]	Constructors
`~LazyArrayImpl` [destructor] [virtual]	Virtual destructor.
`emplace_back` [virtual]	Append an element to the end of the array.
`get` [virtual]	`get` overloads
`set` [virtual]	Set the i-th element, without bounds checking.
`size` [virtual]	Return the number of elements, computing it lazily if needed.
`type_key` [virtual]	Return the type key of the implementation.

Synopses

Declared in <mrdocs/Dom/LazyArray.hpp>

Construct from a range of values.

explicit
LazyArrayImpl(R const& arr);

» more...

Construct from a range and a conversion context.

explicit
LazyArrayImpl(
    R const& arr,
    Context const& ctx);

» more...

Parameters

Name	Description
arr	Range to wrap lazily.
ctx	Context used to convert elements.

Synopsis

Declared in <mrdocs/Dom/LazyArray.hpp>

explicit
LazyArrayImpl(R const& arr);

Parameters

Name	Description
arr	The object to copy construct from

Synopsis

Declared in <mrdocs/Dom/LazyArray.hpp>

explicit
LazyArrayImpl(
    R const& arr,
    Context const& ctx);

Parameters

Name	Description
arr	Range to wrap lazily.
ctx	Context used to convert elements.

Synopsis

Declared in <mrdocs/Dom/LazyArray.hpp>

virtual
~LazyArrayImpl() override = default;

Synopses

Declared in <mrdocs/Dom/Array.hpp>

Retrieve the element at index i, or nil if out of range.

virtual
dom::Value
get(std::size_t i) const override;

» more...

Return the i-th element, without bounds checking.

virtual
value_type
get(size_type i) const = 0;

» more...

Parameters

Name	Description
i	Index of the element.

Synopsis

Declared in <mrdocs/Dom/LazyArray.hpp>

virtual
dom::Value
get(std::size_t i) const override;

Return Value

A variant container for any kind of Dom value.

Parameters

Name	Description
i	Index of the element.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

virtual
value_type
get(size_type i) const = 0;

Return Value

the i-th element, without bounds checking.

Parameters

Name	Description
i	An unsigned integral type used for indexes and sizes.

Synopsis

Declared in <mrdocs/Dom/LazyArray.hpp>

virtual
std::size_t
size() const noexcept override;

Return Value

the number of elements, computing it lazily if needed.

Synopsis

Declared in <mrdocs/Dom/LazyArray.hpp>

virtual
char const*
type_key() const noexcept override;

Return Value

the type key of the implementation.

Synopsis

Declared in <mrdocs/Dom/LazyArray.hpp>

template<
    std::ranges::random_access_range R,
    class Context = /* implementation-defined */>
requires HasValueFrom<std::ranges::range_value_t<R>, Context> ||
       (std::invocable<Context, std::ranges::range_value_t<R>> &&
        HasStandaloneValueFrom<std::invoke_result_t<Context, std::ranges::range_value_t<R>>>)
class LazyArrayImpl
    : public ArrayImpl

Description

This array type is used to define a dom::Array whose members are evaluated on demand as they are accessed.

Each member can goes through a transform function before being returned as a Value so that all types can be converted to dom::Value.

The underlying representation of the array is a range from where the elements are extracted. Elements in this range should be convertible to dom::Value.

This class is typically useful for implementing arrays that are expensive and have recursive dependencies, as these recursive dependencies can also be deferred.

Unlike a LazyObjectImpl, which contains an overlay object, this implementation is read-only. The set and emplace_back methods are not implemented.

Base Classes

Name	Description
`ArrayImpl`	Abstract array interface.

Type Aliases

Name	Description
`size_type`	An unsigned integral type used for indexes and sizes.
`value_type`	The type of an element.

Member Functions

Name	Description
`emplace_back` [virtual]	Append an element to the end of the array.
`get` [virtual]	Return the i-th element, without bounds checking.
`set` [virtual]	Set the i-th element, without bounds checking.
`size` [virtual]	Return the number of elements in the array.
`type_key` [virtual]	Return the type key of the implementation.

Synopsis

Declared in <mrdocs/Dom/LazyObject.hpp>

class LazyObjectImpl
    : public ObjectImpl

Description

This interface is used to define objects whose members are evaluated on demand as they are accessed.

When any of the object properties are accessed, the object dom::Value is constructed. In practice, the object never takes any memory besides the pointer to the underlying object.

The keys and values in the underlying object should be mapped using tag_invoke.

This class is typically useful for implementing objects that are expensive and have recursive dependencies, as these recursive dependencies can also be deferred.

A context can also be stored in the object as a form to customize how the object is mapped. This context should be copyable and is propagated to other objects that support an overload with the same context.

The context can be simply a tag identifying how to map the object, or a more complex object carrying data to customize the mapping process.

In the latter case, because the context should be a copyable, the user might want to use a type with reference semantics.

Base Classes

Name	Description
`ObjectImpl`	Abstract object interface.

Type Aliases

Name	Description
`reference`	A reference to an element.
`storage_type`	The type of storage used by the default implementation.

Member Functions

Name	Description
`LazyObjectImpl` [constructor]	Constructors
`~LazyObjectImpl` [destructor] [virtual]	Virtual destructor.
`exists` [virtual]	Determine if a key exists.
`get` [virtual]	Return the value for the specified key, or null.
`set` [virtual]	Insert or set the given key/value pair.
`size` [virtual]	Return the number of properties in the object.
`type_key` [virtual]	Return the type key of the implementation.
`visit` [virtual]	Invoke the visitor for each key/value pair.

Synopses

Declared in <mrdocs/Dom/LazyObject.hpp>

Wrap an object using the default lazy mapping.

explicit
LazyObjectImpl(T const& obj)
requires HasLazyObjectMapWithoutContext<T>;

» more...

Wrap an object using a custom mapping context.

explicit
LazyObjectImpl(
    T const& obj,
    Context const& context)
requires HasLazyObjectMapWithContext<T, Context>;

» more...

Parameters

Name	Description
obj	Object providing the data.
context	Context that guides the mapping.

Synopsis

Declared in <mrdocs/Dom/LazyObject.hpp>

explicit
LazyObjectImpl(T const& obj)
requires HasLazyObjectMapWithoutContext<T>;

Parameters

Name	Description
obj	Object providing the data.

Synopsis

Declared in <mrdocs/Dom/LazyObject.hpp>

explicit
LazyObjectImpl(
    T const& obj,
    Context const& context)
requires HasLazyObjectMapWithContext<T, Context>;

Parameters

Name	Description
obj	Object providing the data.
context	Context that guides the mapping.

Synopsis

Declared in <mrdocs/Dom/LazyObject.hpp>

virtual
~LazyObjectImpl() override = default;

Synopsis

Declared in <mrdocs/Dom/LazyObject.hpp>

virtual
bool
exists(std::string_view key) const override;

Return Value

true if the key exists, otherwise false.

Parameters

Name	Description
key	The key to check for existence.

Synopsis

Declared in <mrdocs/Dom/LazyObject.hpp>

virtual
Value
get(std::string_view key) const override;

Return Value

The value for the specified key, or null if the key does not exist.

Parameters

Name	Description
key	The key.

Synopsis

Declared in <mrdocs/Dom/LazyObject.hpp>

virtual
void
set(
    String key,
    Value value) override;

Parameters

Name	Description
key	The key.
value	The value to set.

Synopsis

Declared in <mrdocs/Dom/LazyObject.hpp>

virtual
std::size_t
size() const override;

Return Value

the number of properties in the object.

Synopsis

Declared in <mrdocs/Dom/LazyObject.hpp>

virtual
char const*
type_key() const noexcept override;

Return Value

the type key of the implementation.

Synopsis

Declared in <mrdocs/Dom/LazyObject.hpp>

virtual
bool
visit(std::function<bool(String, Value)> fn) const override;

Description

The visitor function must return true to continue iteration, or false to stop.

The visit function returns true if the visitor returned true for all elements, otherwise false.

Return Value

true if the visitor returned true for all elements, otherwise false.

Parameters

Name	Description
fn	The visitor function.

Synopsis

Declared in <mrdocs/Dom/LazyObject.hpp>

template<
    class T,
    class Context = /* implementation-defined */>
requires HasLazyObjectMap<T, Context>
class LazyObjectImpl
    : public ObjectImpl

Description

This interface is used to define objects whose members are evaluated on demand as they are accessed.

When any of the object properties are accessed, the object dom::Value is constructed. In practice, the object never takes any memory besides the pointer to the underlying object.

The keys and values in the underlying object should be mapped using tag_invoke.

This class is typically useful for implementing objects that are expensive and have recursive dependencies, as these recursive dependencies can also be deferred.

A context can also be stored in the object as a form to customize how the object is mapped. This context should be copyable and is propagated to other objects that support an overload with the same context.

The context can be simply a tag identifying how to map the object, or a more complex object carrying data to customize the mapping process.

In the latter case, because the context should be a copyable, the user might want to use a type with reference semantics.

Base Classes

Name	Description
`ObjectImpl`	Abstract object interface.

Type Aliases

Name	Description
`reference`	A reference to an element.
`storage_type`	The type of storage used by the default implementation.

Member Functions

Name	Description
`exists` [virtual]	Determine if a key exists.
`get` [virtual]	Return the value for the specified key, or null.
`set` [virtual]	Insert or set the given key/value pair.
`size` [virtual]	Return the number of properties in the object.
`type_key` [virtual]	Return the type key of the implementation.
`visit` [virtual]	Invoke the visitor for each key/value pair.

Synopsis

Declared in <mrdocs/Dom/LazyObject.hpp>

struct LazyObjectMapTag;

Description

This tag type is used by the class dom::LazyObjectImpl to select overloads of tag_invoke.

NOTE

This type is empty; it has no members.

Non-Member Functions

Name	Description
`::mrdocs::tag_invoke`	Map a FriendInfo to a dom::Object with deferred name lookup.
`::mrdocs::tag_invoke`	Map the Polymorphic Symbol to a `dom::Object`.
`::mrdocs::tag_invoke`	Map the SourceInfo to a lazy DOM object.
`::mrdocs::tag_invoke`	Generic tag_invoke for any described type with DomCorpus context.
`::mrdocs::tag_invoke`	Map a TemplateInfo to a dom::Object with computed specialization kind.
`::mrdocs::tag_invoke`	Map a Name to a dom::Object via visit-based polymorphic dispatch.
`::mrdocs::tag_invoke`	Generic tag_invoke for described types without context.
`::mrdocs::tag_invoke`	Map a BaseInfo to a dom::Object with computed access booleans.
`::mrdocs::tag_invoke`	Map a Symbol to a dom::Object with computed extraction properties.
`::mrdocs::tag_invoke`	Map an ExprInfo to a `dom::Value` object.
`::mrdocs::tag_invoke`	Map a RecordSymbol to a dom::Object with computed defaultAccess.
`::mrdocs::tag_invoke`	Map an ArrayType to a dom::Object with split bounds properties.
`::mrdocs::doc::tag_invoke`	Map the Polymorphic Block to a `dom::Object`.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

class Object final

Description

Objects are a collection of properties, which are equivalent to key-value pairs. Property values can be any type, including other Objects, allowing for the creation of arbitrarily complex data structures.

An Object is a non-primitive (or reference) type, meaning that they are not copied when assigned or passed as a parameter. Instead, the reference is copied, and the original value is shared.

These reference types are modeled after JavaScript "Objects". All non-primitive types (Object types) are derived from Object in JavaScript. This means types such as Array and Function represent a relevant selection of built-in types that would derive from Object in JavaScript.

Properties


Objects are a collection of properties, which are
equivalent to key-value pairs. There are two
kinds of properties:

@li Data properties: Associates a key with a value.
@li Accessor properties: Associates a key with
    one of two accessor functions (`get` and `set`),
    which are used to retrieve or set the value.

The internal representation of objects can determine
how properties are stored and the type of properties
being represented.

Properties can also be enumerable or non-enumerable.
An enumerable property is one that is iterated by
the `visit` function. Non-enumerable properties can
only be accessed by name with the `get` and `set`
functions.

Types

Name	Description
`value_type`	The type of an element.

Type Aliases

Name	Description
`const_pointer`	A pointer to an element.
`const_reference`	A reference to an element.
`difference_type`	A signed integral type.
`impl_type`	The implementation type.
`pointer`	A pointer to an element.
`reference`	A reference to an element.
`size_type`	An unsigned integral type used for indexes and sizes.
`storage_type`	The type of storage used by the default implementation.

Member Functions

Name	Description
`Object` [constructor]	Constructor.
`~Object` [destructor]	Destructor.
`operator=`	Assignment.
`at`	Return the element at a given index.
`empty`	Return true if the container is empty.
`exists`	Return true if a key exists.
`get`	Return the element with the specified key
`impl`	Return the implementation used by this object.
`set`	Set or replace the value for a given key.
`size`	Return the number of elements.
`swap`	Swap two objects.
`type_key`	Return the type key.
`visit`	Invoke the visitor for each key/value pair

Friends

Name	Description
`mrdocs::dom::toString`	Return a diagnostic string.
`mrdocs::dom::operator<=>`	Compare two objects for precedence.
`mrdocs::dom::operator==`	Compare two objects for equality.
`mrdocs::dom::swap`	Swap two objects.

Non-Member Functions

Name	Description
`LazyObject`	Return a new dom::Object based on a transformed lazy array implementation.
`LazyObject`	Return a new dom::Object based on a lazy object implementation.
`newObject`	Return a new object using a custom implementation.
`::mrdocs::createFrame`	Create child data objects.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

using const_pointer = pointer;

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

using const_reference = reference;

Description

This is a read-only reference to an element.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

using difference_type = std::ptrdiff_t;

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

using impl_type = std::shared_ptr<ObjectImpl>;

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

using pointer = value_type const*;

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

using reference = value_type;

Description

This is a read-only reference to an element.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

using size_type = std::size_t;

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

using storage_type = std::vector<value_type>;

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

struct value_type;

Description

Elements of this container are key and value pairs where the key is a string. This type is a copyable, movable value type.

Synopses

Declared in <mrdocs/Dom/Object.hpp>

Constructor.

Object();

» more...

Constructor.

Object(Object const& other) noexcept;

» more...

Constructor.

Object(Object&& other);

» more...

Constructor.

explicit
Object(impl_type impl) noexcept;

» more...

Constructor.

explicit
Object(storage_type list);

» more...

Parameters

Name	Description
list	The initial list of values.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

Object();

Description

Default-constructed objects refer to a new, empty container which is distinct from every other empty container.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

Object(Object const& other) noexcept;

Description

The newly constructed object will contain copies of the scalars in other, and references to its structured data.

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

Object(Object&& other);

Description

Ownership of the contents is transferred to the new object. The moved-from object will behave as if default-constructed.

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

explicit
Object(impl_type impl) noexcept;

Description

This constructs an object from an existing implementation, with shared ownership. The pointer cannot not be null.

Parameters

Name	Description
impl	The object to construct from

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

explicit
Object(storage_type list);

Description

Upon construction, the object will retain ownership of a shallow copy of the specified list. In particular, dynamic objects will be acquired with shared ownership.

Parameters

Name	Description
list	The initial list of values.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

constexpr
~Object() = default;

Synopses

Declared in <mrdocs/Dom/Object.hpp>

Assignment.

Object&
operator=(Object const& other) noexcept;

» more...

Assignment.

Object&
operator=(Object&& other);

» more...

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

Object&
operator=(Object const& other) noexcept;

Description

Shared ownership and copies of elements in others are acquired by this. Ownership of the previous contents is released.

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

Object&
operator=(Object&& other);

Description

Ownership of the object is transferred to this, and ownership of the previous contents is released. The moved-from object behaves as if default constructed.

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to move assign from

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

Value
at(std::string_view i) const;

Return Value

The value at the specified index, or null if the index is out of range.

Parameters

Name	Description
i	The index.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

bool
empty() const;

Return Value

true if the container is empty.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

bool
exists(std::string_view key) const;

Return Value

true if the key exists, otherwise false.

Parameters

Name	Description
key	The key to check for existence.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

Value
get(std::string_view key) const;

Return Value

The value for the specified key, or null if the key does not exist.

Parameters

Name	Description
key	The key.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

impl_type const&
impl() const noexcept;

Return Value

the implementation used by this object.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

void
set(
    String key,
    Value value) const;

Description

This function inserts a new key or changes the value for the existing key if it is already present.

Parameters

Name	Description
key	The key.
value	The value to set.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

std::size_t
size() const;

Return Value

the number of elements.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

void
swap(Object& other) noexcept;

Parameters

Name	Description
other	A container of key and value pairs.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

char const*
type_key() const noexcept;

Return Value

the type key.

Synopses

Declared in <mrdocs/Dom/Object.hpp>

Invoke the visitor for each key/value pair

template<class F>
requires std::invocable<F, String, Value> &&
        std::same_as<std::invoke_result_t<F, String, Value>, bool>
bool
visit(F&& fn) const;

» more...

Invoke the visitor for each key/value pair

template<class F>
requires std::invocable<F, String, Value> &&
        mrdocs::detail::isExpected<std::invoke_result_t<F, String, Value>>
Expected<void, std::invoke_result_t<F, String, Value>::error_type>
visit(F&& fn) const;

» more...

Invoke the visitor for each key/value pair

template<class F>
requires std::invocable<F, String, Value> &&
        std::same_as<std::invoke_result_t<F, String, Value>, void>
void
visit(F&& fn) const;

» more...

Return Value

true if the visitor returned true for all elements, otherwise false.
void if the visitor returned did not return an error for any element, otherwise E.

Parameters

Name	Description
fn	The visitor function.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

template<class F>
requires std::invocable<F, String, Value> &&
        std::same_as<std::invoke_result_t<F, String, Value>, bool>
bool
visit(F&& fn) const;

Description

The visitor function must return true to continue iteration, or false to stop iteration early.

Return Value

true if the visitor returned true for all elements, otherwise false.

Parameters

Name	Description
fn	The visitor function.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

template<class F>
requires std::invocable<F, String, Value> &&
        mrdocs::detail::isExpected<std::invoke_result_t<F, String, Value>>
Expected<void, std::invoke_result_t<F, String, Value>::error_type>
visit(F&& fn) const;

Description

The visitor function must return void to continue iteration, or an Unexpected<E> to stop iteration early.

If an error is returned, the iteration stops and the error is returned from this function.

Return Value

void if the visitor returned did not return an error for any element, otherwise E.
void if the visitor returned did not return an error for any element, otherwise E.

Parameters

Name	Description
fn	The visitor function.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

template<class F>
requires std::invocable<F, String, Value> &&
        std::same_as<std::invoke_result_t<F, String, Value>, void>
void
visit(F&& fn) const;

Parameters

Name	Description
fn	The visitor function.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

class ObjectImpl;

Description

This interface is used by Object types.

Type Aliases

Name	Description
`reference`	A reference to an element.
`storage_type`	The type of storage used by the default implementation.

Member Functions

Name	Description
`~ObjectImpl` [destructor] [virtual]	Destructor.
`exists` [virtual]	Determine if a key exists.
`get` [virtual]	Return the value for the specified key, or null.
`set` [virtual]	Insert or set the given key/value pair.
`size` [virtual]	Return the number of properties in the object.
`type_key` [virtual]	Return the type key of the implementation.
`visit` [virtual]	Invoke the visitor for each key/value pair.

Derived Classes

Name	Description
`DefaultObjectImpl`	The default Object implementation.
`LazyObjectImpl`	Lazy object implementation.
`LazyObjectImpl`	Lazy object implementation.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

using reference = Object::reference;

Description

This is a read-only reference to an element.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

using storage_type = Object::storage_type;

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

virtual
~ObjectImpl();

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

virtual
bool
exists(std::string_view key) const;

Return Value

true if the key exists, otherwise false.

Parameters

Name	Description
key	The key to check for existence.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

virtual
Value
get(std::string_view key) const = 0;

Return Value

The value for the specified key, or null if the key does not exist.

Parameters

Name	Description
key	The key.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

virtual
void
set(
    String key,
    Value value) = 0;

Parameters

Name	Description
key	The key.
value	The value to set.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

virtual
std::size_t
size() const = 0;

Return Value

the number of properties in the object.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

virtual
char const*
type_key() const noexcept;

Return Value

the type key of the implementation.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

virtual
bool
visit(std::function<bool(String, Value)> fn) const = 0;

Description

The visitor function must return true to continue iteration, or false to stop.

The visit function returns true if the visitor returned true for all elements, otherwise false.

Return Value

true if the visitor returned true for all elements, otherwise false.

Parameters

Name	Description
fn	The visitor function.

Synopsis

Declared in <mrdocs/Dom/String.hpp>

class String final

Member Functions

Name	Description
`String` [constructor]	Constructor.
`~String` [destructor]	Destructor.
`operator=`	Assignment.
`c_str`	Return the string.
`data`	Return the string.
`empty`	Return true if the string is empty.
`get`	Return the string.
`size`	Return the size.
`str`	Return the string.
`swap`	Swap two strings.
`operator std::string_view`	Return the string.

Friends

Name	Description
`mrdocs::dom::operator+`
`mrdocs::dom::operator+`
`mrdocs::dom::operator+`	Concatenate two strings.
`mrdocs::dom::operator<=>`	Return the result of comparing two strings.
`mrdocs::dom::operator!=`	Return the result of comparing two strings.
`mrdocs::dom::operator==`	Return the result of comparing two strings.
`mrdocs::dom::operator<=>`	Return the result of comparing two strings.
`mrdocs::dom::operator!=`	Return the result of comparing two strings.
`mrdocs::dom::operator==`	Return the result of comparing two strings.
`mrdocs::dom::swap`	Swap two strings.

Non-Member Functions

Name	Description
`::mrdocs::toString`	Convert an explicit kind to its string form.
`::mrdocs::toString`	Convert a reference kind to its string representation.
`::mrdocs::toString`	Convert a storage class kind to its string form.
`::mrdocs::toString`	Convert ExplicitInfo to a string.
`::mrdocs::toString`	Convert a noexcept kind to its string form.
`::mrdocs::toString`	Convert a cv/ref qualifier kind to its string form.
`::mrdocs::toString`	Convert access specifier to its string form.
`::mrdocs::toString`	Convert NoexceptInfo to a string.
`::mrdocs::toString`	Convert a TypeKind to its string representation.
`::mrdocs::toString`	Convert an auto-kind to its spelling.
`::mrdocs::toString`	Convert a constexpr/consteval specifier kind to a string.
`::mrdocs::doc::toString`	Convert an inline kind to its kebab-case string.
`::mrdocs::doc::toString`	Return the name of the Admonish as a string.
`::mrdocs::doc::toString`	Return the name of the Parts as a string.
`::mrdocs::doc::toString`	Convert a block kind to its kebab-case string name.
`::mrdocs::doc::toString`	Return the name of the ParamDirection as a string.

Synopses

Declared in <mrdocs/Dom/String.hpp>

Constructor.

constexpr
String() noexcept = default;

» more...

Constructor.

String(String const& other) noexcept;

» more...

Constructor.

constexpr
String(String&& other) noexcept;

» more...

Constructor.

String(std::string_view sv);

» more...

Constructor.

template<StringLikeTy StringLike>
String(StringLike const& s);

» more...

Constructor.

template<std::size_t N>
constexpr
String(char const(& str)[N]);

» more...

Constructor.

String(
    char const* str,
    std::size_t len);

» more...

Parameters

Name	Description
sv	The string to construct with. A copy of this string is made.
s	The string to construct with. A copy of this string is made.
str	A null-terminated string. If the string is not null-terminated, the result is undefined.
len	The length of the string.

Synopsis

Declared in <mrdocs/Dom/String.hpp>

constexpr
String() noexcept = default;

Description

Default constructed strings have a zero size, and include a null terminator.

Synopsis

Declared in <mrdocs/Dom/String.hpp>

String(String const& other) noexcept;

Description

The newly constructed string acquries shared ownership of the string referenced by other.

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Dom/String.hpp>

constexpr
String(String&& other) noexcept;

Description

Ownership of the string is transferred to the newly constructed string. The moved-from string behaves as if default constructed.

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Dom/String.hpp>

String(std::string_view sv);

Description

This function constructs a new string from the buffer pointed to by sv.

Parameters

Name	Description
sv	The string to construct with. A copy of this string is made.

Synopsis

Declared in <mrdocs/Dom/String.hpp>

template<StringLikeTy StringLike>
String(StringLike const& s);

Description

This function constructs a new string from s, which must be convertible to std::string_view.

Parameters

Name	Description
s	The string to construct with. A copy of this string is made.

Synopsis

Declared in <mrdocs/Dom/String.hpp>

template<std::size_t N>
constexpr
String(char const(& str)[N]);

Description

This function constructs a string literal which references the buffer pointed to by str. Ownership is not transferred; the lifetime of the buffer must extend until the string is destroyed, otherwise the behavior is undefined.

Parameters

Name	Description
str	A null-terminated string. If the string is not null-terminated, the result is undefined.

Synopsis

Declared in <mrdocs/Dom/String.hpp>

String(
    char const* str,
    std::size_t len);

Description

This function constructs a new string from the string pointed to by str of length len.

Parameters

Name	Description
str	The string to construct with. A copy of this string is made.
len	The length of the string.

Synopsis

Declared in <mrdocs/Dom/String.hpp>

~String() noexcept;

Synopses

Declared in <mrdocs/Dom/String.hpp>

Assignment.

String&
operator=(String const& other) noexcept;

» more...

Assignment.

String&
operator=(String&& other) noexcept;

» more...

Synopsis

Declared in <mrdocs/Dom/String.hpp>

String&
operator=(String const& other) noexcept;

Description

This acquires shared ownership of the string referenced by other. Ownership of the previously referenced string is released.

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Dom/String.hpp>

String&
operator=(String&& other) noexcept;

Description

This transfers ownership of the string referenced by other to this. Ownership of the previously referened string is released. After the assignment, the moved-from string behaves as if default constructed.

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to move assign from

Synopsis

Declared in <mrdocs/Dom/String.hpp>

char const*
c_str() const noexcept;

Description

The pointed-to character buffer returned by this function is always null-terminated.

Return Value

the string.

Synopsis

Declared in <mrdocs/Dom/String.hpp>

char const*
data() const noexcept;

Description

constexpr
void
swap(String& other) noexcept;

Parameters

Name	Description
other	The other string.

Synopsis

Declared in <mrdocs/Dom/String.hpp>

operator std::string_view() const noexcept;

Return Value

the string.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

class Value;

Member Functions

Name	Description
`Value` [constructor]	Constructors
`~Value` [destructor]	Destroy the contained value, releasing owned storage.
`operator=`	Assignment operators
`empty`	Return if an Array or Object is empty.
`exists`	Return true if a key exists.
`get`	`get` overloads
`getArray`	Return the array.
`getBool`	Return the underlying boolean value.
`getFunction`	Return the function.
`getInteger`	Return the underlying integer value.
`getObject`	Return the object.
`getString`	Return the underlying string value.
`isArray`	Return true if this is an array.
`isBoolean`	Return true if this is a boolean.
`isFunction`	Return true if this is a function.
`isInteger`	Return true if this is an integer.
`isNull`	Return true if this is null.
`isObject`	Return true if this is an object.
`isSafeString`	Return true if this is a safe string.
`isString`	Return true if this is a string.
`isTruthy`	Determine if a value is truthy
`isUndefined`	Return true if this is undefined.
`kind`	Return the type of value contained.
`lookup`	Lookup a sequence of keys.
`operator()`	Invoke the function.
`set`	Set or replace the value for a given key.
`size`	Return if an Array or Object is empty.
`swap`	Swap two values.
`type_key`	Return the type key of the value.
`operator std::string`	Return the string.
`operator bool`	Determine if a value is truthy

Data Members

Name	Description
`arr_` [variant member]	Array payload; shared with lazy arrays.
`b_` [variant member]	Boolean payload when the value kind is `Boolean`.
`fn_` [variant member]	Callable payload used by template helpers.
`i_` [variant member]	Integer payload when the value kind is `Integer`.
`obj_` [variant member]	Object payload; shared with lazy objects.
`str_` [variant member]	UTF-8 string or safe-string payload.

Friends

Name	Description
`mrdocs::dom::toString`	Return value as a string.
`mrdocs::dom::operator&&`
`mrdocs::dom::operator&&`
`mrdocs::dom::operator&&`	Return the first dom::Value that is not truthy, or the last one.
`mrdocs::dom::operator\|\|`
`mrdocs::dom::operator\|\|`
`mrdocs::dom::operator\|\|`	Return the first dom::Value that is truthy, or the last one.
`mrdocs::dom::operator+`
`mrdocs::dom::operator+`
`mrdocs::dom::operator+`	Add or concatenate two values.
`mrdocs::dom::operator<=>`	Three-way comparison operator
`mrdocs::dom::operator<=>`	Three-way comparison operator
`mrdocs::dom::operator<=>`	Compare two values for inequality.
`mrdocs::dom::operator==`	Compare two values for equality.
`mrdocs::dom::swap`	Swap two values.
`mrdocs::safeString`	Create a wrapper for a safe string.
`mrdocs::dom::Object`	A container of key and value pairs.
`mrdocs::dom::Array`	An array of values

Non-Member Functions

Name	Description
`ValueFrom`	Convert an object of type `T` to `dom::Value` with a context
`ValueFrom`	Convert an object of type `T` to `dom::Value`.
`stringOrNull`	Return a non-empty string, or a null.
`stringOrNull`	Return a non-empty string, or a null.
`stringOrNull`	Return a non-empty string, or a null.
`JSON::stringify`	Stringify a value as JSON
`::mrdocs::isEmpty`	Determine if a value is empty
`::mrdocs::safeString`	Return a DOM string ensuring special characters are escaped.
`::mrdocs::safeString`	Mark an existing string-like value as safe to emit without escaping.
`::mrdocs::helpers::detag_fn`	"detag" helper function
`::mrdocs::helpers::increment_fn`	"increment" helper function
`::mrdocs::helpers::or_fn`	"or" helper function
`::mrdocs::helpers::relativize_fn`	"relativize" helper function
`::mrdocs::helpers::select_fn`	"select" helper function

Synopses

Declared in <mrdocs/Dom/Value.hpp>

Construct an undefined value.

Value() noexcept;

» more...

Copy-construct from another value.

Value(Value const& other);

» more...

Move-construct from another value, leaving it undefined.

Value(Value&& other) noexcept;

» more...

Construct an array value, taking ownership of the elements.

Value(Array arr) noexcept;

» more...

Construct a function value that can be invoked by templates.

Value(Function fn) noexcept;

» more...

Construct an empty value with the specified kind.

Value(dom::Kind kind) noexcept;

» more...

Construct an object value, taking ownership of the members.

Value(Object obj) noexcept;

» more...

Construct a string or safe-string value, taking ownership.

Value(String str) noexcept;

» more...

Construct a single-character string value.

Value(char c) noexcept;

» more...

Construct an integer value.

Value(int64_t v) noexcept;

» more...

Construct a null value.

Value(std::nullptr_t v) noexcept;

» more...

Construct an array value from raw storage.

Value(Array::storage_type elements);

» more...

Construct a string value from a C string.

Value(char const* s);

» more...

Construct an integer value from a floating-point number by truncation.

template<std::floating_point T>
Value(T v) noexcept;

» more...

Construct an integer value from an integral type other than bool or char.

template<std::integral T>
requires (!std::same_as<T, bool>) &&
        (!std::same_as<T, char>)
Value(T v) noexcept;

» more...

Construct a boolean value.

template<std::convertible_to<String> Boolean>
Value(Boolean const& b);

» more...

Construct a function value from a callable object.

template<class F>
requires function_traits_convertible_to_value<F>
Value(F const& f);

» more...

Construct from Optional, using Undefined when empty.

template<class T>
requires std::constructible_from<Value, T>
Value(Optional<T> const& opt);

» more...

Construct from std::optional, using Undefined when empty.

template<class T>
requires std::constructible_from<Value, T>
Value(std::optional<T> const& opt);

» more...

Construct a string value from a string literal.

template<std::size_t N>
Value(char const(& sz)[N]);

» more...

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Value() noexcept;

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Value(Value const& other);

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Value(Value&& other) noexcept;

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Value(Array arr) noexcept;

Parameters

Name	Description
arr	The object to construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Value(Function fn) noexcept;

Parameters

Name	Description
fn	The object to construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Value(dom::Kind kind) noexcept;

Parameters

Name	Description
kind	The object to construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Value(Object obj) noexcept;

Parameters

Name	Description
obj	The object to construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Value(String str) noexcept;

Parameters

Name	Description
str	The object to construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Value(char c) noexcept;

Parameters

Name	Description
c	The value to construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Value(int64_t v) noexcept;

Parameters

Name	Description
v	The object to construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Value(std::nullptr_t v) noexcept;

Parameters

Name	Description
v	The object to construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Value(Array::storage_type elements);

Parameters

Name	Description
elements	The object to construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Value(char const* s);

Parameters

Name	Description
s	The value to construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

template<std::floating_point T>
Value(T v) noexcept;

Parameters

Name	Description
v	The object to construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

template<std::integral T>
requires (!std::same_as<T, bool>) &&
        (!std::same_as<T, char>)
Value(T v) noexcept;

Parameters

Name	Description
v	The object to construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

template<std::convertible_to<String> Boolean>
Value(Boolean const& b);

Description

Construct a string value from any String-convertible type.

Parameters

Name	Description
b	The object to copy construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

template<class F>
requires function_traits_convertible_to_value<F>
Value(F const& f);

Parameters

Name	Description
f	The object to copy construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

template<class T>
requires std::constructible_from<Value, T>
Value(Optional<T> const& opt);

Parameters

Name	Description
opt	The object to copy construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

template<class T>
requires std::constructible_from<Value, T>
Value(std::optional<T> const& opt);

Parameters

Name	Description
opt	The object to copy construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

template<std::size_t N>
Value(char const(& sz)[N]);

Parameters

Name	Description
sz	The value to construct from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

~Value();

Synopses

Declared in <mrdocs/Dom/Value.hpp>

Copy-assign from another value, replacing the stored payload.

Value&
operator=(Value const& other);

» more...

Move-assign from another value, leaving it undefined.

Value&
operator=(Value&& other) noexcept;

» more...

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Value&
operator=(Value const& other);

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Value&
operator=(Value&& other) noexcept;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to move assign from

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

bool
empty() const;

Return Value

if an Array or Object is empty.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

bool
exists(std::string_view key) const;

Return Value

true if the key exists, otherwise false.

Parameters

Name	Description
key	The key to check for existence.

Synopses

Declared in <mrdocs/Dom/Value.hpp>

Return the element at a given index.

dom::Value
get(std::size_t i) const;

» more...

Return the element for a given key.

dom::Value
get(std::string_view key) const;

» more...

Return the element at a given index or key.

dom::Value
get(dom::Value const& i) const;

» more...

Return the element for a given key.

template<std::convertible_to<std::string_view> S>
dom::Value
get(S const& key) const;

» more...

Return Value

The value at the specified index, or a Value of type
The value for the specified key, or a Value of type Kind::Undefined if the key does not exist.
The value for the specified key, or a Value of type Kind::Undefined if the key does not exist.

Parameters

Name	Description
i	The index.
key	The key.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

dom::Value
get(std::size_t i) const;

Return Value

The value at the specified index, or a Value of type

Parameters

Name	Description
i	The index.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

dom::Value
get(std::string_view key) const;

Description

If the Value is not an object, or the key is not found, a Value of type Kind::Undefined is returned.

Return Value

The value for the specified key, or a Value of type Kind::Undefined if the key does not exist.

Parameters

Name	Description
key	The key.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

dom::Value
get(dom::Value const& i) const;

Return Value

the element at a given index or key.

Parameters

Name	Description
i	A variant container for any kind of Dom value.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

template<std::convertible_to<std::string_view> S>
dom::Value
get(S const& key) const;

Description

If the Value is not an object, or the key is not found, a Value of type Kind::Undefined is returned.

Return Value

The value for the specified key, or a Value of type Kind::Undefined if the key does not exist.

Parameters

Name	Description
key	The key.

Synopses

Declared in <mrdocs/Dom/Value.hpp>

Return the array.

Array const&
getArray() const;

» more...

Array&
getArray();

» more...

Exceptions

Name	Thrown on
`Exception`	`! isArray()`

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Array const&
getArray() const;

Exceptions

Name	Thrown on
`Exception`	`! isArray()`

Return Value

the array.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Array&
getArray();

Return Value

An array of values

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

bool
getBool() const noexcept;

Description

NOTE

Behaviour is undefined if !isBoolean()

Return Value

the underlying boolean value.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Function const&
getFunction() const;

Exceptions

Name	Thrown on
`Exception`	`! isFunction()`

Return Value

the function.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

int64_t
getInteger() const noexcept;

Description

NOTE

Behaviour is undefined if !isInteger()

Return Value

the underlying integer value.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Object const&
getObject() const;

Exceptions

Name	Thrown on
`Exception`	`! isObject()`

Return Value

the object.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

String const&
getString() const noexcept;

Description

NOTE

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

bool
isUndefined() const noexcept;

Return Value

true if this is undefined.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

dom::Kind
kind() const noexcept;

Return Value

the type of value contained.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

dom::Value
lookup(std::string_view keys) const;

Description

This function is equivalent to calling get multiple times, once for each key in the sequence of dot-separated keys.

Return Value

The value at the end of the sequence, or a Value of type Kind::Undefined if any key is not found.

Parameters

Name	Description
keys	The dot-separated sequence of keys.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

template<class... Args>
Value
operator()(Args&&... args) const;

Description

If the Value is not an object, or the key is not found, a Value of type Kind::Undefined is returned.

Return Value

Another instance of the object

Parameters

Name	Description
args	The arguments to the function.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

void
set(
    String const& key,
    Value const& value);

Parameters

Name	Description
key	The key.
value	The value to set.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

std::size_t
size() const;

Return Value

if an Array or Object is empty.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

void
swap(Value& other) noexcept;

Parameters

Name	Description
other	A variant container for any kind of Dom value.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

char const*
type_key() const noexcept;

Return Value

the type key of the value.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

explicit
operator std::string() const noexcept;

Return Value

the string.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

explicit
operator bool() const noexcept;

Description

A value is truthy if it is a boolean and is true, a number and not zero, or an non-empty string, array or object.

Return Value

true if the value is truthy, false otherwise

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Array arr_;

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

bool b_ = {false};

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Function fn_;

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

int64_t i_;

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Object obj_;

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

String str_;

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

struct ValueFromTag;

Description

This tag type is used by the function dom::ValueFrom to select overloads of tag_invoke.

NOTE

This type is empty; it has no members.

Non-Member Functions

Name	Description
`::mrdocs::tag_invoke`	Convert a NoexceptInfo to a DOM value.
`::mrdocs::tag_invoke`	Serialize a Type into a DOM value.
`::mrdocs::tag_invoke`	Serialize a polymorphic template argument into a DOM value.
`::mrdocs::tag_invoke`	Serialize a FundamentalTypeKind into a DOM value.
`::mrdocs::tag_invoke`	Return the UsingClass as a `dom::Value` string.
`::mrdocs::tag_invoke`	Serialize an optional polymorphic name into a DOM value.
`::mrdocs::tag_invoke`	Serialize a polymorphic name into a DOM value.
`::mrdocs::tag_invoke`	Return the AccessKind as a `dom::Value` string.
`::mrdocs::tag_invoke`	Serialize an optional polymorphic type into a DOM value.
`::mrdocs::tag_invoke`	Convert SymbolID to dom::Value object in the DOM using Corpus
`::mrdocs::tag_invoke`	Serialize template info into a DOM value.
`::mrdocs::tag_invoke`	Convert SymbolID pointers to dom::Value or null.
`::mrdocs::tag_invoke`	Return the ConstexprKind as a `dom::Value` string.
`::mrdocs::tag_invoke`	Serialize the auto kind into a DOM value.
`::mrdocs::tag_invoke`	Generic ValueFrom for any described enum.
`::mrdocs::tag_invoke`	Serialize a name into a DOM value.
`::mrdocs::tag_invoke`	Serialize source locations into a DOM value.
`::mrdocs::tag_invoke`	Serialize a base description into a DOM value.
`::mrdocs::tag_invoke`	Map a TypeKind into a DOM value.
`::mrdocs::tag_invoke`	Serialize the argument to a DOM value.
`::mrdocs::tag_invoke`	Serialize a template parameter into a DOM value.
`::mrdocs::tag_invoke`	Return the Param as a `dom::Value` object.
`::mrdocs::tag_invoke`	Generic ValueFrom for any described compound type.
`::mrdocs::tag_invoke`	Serialize an optional template info into a DOM value.
`::mrdocs::tag_invoke`	Serialize a polymorphic type into a DOM value.
`::mrdocs::tag_invoke`	Return the ReferenceKind as a `dom::Value` string.
`::mrdocs::tag_invoke`	Map an operator kind to a DOM value (its underlying integer).
`::mrdocs::tag_invoke`	Return the ExplicitInfo as a `dom::Value` string.
`::mrdocs::tag_invoke`	Return the StorageClassKind as a `dom::Value` string.
`::mrdocs::tag_invoke`	Generic ValueFrom for described enums, with context.
`::mrdocs::tag_invoke`	Convert an optional SymbolID to dom::Value or null.
`::mrdocs::tag_invoke`	Map a vector of parameters to a `dom::Value` object.
`::mrdocs::tag_invoke`	Convert SymbolID to dom::Value string in the DOM using toBase16
`::mrdocs::tag_invoke`	Map an ExprInfo to a `dom::Value` object.
`::mrdocs::tag_invoke`	Map a QualifierKind into a DOM value.
`::mrdocs::tag_invoke`	Serialize a polymorphic template parameter.
`::mrdocs::doc::tag_invoke`	Return the Parts from a `dom::Value` string.
`::mrdocs::doc::tag_invoke`	Map an optional brief block to a DOM value, yielding null when absent.
`::mrdocs::doc::tag_invoke`	Map the Polymorphic Block as a `dom::Value` object.
`::mrdocs::doc::tag_invoke`	Map an optional polymorphic block into a DOM value, producing null when empty.
`::mrdocs::doc::tag_invoke`	Serialize a polymorphic inline node into a DOM value.
`::mrdocs::doc::tag_invoke`	Return the ParamDirection from a `dom::Value` string.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<class F>
class VariadicFunctionImpl
    : public FunctionImpl

Base Classes

Name	Description
`FunctionImpl`	Value-semantic wrapper over a callable exposed to the DOM layer.

Type Aliases

Name	Description
`args_type`	Argument tuple type accepted by the callable.
`return_type`	Result type produced by the callable.

Member Functions

Name	Description
`VariadicFunctionImpl` [constructor]	Construct from any callable convertible to `F`.
`call` [virtual]	Invoke the wrapped callable with the full argument array.
`type_key` [virtual]	Return the type key of the implementation.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

using args_type = function_traits<F>::args_type;

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

using return_type = function_traits<F>::return_type;

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<class U>
VariadicFunctionImpl(U&& u);

Parameters

Name	Description
u	Callable to wrap.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

virtual
Expected<Value>
call(Array const& args) const override;

Return Value

A container holding an error or a value.

Parameters

Name	Description
args	An array of values

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

virtual
char const*
type_key() const noexcept override;

Return Value

the type key of the implementation.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<typename F>
struct function_traits;

Derived Classes

Name	Description
`function_traits<F>`	Traits specialization for functors/lambdas.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<typename F>
requires requires { &F::operator(); }
struct function_traits<F>
    : function_traits<decltype(&F::operator)>

Base Classes

Name	Description
`function_traits<decltype(&F::operator)>`	Helper traits to extract return and argument types from callables.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<
    typename R,
    typename... Args>
struct function_traits<R(*)(Args...)>;

Type Aliases

Name	Description
`args_type`	Tuple of argument types accepted by the callable.
`return_type`	Result type of the callable.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

using args_type = std::tuple<Args...>;

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

using return_type = R;

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<
    typename R,
    typename... Args>
struct function_traits<R(Args...)>;

Type Aliases

Name	Description
`args_type`	Tuple of argument types accepted by the callable.
`return_type`	Result type of the callable.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

using args_type = std::tuple<Args...>;

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

using return_type = R;

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<
    typename C,
    typename R,
    typename... Args>
struct function_traits<R const volatile(C::*)(Args...)>;

Description

Traits specialization for const member functions.

Traits specialization for volatile member functions.

Traits specialization for const volatile member functions.

Type Aliases

Name	Description
`args_type`	Tuple of argument types accepted by the callable.
`return_type`	Result type of the callable.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

using args_type = std::tuple<Args...>;

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

using return_type = R;

Synopsis

Declared in <mrdocs/Dom/Kind.hpp>

enum class Kind : int;

Description

This is the type of data stored in a Value. These types are loosely modeled after the JavaScript types and data structures.

Primitive values are Undefined, Null, Boolean, Integer, and String.

Undefined and Null are inhabited by a single value each. The difference between Undefined and Null is that Undefined is the default value for a Value, while Null represents a value that is explicitly set. Undefined is used to represent things such as:

An uninitialized Value
The Value returned from a function that failed to return a value
The result of accessing a nonexistent object property
The result of a find algorithm when no element is found

This distinction is semantically important as algorithms frequently need to distinguish between these two cases.

Booleans, Integers, and Strings are also primitive values. This means they are deeply copied when assigned or passed as a parameter.

Other value types, such as Array, Object, and Function are reference types, meaning that they are not copied when assigned or passed as a parameter. Instead, the reference is copied, and the original value is shared.

These reference types are modeled after JavaScript "Objects". All non-primitive types (Object types) are derived from Object in JavaScript. This means types such as Array and Function represent a relevant selection of built-in types that would derive from Object in JavaScript.

Objects are a collection of properties, which are equivalent to key-value pairs. Property values can be any type, including other Objects, allowing for the creation of arbitrarily complex data structures.

https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures

Members

Name	Description
`Undefined`	The value is undefined.
`Null`	The value is null.
`Boolean`	The value is a boolean.
`Integer`	The value is an integer.
`String`	The value is a string.
`SafeString`	The value is a safe string.
`Array`	The value is an array.
`Object`	The value is an object.
`Function`	The value is a function.

Synopses

Declared in <mrdocs/Dom/LazyArray.hpp>

Return a new dom::Array based on a lazy array implementation.

template<std::ranges::random_access_range T>
requires HasStandaloneValueFrom<std::ranges::range_value_t<T>>
Array
LazyArray(T const& arr);

» more...

Return a new dom::Array based on a FromValue context

template<
    std::ranges::random_access_range T,
    class Context>
requires HasValueFrom<std::ranges::range_value_t<T>, Context>
Array
LazyArray(
    T const& arr,
    Context const& ctx);

» more...

Return Value

A new dom::Array whose elements are the result of converting each element in the underlying range to a dom::Value.
A new dom::Array whose elements are the result of converting each element in the underlying range using the specified context.

Parameters

Name	Description
arr	The underlying range of elements.
ctx	The context used to convert each element to a dom::Value.

Synopsis

Declared in <mrdocs/Dom/LazyArray.hpp>

template<std::ranges::random_access_range T>
requires HasStandaloneValueFrom<std::ranges::range_value_t<T>>
Array
LazyArray(T const& arr);

Return Value

A new dom::Array whose elements are the result of converting each element in the underlying range to a dom::Value.

Parameters

Name	Description
arr	The underlying range of elements.

Synopsis

Declared in <mrdocs/Dom/LazyArray.hpp>

template<
    std::ranges::random_access_range T,
    class Context>
requires HasValueFrom<std::ranges::range_value_t<T>, Context>
Array
LazyArray(
    T const& arr,
    Context const& ctx);

Return Value

A new dom::Array whose elements are the result of converting each element in the underlying range using the specified context.

Parameters

Name	Description
arr	The underlying range of elements.
ctx	The context used to convert each element to a dom::Value.

Synopses

Declared in <mrdocs/Dom/LazyObject.hpp>

Return a new dom::Object based on a lazy object implementation.

template<HasLazyObjectMapWithoutContext T>
Object
LazyObject(T const& obj);

» more...

Return a new dom::Object based on a transformed lazy array implementation.

template<
    class T,
    class Context>
requires HasLazyObjectMap<T, Context>
Object
LazyObject(
    T const& arr,
    Context const& context);

» more...

Return Value

A new dom::Object whose properties are the result of converting each property in the underlying object to a dom::Value.
A new dom::Array whose elements are the result of converting each element in the underlying range using the specified context.

Parameters

Name	Description
obj	The underlying object.
arr	The underlying range of elements.
context	The context used to convert each element to a dom::Value.

Synopsis

Declared in <mrdocs/Dom/LazyObject.hpp>

template<HasLazyObjectMapWithoutContext T>
Object
LazyObject(T const& obj);

Return Value

A new dom::Object whose properties are the result of converting each property in the underlying object to a dom::Value.

Parameters

Name	Description
obj	The underlying object.

Synopsis

Declared in <mrdocs/Dom/LazyObject.hpp>

template<
    class T,
    class Context>
requires HasLazyObjectMap<T, Context>
Object
LazyObject(
    T const& arr,
    Context const& context);

Return Value

A new dom::Array whose elements are the result of converting each element in the underlying range using the specified context.

Parameters

Name	Description
arr	The underlying range of elements.
context	The context used to convert each element to a dom::Value.

Synopsis

Declared in <mrdocs/Dom/LazyArray.hpp>

template<
    std::ranges::random_access_range T,
    class F>
requires std::invocable<F, std::ranges::range_value_t<T>> &&
    HasStandaloneValueFrom<std::invoke_result_t<F, std::ranges::range_value_t<T>>>
Array
TransformArray(
    T const& arr,
    F const& f);

Return Value

A new dom::Array whose elements are the result of applying the transform function to each element in the underlying range.

Parameters

Name	Description
arr	The underlying range of elements.
f	The transform function to apply to each element before converting it to a dom::Value.

Synopses

Declared in <mrdocs/Dom/Value.hpp>

Convert an object of type T to dom::Value.

template<class T>
requires HasStandaloneValueFrom<T>
Value
ValueFrom(T&& t);

» more...

Convert an object of type T to dom::Value.

template<class T>
requires HasStandaloneValueFrom<T>
void
ValueFrom(
    T&& t,
    Value& v);

» more...

Convert an object of type T to dom::Value with a context

template<
    class T,
    class Context>
requires HasValueFrom<T, Context>
Value
ValueFrom(
    T&& t,
    Context const& ctx);

» more...

Convert an object of type T to dom::Value.

template<
    class Context,
    HasValueFrom<Context> T>
void
ValueFrom(
    T&& t,
    Context const& ctx,
    Value& v);

» more...

Return Value

dom::Value out parameter.

Template Parameters

Name	Description
T	The type of the object to convert.
Context	The type of context passed to the conversion function.

Parameters

Name	Description
t	The object to convert.
v	`dom::Value` out parameter.
ctx	Context passed to the conversion function.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

template<class T>
requires HasStandaloneValueFrom<T>
Value
ValueFrom(T&& t);

Description

This function attempts to convert an object of type T to dom::Value using

a user-provided overload of tag_invoke.
one of dom::Value's constructors,

Conversion of other types is done by calling an overload of tag_invoke found by argument-dependent lookup. Its signature should be similar to:


void tag_invoke( ValueFromTag, dom::Value&, T );

Exception Safety

Strong guarantee.

Return Value

dom::Value out parameter.

Template Parameters

Name	Description
T	The type of the object to convert.

Parameters

Name	Description
t	The object to convert.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

template<class T>
requires HasStandaloneValueFrom<T>
void
ValueFrom(
    T&& t,
    Value& v);

Description

This function attempts to convert an object of type T to dom::Value using

a user-provided overload of tag_invoke.
one of dom::Value's constructors,

Conversion of other types is done by calling an overload of tag_invoke found by argument-dependent lookup. Its signature should be similar to:


void tag_invoke( ValueFromTag, dom::Value&, T );

Exception Safety

Strong guarantee.

Template Parameters

Name	Description
T	The type of the object to convert.

Parameters

Name	Description
t	The object to convert.
v	`dom::Value` out parameter.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

template<
    class T,
    class Context>
requires HasValueFrom<T, Context>
Value
ValueFrom(
    T&& t,
    Context const& ctx);

Description

This function attempts to convert an object of type T to dom::Value using

a user-provided overload of tag_invoke.
one of dom::Value's constructors,

Conversion of other types is done by calling an overload of tag_invoke found by argument-dependent lookup. Its signature should be similar to:


void tag_invoke( ValueFromTag, dom::Value&, T );

Exception Safety

Strong guarantee.

Return Value

dom::Value out parameter.

Template Parameters

Name	Description
T	The type of the object to convert.

Parameters

Name	Description
t	The object to convert.
ctx	Context passed to the conversion function.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

template<
    class Context,
    HasValueFrom<Context> T>
void
ValueFrom(
    T&& t,
    Context const& ctx,
    Value& v);

Description

This function attempts to convert an object of type T to dom::Value using

a user-provided overload of tag_invoke.
one of dom::Value's constructors,

Conversion of user-provided types is done by calling an overload of tag_invoke found by argument-dependent lookup. Its signature should be similar to:


void tag_invoke( ValueFromTag, dom::Value&, T,  Context const& );

or


void tag_invoke( ValueFromTag, dom::Value&, T );

The overloads are checked for existence in that order and the first that matches will be selected.

The ctx argument can be used either as a tag type to provide conversions for third-party types, or to pass extra data to the conversion function.

Exception Safety

Strong guarantee.

Template Parameters

Name	Description
T	The type of the object to convert.
Context	The type of context passed to the conversion function.

Parameters

Name	Description
t	The object to convert.
ctx	Context passed to the conversion function.
v	`dom::Value` out parameter.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<class F>
Function
makeInvocable(F&& f);

Return Value

Function that forwards arguments to f.

Parameters

Name	Description
f	Callable to wrap.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<class F>
requires std::invocable<F, Array const&>
Function
makeVariadicInvocable(F&& f);

Return Value

Function wrapper for the callable.

Parameters

Name	Description
f	Callable invoked with the argument array.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

template<
    class T,
    class... Args>
requires std::derived_from<T, ArrayImpl>
Array
newArray(Args&&... args);

Description

Return a new array using a custom implementation.

Return Value

A new array using the specified implementation.

Template Parameters

Name	Description
T	The type of the custom implementation. This must be derived from ArrayImpl.
Args	The types of the arguments.

Parameters

Name	Description
args	Arguments forwarded to the constructor of T.

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<
    class T,
    class... Args>
requires std::derived_from<T, FunctionImpl>
Function
newFunction(Args&&... args);

Description

Return a new function using a custom implementation.

Return Value

a diagnostic string.

Parameters

Name	Description
args	The arguments to the function.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

template<
    class T,
    class... Args>
requires std::derived_from<T, ObjectImpl>
Object
newObject(Args&&... args);

Return Value

A new object using the specified implementation.

Template Parameters

Name	Description
T	The type of the custom implementation. This must be derived from ObjectImpl.
Args	The types of the arguments.

Parameters

Name	Description
args	Arguments forwarded to the constructor of T.

Synopses

Declared in <mrdocs/Dom/Value.hpp>

auto
operator&&(
    S const& lhs,
    Value const& rhs) noexcept;

» more...

auto
operator&&(
    Value const& lhs,
    S const& rhs) noexcept;

» more...

Return the first dom::Value that is not truthy, or the last one.

dom::Value
operator&&(
    Value const& lhs,
    Value const& rhs);

» more...

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

auto
operator&&(
    S const& lhs,
    Value const& rhs) noexcept;

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

auto
operator&&(
    Value const& lhs,
    S const& rhs) noexcept;

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

dom::Value
operator&&(
    Value const& lhs,
    Value const& rhs);

Description

This function is equivalent to the JavaScript && operator.

Return Value

the first dom::Value that is not truthy, or the last one.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopses

Declared in <mrdocs/Dom/Array.hpp>

iterator
operator+(
    difference_type n,
    iterator it) noexcept;

» more...

Concatenate two arrays.

Array
operator+(
    Array const& lhs,
    Array const& rhs);

» more...

auto
operator+(
    Array const& lhs,
    S const& rhs) noexcept;

» more...

auto
operator+(
    S const& lhs,
    Array const& rhs) noexcept;

» more...

auto
operator+(
    S const& lhs,
    String const& rhs) noexcept;

» more...

auto
operator+(
    S const& lhs,
    Value const& rhs) noexcept;

» more...

auto
operator+(
    String const& lhs,
    S const& rhs) noexcept;

» more...

Concatenate two strings.

auto
operator+(
    String const& lhs,
    String const& rhs) noexcept;

» more...

auto
operator+(
    Value const& lhs,
    S const& rhs) noexcept;

» more...

Add or concatenate two values.

dom::Value
operator+(
    Value const& lhs,
    Value const& rhs);

» more...

Return Value

The concatenated string.

Parameters

Name	Description
lhs	The left-hand side string.
rhs	The right-hand side string.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

Array
operator+(
    Array const& lhs,
    Array const& rhs);

Return Value

An array of values

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

auto
operator+(
    Array const& lhs,
    S const& rhs) noexcept;

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

auto
operator+(
    S const& lhs,
    Array const& rhs) noexcept;

Synopsis

Declared in <mrdocs/Dom/String.hpp>

auto
operator+(
    S const& lhs,
    String const& rhs) noexcept;

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

auto
operator+(
    S const& lhs,
    Value const& rhs) noexcept;

Synopsis

Declared in <mrdocs/Dom/String.hpp>

auto
operator+(
    String const& lhs,
    S const& rhs) noexcept;

Synopsis

Declared in <mrdocs/Dom/String.hpp>

auto
operator+(
    String const& lhs,
    String const& rhs) noexcept;

Return Value

The concatenated string.

Parameters

Name	Description
lhs	The left-hand side string.
rhs	The right-hand side string.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

auto
operator+(
    Value const& lhs,
    S const& rhs) noexcept;

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

dom::Value
operator+(
    Value const& lhs,
    Value const& rhs);

Return Value

A variant container for any kind of Dom value.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopses

Declared in <mrdocs/Dom/Value.hpp>

auto
operator||(
    S const& lhs,
    Value const& rhs) noexcept;

» more...

auto
operator||(
    Value const& lhs,
    S const& rhs) noexcept;

» more...

Return the first dom::Value that is truthy, or the last one.

dom::Value
operator||(
    Value const& lhs,
    Value const& rhs);

» more...

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

auto
operator||(
    S const& lhs,
    Value const& rhs) noexcept;

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

auto
operator||(
    Value const& lhs,
    S const& rhs) noexcept;

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

dom::Value
operator||(
    Value const& lhs,
    Value const& rhs);

Description

This function is equivalent to the JavaScript || operator.

Return Value

the first dom::Value that is truthy, or the last one.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopses

Declared in <mrdocs/Dom/Value.hpp>

Return a non-empty string, or a null.

Value
stringOrNull(std::string_view s);

» more...

Return a non-empty string, or a null.

Value
stringOrNull(Optional<std::string> s);

» more...

Return a non-empty string, or a null.

Value
stringOrNull(std::string const& s);

» more...

Parameters

Name	Description
s	The string to check.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Value
stringOrNull(std::string_view s);

Return Value

a non-empty string, or a null.

Parameters

Name	Description
s	The string to check.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Value
stringOrNull(Optional<std::string> s);

Return Value

a non-empty string, or a null.

Parameters

Name	Description
s	The string to check.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

Value
stringOrNull(std::string const& s);

Return Value

a non-empty string, or a null.

Parameters

Name	Description
s	The string to check.

Synopses

Declared in <mrdocs/Dom/Array.hpp>

Swap two arrays.

void
swap(
    Array& lhs,
    Array& rhs) noexcept;

» more...

Swap two objects.

void
swap(
    Function& lhs,
    Function& rhs) noexcept;

» more...

Swap two objects.

void
swap(
    Object& lhs,
    Object& rhs) noexcept;

» more...

Swap two strings.

constexpr
void
swap(
    String& lhs,
    String& rhs) noexcept;

» more...

Swap two values.

void
swap(
    Value& v0,
    Value& v1) noexcept;

» more...

Parameters

Name	Description
lhs	The first object.
rhs	The second object.

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

void
swap(
    Array& lhs,
    Array& rhs) noexcept;

Parameters

Name	Description
lhs	An array of values
rhs	An array of values

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

void
swap(
    Function& lhs,
    Function& rhs) noexcept;

Parameters

Name	Description
lhs	The first object.
rhs	The second object.

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

void
swap(
    Object& lhs,
    Object& rhs) noexcept;

Parameters

Name	Description
lhs	A container of key and value pairs.
rhs	A container of key and value pairs.

Synopsis

Declared in <mrdocs/Dom/String.hpp>

constexpr
void
swap(
    String& lhs,
    String& rhs) noexcept;

Parameters

Name	Description
lhs	The first string.
rhs	The second string.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

void
swap(
    Value& v0,
    Value& v1) noexcept;

Parameters

Name	Description
v0	A variant container for any kind of Dom value.
v1	A variant container for any kind of Dom value.

Synopses

Declared in <mrdocs/Dom/Array.hpp>

Return a diagnostic string.

std::string
toString(Array const& arr);

» more...

Return a diagnostic string.

std::string
toString(Object const& object);

» more...

Return value as a string.

std::string
toString(Value const& value);

» more...

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

std::string
toString(Array const& arr);

Return Value

a diagnostic string.

Parameters

Name	Description
arr	An array of values

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

std::string
toString(Object const& object);

Return Value

a diagnostic string.

Parameters

Name	Description
object	A container of key and value pairs.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

std::string
toString(Value const& value);

Return Value

value as a string.

Parameters

Name	Description
value	A variant container for any kind of Dom value.

Synopses

Declared in <mrdocs/Dom/Array.hpp>

Return the result of comparing two strings.

bool
operator==(
    String const& lhs,
    String const& rhs) noexcept;

» more...

Return the result of comparing two strings.

bool
operator==(
    String const& lhs,
    StringLike const& rhs) noexcept;

» more...

Compare two values for equality.

bool
operator==(
    Value const& lhs,
    Value const& rhs) noexcept;

» more...

Compare two objects for equality.

bool
operator==(
    Object const& a,
    Object const& b) noexcept;

» more...

Compare two arrays for equality.

bool
operator==(
    Array const& lhs,
    Array const& rhs) noexcept;

» more...

Synopsis

Declared in <mrdocs/Dom/String.hpp>

bool
operator==(
    String const& lhs,
    String const& rhs) noexcept;

Return Value

the result of comparing two strings.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Dom/String.hpp>

bool
operator==(
    String const& lhs,
    StringLike const& rhs) noexcept;

Return Value

the result of comparing two strings.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

bool
operator==(
    Value const& lhs,
    Value const& rhs) noexcept;

Description

This operator uses strict equality, meaning that the types must match exactly, and for objects and arrays the children must match exactly.

The == operator behaves differently for objects compared to primitive data types like numbers and strings. When comparing objects using ==, it checks for reference equality, not structural equality.

This means that two objects are considered equal with === only if they reference the exact same object in memory.

NOTE

In JavaScript, this is equivalent to the === operator, which does not perform type conversions.

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

bool
operator==(
    Object const& a,
    Object const& b) noexcept;

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
a	The left operand
b	The right operand

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

bool
operator==(
    Array const& lhs,
    Array const& rhs) noexcept;

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopses

Declared in <mrdocs/Dom/String.hpp>

Return the result of comparing two strings.

bool
operator!=(
    String const& lhs,
    String const& rhs) noexcept;

» more...

Return the result of comparing two strings.

bool
operator!=(
    String const& lhs,
    StringLike const& rhs) noexcept;

» more...

Synopsis

Declared in <mrdocs/Dom/String.hpp>

bool
operator!=(
    String const& lhs,
    String const& rhs) noexcept;

Return Value

the result of comparing two strings.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Dom/String.hpp>

bool
operator!=(
    String const& lhs,
    StringLike const& rhs) noexcept;

Return Value

the result of comparing two strings.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopses

Declared in <mrdocs/Dom/Array.hpp>

Return the result of comparing two strings.

auto
operator<=>(
    String const& lhs,
    String const& rhs) noexcept;

» more...

Return the result of comparing two strings.

auto
operator<=>(
    String const& lhs,
    StringLike const& rhs) noexcept;

» more...

Three-way comparison operator

auto
operator<=>(
    Value const& lhs,
    S const& rhs) noexcept;

» more...

Three-way comparison operator

auto
operator<=>(
    S const& lhs,
    Value const& rhs) noexcept;

» more...

Compare two values for inequality.

std::strong_ordering
operator<=>(
    Value const& lhs,
    Value const& rhs) noexcept;

» more...

Compare two objects for precedence.

std::strong_ordering
operator<=>(
    Object const& a,
    Object const& b) noexcept;

» more...

Compare two arrays for precedence.

std::strong_ordering
operator<=>(
    Array const& lhs,
    Array const& rhs) noexcept;

» more...

Synopsis

Declared in <mrdocs/Dom/String.hpp>

auto
operator<=>(
    String const& lhs,
    String const& rhs) noexcept;

Return Value

the result of comparing two strings.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Dom/String.hpp>

auto
operator<=>(
    String const& lhs,
    StringLike const& rhs) noexcept;

Return Value

the result of comparing two strings.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

auto
operator<=>(
    Value const& lhs,
    S const& rhs) noexcept;

Return Value

The relative order of the objects

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

auto
operator<=>(
    S const& lhs,
    Value const& rhs) noexcept;

Return Value

The relative order of the objects

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

std::strong_ordering
operator<=>(
    Value const& lhs,
    Value const& rhs) noexcept;

Return Value

The relative order of the objects

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Dom/Object.hpp>

std::strong_ordering
operator<=>(
    Object const& a,
    Object const& b) noexcept;

Return Value

The relative order of the objects

Parameters

Name	Description
a	The left operand
b	The right operand

Synopsis

Declared in <mrdocs/Dom/Array.hpp>

std::strong_ordering
operator<=>(
    Array const& lhs,
    Array const& rhs) noexcept;

Return Value

The relative order of the objects

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Dom/LazyObject.hpp>

template<
    class T,
    class Context>
concept HasLazyObjectMap = HasLazyObjectMapWithContext<T, Context> ||
    HasLazyObjectMapWithoutContext<T>;

Description

If T can be converted to dom::Value via a call to dom::ValueFrom, the static data member value is defined as true. Otherwise, value is defined as false.

Synopsis

Declared in <mrdocs/Dom/LazyObject.hpp>

template<
    class T,
    class Context>
concept HasLazyObjectMapWithContext = requires(
    detail::ArchetypalIO& io,
    T const& t,
    Context const& ctx)
{
    { tag_invoke(LazyObjectMapTag{}, io, t, ctx) } -> std::same_as<void>;
};

Description

This concept determines if the user-provided conversion is defined as:


template <class IO>
void tag_invoke( LazyObjectMapTag, IO&, T,  Context const& );

Synopsis

Declared in <mrdocs/Dom/LazyObject.hpp>

template<class T>
concept HasLazyObjectMapWithoutContext = requires(
    detail::ArchetypalIO& io,
    T const& t)
{
    { tag_invoke(LazyObjectMapTag{}, io, t) } -> std::same_as<void>;
};

Description

This concept determines if the user-provided conversion is defined as:


template <class IO>
void tag_invoke( LazyObjectMapTag, IO&, T& );

This customization can be defined by any type that needs to be converted to/from a lazy dom::Object. For example:


template <class IO>
void tag_invoke( LazyObjectMapTag, IO& io, MyStruct const& s)
{
    io.map("name", s.name);
    io.map("size", s.size);
    io.map("age",  s.age);
}

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

template<class T>
concept HasStandaloneValueFrom = HasValueFromWithoutContext<T> ||
    std::constructible_from<Value, T>;

Description

This concept determines if there is a user-provided conversion to dom::Value that does not require a context or if dom::Value has a constructor that can be used to convert T to a dom::Value.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

template<
    class T,
    class Context>
concept HasValueFrom = HasValueFromWithContext<T, Context> ||
    HasValueFromWithoutContext<T> ||
    std::constructible_from<Value, T>;

Description

If T can be converted to dom::Value via a call to dom::ValueFrom, the static data member value is defined as true. Otherwise, value is defined as false.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

template<
    class T,
    class Context>
concept HasValueFromWithContext = requires(
    Value& v,
    T const& t,
    Context const& ctx)
{
    tag_invoke(ValueFromTag{}, v, t, ctx);
};

Description

This concept determines if the user-provided conversion is defined as:


void tag_invoke( ValueFromTag, dom::Value&, T,  Context const& );

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

template<class T>
concept HasValueFromWithoutContext = requires(
    Value& v,
    T const& t)
{
    tag_invoke(ValueFromTag{}, v, t);
};

Description

This concept determines if the user-provided conversion is defined as:


void tag_invoke( ValueFromTag, dom::Value&, T );

Synopsis

Declared in <mrdocs/Dom/String.hpp>

template<class StringTy>
concept StringLikeTy = ! std::is_same_v<StringTy, String> &&
    std::convertible_to<StringTy, std::string_view>;

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<class F>
concept function_traits_convertible_to_value = has_function_traits<F> &&
    has_function_traits_for_default_function_impl<F>;

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<typename F>
concept has_function_args_for_default_function_impl = (std::tuple_size_v<typename function_traits<F>::args_type> == 0 ||
        []<std::size_t... I>(std::index_sequence<I...>) {
        return
            (std::convertible_to<
                std::tuple_element_t<
                    I, typename function_traits<F>::args_type>,
                Value> && ...);
        }(std::make_index_sequence<std::tuple_size_v<typename function_traits<F>::args_type>>()));

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<typename F>
concept has_function_traits = requires {
    typename function_traits<F>::return_type;
    typename function_traits<F>::args_type;
};

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<typename F>
concept has_function_traits_for_default_function_impl = has_invoke_result_for_default_function_impl<F> &&
    has_function_args_for_default_function_impl<F>;

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<typename F>
concept has_invoke_expected_result_convertible_to_dom_value = detail::isExpected<typename function_traits<F>::return_type> &&
    (std::convertible_to<typename function_traits<F>::return_type::value_type, Value> ||
     std::same_as<typename function_traits<F>::return_type::value_type, void>);

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<typename F>
concept has_invoke_result_convertible_to_dom_value = std::convertible_to<typename function_traits<F>::return_type, Value> ||
    std::same_as<typename function_traits<F>::return_type, void>;

Synopsis

Declared in <mrdocs/Dom/Function.hpp>

template<typename F>
concept has_invoke_result_for_default_function_impl = has_invoke_result_convertible_to_dom_value<F> ||
    has_invoke_expected_result_convertible_to_dom_value<F>;

Description

The files namespace centralizes cross-platform path manipulation so CLI, generators, and tests can share the same normalization and staging logic.

Enums

Name	Description
`FileType`	The type of a file.

Functions

Name	Description
`appendPath`	`appendPath` overloads
`createDirectory`	Create a directory.
`exists`	Determine if a path exists
`getFileName`	Return the filename part of the path.
`getFileText`	Return the contents of a file as a string.
`getFileType`	Return the file type or an error
`getParentDir`	Return the parent directory.
`getSourceFilename`	Return the relevant suffix of a source file path.
`isAbsolute`	Return true if pathName is absolute.
`isDirectory`	Determine if a path is a directory.
`isDirsy`	Return true if pathName ends in a separator.
`isLexicalDirectory`	Determine lexically if a path is a directory.
`isPosixStyle`	Check if the path is posix style.
`isResolvedSubpathOf`	Checks whether the given path lies within the specified prefix, tolerating symlinks.
`isSubpathOf`	Checks whether the given path lies within the specified prefix.
`makeAbsolute`	Return an absolute path from a possibly relative path.
`makeDirsy`	Append a trailing native separator if not already present.
`makePosixStyle`	Convert all backward slashes to forward slashes.
`makeRealPath`	Return the real, symlink-resolved form of a path.
`normalizeDir`	Return a normalized directory.
`normalizePath`	Return a normalized path.
`requireAbsolute`	Return an error if pathName is not absolute.
`requireDirectory`	Return an error if the path is not a directory.
`withExtension`	Return the filename with a new or different extension.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

enum class FileType : int;

Members

Name	Description
`not_found`	The file does not exist
`regular`	The path represents a regular file
`directory`	The file is a directory
`other`	The file is something else

Non-Member Functions

Name	Description
`getFileType`	Return the file type or an error

Synopses

Declared in <mrdocs/Support/Path.hpp>

Append a component to a base path using the native separator.

std::string
appendPath(
    std::string_view basePath,
    std::string_view name);

» more...

Append two components to a base path using the native separator.

std::string
appendPath(
    std::string_view basePath,
    std::string_view name1,
    std::string_view name2);

» more...

Append three components to a base path using the native separator.

std::string
appendPath(
    std::string_view basePath,
    std::string_view name1,
    std::string_view name2,
    std::string_view name3);

» more...

Append four components to a base path using the native separator.

std::string
appendPath(
    std::string_view basePath,
    std::string_view name1,
    std::string_view name2,
    std::string_view name3,
    std::string_view name4);

» more...

Return Value

Combined path string.

Parameters

Name	Description
basePath	Base path.
name	Component to append.
name1	First component to append.
name2	Second component to append.
name3	Third component to append.
name4	Fourth component to append.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

std::string
appendPath(
    std::string_view basePath,
    std::string_view name);

Return Value

Combined path string.

Parameters

Name	Description
basePath	Base path.
name	Component to append.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

std::string
appendPath(
    std::string_view basePath,
    std::string_view name1,
    std::string_view name2);

Return Value

Combined path string.

Parameters

Name	Description
basePath	Base path.
name1	First component to append.
name2	Second component to append.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

std::string
appendPath(
    std::string_view basePath,
    std::string_view name1,
    std::string_view name2,
    std::string_view name3);

Return Value

Combined path string.

Parameters

Name	Description
basePath	Base path.
name1	First component to append.
name2	Second component to append.
name3	Third component to append.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

std::string
appendPath(
    std::string_view basePath,
    std::string_view name1,
    std::string_view name2,
    std::string_view name3,
    std::string_view name4);

Return Value

Combined path string.

Parameters

Name	Description
basePath	Base path.
name1	First component to append.
name2	Second component to append.
name3	Third component to append.
name4	Fourth component to append.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

Expected<void>
createDirectory(std::string_view pathName);

Description

Any missing parent directories will also be created.

Return Value

A container holding an error or a value.

Parameters

Name	Description
pathName	The absolute or relative path to create.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

bool
exists(std::string_view pathName);

Return Value

true if the path exists, false otherwise.

Parameters

Name	Description
pathName	The absolute or relative path

Synopsis

Declared in <mrdocs/Support/Path.hpp>

std::string_view
getFileName(std::string_view pathName);

Return Value

The filename part of the path, or the empty string if there is none.

Parameters

Name	Description
pathName	The absolute or relative path to the directory or file.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

Expected<std::string>
getFileText(std::string_view pathName);

Return Value

The contents of the file, or an error if any occurred.

Parameters

Name	Description
pathName	The absolute or relative path to the file.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

Expected<FileType>
getFileType(std::string_view pathName);

Return Value

the file type or an error

Parameters

Name	Description
pathName	The absolute or relative path to the file.

Synopses

Declared in <mrdocs/Support/Path.hpp>

Return the parent directory.

std::string
getParentDir(std::string_view pathName);

» more...

Return the parent directory.

std::string
getParentDir(
    std::string_view pathName,
    unsigned int levels);

» more...

Return Value

The parent directory, or the empty string if there is none.

Parameters

Name	Description
pathName	The absolute or relative path to the directory or file.
levels	The number of levels to go up. If this is zero, the original path is returned. If this is greater than the number of levels in the path, the empty string is returned.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

std::string
getParentDir(std::string_view pathName);

Description

If the parent directory is defined, the returned path will always have a trailing separator.

Return Value

The parent directory, or the empty string if there is none.

Parameters

Name	Description
pathName	The absolute or relative path to the directory or file.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

std::string
getParentDir(
    std::string_view pathName,
    unsigned int levels);

Description

If the parent directory is defined, the returned path will always have a trailing separator.

Return Value

The parent directory, or the empty string if there is none.

Parameters

Name	Description
pathName	The absolute or relative path to the directory or file.
levels	The number of levels to go up. If this is zero, the original path is returned. If this is greater than the number of levels in the path, the empty string is returned.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

std::string_view
getSourceFilename(std::string_view pathName);

Return Value

The suffix, including the leading dot, or the empty string if there is no suffix.

Parameters

Name	Description
pathName	The absolute or relative path to the file.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

bool
isAbsolute(std::string_view pathName) noexcept;

Return Value

true if the path is absolute, false otherwise.

Parameters

Name	Description
pathName	The absolute or relative path to the directory or file.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

bool
isDirectory(std::string_view pathName);

Return Value

true if the path exists and is a directory, false otherwise.

Parameters

Name	Description
pathName	The absolute or relative path

Synopsis

Declared in <mrdocs/Support/Path.hpp>

bool
isDirsy(std::string_view pathName) noexcept;

Return Value

true if the path ends in a separator, false otherwise.

Parameters

Name	Description
pathName	The absolute or relative path to the directory or file.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

bool
isLexicalDirectory(std::string_view pathName);

Description

This function determines if a path is a directory.

If the path does not exist, the function determines lexically if the path represents a directory. In this case, the function returns true if the last path segment contains a period, otherwise false.

Return Value

true if the path exists and is a directory, or if the path does not exist and the last path segment does not contain a period. false otherwise.

Parameters

Name	Description
pathName	The absolute or relative path

Synopsis

Declared in <mrdocs/Support/Path.hpp>

bool
isPosixStyle(std::string_view pathName);

Return Value

true if the path uses only forward slashes as path separators, false otherwise.

Parameters

Name	Description
pathName	The absolute or relative path to the directory or file.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

bool
isResolvedSubpathOf(
    std::string_view pathName,
    std::string_view prefix);

Description

This behaves like isSubpathOf, but also returns true when pathName lies within prefix only after resolving symbolic links on both sides (see makeRealPath). It recognizes a file reached through a symlinked directory while prefix refers to the real path, or vice versa.

Matching is generous: a lexical match alone is enough, and resolving symlinks only ever adds matches, so anything isSubpathOf accepts is still accepted. This makes it suitable for inclusion decisions. Prefer the strict isSubpathOf for exclusion decisions, so that a symlinked alias of an excluded file is not excluded.

The symlink resolution performs filesystem lookups, so it is reached only when the lexical comparison fails; paths with no symlinks pay no extra cost.

Return Value

A boolean value. Returns true if pathName lies within prefix as written or after resolving symlinks, false otherwise.

Parameters

Name	Description
pathName	A string view representing the path to be checked.
prefix	A string view representing the prefix to be checked against the path.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

bool
isSubpathOf(
    std::string_view pathName,
    std::string_view prefix);

Description

It returns true if pathName is prefix or lies underneath it. The comparison walks whole path segments rather than characters, so /abc contains /abc/def but not /abcdef. The comparison is case-sensitive.

Unlike a direct string comparison, this function also accepts differences in the slashes used to separate paths. Therefore, it returns true even when the slashes used in pathName and prefix are not the same. The function accepts both forward slashes ("/") and backslashes ("").

It does not resolve symbolic links; use isResolvedSubpathOf when symlink equivalence matters.

Return Value

A boolean value. Returns true if pathName lies within prefix, false otherwise.

Parameters

Name	Description
pathName	A string view representing the path to be checked.
prefix	A string view representing the prefix to be checked against the path.

Synopses

Declared in <mrdocs/Support/Path.hpp>

Return an absolute path from a possibly relative path.

Expected<std::string>
makeAbsolute(std::string_view pathName);

» more...

Return an absolute path from a possibly relative path.

std::string
makeAbsolute(
    std::string_view pathName,
    std::string_view workingDir);

» more...

Return Value

The absolute path, or an error if any occurred.
The absolute path, or an error if any occurred.

Parameters

Name	Description
pathName	The absolute or relative path to the directory or file.
workingDir	The working directory to resolve relative paths against.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

Expected<std::string>
makeAbsolute(std::string_view pathName);

Description

Relative paths are resolved against the current working directory of the process.

Return Value

The absolute path, or an error if any occurred.

Parameters

Name	Description
pathName	The absolute or relative path to the directory or file.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

std::string
makeAbsolute(
    std::string_view pathName,
    std::string_view workingDir);

Return Value

The absolute path, or an error if any occurred.

Parameters

Name	Description
pathName	The absolute or relative path to the directory or file.
workingDir	The working directory to resolve relative paths against.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

std::string
makeDirsy(std::string_view pathName);

Return Value

A copy of the path with a trailing separator if not already present.

Parameters

Name	Description
pathName	The absolute or relative path to the directory or file.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

std::string
makePosixStyle(std::string_view pathName);

Return Value

A copy of the path with all backslashes replaced with forward slashes.

Parameters

Name	Description
pathName	The absolute or relative path to the directory or file.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

std::string
makeRealPath(std::string_view pathName);

Description

Resolves every symbolic link and ./.. component in pathName to the file's actual on-disk location and returns it in POSIX style (forward slashes). The same file can be named by many paths (through symlinks, .., or a directory that is itself a link); this collapses all of those spellings to one real path, so two paths that refer to the same file produce the same result.

If the path cannot be resolved, for example because it does not exist on disk, is a virtual or in-memory file, or has not been created yet, the input is returned unchanged apart from POSIX normalization. Callers can therefore always fall back to comparing the path as written, and this function never fails.

Return Value

The real POSIX path, or the POSIX-normalized input if it cannot be resolved.

Parameters

Name	Description
pathName	The absolute or relative path to a directory or file.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

std::string
normalizeDir(std::string_view pathName);

Description

This function returns a new directory path based on applying the changes defined by normalizePath and makeDirsy.

Return Value

The normalized path.

Parameters

Name	Description
pathName	The relative or absolute path.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

std::string
normalizePath(std::string_view pathName);

Description

This function returns a new path based on applying the following changes to the passed path:

"." and ".." are resolved
Separators made uniform
Separators are replaced with the native separator

Return Value

The normalized path.

Parameters

Name	Description
pathName	The relative or absolute path.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

Expected<void>
requireAbsolute(std::string_view pathName);

Return Value

An error if the path is not absolute.

Parameters

Name	Description
pathName	The absolute or relative path to the directory or file.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

Expected<void>
requireDirectory(std::string_view pathName);

Return Value

An error if the path does not exist or is not a directory.

Parameters

Name	Description
pathName	The absolute or relative path

Synopsis

Declared in <mrdocs/Support/Path.hpp>

std::string
withExtension(
    std::string_view fileName,
    std::string_view ext);

Return Value

the filename with a new or different extension.

Parameters

Name	Description
fileName	The absolute or relative path to the directory or file.
ext	The extension to use, without a leading dot. If this is empty and the path contains an extension, then the extension is removed.

Description

Everything under helpers mirrors the runtime helper registry shipped with our bundled Handlebars engine so templates can call the same helpers in both Node-based dev mode and the embedded C++ rendering pipeline.

Functions

Name	Description
`and_fn`	"and" helper function
`detag_fn`	"detag" helper function
`eq_fn`	"eq" helper function
`increment_fn`	"increment" helper function
`ne_fn`	"ne" helper function
`not_fn`	"not" helper function
`or_fn`	"or" helper function
`registerAntoraHelpers`	Register all the Antora helpers into a Handlebars instance
`registerBuiltinHelpers`	Register all the built-in helpers into a Handlebars instance
`registerConstructorHelpers`	Register contructor helpers into a Handlebars instance
`registerContainerHelpers`	Register helpers to manipulate composite data types
`registerLogicalHelpers`	Register logical helpers into a Handlebars instance
`registerMathHelpers`	Register math helpers into a Handlebars instance
`registerStringHelpers`	Register string helpers into a Handlebars instance
`registerTypeHelpers`	Register type helpers into a Handlebars instance
`relativize_fn`	"relativize" helper function
`select_fn`	"select" helper function
`year_fn`	"year" helper function

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

bool
and_fn(dom::Array const& args);

Description

The "and" helper returns true if all of the values are truthy.

Return Value

True if all of the values are truthy, false otherwise.

Parameters

Name	Description
args	The values to test

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

dom::Value
detag_fn(dom::Value html);

Description

The "detag" helper applies the regex expression "<[]+>" to the input to remove all HTML tags.

Return Value

A variant container for any kind of Dom value.

Parameters

Name	Description
html	A variant container for any kind of Dom value.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

bool
eq_fn(dom::Array const& args);

Description

The "eq" helper returns true if all of the values are equal.

Return Value

True if all of the values are equal, false otherwise.

Parameters

Name	Description
args	The values to compare

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

dom::Value
increment_fn(dom::Value const& value);

Description

The "increment" helper adds 1 to the value if it's an integer and converts booleans to true. Other values are returned as-is.

Return Value

A variant container for any kind of Dom value.

Parameters

Name	Description
value	A variant container for any kind of Dom value.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

bool
ne_fn(dom::Array const& args);

Description

The "ne" helper returns true if any of the values are not equal.

Return Value

True if any of the values are not equal, false otherwise.

Parameters

Name	Description
args	The values to compare

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

bool
not_fn(dom::Array const& arg);

Description

The "not" helper returns true if not all of the values are truthy.

Return Value

True if not all of the values are truthy, false otherwise.

Parameters

Name	Description
arg	An array of values

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

dom::Value
or_fn(dom::Array const& args);

Description

The "or" helper returns true if any of the values are truthy.

Return Value

A variant container for any kind of Dom value.

Parameters

Name	Description
args	An array of values

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
registerAntoraHelpers(Handlebars& hbs);

Description

This function registers all the helpers that are part of the default Antora UI.

Individual Antora helpers can also be registered with the public *_fn functions in this namespace.

Since the Antora helpers are not mandatory and include many functions not applicable to all applications, this allows the user to register only some of the Antora helpers.

Parameters

Name	Description
hbs	The Handlebars instance to register the helpers into

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
registerBuiltinHelpers(Handlebars& hbs);

Description

Individual built-in helpers can also be registered with the public *_fn functions in this namespace.

This allows the user to override only some of the built-in helpers. In particular, this is important for mandatory helpers, such as blockHelperMissing and helperMissing.

Parameters

Name	Description
hbs	The Handlebars instance to register the helpers into

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
registerConstructorHelpers(Handlebars& hbs);

Description

This function registers a number of common helpers that allows the user to create objects of specific types directly from literals in the template.

Parameters

Name	Description
hbs	The Handlebars instance to register the helpers into

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
registerContainerHelpers(Handlebars& hbs);

Description

This function registers a number of common helpers that operate on Objects and Arrays. Object and Array helpers are particularly useful because most applications will need to manipulate Objects and Arrays to extract information from them, such as object keys or specific Array items known ahead of time.

The helper names are inspired by the default functions provided in multiple programming languages for dictionaries, objects, and arrays, such as Python and JavaScript, for their default types.

The individual helpers are defined as an implementation detail and cannot be registered individually.

Parameters

Name	Description
hbs	The Handlebars instance to register the helpers into

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
registerLogicalHelpers(Handlebars& hbs);

Description

This function registers a number of common helpers that perform logical operations.

Parameters

Name	Description
hbs	The Handlebars instance to register the helpers into

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
registerMathHelpers(Handlebars& hbs);

Description

This function registers a number of common helpers that perform mathemathical operations.

Parameters

Name	Description
hbs	The Handlebars instance to register the helpers into

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
registerStringHelpers(Handlebars& hbs);

Description

This function registers a number of common helpers that operate on strings. String helpers are particularly useful because most applications will need to manipulate strings for presentation purposes.

All helpers can be used as either block helpers or inline helpers. When used as a block helper, the block content is used as the first argument to the helper function. When used as an inline helper, the first argument is the value of the helper.

The helper names are inspired by the default string functions provided in multiple programming languages, such as Python and JavaScript, for their default string types.

The individual helpers are defined as an implementation detail and cannot be registered individually.

Parameters

Name	Description
hbs	The Handlebars instance to register the helpers into

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
registerTypeHelpers(Handlebars& hbs);

Description

This function registers a number of common helpers that operate on types, such as identity, type checking, and type conversion.

Parameters

Name	Description
hbs	The Handlebars instance to register the helpers into

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

dom::Value
relativize_fn(
    dom::Value to,
    dom::Value from,
    dom::Value context);

Description

The "relativize" helper makes the first path relative to the second path.

Return Value

A variant container for any kind of Dom value.

Parameters

Name	Description
to	A variant container for any kind of Dom value.
from	A variant container for any kind of Dom value.
context	A variant container for any kind of Dom value.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

dom::Value
select_fn(
    dom::Value const& condition,
    dom::Value const& result_true,
    dom::Value const& result_false);

Description

The "select" helper returns the second argument if the first argument is truthy, and the third argument otherwise.

Return Value

A variant container for any kind of Dom value.

Parameters

Name	Description
condition	A variant container for any kind of Dom value.
result_true	A variant container for any kind of Dom value.
result_false	A variant container for any kind of Dom value.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

int
year_fn();

Description

The "year" helper returns the current year as an integer.

Return Value

The current year as an integer.

Description

These functions abstract over the embedded JavaScript engine so that scripts and helpers can be bound, invoked, and marshalled without leaking engine-specific types into the rest of the codebase.

## Implementation Notes (for Python/Lua integrations)

The current implementation uses JerryScript with the following design choices:

### Context Isolation Each Context owns an independent JerryScript interpreter with its own 512KB heap. This allows multiple threads to execute JavaScript in parallel by giving each thread its own Context. The JERRY_EXTERNAL_CONTEXT build flag enables this multi-context support.

### Scope and Value Lifetime JerryScript uses heap-based reference counting (not a stack like Lua/Duktape). To provide deterministic cleanup similar to stack-based engines:

Scope tracks values created within it and releases one reference to each when the scope ends. Values that were copied elsewhere survive; values that remained local are freed.
Value holds its own reference via jerry_value_copy/jerry_value_free. Values can safely outlive their creating Scope if copied.

### Integer Limitations JerryScript only guarantees 32-bit integer precision. Values outside the int32 range (approximately +/-2 billion) are converted to strings when passed to JavaScript to avoid wraparound bugs. When reading values back, integers that fit in int64 are returned as integers; others remain as doubles.

### DOM to JS Conversion Strategy

Objects: Use lazy Proxy wrappers to avoid infinite recursion from circular references (e.g., Handlebars symbol contexts that reference parent symbols). Properties are converted on-demand when accessed.
Arrays: Converted eagerly (snapshot semantics) because they rarely contain circular references. This means JS mutations don't affect the original C++ array and vice versa.
Functions: Wrapped bidirectionally so JS can call C++ functions and C++ can invoke JS functions through dom::Function.

### Thread Safety Each Context has its own mutex serializing operations on that context. Different Contexts can execute in parallel on different threads. Values hold a shared_ptr to their Context, keeping it alive and using the mutex for all JerryScript operations.

### Port Functions JerryScript requires "port functions" for platform-specific operations. We use the default jerry-port library (JERRY_PORT=ON) for most functions (logging, time, fatal errors, etc.), but provide custom implementations of the context management functions:

jerry_port_context_alloc: Allocates context + heap memory
jerry_port_context_free: Frees context memory
jerry_port_context_get: Returns current thread's active context

The default jerry-port context functions use a static global pointer, limiting all threads to a single shared context. When building with JERRY_EXTERNAL_CONTEXT=ON, these functions are excluded from jerry-port (see third-party/patches/jerryscript/CMakeLists.txt), and mrdocs provides TLS-based implementations that allow each thread to have its own active context, enabling parallel JavaScript execution.

Types

Name	Description
`Array`	Lightweight handle to a JavaScript array.
`Boolean`	Boolean wrapper for JavaScript values.
`Context`	An isolated JavaScript interpreter instance.
`Object`	Object wrapper for JavaScript values.
`Scope`	A JavaScript scope for value lifetime management.
`String`	String wrapper for JavaScript values.
`Value`	An ECMAScript value.

Enums

Name	Description
`Type`	Types of values.

Functions

Name	Description
`operator&&`	Return the first Value that is not truthy, or the last one.
`operator\|\|`	Return the first Value that is truthy, or the last one.
`registerHelper`	Register a JavaScript helper function
`swap`	Swap two values.
`toString`	Return value as a string.
`operator==`	Compare two values for equality.
`operator!=`	Inequality operators
`operator<=>`	Compare two values for inequality.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

class Array;

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

class Boolean;

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

class Context;

Description

Each Context owns an independent JerryScript interpreter with its own 512KB heap. Multiple Contexts can exist simultaneously, allowing parallel JavaScript execution across threads (each thread should use its own Context).

To execute scripts or create values, construct a Scope from the Context. The Scope activates the Context on the current thread and provides methods for script evaluation and value creation.

Contexts can be copied (via copy constructor); copies share the same underlying interpreter and heap. This is useful for passing context references without transferring ownership.

Types

Name	Description
`Impl`	Shared runtime data for a JavaScript context.

Member Functions

Name	Description
`Context` [constructor]	Constructors
`~Context` [destructor]	Destructor.
`operator=` [deleted]	Copy assignment (deleted).

Friends

Name	Description
`mrdocs::js::Scope`	A JavaScript scope for value lifetime management.
`mrdocs::js::Value`	An ECMAScript value.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

struct Impl;

Synopses

Declared in <mrdocs/Support/JavaScript.hpp>

Constructor.

Context();

» more...

Copy constructor.

Context(Context const& other) noexcept;

» more...

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Context();

Description

Creates a new JavaScript interpreter with its own 512KB heap. The interpreter is initialized but inactive until a Scope is created.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Context(Context const& other) noexcept;

Description

Creates a new Context that shares the same underlying interpreter. Both Contexts reference the same heap and global object. This is useful for passing Context references without transferring ownership.

NOTE

Operations on the shared interpreter are serialized by a mutex, so only one thread can execute at a time per interpreter.

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

~Context();

Description

Releases this reference to the interpreter. The underlying JerryScript context is destroyed when the last Context (or Value) referencing it is destroyed.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Context&
operator=(Context const& other) = delete;

Description

Copy assignment is deleted to prevent accidental interpreter sharing. Use the copy constructor explicitly if sharing is intended.

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

class Object;

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

class Scope;

Description

Scope serves two purposes:

1. Value batch tracking: Tracks JavaScript values created within the scope and releases one reference to each when the scope ends. Values that were copied elsewhere (e.g., returned from functions, stored in containers) survive because they hold their own references. Values that remained local to the scope are freed.

2. Thread safety: Each Scope operation briefly locks the Context's mutex and activates the context (sets TLS). This allows multiple threads to share a Context while serializing access to the interpreter. Values obtained from a Scope can be used from other threads; they will acquire the lock as needed.

This provides deterministic cleanup similar to stack-based engines (Lua, Duktape) while working with JerryScript's reference-counted heap.

NOTE

Multiple Scopes can exist for the same Context (even in different threads), but operations are serialized by the Context's mutex.

Member Functions

Name	Description
`Scope` [constructor]	Constructor.
`~Scope` [destructor]	Destructor.
`compile_function`	Compile a script and push results to stack.
`compile_script`	Compile a script and push results to stack.
`eval`	Compile and run a expression.
`getGlobal`	Return a global object if it exists.
`getGlobalObject`	Return the global object.
`pushArray`	Push a new array to the stack
`pushBoolean`	Push a boolean to the stack
`pushDouble`	Push a double to the stack
`pushInteger`	Push an integer to the stack
`pushObject`	Push a new object to the stack
`pushString`	Push a string to the stack
`script`	Compile and run a script.
`setGlobal`	Set a global object.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Scope(Context const& ctx) noexcept;

Description

Records the context for this scope. The context's mutex is NOT held for the lifetime of the Scope; instead, each operation locks briefly.

Parameters

Name	Description
ctx	The context to use.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

~Scope();

Description

Releases one reference to each value created within this scope. Values whose reference count drops to zero are freed; values that were copied elsewhere survive.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Expected<Value>
compile_function(std::string_view jsCode);

Description

Coerces provided source into a callable function. First parenthesizes the source to force expression parsing; if that fails, executes the script and returns the first declared function name. Ambiguous sources may run side effects twice (expression attempt + fallback) matching existing behavior.

Return Value

A function object that can be called. The function object has the number of arguments defined in the code. If the code does not define a function, an error is returned.

Parameters

Name	Description
jsCode	The JavaScript code to compile.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Expected<Value>
compile_script(std::string_view jsCode);

Description

Wraps arbitrary script text in an IIFE that calls eval when invoked, returning the last expression result. Function declarations are rejected to avoid silent re-declarations. Side effects in the script run at invocation time.

Return Value

A function object that can be called. The function object has zero arguments.

Parameters

Name	Description
jsCode	The JavaScript code to compile.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Expected<Value>
eval(std::string_view jsCode);

Description

This function compiles and executes the specified JavaScript code. The script can be used to execute commands or define global variables in the parent context.

It evaluates the ECMAScript source code and converts any internal errors to Error.

Return Value

A container holding an error or a value.

Parameters

Name	Description
jsCode	The JavaScript code to execute.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Expected<Value>
getGlobal(std::string_view name);

Description

This function returns a Value that represents a global variable in the parent context.

If the variable does not exist, an error is returned.

Return Value

a global object if it exists.

Parameters

Name	Description
name	The name of the global variable.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value
getGlobalObject();

Description

This function returns a Value that represents the global object in the parent context.

Name	Description
value	The boolean value to push.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value
pushDouble(double value);

Return Value

A Value representing the double.

Parameters

Name	Description
value	The double value to push.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value
pushInteger(int64_t value);

Return Value

A Value representing the integer.

Parameters

Name	Description
value	The integer value to push.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value
pushObject();

Return Value

An ECMAScript value.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value
pushString(std::string_view value);

Return Value

A Value representing the string.

Parameters

Name	Description
value	The string value to push. The string is copied to the internal heap.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Expected<void>
script(std::string_view jsCode);

Description

This function compiles and executes the specified JavaScript code. The script can be used to execute commands or define global variables in the parent context.

ES module import/export is not enabled; scripts must be self-contained or rely on globals.

It evaluates the ECMAScript source code and converts any internal errors to Error.

Return Value

A container holding an error or a value.

Parameters

Name	Description
jsCode	The JavaScript code to execute.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

void
setGlobal(
    std::string_view name,
    dom::Value const& value);

Parameters

Name	Description
name	The name of the global variable.
value	The value to set.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

class String;

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

class Value;

Description

This class represents a value in the JavaScript interpreter.

A value is a variable that is defined in a Scope. It can be a primitive type or an object.

A Value not associated with a Scope is undefined.

The user is responsible for ensuring that the lifetime of a Value does not exceed the lifetime of the Scope that created it.

A value can be converted to a DOM value using the getDom function.

Generic JavaScript value wrapper.

An ECMAScript value.

This class represents a value in the JavaScript interpreter.

A value is a variable that is defined in a Scope. It can be a primitive type or an object.

A Value not associated with a Scope is undefined.

The user is responsible for ensuring that the lifetime of a Value does not exceed the lifetime of the Scope that created it.

A value can be converted to a DOM value using the getDom function.

Member Functions

Name	Description
`Value` [constructor]	Constructor
`~Value` [destructor]	Destructor
`operator=`	Assignment operators
`apply`	`apply` overloads
`call`	Invoke a function.
`empty`	Return if an Array or Object is empty.
`erase`	Remove a property from an object if it exists.
`exists`	Return true if a key exists.
`get`	`get` overloads
`getArray`	Return the underlying array.
`getBool`	Return the underlying boolean value.
`getDom`	Return the value as a dom::Value
`getDouble`	Return the underlying double value.
`getFunction`	Return the underlying array.
`getInteger`	Return the underlying integer value.
`getObject`	Return the underlying object.
`getString`	Return the underlying string
`isArray`	Check if the value is an array.
`isBoolean`	Check if the value is a boolean.
`isDouble`	Check if the value is a floating point number.
`isFunction`	Check if the value is a function.
`isInteger`	Check if the value is an integer number.
`isNull`	Check if the value is null.
`isNumber`	Check if the value is a number.
`isObject`	Check if the value is an object.
`isString`	Check if the value is a string.
`isTruthy`	Determine if a value is truthy
`isUndefined`	Check if the value is undefined.
`lookup`	Lookup a sequence of keys.
`operator()`	Invoke a function.
`operator[]`	Subscript operators
`set`	Set or replace the value for a given key.
`size`	Return if an Array or Object is empty.
`swap`	Swap two values.
`type`	Return the type of the value.
`operator std::string`	Return the string.
`operator bool`	Determine if a value is truthy

Protected Member Functions

Name	Description
`Value` [constructor]	Wrap an existing engine value without transferring ownership.

Protected Data Members

Name	Description
`impl_`	Shared lifetime owner for the underlying JavaScript runtime.
`val_`	Opaque engine value handle stored as an integer (engine-specific inside the implementation).

Friends

Name	Description
`mrdocs::js::toString`	Return value as a string.
`mrdocs::js::operator&&`
`mrdocs::js::operator&&`
`mrdocs::js::operator&&`	Return the first Value that is not truthy, or the last one.
`mrdocs::js::operator\|\|`
`mrdocs::js::operator\|\|`
`mrdocs::js::operator\|\|`	Return the first Value that is truthy, or the last one.
`mrdocs::js::operator<=>`	Compare two values for inequality.
`mrdocs::js::operator!=`
`mrdocs::js::operator!=`
`mrdocs::js::operator!=`	Inequality operator
`mrdocs::js::operator==`
`mrdocs::js::operator==`
`mrdocs::js::operator==`	Compare two values for equality.
`mrdocs::js::swap`	Swap two values.
`mrdocs::js::Scope`	A JavaScript scope for value lifetime management.

Synopses

Declared in <mrdocs/Support/JavaScript.hpp>

Constructor

Value() noexcept;

» more...

Constructor

Value(Value const& other);

» more...

Constructor

Value(Value&& other) noexcept;

» more...

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value() noexcept;

Description

Construct a value that is not associated with a Scope.

The value is undefined.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value(Value const& other);

Description

Duplicates the underlying engine handle held by value and shares the same runtime state.

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value(Value&& other) noexcept;

Description

The function associates the existing value with this object.

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

~Value();

Description

Releases the underlying engine handle; lifetime is tied to the shared Context::Impl, not to a stack frame.

Synopses

Declared in <mrdocs/Support/JavaScript.hpp>

Copy assignment.

Value&
operator=(Value const& other);

» more...

Move assignment.

Value&
operator=(Value&& other) noexcept;

» more...

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value&
operator=(Value const& other);

Description

Duplicates the underlying engine handle held by value and shares the same runtime state.

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value&
operator=(Value&& other) noexcept;

Description

The function associates the existing value with this object.

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to move assign from

Synopses

Declared in <mrdocs/Support/JavaScript.hpp>

Invoke a function with an initializer_list of arguments.

Expected<Value>
apply(std::initializer_list<dom::Value> args) const;

» more...

Invoke a function with a span of arguments.

Expected<Value>
apply(std::span<dom::Value const> args) const;

» more...

Return Value

The return value of the function.

Parameters

Name	Description
args	Arguments to pass to the JavaScript function.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Expected<Value>
apply(std::initializer_list<dom::Value> args) const;

Return Value

The return value of the function.

Parameters

Name	Description
args	Arguments to pass to the JavaScript function.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Expected<Value>
apply(std::span<dom::Value const> args) const;

Return Value

The return value of the function.

Parameters

Name	Description
args	Arguments to pass to the JavaScript function.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

template<std::convertible_to<dom::Value>... Args>
Expected<Value>
call(Args&&... args) const;

Return Value

The return value of the method.

Parameters

Name	Description
args	Zero or more arguments to pass to the method.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

bool
empty() const;

Return Value

if an Array or Object is empty.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

void
erase(std::string_view key) const;

Parameters

Name	Description
key	Property name to erase from the current object.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

bool
exists(std::string_view key) const;

Return Value

true if the key exists, false otherwise.

Parameters

Name	Description
key	The key to check for.

Synopses

Declared in <mrdocs/Support/JavaScript.hpp>

Return the element at a given index.

Value
get(std::size_t i) const;

» more...

Return the element for a given key.

Value
get(std::string_view key) const;

» more...

Return the element at a given index or key.

Value
get(dom::Value const& i) const;

» more...

Return the element for a given key.

template<std::convertible_to<std::string_view> S>
Value
get(S const& key) const;

» more...

Return Value

The element at the given index, or a Value of type Kind::Undefined if the index is out of range.
The element for the given key, or a Value of type Kind::Undefined if the key is not found.

Parameters

Name	Description
i	The index of the element to return.
key	The key to look up.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value
get(std::size_t i) const;

Return Value

The element at the given index, or a Value of type Kind::Undefined if the index is out of range.

Parameters

Name	Description
i	The index of the element to return.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value
get(std::string_view key) const;

Description

If the Value is not an object, or the key is not found, a Value of type Kind::Undefined is returned.

Return Value

The element for the given key, or a Value of type Kind::Undefined if the key is not found.

Parameters

Name	Description
key	The key to look up.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value
get(dom::Value const& i) const;

Return Value

the element at a given index or key.

Parameters

Name	Description
i	A variant container for any kind of Dom value.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

template<std::convertible_to<std::string_view> S>
Value
get(S const& key) const;

Description

If the Value is not an object, or the key is not found, a Value of type Kind::Undefined is returned.

Return Value

The element for the given key, or a Value of type Kind::Undefined if the key is not found.

Parameters

Name	Description
key	The key to look up.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

dom::Array
getArray() const noexcept;

Description

NOTE

Behaviour is undefined if !isArray()

Return Value

the underlying array.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

bool
getBool() const noexcept;

Description

NOTE

Behaviour is undefined if !isBoolean()

Return Value

the underlying boolean value.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

dom::Value
getDom() const;

Description

This function returns the value as a dom::Value.

If the value is a primitive type, it is converted to a DOM primitive.

If the value is an object, a type with reference semantics to access the underlying DOM object is returned.

Return Value

the value as a dom::Value

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

double
getDouble() const noexcept;

Description

NOTE

Behaviour is undefined if !isNumber()

Return Value

the underlying double value.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

dom::Function
getFunction() const noexcept;

Description

NOTE

Behaviour is undefined if !isFunction()

Return Value

the underlying array.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

int64_t
getInteger() const noexcept;

Description

NOTE

Behaviour is undefined if !isNumber()

Return Value

the underlying integer value.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

dom::Object
getObject() const noexcept;

Description

NOTE

Behaviour is undefined if !isObject()

Return Value

the underlying object.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

std::string
getString() const;

Description

This function returns the value as a string.

This function performs no coercions. If the value is not a string, it is not converted to a string.

JerryScript allocates a new buffer for string extraction, so the returned value is an owning std::string rather than a view.

NOTE

bool
isInteger() const noexcept;

Description

All numbers are internally represented by IEEE doubles, which are capable of representing all integers up to 53 bits accurately.

This function returns true if the value is a number with no precision loss when representing an integer.

When isNumber() is true, the function behaves as if evaluating the condition d == static_cast<double>(static_cast<int>(d)) where d is the result of toDouble().

Return Value

true if the value is a number with no fractional part, false otherwise

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

bool
isNull() const noexcept;

Return Value

true if the value is null, false otherwise

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

bool
isNumber() const noexcept;

Description

In ECMA, the number type is an IEEE double, including +/- Infinity and NaN values.

Zero sign is also preserved.

An IEEE double can represent all integers up to 53 bits accurately.

The user should not rely on NaNs preserving their exact non-normalized form.

Return Value

true if the value is a number, false otherwise

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

bool
isObject() const noexcept;

Description

Check if the value is an object but not an array or function.

true if the value is truthy, false otherwise

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

bool
isUndefined() const noexcept;

Return Value

true if the value is undefined, false otherwise

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value
lookup(std::string_view keys) const;

Description

This function is equivalent to calling get multiple times, once for each key in the sequence of dot-separated keys.

Return Value

The value at the end of the sequence, or a Value of type Kind::Undefined if any key is not found.

Parameters

Name	Description
keys	A sequence of keys separated by dots.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

template<class... Args>
Value
operator()(Args&&... args) const;

Return Value

The return value of the method.

Parameters

Name	Description
args	Zero or more arguments to pass to the method.

Synopses

Declared in <mrdocs/Support/JavaScript.hpp>

Return the element for an array index.

Value
operator[](std::size_t index) const;

» more...

Return the element for a property name.

Value
operator[](std::string_view key) const;

» more...

Return Value

The element for the given index, or undefined if out of bounds / not an array.
The element for the given key, or undefined if missing / not an object.

Parameters

Name	Description
index	Zero-based array index to fetch when the value is an array.
key	Property name to fetch from the current object.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value
operator[](std::size_t index) const;

Return Value

The element for the given index, or undefined if out of bounds / not an array.

Parameters

Name	Description
index	Zero-based array index to fetch when the value is an array.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value
operator[](std::string_view key) const;

Return Value

The element for the given key, or undefined if missing / not an object.

Parameters

Name	Description
key	Property name to fetch from the current object.

Synopses

Declared in <mrdocs/Support/JavaScript.hpp>

Set or replace the value for a given key.

void
set(
    std::string_view key,
    Value const& value) const;

» more...

Set or replace the value for a given key.

void
set(
    std::string_view key,
    dom::Value const& value) const;

» more...

Parameters

Name	Description
key	The key to set.
value	The value to set.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

void
set(
    std::string_view key,
    Value const& value) const;

Parameters

Name	Description
key	The key to set.
value	The value to set.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

void
set(
    std::string_view key,
    dom::Value const& value) const;

Parameters

Name	Description
key	The key to set.
value	The value to set.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

std::size_t
size() const;

Return Value

if an Array or Object is empty.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

void
swap(Value& other) noexcept;

Parameters

Name	Description
other	An ECMAScript value.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Type
type() const noexcept;

Description

This function returns the JavaScript type of the value.

The type can represent a primitive type (such as boolean, number, and string) or an object.

When the type is an object, the return type also classifies the object as an array or function.

true if the value is truthy, false otherwise

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value(
    uint32_t val,
    std::shared_ptr<Context::Impl> impl) noexcept;

Parameters

Name	Description
val	JerryScript value handle that will be acquired.
impl	Shared runtime state that keeps the context alive.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

std::shared_ptr<Context::Impl> impl_;

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

uint32_t val_;

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

enum class Type : int;

Members

Name	Description
`undefined`	The value is undefined
`null`	The value is null
`boolean`	The value is a boolean
`number`	The value is a number
`string`	The value is a string
`object`	The value is an object
`function`	The value is a function
`array`	The value is an array

Synopses

Declared in <mrdocs/Support/JavaScript.hpp>

auto
operator&&(
    S const& lhs,
    Value const& rhs) noexcept;

» more...

auto
operator&&(
    Value const& lhs,
    S const& rhs) noexcept;

» more...

Return the first Value that is not truthy, or the last one.

Value
operator&&(
    Value const& lhs,
    Value const& rhs);

» more...

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

auto
operator&&(
    S const& lhs,
    Value const& rhs) noexcept;

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

auto
operator&&(
    Value const& lhs,
    S const& rhs) noexcept;

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value
operator&&(
    Value const& lhs,
    Value const& rhs);

Description

This function is equivalent to the JavaScript && operator.

Return Value

the first Value that is not truthy, or the last one.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopses

Declared in <mrdocs/Support/JavaScript.hpp>

auto
operator||(
    S const& lhs,
    Value const& rhs) noexcept;

» more...

auto
operator||(
    Value const& lhs,
    S const& rhs) noexcept;

» more...

Return the first Value that is truthy, or the last one.

Value
operator||(
    Value const& lhs,
    Value const& rhs);

» more...

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

auto
operator||(
    S const& lhs,
    Value const& rhs) noexcept;

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

auto
operator||(
    Value const& lhs,
    S const& rhs) noexcept;

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

Value
operator||(
    Value const& lhs,
    Value const& rhs);

Description

This function is equivalent to the JavaScript || operator.

Return Value

the first Value that is truthy, or the last one.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

[[nodiscard]]
Expected<void, Error>
registerHelper(
    mrdocs::Handlebars& hbs,
    std::string_view name,
    Context& ctx,
    std::string_view script);

Description

This function registers a JavaScript function as a helper function that can be called from Handlebars templates.

The helper source is resolved in the following order:

1. Parenthesized eval - wraps the script in parentheses and evaluates. Handles function declarations without side effects. Example: "function add(a, b) { return a + b; }"

2. Direct eval - evaluates the script as-is. Handles IIFEs and expressions that return functions. Example: "(function(){ return function(x){ return x*2; }; })()"

3. Global lookup - looks up the helper name on the global object. Handles scripts that define globals before returning. Example: "var helper = function(x){ return x; }; helper;"

The resolved function is stored on the shared MrDocsHelpers global object and registered with Handlebars. When invoked, positional arguments are passed to the JavaScript function (the Handlebars options object is stripped to avoid expensive recursive conversion of symbol contexts).

Return Value

Success, or an error if the script could not be resolved to a function

Parameters

Name	Description
hbs	The Handlebars instance to register the helper into
name	The name of the helper function
ctx	The JavaScript context to use
script	The JavaScript code that defines the helper function

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

void
swap(
    Value& v0,
    Value& v1) noexcept;

Parameters

Name	Description
v0	An ECMAScript value.
v1	An ECMAScript value.

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

std::string
toString(Value const& value);

Description

This function coerces any value to a string.

Return Value

value as a string.

Parameters

Name	Description
value	An ECMAScript value.

Synopses

Declared in <mrdocs/Support/JavaScript.hpp>

auto
operator==(
    Value const& lhs,
    S const& rhs) noexcept;

» more...

auto
operator==(
    S const& lhs,
    Value const& rhs) noexcept;

» more...

Compare two values for equality.

bool
operator==(
    Value const& lhs,
    Value const& rhs) noexcept;

» more...

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

auto
operator==(
    Value const& lhs,
    S const& rhs) noexcept;

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

auto
operator==(
    S const& lhs,
    Value const& rhs) noexcept;

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

bool
operator==(
    Value const& lhs,
    Value const& rhs) noexcept;

Description

This operator uses strict equality, meaning that the types must match exactly, and for objects and arrays the children must match exactly.

The == operator behaves differently for objects compared to primitive data types like numbers and strings. When comparing objects using ==, it checks for reference equality, not structural equality.

This means that two objects are considered equal with === only if they reference the exact same object in memory.

NOTE

In JavaScript, this is equivalent to the === operator, which does not perform type conversions.

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopses

Declared in <mrdocs/Support/JavaScript.hpp>

auto
operator!=(
    Value const& lhs,
    S const& rhs) noexcept;

» more...

auto
operator!=(
    S const& lhs,
    Value const& rhs) noexcept;

» more...

Inequality operator

bool
operator!=(
    Value const& lhs,
    Value const& rhs) noexcept;

» more...

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

auto
operator!=(
    Value const& lhs,
    S const& rhs) noexcept;

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

auto
operator!=(
    S const& lhs,
    Value const& rhs) noexcept;

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

bool
operator!=(
    Value const& lhs,
    Value const& rhs) noexcept;

Return Value

true if the objects are not equal, false otherwise

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Support/JavaScript.hpp>

std::strong_ordering
operator<=>(
    Value const& lhs,
    Value const& rhs) noexcept;

Return Value

The relative order of the objects

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Description

This namespace contains glue for pushing/popping values, registering functions, and safely executing snippets so embedders can enable Lua without duplicating binding code.

Types

Name	Description
`Access`	Internal tag granting access to lua internals.
`Context`	A reference to an instance of a Lua interpreter.
`Function`	A Lua function.
`Param`	A lazy container to push values to the Lua stack.
`Scope`	Stack scope guard for Lua calls.
`String`	A Lua string.
`Table`	A Lua table.
`Value`	A Lua value.
`zstring`	A null-terminated string.

Type Aliases

Name	Description
`FunctionPtr`	Pointer to a Lua-callable function returning Value.

Enums

Name	Description
`Type`	Types of values.

Functions

Name	Description
`registerHelper`	Register a Lua helper function

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

using FunctionPtr = Value(*)(std::vector<Value>);

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

struct Access;

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

class Context;

Member Functions

Name	Description
`Context` [constructor]	Constructor.
`~Context` [destructor]	Destructor.
`operator=` [deleted]	Copy assignment.
`nativeState`	Return the underlying `lua_State*`.

Friends

Name	Description
`mrdocs::lua::Scope`	Stack scope guard for Lua calls.
`mrdocs::lua::Access`	Internal tag granting access to lua internals.

Synopses

Declared in <mrdocs/Support/Lua.hpp>

Constructor.

Context();

» more...

Constructor.

Context(Context const& other) noexcept;

» more...

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Context();

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Context(Context const& other) noexcept;

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

~Context();

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Context&
operator=(Context const& other) = delete;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

void*
nativeState() const noexcept;

Description

Exposed as void* so callers don't have to drag lua.h into the public API. Cast to lua_State* at the use site. The state is owned by this Context and must not be lua_closed by the caller; use this only when the wrapper does not yet abstract the operation you need (for example, registering a native C function that the script can call as a global).

Return Value

the underlying lua_State*.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

class Function
    : public Value

Base Classes

Name	Description
`Value`	A Lua value.

Member Functions

Name	Description
`Function` [constructor]	Construct a function wrapper from an existing value.
`call`	Invoke the value as a function.
`displayString`	Return a string representation.
`isBoolean`	Return true if the value is a boolean.
`isFunction`	Return true if the value is a function.
`isNil`	Return true if the value is nil.
`isNumber`	Return true if the value is numeric.
`isString`	Return true if the value is a string.
`isTable`	Return true if the value is a table.
`operator()`	Invoke the value as a function.
`type`	Return the Lua type of this value.

Protected Data Members

Name	Description
`index_`	Stack index where the value is stored.
`scope_`	Scope that owns the stack slot for this value.

Friends

Name	Description
`mrdocs::lua::Access`	Internal tag granting access to lua internals.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Function(Value value);

Parameters

Name	Description
value	The object to construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

class Param;

Member Functions

Name	Description
`Param` [constructor] [deleted]	Constructors
`~Param` [destructor]	Destroy the stored value without throwing.
`operator=` [deleted]	Deleted copy assignment to avoid double pops.

Data Members

Name	Description
`arr_` [variant member]	Stored array when kind_ == domArray.
`b_` [variant member]	Stored boolean value when kind_ == boolean.
`i_` [variant member]	Stored integer value when kind_ == integer.
`index_` [variant member]	Stack index when kind_ == value.
`obj_` [variant member]	Stored object when kind_ == domObject.
`s_` [variant member]	Stored string view when kind_ == string.

Friends

Name	Description
`mrdocs::lua::Access`	Internal tag granting access to lua internals.

Synopses

Declared in <mrdocs/Support/Lua.hpp>

Deleted copy constructor to avoid double pops.

Param(Param const& other) = delete;

» more...

Construct from a DOM array.

Param(dom::Array arr) noexcept;

» more...

Construct from a DOM object.

Param(dom::Object obj) noexcept;

» more...

Construct an integer parameter.

Param(int64_t value) noexcept;

» more...

Construct a nil parameter.

Param(std::nullptr_t value) noexcept;

» more...

Construct a string parameter (non-owning).

Param(std::string_view s) noexcept;

» more...

Construct from a Lua Value already on the stack.

Param(Value const& value) noexcept;

» more...

Construct from a generic DOM value.

Param(dom::Value const& value) noexcept;

» more...

Construct a string parameter from C-string.

Param(char const* s) noexcept;

» more...

Construct an integral parameter from an enum.

template<class Enum>
requires std::is_enum_v<Enum>
Param(Enum v) noexcept;

» more...

Construct a boolean parameter from a bool-like type.

template<class Boolean>
requires std::is_same_v<Boolean, bool>
Param(Boolean const& b) noexcept;

» more...

Construct a string parameter from a convertible string type.

template<class String>
requires std::is_convertible_v<
        String, std::string_view>
Param(String const& s);

» more...

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Param(Param const& other) = delete;

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Param(dom::Array arr) noexcept;

Parameters

Name	Description
arr	The object to construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Param(dom::Object obj) noexcept;

Parameters

Name	Description
obj	The object to construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Param(int64_t value) noexcept;

Parameters

Name	Description
value	The object to construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Param(std::nullptr_t value) noexcept;

Parameters

Name	Description
value	The object to construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Param(std::string_view s) noexcept;

Parameters

Name	Description
s	The object to construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Param(Value const& value) noexcept;

Parameters

Name	Description
value	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Param(dom::Value const& value) noexcept;

Parameters

Name	Description
value	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Param(char const* s) noexcept;

Parameters

Name	Description
s	The value to construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

template<class Enum>
requires std::is_enum_v<Enum>
Param(Enum v) noexcept;

Parameters

Name	Description
v	The object to construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

template<class Boolean>
requires std::is_same_v<Boolean, bool>
Param(Boolean const& b) noexcept;

Parameters

Name	Description
b	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

template<class String>
requires std::is_convertible_v<
        String, std::string_view>
Param(String const& s);

Parameters

Name	Description
s	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

~Param();

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Param&
operator=(Param const& other) = delete;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

dom::Array arr_;

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

bool b_;

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

int i_;

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

int index_;

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

dom::Object obj_;

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

std::string_view s_;

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

class Scope;

Description

Helper that balances the Lua stack for a Context scope.

Member Functions

Name	Description
`Scope` [constructor]	Create a scope that manages Lua stack references.
`~Scope` [destructor]	Pop any pending stack references on destruction.
`getGlobal`	Return a value from the global table if it exists.
`getGlobalTable`	Return the global table.
`loadChunk`	Load a Lua chunk
`loadChunkFromFile`	Run a Lua chunk.
`pushDom`	Push a dom::Value onto the Lua stack.

Friends

Name	Description
`mrdocs::lua::Access`	Internal tag granting access to lua internals.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Scope(Context const& ctx) noexcept;

Parameters

Name	Description
ctx	Lua context to guard.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

~Scope();

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Expected<Value>
getGlobal(
    std::string_view key,
    std::source_location loc = source_location::current());

Return Value

The value if it exists, or an error.

Parameters

Name	Description
key	The key to get.
loc	The source location of the call site.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Table
getGlobalTable();

Return Value

the global table.

Synopses

Declared in <mrdocs/Support/Lua.hpp>

Load a Lua chunk

Expected<Function>
loadChunk(
    std::string_view luaChunk,
    std::source_location loc = source_location::current());

» more...

Load a Lua chunk

Expected<Function>
loadChunk(
    std::string_view luaChunk,
    zstring chunkName,
    std::source_location loc = source_location::current());

» more...

Return Value

The function if successful, or an error.

Parameters

Name	Description
luaChunk	The Lua chunk to load.
loc	The source location of the call site.
chunkName	The name of the chunk (used in error messages).

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Expected<Function>
loadChunk(
    std::string_view luaChunk,
    std::source_location loc = source_location::current());

Return Value

The function if successful, or an error.

Parameters

Name	Description
luaChunk	The Lua chunk to load.
loc	The source location of the call site.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Expected<Function>
loadChunk(
    std::string_view luaChunk,
    zstring chunkName,
    std::source_location loc = source_location::current());

Return Value

The function if successful, or an error.

Parameters

Name	Description
luaChunk	The Lua chunk to load.
chunkName	The name of the chunk (used in error messages).
loc	The source location of the call site.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Expected<Function>
loadChunkFromFile(
    std::string_view fileName,
    std::source_location loc = source_location::current());

Return Value

The function if successful, or an error.

Parameters

Name	Description
fileName	The name of the file to load.
loc	The source location of the call site.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Value
pushDom(dom::Value const& value);

Description

Primitives (nil, boolean, integer, string) are pushed as their Lua-native counterparts. Arrays and objects are pushed as userdata wrapping the underlying dom container, with the same lazy bindings used elsewhere in the wrapper.

Return Value

A Value referring to the new stack slot.

Parameters

Name	Description
value	The DOM value to push.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

class String
    : public Value

Base Classes

Name	Description
`Value`	A Lua value.

Member Functions

Name	Description
`String` [constructor]	Constructors
`call`	Invoke the value as a function.
`displayString`	Return a string representation.
`get`	Retrieve the underlying string view.
`isBoolean`	Return true if the value is a boolean.
`isFunction`	Return true if the value is a function.
`isNil`	Return true if the value is nil.
`isNumber`	Return true if the value is numeric.
`isString`	Return true if the value is a string.
`isTable`	Return true if the value is a table.
`operator()`	Invoke the value as a function.
`operator*`	Dereference to the underlying string view.
`type`	Return the Lua type of this value.
`operator std::string_view`	Implicit conversion to string view.

Protected Data Members

Name	Description
`index_`	Stack index where the value is stored.
`scope_`	Scope that owns the stack slot for this value.

Friends

Name	Description
`mrdocs::lua::Access`	Internal tag granting access to lua internals.

Synopses

Declared in <mrdocs/Support/Lua.hpp>

Wrap an existing Lua value as a string.

String(Value value);

» more...

Create a new Lua string from the given view.

explicit
String(std::string_view s);

» more...

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

String(Value value);

Parameters

Name	Description
value	The object to construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

explicit
String(std::string_view s);

Parameters

Name	Description
s	The object to construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

std::string_view
get() const noexcept;

Return Value

View of the Lua string contents.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

std::string_view
operator*() const noexcept;

Return Value

View of the Lua string contents.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

operator std::string_view() const noexcept;

Return Value

The object converted to string_view

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

class Table
    : public Value

Base Classes

Name	Description
`Value`	A Lua value.

Member Functions

Name	Description
`Table` [constructor]	Constructors
`call`	Invoke the value as a function.
`displayString`	Return a string representation.
`get`	Retrieve a table entry by key; returns nil if missing.
`isBoolean`	Return true if the value is a boolean.
`isFunction`	Return true if the value is a function.
`isNil`	Return true if the value is nil.
`isNumber`	Return true if the value is numeric.
`isString`	Return true if the value is a string.
`isTable`	Return true if the value is a table.
`operator()`	Invoke the value as a function.
`set`	Create or replace the value with a key.
`type`	Return the Lua type of this value.

Protected Data Members

Name	Description
`index_`	Stack index where the value is stored.
`scope_`	Scope that owns the stack slot for this value.

Friends

Name	Description
`mrdocs::lua::Access`	Internal tag granting access to lua internals.

Synopses

Declared in <mrdocs/Support/Lua.hpp>

Wrap an existing Lua value as a table.

Table(Value value);

» more...

Create an empty table in the given scope.

explicit
Table(Scope& scope);

» more...

Construct a table by copying fields from a DOM object.

Table(
    Scope& scope,
    dom::Object const& obj);

» more...

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Table(Value value);

Parameters

Name	Description
value	The object to construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

explicit
Table(Scope& scope);

Parameters

Name	Description
scope	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Table(
    Scope& scope,
    dom::Object const& obj);

Parameters

Name	Description
scope	The object to copy construct from
obj	A container of key and value pairs.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Value
get(std::string_view key) const;

Return Value

Value stored at key or nil if absent.

Parameters

Name	Description
key	Table key to look up.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

void
set(
    std::string_view key,
    Param value) const;

Parameters

Name	Description
key	The key to set.
value	The value to set.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

class Value;

Member Functions

Name	Description
`Value` [constructor]	Constructor.
`~Value` [destructor]	Destructor.
`call`	Invoke the value as a function.
`displayString`	Return a string representation.
`isBoolean`	Return true if the value is a boolean.
`isFunction`	Return true if the value is a function.
`isNil`	Return true if the value is nil.
`isNumber`	Return true if the value is numeric.
`isString`	Return true if the value is a string.
`isTable`	Return true if the value is a table.
`operator()`	Invoke the value as a function.
`type`	Return the Lua type of this value.

Protected Member Functions

Name	Description
`Value` [constructor]	Create a value referring to a stack slot within a scope.

Protected Data Members

Name	Description
`index_`	Stack index where the value is stored.
`scope_`	Scope that owns the stack slot for this value.

Friends

Name	Description
`mrdocs::lua::Access`	Internal tag granting access to lua internals.

Derived Classes

Name	Description
`Function`	A Lua function.
`String`	A Lua string.
`Table`	A Lua table.

Synopses

Declared in <mrdocs/Support/Lua.hpp>

Constructor.

Value() noexcept;

» more...

Constructor.

Value(Value const& other);

» more...

Constructor.

Value(Value&& other) noexcept;

» more...

Parameters

Name	Description
other	The value to copy.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Value() noexcept;

Description

Default constructed values have no scope or assigned stack index and are equivalent to the value Nil.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Value(Value const& other);

Description

The new value will be assigned a new stack index which has the same underlying value as other.

Parameters

Name	Description
other	The value to copy.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Value(Value&& other) noexcept;

Description

The newly constructed object will acquire the same stack index, while the moved-from object will become as if default-constructed.

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

~Value();

Description

The Lua value will eventually be removed from the stack.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

template<class... Args>
Expected<Value>
call(Args&&... args);

Description

If the invocation fails the return value will contain the corresponding error.

Return Value

The return value of the function.

Parameters

Name	Description
args	Zero or more values to pass to the function.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

std::string
displayString() const;

Description

template<class... Args>
Value
operator()(Args&&... args);

Return Value

Another instance of the object

Parameters

Name	Description
args	Zero or more values to pass to the function.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Type
type() const noexcept;

Return Value

the Lua type of this value.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Value(
    int position,
    Scope& scope) noexcept;

Parameters

Name	Description
position	The value to construct from
scope	Stack scope guard for Lua calls.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

int index_;

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

Scope* scope_;

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

class zstring;

Member Functions

Name	Description
`zstring` [constructor]	Constructors
`c_str`	Return the underlying C-string pointer.

Synopses

Declared in <mrdocs/Support/Lua.hpp>

Construct from string_view (stores an owned copy).

zstring(std::string_view s);

» more...

Construct from std::string without copying.

zstring(std::string const& s);

» more...

Construct from a C-string pointer.

zstring(char const* s) noexcept;

» more...

Parameters

Name	Description
s	String view to copy.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

zstring(std::string_view s);

Parameters

Name	Description
s	String view to copy.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

zstring(std::string const& s);

Parameters

Name	Description
s	Source string.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

zstring(char const* s) noexcept;

Parameters

Name	Description
s	Null-terminated string.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

char const*
c_str() const noexcept;

Return Value

the underlying C-string pointer.

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

enum class Type : int;

Members

Name	Description
`nil`	The value is nil
`boolean`	The value is a boolean
`number`	The value is a number
`string`	The value is a string
`table`	The value is a table
`function`	The value is a function

Synopsis

Declared in <mrdocs/Support/Lua.hpp>

[[nodiscard]]
Expected<void, Error>
registerHelper(
    mrdocs::Handlebars& hbs,
    std::string_view name,
    Context& ctx,
    std::string_view script);

Description

Register a Lua chunk as a Handlebars helper. The chunk source is resolved to a callable in the following order:

1. Chunk return value - load and execute the chunk; if it returns a function, use that. This is the idiomatic shape for a per-file helper: Example: return function(x) return 'lua:' .. tostring(x) end

2. Global lookup - if the chunk does not return a function, look up the helper name on the global table. This handles chunks that define a function as a side effect: Example: function helper_name(x) return tostring(x) end

The resolved function is anchored in LUA_REGISTRYINDEX for the lifetime of the registration. When the helper is invoked from a template, positional arguments are converted from dom::Value to Lua values; the trailing Handlebars options object is dropped (matching the JavaScript helper semantics) to avoid recursive marshalling of symbol contexts.

Return Value

Success, or an error if the script could not be resolved to a function

Parameters

Name	Description
hbs	The Handlebars instance to register the helper into
name	The name of the helper function
ctx	The Lua context that anchors the helper closure
script	The Lua source that defines the helper function

Description

The report namespace owns severity enums, message structs, and output sinks so tooling and libraries emit diagnostics in a uniform, testable format regardless of UI.

Types

Name	Description
`Located`	Parameter type that adds a source location to a value.
`Results`	Provides statistics on the number of reported messages.

Enums

Name	Description
`Level`	Severity levels attached to reported messags.

Functions

Name	Description
`debug`	Emit a debug-level diagnostic for troubleshooting.
`error`	Emit an error that indicates failure but allows continuation.
`fatal`	Emit a fatal error and mark the report as the highest severity.
`getMinimumLevel`	Get the minimum threshold level for reporting.
`info`	Emit an informational message for users.
`log`	Format a message to the console.
`print`	Report a message to the console.
`setMinimumLevel`	Set the minimum threshold level for reporting.
`setSourceLocationWarnings`	If true, source location information will be printed with warnings, errors, and fatal messages.
`trace`	Emit a trace-level diagnostic (verbose, off by default).
`warn`	Emit a warning that does not stop execution.

Variables

Name	Description
`results`	Holds current statistics on reported messages.

Synopsis

Declared in <mrdocs/Support/Report.hpp>

template<class T>
struct Located;

Member Functions

Name	Description
`Located` [constructor]	Construct a Located wrapper.

Data Members

Name	Description
`value`	Wrapped value.
`where`	Source location of the value.

Non-Member Functions

Name	Description
`debug`	Emit a debug-level diagnostic for troubleshooting.
`error`	Emit an error that indicates failure but allows continuation.
`fatal`	Emit a fatal error and mark the report as the highest severity.
`info`	Emit an informational message for users.
`trace`	Emit a trace-level diagnostic (verbose, off by default).
`warn`	Emit a warning that does not stop execution.

Synopsis

Declared in <mrdocs/Support/Report.hpp>

template<class Arg>
requires std::is_constructible_v<T, Arg>
Located(
    Arg&& arg,
    std::source_location const& loc = source_location::current());

Parameters

Name	Description
arg	Value to wrap.
loc	Source location to associate (defaults to current).

Synopsis

Declared in <mrdocs/Support/Report.hpp>

T value;

Synopsis

Declared in <mrdocs/Support/Report.hpp>

std::source_location where;

Synopsis

Declared in <mrdocs/Support/Report.hpp>

struct Results;

Data Members

Name	Description
`debugCount`	Number of debug-level messages.
`errorCount`	Number of error-level messages.
`fatalCount`	Number of fatal-level messages.
`infoCount`	Number of info-level messages.
`traceCount`	Number of trace-level messages.
`warnCount`	Number of warning-level messages.

Synopsis

Declared in <mrdocs/Support/Report.hpp>

std::size_t debugCount;

Synopsis

Declared in <mrdocs/Support/Report.hpp>

std::size_t errorCount;

Synopsis

Declared in <mrdocs/Support/Report.hpp>

std::size_t fatalCount;

Synopsis

Declared in <mrdocs/Support/Report.hpp>

std::size_t infoCount;

Synopsis

Declared in <mrdocs/Support/Report.hpp>

std::size_t traceCount;

Synopsis

Declared in <mrdocs/Support/Report.hpp>

std::size_t warnCount;

Synopsis

Declared in <mrdocs/Support/Report.hpp>

enum class Level : int;

Members

Name	Description
`trace`	Programming trace messages
`debug`	Debug messages
`info`	Informational messages
`warn`	Warning messages
`error`	Error messages
`fatal`	Fatal error messages

Non-Member Functions

Name	Description
`getMinimumLevel`	Get the minimum threshold level for reporting.
`log`	Format a message to the console.
`print`	Report a message to the console.
`setMinimumLevel`	Set the minimum threshold level for reporting.

Synopsis

Declared in <mrdocs/Support/Report.hpp>

template<class... Args>
void
debug(
    Located<std::string_view> format,
    Args&&... args);

Parameters

Name	Description
format	fmt-style format string.
args	Arguments substituted into the format string.

Synopsis

Declared in <mrdocs/Support/Report.hpp>

template<class... Args>
void
error(
    Located<std::string_view> format,
    Args&&... args);

Parameters

Name	Description
format	fmt-style format string.
args	Arguments substituted into the format string.

Synopsis

Declared in <mrdocs/Support/Report.hpp>

template<class... Args>
void
fatal(
    Located<std::string_view> format,
    Args&&... args);

Parameters

Name	Description
format	fmt-style format string.
args	Arguments substituted into the format string.

Synopsis

Declared in <mrdocs/Support/Report.hpp>

Level
getMinimumLevel() noexcept;

Return Value

Current minimum Level that will be emitted.

Synopsis

Declared in <mrdocs/Support/Report.hpp>

template<class... Args>
void
info(
    Located<std::string_view> format,
    Args&&... args);

Parameters

Name	Description
format	fmt-style format string.
args	Arguments substituted into the format string.

Synopsis

Declared in <mrdocs/Support/Report.hpp>

template<class... Args>
void
log(
    Level level,
    Located<std::string_view> fs,
    Args&&... args);

Parameters

Name	Description
level	0 to 4 The severity of the report. 0 is debug and 4 is fatal.
fs	The format string.
args	Optional additional arguments used to format a message to print. A trailing newline will be added to the message automatically.

Synopses

Declared in <mrdocs/Support/Report.hpp>

Report a message to the console.

void
print(std::string const& text);

» more...

Report a message to the console.

void
print(
    Level level,
    std::string const& text,
    std::source_location const* loc = nullptr,
    Error const* e = nullptr);

» more...

Parameters

Name	Description
text	The message to print. A trailing newline will be added to the message automatically.
level	0 to 4 The severity of the report. 0 is debug and 4 is fatal.
loc	The source location of the report. If this value is null, no location is printed.

Synopsis

Declared in <mrdocs/Support/Report.hpp>

void
print(std::string const& text);

Parameters

Name	Description
text	The message to print. A trailing newline will be added to the message automatically.

Synopsis

Declared in <mrdocs/Support/Report.hpp>

void
print(
    Level level,
    std::string const& text,
    std::source_location const* loc = nullptr,
    Error const* e = nullptr);

Parameters

Name	Description
level	0 to 4 The severity of the report. 0 is debug and 4 is fatal.
text	The message to print. A trailing newline will be added to the message automatically.
loc	The source location of the report. If this value is null, no location is printed.
e	Holds the description of an error, or success.

Synopsis

Declared in <mrdocs/Support/Report.hpp>

void
setMinimumLevel(Level level) noexcept;

Description

Messages below this level will not be printed. A value of 5 will suppress all messages. Note that messages will still be counted towards result totals even if they are not displayed.

Parameters

Name	Description
level	Severity levels attached to reported messags.

Synopsis

Declared in <mrdocs/Support/Report.hpp>

void
setSourceLocationWarnings(bool b) noexcept;

Parameters

Name	Description
b	true to enable source location information, false to disable it. The default value is true.

Synopsis

Declared in <mrdocs/Support/Report.hpp>

template<class... Args>
void
trace(
    Located<std::string_view> format,
    Args&&... args);

Parameters

Name	Description
format	fmt-style format string.
args	Arguments substituted into the format string.

Synopsis

Declared in <mrdocs/Support/Report.hpp>

template<class... Args>
void
warn(
    Located<std::string_view> format,
    Args&&... args);

Parameters

Name	Description
format	fmt-style format string.
args	Arguments substituted into the format string.

Synopsis

Declared in <mrdocs/Support/Report.hpp>

extern
Results results;

Synopsis

Declared in <mrdocs/ADT/UnorderedStringMap.hpp>

template<class T>
using UnorderedStringMap = std::unordered_map<std::string, T, StringHash, std::equal_to<>>;

Synopsis

Declared in <mrdocs/ADT/UnorderedStringMap.hpp>

template<class T>
using UnorderedStringMultiMap = std::unordered_multimap<std::string, T, StringHash, std::equal_to<>>;

Synopsis

Declared in <mrdocs/Support/TypeTraits.hpp>

template<
    typename From,
    typename To>
using add_const_from_t = add_const_from<From, To>::type;

Template Parameters

Name	Description
From	Source type providing const qualifier.
To	Destination type to adjust.

Synopsis

Declared in <mrdocs/Support/TypeTraits.hpp>

template<
    typename From,
    typename To>
using add_cv_from_t = add_cv_from<From, To>::type;

Template Parameters

Name	Description
From	Source type providing cv qualifiers.
To	Destination type to adjust.

Synopsis

Declared in <mrdocs/Support/TypeTraits.hpp>

template<
    typename From,
    typename To>
using add_cvref_from_t = add_cvref_from<From, To>::type;

Template Parameters

Name	Description
From	Source type providing cv-ref qualifiers.
To	Destination type to adjust.

Synopsis

Declared in <mrdocs/Support/TypeTraits.hpp>

template<
    typename From,
    typename To>
using add_lvalue_reference_from_t = add_lvalue_reference_from<From, To>::type;

Template Parameters

Name	Description
From	Source type providing reference qualifier.
To	Destination type to adjust.

Synopsis

Declared in <mrdocs/Support/TypeTraits.hpp>

template<
    typename From,
    typename To>
using add_reference_from_t = add_reference_from<From, To>::type;

Template Parameters

Name	Description
From	Source type providing reference qualifier.
To	Destination type to adjust.

Synopsis

Declared in <mrdocs/Support/TypeTraits.hpp>

template<
    typename From,
    typename To>
using add_rvalue_reference_from_t = add_rvalue_reference_from<From, To>::type;

Template Parameters

Name	Description
From	Source type providing reference qualifier.
To	Destination type to adjust.

Synopsis

Declared in <mrdocs/Support/TypeTraits.hpp>

template<
    typename From,
    typename To>
using add_volatile_from_t = add_volatile_from<From, To>::type;

Template Parameters

Name	Description
From	Source type providing volatile qualifier.
To	Destination type to adjust.

Synopsis

Declared in <mrdocs/Support/TypeTraits.hpp>

template<
    typename T,
    typename U>
using make_dependent_t = T;

Template Parameters

Name	Description
T	Type to make dependent.
U	Dependent parameter.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

struct AnyFileVisitor;

Member Functions

Name	Description
`~AnyFileVisitor` [destructor] [virtual]	Virtual destructor.
`visitFile` [virtual]	Visit a single file path.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

virtual
~AnyFileVisitor() = 0;

Synopsis

Declared in <mrdocs/Support/Path.hpp>

virtual
Expected<void>
visitFile(std::string_view fileName) = 0;

Return Value

Success or error from visitor.

Parameters

Name	Description
fileName	Path to the file being visited.

Synopsis

Declared in <mrdocs/Metadata/Type/ArrayType.hpp>

struct ArrayType final
    : TypeCommonBase<TypeKind::Array>

Base Classes

Name	Description
`TypeCommonBase<TypeKind::Array>`	CRTP base that ties a concrete type to a fixed TypeKind.

Static Member Functions

Name
`isArray`
`isAuto`
`isDecltype`
`isFunction`
`isLValueReference`
`isMemberPointer`
`isNamed`
`isPointer`
`isRValueReference`

Data Members

Name	Description
`Bounds`	Optional bound; empty means unknown or dependent.
`ElementType`	Element type held by the array.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`innerType`	Return the inner type.
`innerType`	Return the inner type.
`innerTypePtr`	Return the inner type.
`innerTypePtr`	Return the inner type.
`toString`	Render a type to a human-readable string.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isArray() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isAuto() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isDecltype() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isLValueReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isMemberPointer() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isNamed() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isPointer() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isRValueReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/ArrayType.hpp>

ConstantExprInfo<uint64_t> Bounds;

Synopsis

Declared in <mrdocs/Metadata/Type/ArrayType.hpp>

Polymorphic<Type> ElementType = Polymorphic<Type>(AutoType{});

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr static
TypeKind kind_id;

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

template<class T>
class ArrayView;

Description

Similar to std::string_view but for arbitrary element type T.

Type Aliases

Name	Description
`const_iterator`	Iterator over elements.
`const_pointer`	Pointer to constant element.
`const_reference`	Reference to constant element.
`const_reverse_iterator`	Const reverse iterator over the view.
`difference_type`	Signed iterator difference type.
`iterator`	Iterator over elements.
`pointer`	Pointer to constant element.
`reference`	Reference to constant element.
`reverse_iterator`	Reverse iterator over the view.
`size_type`	Unsigned size type.
`value_type`	Element type referenced by the view.

Member Functions

Name	Description
`ArrayView` [constructor]	Constructors
`at`	Access the element at the specified index with bounds checking.
`back`	Return a reference to the last element.
`begin`	Return an iterator to the first element.
`cbegin`	Return a const iterator to the first element.
`cend`	Return a const iterator one past the last element.
`data`	Return a pointer to the underlying data.
`drop_back`	Return a view with the last `n` elements removed.
`drop_front`	Return a view with the first `n` elements removed.
`empty`	Return true if the view contains no elements.
`end`	Return an iterator one past the last element.
`front`	Return a reference to the first element.
`length`	Return the number of elements in the view.
`operator[]`	Access the element at the specified index without bounds checking.
`rbegin`	Return a reverse iterator to the last element.
`remove_prefix`	Remove `n` elements from the front of the view.
`remove_suffix`	Remove `n` elements from the back of the view.
`rend`	Return a reverse iterator one before the first element.
`size`	Return the number of elements in the view.
`slice`	Return a subview starting at `pos` with up to `count` elements.
`take_back`	Return a view containing the last `n` elements.
`take_front`	Return a view containing the first `n` elements.

Static Data Members

Name	Description
`npos`	Sentinel used by slicing helpers to indicate “until the end”.

Friends

Name	Description
`mrdocs::operator<=>`	Three-way comparison operator
`mrdocs::operator==`	Equality operator

Non-Member Functions

Name	Description
`make_array_view`	Create an ArrayView from a C-style array.
`make_array_view`	Create an ArrayView from a pointer and count.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

using const_iterator = T const*;

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

using const_pointer = T const*;

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

using const_reference = T const&;

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

using const_reverse_iterator = std::reverse_iterator<const_iterator>;

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

using difference_type = std::ptrdiff_t;

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

using iterator = T const*;

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

using pointer = T const*;

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

using reference = T const&;

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

using reverse_iterator = std::reverse_iterator<const_iterator>;

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

using size_type = std::size_t;

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

using value_type = T;

Synopses

Declared in <mrdocs/ADT/ArrayView.hpp>

Construct an empty view.

constexpr
ArrayView() noexcept = default;

» more...

Construct a view from a C-style array.

template<size_type N>
constexpr
ArrayView(T const(& arr)[N]) noexcept;

» more...

Construct a view from a pointer and element count.

constexpr
ArrayView(
    T const* data,
    size_type count) noexcept;

» more...

Construct a view from a contiguous iterator range of known size.

template<class It>
requires (std::contiguous_iterator<It> &&
             std::same_as<std::remove_cv_t<std::remove_reference_t<std::iter_value_t<It>>>, T>)
constexpr
ArrayView(
    It first,
    size_type count) noexcept;

» more...

Parameters

Name	Description
arr	The array to view.
data	Pointer to the first element.
count	Number of elements in the range.
first	Iterator to the first element.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
ArrayView() noexcept = default;

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

template<size_type N>
constexpr
ArrayView(T const(& arr)[N]) noexcept;

Parameters

Name	Description
arr	The array to view.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
ArrayView(
    T const* data,
    size_type count) noexcept;

Parameters

Name	Description
data	Pointer to the first element.
count	Number of elements in the range.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

template<class It>
requires (std::contiguous_iterator<It> &&
             std::same_as<std::remove_cv_t<std::remove_reference_t<std::iter_value_t<It>>>, T>)
constexpr
ArrayView(
    It first,
    size_type count) noexcept;

Parameters

Name	Description
first	Iterator to the first element.
count	Number of elements starting at `first`.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
const_reference
at(size_type i) const;

Return Value

Reference to the element.

Parameters

Name	Description
i	Zero-based index.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
const_reference
back() const;

Return Value

a reference to the last element.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
const_iterator
begin() const noexcept;

Return Value

Iterator to the start of the view.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
const_iterator
cbegin() const noexcept;

Return Value

Const iterator to the start of the view.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
const_iterator
cend() const noexcept;

Return Value

Const iterator to the end sentinel.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
const_pointer
data() const noexcept;

Return Value

Pointer to the first element, or nullptr when empty.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
ArrayView
drop_back(size_type n) const noexcept;

Return Value

Subview excluding the dropped elements.

Parameters

Name	Description
n	Number of elements to drop from the back.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
ArrayView
drop_front(size_type n) const noexcept;

Return Value

Subview starting after the dropped elements.

Parameters

Name	Description
n	Number of elements to drop from the front.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

[[nodiscard]]
constexpr
bool
empty() const noexcept;

Return Value

true when size is zero, otherwise false.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
const_iterator
end() const noexcept;

Return Value

Iterator to the end sentinel.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
const_reference
front() const;

Return Value

a reference to the first element.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
size_type
length() const noexcept;

Return Value

Element count.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
const_reference
operator[](size_type i) const noexcept;

Return Value

Reference to the element.

Parameters

Name	Description
i	Zero-based index.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
const_reverse_iterator
rbegin() const noexcept;

Return Value

Reverse iterator to the last element.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
void
remove_prefix(size_type n) noexcept;

Parameters

Name	Description
n	Number of elements to drop.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
void
remove_suffix(size_type n) noexcept;

Parameters

Name	Description
n	Number of elements to drop.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
const_reverse_iterator
rend() const noexcept;

Return Value

Reverse iterator denoting the rend sentinel.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
size_type
size() const noexcept;

Return Value

Element count.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
ArrayView
slice(
    size_type pos,
    size_type count = npos) const noexcept;

Return Value

Subview representing the requested slice.

Parameters

Name	Description
pos	Starting index within the current view.
count	Maximum number of elements to include; use npos for the remainder.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
ArrayView
take_back(size_type n) const noexcept;

Return Value

Subview of the last n elements (clamped to size).

Parameters

Name	Description
n	Desired suffix length.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
ArrayView
take_front(size_type n) const noexcept;

Return Value

Subview of the first n elements (clamped to size).

Parameters

Name	Description
n	Desired prefix length.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

inline constexpr static
size_type npos = static_cast<size_type>(-1);

Synopsis

Declared in <mrdocs/Metadata/Type/AutoType.hpp>

struct AutoType final
    : TypeCommonBase<TypeKind::Auto>

Base Classes

Name	Description
`TypeCommonBase<TypeKind::Auto>`	CRTP base that ties a concrete type to a fixed TypeKind.

Static Member Functions

Name
`isArray`
`isAuto`
`isDecltype`
`isFunction`
`isLValueReference`
`isMemberPointer`
`isNamed`
`isPointer`
`isRValueReference`

Data Members

Name	Description
`Constraint`	Constraint on the auto type, if any.
`Keyword`	Which placeholder keyword appears (`auto` or `decltype(auto)`).

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`innerType`	Return the inner type.
`innerType`	Return the inner type.
`innerTypePtr`	Return the inner type.
`innerTypePtr`	Return the inner type.
`toString`	Render a type to a human-readable string.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isArray() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isAuto() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isDecltype() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isLValueReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isMemberPointer() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isNamed() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isPointer() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isRValueReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/AutoType.hpp>

Optional<Polymorphic<Name>> Constraint = std::nullopt;

Synopsis

Declared in <mrdocs/Metadata/Type/AutoType.hpp>

AutoKind Keyword = AutoKind::Auto;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr static
TypeKind kind_id;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class E>
class BadExpectedAccess
    : public BadExpectedAccess<void>

Description

Exception thrown when reading the error of an Expected with a value.

Base Classes

Name	Description
`BadExpectedAccess<void>`	Exception thrown when reading the value of an empty Expected.

Member Functions

Name	Description
`BadExpectedAccess` [constructor]	Construct with the unexpected error value.
`operator=`	Assignment operators
`error`	`error` overloads
`what` [virtual]	Return a diagnostic string.

Protected Member Functions

Name	Description
`operator=`	Assignment operators

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

explicit
BadExpectedAccess(E e);

Parameters

Name	Description
e	The object to construct from

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Access the contained error by lvalue reference.

[[nodiscard]]
E&
error() & noexcept;

» more...

Access the contained error by const lvalue reference.

[[nodiscard]]
E const&
error() const & noexcept;

» more...

Access the contained error by rvalue reference.

[[nodiscard]]
E&&
error() && noexcept;

» more...

Access the contained error by const rvalue reference.

[[nodiscard]]
E const&&
error() const && noexcept;

» more...

Return Value

Reference to the stored unexpected value.
Const reference to the stored unexpected value.
Rvalue reference to the stored unexpected value.
Const rvalue reference to the stored unexpected value.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
E&
error() & noexcept;

Return Value

Reference to the stored unexpected value.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
E const&
error() const & noexcept;

Return Value

Const reference to the stored unexpected value.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
E&&
error() && noexcept;

Return Value

Rvalue reference to the stored unexpected value.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
E const&&
error() const && noexcept;

Return Value

Const rvalue reference to the stored unexpected value.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<>
class BadExpectedAccess<void>
    : public std::exception

Base Classes

Name	Description
`std::exception`	Base class for all library exceptions.

Member Functions

Name	Description
`operator=`	Assignment operators
`what` [virtual]	Return a diagnostic string.

Protected Member Functions

Name	Description
`BadExpectedAccess` [constructor]	Constructors
`~BadExpectedAccess` [destructor] [virtual]	Virtual destructor.
`operator=`	Assignment operators

Derived Classes

Name	Description
`BadExpectedAccess`	Base class for accessing an empty Expected.

Synopses

Declared in <bits/exception.h>

Assignment operator

constexpr
exception&
operator=(exception const& value) = default;

» more...

Assignment operator

constexpr
exception&
operator=(exception&& value) = default;

» more...

Synopsis

Declared in <bits/exception.h>

constexpr
exception&
operator=(exception const& value) = default;

Return Value

Base class for all library exceptions.

Parameters

Name	Description
value	The object to copy assign from

Synopsis

Declared in <bits/exception.h>

constexpr
exception&
operator=(exception&& value) = default;

Return Value

Base class for all library exceptions.

Parameters

Name	Description
value	The object to move assign from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
virtual
char const*
what() const noexcept override;

Return Value

a diagnostic string.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Default constructor.

constexpr
BadExpectedAccess() noexcept = default;

» more...

Copy constructor.

constexpr
BadExpectedAccess(BadExpectedAccess<void> const& other) = default;

» more...

Move constructor.

constexpr
BadExpectedAccess(BadExpectedAccess<void>&& other) = default;

» more...

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
BadExpectedAccess() noexcept = default;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
BadExpectedAccess(BadExpectedAccess<void> const& other) = default;

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
BadExpectedAccess(BadExpectedAccess<void>&& other) = default;

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
virtual
~BadExpectedAccess() override = default;

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Copy assignment.

constexpr
BadExpectedAccess<void>&
operator=(BadExpectedAccess<void> const& other) = default;

» more...

Move assignment.

constexpr
BadExpectedAccess<void>&
operator=(BadExpectedAccess<void>&& other) = default;

» more...

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
BadExpectedAccess<void>&
operator=(BadExpectedAccess<void> const& other) = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
BadExpectedAccess<void>&
operator=(BadExpectedAccess<void>&& other) = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to move assign from

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordBase.hpp>

struct BaseInfo;

Member Functions

Name	Description
`BaseInfo` [constructor] [deleted]	Constructors

Data Members

Name	Description
`Access`	The access specifier for the base.
`IsVirtual`	Whether the base is virtual.
`Type`	The base type.

Synopses

Declared in <mrdocs/Metadata/Symbol/RecordBase.hpp>

Bases must be explicitly described.

BaseInfo() = delete;

» more...

Create a base description.

BaseInfo(
    Polymorphic<Type>&& type,
    AccessKind const access,
    bool const is_virtual);

» more...

Parameters

Name	Description
type	The base type.
access	Declared access specifier.
is_virtual	Whether the base is virtual.

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordBase.hpp>

BaseInfo() = delete;

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordBase.hpp>

BaseInfo(
    Polymorphic<Type>&& type,
    AccessKind const access,
    bool const is_virtual);

Parameters

Name	Description
type	The base type.
access	Declared access specifier.
is_virtual	Whether the base is virtual.

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordBase.hpp>

AccessKind Access = AccessKind::Public;

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordBase.hpp>

bool IsVirtual = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordBase.hpp>

Polymorphic<Type> Type;

Description

This is typically a NamedType that refers to a RecordSymbol, but it could also be a more complex type such as a decltype.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Concept.hpp>

struct ConceptSymbol final
    : SymbolCommonBase<SymbolKind::Concept>

Base Classes

Name	Description
`SymbolCommonBase<SymbolKind::Concept>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`ConceptSymbol` [constructor]	Construct a concept symbol with its ID.
`operator<=>`	Compare concept symbols by base info, template, and constraint.

Static Member Functions

Name
`isConcept`
`isEnum`
`isEnumConstant`
`isFunction`
`isGuide`
`isNamespace`
`isNamespaceAlias`
`isOverloads`
`isRecord`
`isTypedef`
`isUsing`
`isVariable`

Data Members

Name	Description
`Constraint`	The concepts constraint-expression
`Template`	The concepts template parameters

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`canMerge`	Check whether two symbols may be merged.
`getPrimaryLocation`	Determine a location to use when none is explicitly chosen.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Concept.hpp>

explicit
ConceptSymbol(SymbolID const& ID) noexcept;

Parameters

Name	Description
ID	The object to copy construct from

Synopsis

Declared in <mrdocs/Metadata/Symbol/Concept.hpp>

std::strong_ordering
operator<=>(ConceptSymbol const& other) const;

Return Value

The relative order of the objects

Parameters

Name	Description
other	The right operand

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isConcept() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnum() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnumConstant() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isGuide() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespace() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespaceAlias() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isOverloads() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isRecord() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isTypedef() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isUsing() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isVariable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Concept.hpp>

ExprInfo Constraint;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Concept.hpp>

Optional<TemplateInfo> Template;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr static
SymbolKind kind_id;

Synopsis

Declared in <mrdocs/Config.hpp>

class Config;

Description

This contains all the public settings applied from the command line and the YML file (if any).

This class stores the original and public config options as they are passed to MrDocs, in their original data types, such as strings and bools.

This class is an abstract interface whose private concrete implementation typically includes these parsed configuration values in a more convenient form for use by MrDocs.

Meanwhile, this class is provided publicly to plugins.

The configuration is always connected to the directory of the mrdocs.yml file from which absolute paths are calculated from relative paths.

Types

Name	Description
`Settings`	Settings values used to generate the Corpus and Docs

Member Functions

Name	Description
`~Config` [destructor] [virtual]	Destructor.
`object` [virtual]	Return a DOM object representing the configuration keys.
`operator->`	Return the settings used to generate the Corpus and Docs.
`settings` [virtual]	Return the settings used to generate the Corpus and Docs.
`threadPool` [virtual]	Return a pool of threads for executing work.

Static Member Functions

Name	Description
`load`	Create a Config from normalized public settings.

Protected Member Functions

Name	Description
`Config` [constructor]	Construct an empty configuration interface. Implementations populate settings in derived classes.

Synopsis

Declared in <mrdocs/Config.hpp>

struct Settings
    : PublicSettings

Base Classes

Name	Description
`PublicSettings`

Types

Name	Description
`OptionProperties`	Option validation traits

Enums

Name	Description
`BaseMemberInheritance`	Enum for "base-member-inheritance" options
`LogLevel`	Enum for "log-level" options
`OptionType`	Option Type
`SortSymbolBy`	Enum for "sort-symbol-by" options

Member Functions

Name	Description
`configDir`	Full path to the config file directory
`normalize`	Normalize the configuration values with a visitor
`operator->`	Provide pointer-like access to settings fields.
`outputDir`	Full path to the output directory
`visit`	Visit all options

Static Member Functions

Name	Description
`fromString`
`load`	`load` overloads
`load_file`	Loads the public configuration settings from the specified file.
`toString`

Data Members

Name	Description
`addons`	Path to the Addons directory
`addonsSupplemental`	Additional addons layered on top of the base addons
`autoBrief`	command is required.
`autoFunctionMetadata`	Automatically provide missing documentation for special functions and trivial metadata
`autoFunctionObjects`	Automatically detect algorithm function objects
`autoRelates`	Automatically find non-member functions
`baseUrl`	Base URL for links to source code
`cmake`	CMake arguments when generating the compilation database from CMakeLists.txt
`cmdLineInputs`	Configuration or compilation database files
`compilationDatabase`	Path to the compilation database
`concurrency`	Number of threads to use
`config`	Mr.Docs configuration file
`configYaml`	A string holding the complete configuration YAML.
`copycss`	Copy local stylesheets when linking
`cwdDir`	Full path to the current working directory
`defines`	Additional defines passed to the compiler
`embedded`	Output an embeddable document
`errorOnEmptyCorpus`	Treat an empty corpus as an error
`exclude`	Input directories to exclude
`excludePatterns`	File patterns to exclude
`excludeSymbols`	Symbol patterns to exclude
`extractAll`	Extract all symbols
`extractAnonymousNamespaces`	Extraction policy for anonymous namespaces
`extractEmptyNamespaces`	Extraction policy for empty namespaces
`extractFriends`	Extraction policy for friend functions and classes
`extractImplicitSpecializations`	Implicit template specializations used as base classes are extracted as dependencies
`extractLocalClasses`	Extraction policy for records defined locally in source files
`extractPrivate`	Extraction policy for private class members
`extractPrivateBases`	Extraction policy for private base classes
`extractPrivateVirtual`	Extraction policy for private virtual methods of a class
`extractStatic`	Extraction policy for static members of a file
`filePatterns`	File patterns to include
`generator`	Generator(s) used to create the documentation
`globalNamespaceIndex`	Use the global namespace page as an index for all symbols
`ignoreFailures`	Whether AST visitation failures should not stop the program
`ignoreMapErrors`	Continue if files are not mapped correctly
`implementationDefined`	Symbols rendered as "implementation-defined"
`includeSymbols`	Symbol patterns to include
`includes`	Include paths
`inheritBaseMembers`	Determine how derived classes inherit base members
`input`	Input directories to extract symbols from
`legibleNames`	Use legible names
`libcIncludes`	Standard Library include paths
`linkcss`	Link stylesheets instead of embedding them
`logLevel`	The minimum reporting level
`missingIncludePrefixes`	Include path prefixes allowed to be missing
`missingIncludeShims`	Shims for forgiven missing include files
`mrdocsRootDir`	Full path to the mrdocs root directory
`multipage`	Generate a multipage documentation
`noDefaultStyles`	Disable the bundled default stylesheet
`output`	Directory or file for generating output
`overloads`	Detect and group function overloads
`recursive`	Recursively include files from "input" paths
`report`	The minimum reporting level
`seeBelow`	Exposition only symbols rendered as "see-below".
`sfinae`	Detect and reduce SFINAE expressions
`showEnumConstants`	Show enum constant pages in the documentation
`showNamespaces`	Show namespace pages in the documentation
`sortMembers`	Sort the members of a record
`sortMembersAssignment1St`	Sort assignment operators first
`sortMembersBy`	Determine how members of a record are sorted
`sortMembersConversionLast`	Sort conversion operators last
`sortMembersCtors1St`	Sort constructors first
`sortMembersDtors1St`	Sort destructors first
`sortMembersRelationalLast`	Sort relational operators last
`sortNamespaceMembersBy`	Determine how members of a namespace are sorted
`sourceRoot`	Path to the root directory of the source code
`stdlibIncludes`	C++ Standard Library include paths
`stylesdir`	Directory for linked stylesheets
`stylesheets`	Ordered list of stylesheets to apply to HTML output
`systemIncludes`	System include paths
`tagfile`	Path for the tagfile
`useSystemLibc`	Use the system C standard library
`useSystemStdlib`	Use the system C++ standard library
`verbose`	Verbose output
`warnAsError`	Treat warnings as errors
`warnBrokenRef`	Warn if a documentation reference is broken
`warnIfDocError`	Warn if documentation has errors
`warnIfUndocEnumVal`	Warn if enum values are not documented
`warnIfUndocumented`	Warn if symbols are not documented
`warnNoParamdoc`	Warn if parameters are not documented
`warnUnnamedParam`	Warn if documented functions have unnamed parameters
`warnings`	Enable warning messages

Friends

Name	Description
`llvm::yaml::MappingTraits`

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

struct OptionProperties;

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

enum class BaseMemberInheritance : int;

Description

This enumeration value is valid for the inherit-base-members option

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

enum class LogLevel : int;

Description

This enumeration value is valid for the log-level option

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

enum class OptionType : int;

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

enum class SortSymbolBy : int;

Description

These enumeration values are valid for the following options:

sort-members-by
sort-namespace-members-by

Synopsis

Declared in <mrdocs/Config.hpp>

std::string
configDir() const;

Description

The reference directory for most MrDocs options is the directory of the mrdocs.yml file.

It is used to calculate full paths from relative paths.

This string will always be native style and have a trailing directory separator.

Return Value

The full path to the config file directory.

Synopses

Declared in <mrdocs/Config.hpp>

Normalize the configuration values with a visitor

Expected<void>
normalize(ReferenceDirectories const& dirs);

» more...

Normalize the configuration values with a visitor

template<class F>
Expected<void>
normalize(
    ReferenceDirectories const& dirs,
    F&& f);

» more...

Return Value

Expected<void> with the error if any

Parameters

Name	Description
dirs	The reference directories to resolve paths
f	The visitor

Synopsis

Declared in <mrdocs/Config.hpp>

Expected<void>
normalize(ReferenceDirectories const& dirs);

Description

This function normalizes and validates the configuration values.

Return Value

Expected<void> with the error if any

Parameters

Name	Description
dirs	The reference directories to resolve paths

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

template<class F>
Expected<void>
normalize(
    ReferenceDirectories const& dirs,
    F&& f);

Description

This function normalizes and validates the configuration values.

Return Value

Expected<void> with the error if any

Parameters

Name	Description
dirs	The reference directories to resolve paths
f	The visitor

Synopsis

Declared in <mrdocs/Config.hpp>

constexpr
Settings const*
operator->() const noexcept;

Return Value

Pointer to this Settings instance.

Synopsis

Declared in <mrdocs/Config.hpp>

std::string
outputDir() const;

Description

The reference directory for MrDocs output and temporary files is the output directory.

This is either the output option (if already a directory) or the parent directory of the output option (if it is a file).

When the output option is a path that does not exist, we determine if it's a file or directory by checking if the filename contains a period.

This string will always be native style and have a trailing directory separator.

Return Value

The full path to the output directory.

Synopses

Declared in <mrdocs/PublicSettings.hpp>

Visit all options

template<class F>
void
visit(F&& f);

» more...

Visit all options

template<class F>
void
visit(F&& f) const;

» more...

Parameters

Name	Description
f	The visitor

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

template<class F>
void
visit(F&& f);

Parameters

Name	Description
f	The visitor

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

template<class F>
void
visit(F&& f) const;

Parameters

Name	Description
f	The visitor

Synopses

Declared in <mrdocs/PublicSettings.hpp>

constexpr
static
bool
fromString(
    std::string_view const str,
    BaseMemberInheritance& e);

» more...

constexpr
static
bool
fromString(
    std::string_view const str,
    LogLevel& e);

» more...

constexpr
static
bool
fromString(
    std::string_view const str,
    SortSymbolBy& e);

» more...

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

constexpr
static
bool
fromString(
    std::string_view const str,
    BaseMemberInheritance& e);

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

constexpr
static
bool
fromString(
    std::string_view const str,
    LogLevel& e);

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

constexpr
static
bool
fromString(
    std::string_view const str,
    SortSymbolBy& e);

Synopses

Declared in <mrdocs/Config.hpp>

Load the configuration from a YAML string

static
Expected<void>
load(
    PublicSettings& s,
    std::string_view configYaml);

» more...

Loads the public configuration settings from the specified YAML file.

static
Expected<void>
load(
    Config::Settings& s,
    std::string_view configYaml,
    ReferenceDirectories const& dirs);

» more...

Return Value

Expected<void> with the error if any
An Expected object containing a Config::Settings object if the YAML file was successfully parsed and the configuration settings were loaded, or an error otherwise.

Parameters

Name	Description
s	The PublicSettings object to load the configuration into
configYaml	The YAML string with the configuration
dirs	A constant reference to a PublicSettings::ReferenceDirectories object containing the reference directories.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

static
Expected<void>
load(
    PublicSettings& s,
    std::string_view configYaml);

Description

This function loads the values from the YAML string without normalizing or validating them.

After calling this function, call normalize to normalize and validate the options.

Return Value

Expected<void> with the error if any

Parameters

Name	Description
s	The PublicSettings object to load the configuration into
configYaml	The YAML string with the configuration

Synopsis

Declared in <mrdocs/Config.hpp>

static
Expected<void>
load(
    Config::Settings& s,
    std::string_view configYaml,
    ReferenceDirectories const& dirs);

Description

This function takes a YAML file and a set of reference directories as input. It parses the YAML file and loads the configuration settings into a Config::Settings object. The reference directories are used to resolve any relative paths in the configuration settings.

Return Value

An Expected object containing a Config::Settings object if the YAML file was successfully parsed and the configuration settings were loaded, or an error otherwise.

Parameters

Name	Description
s	A reference to a Config::Settings object where the configuration settings will be loaded.
configYaml	A string view representing the YAML file containing the configuration settings.
dirs	A constant reference to a PublicSettings::ReferenceDirectories object containing the reference directories.

Synopsis

Declared in <mrdocs/Config.hpp>

static
Expected<void>
load_file(
    Config::Settings& s,
    std::string_view configPath,
    ReferenceDirectories const& dirs);

Description

This function takes a file path and a set of reference directories as input. It reads the file and loads the configuration settings into a Config::Settings object. The reference directories are used to resolve any relative paths in the configuration settings.

Return Value

An Expected object containing void if the file was successfully read and the configuration settings were loaded, or an error otherwise.

Parameters

Name	Description
s	A reference to a Config::Settings object where the configuration settings will be loaded.
configPath	A string view representing the file path of the configuration settings.
dirs	A constant reference to a PublicSettings::ReferenceDirectories object containing the reference directories.

Synopses

Declared in <mrdocs/PublicSettings.hpp>

constexpr
static
std::string_view
toString(BaseMemberInheritance const e);

» more...

constexpr
static
std::string_view
toString(LogLevel const e);

» more...

constexpr
static
std::string_view
toString(SortSymbolBy const e);

» more...

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

constexpr
static
std::string_view
toString(BaseMemberInheritance const e);

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

constexpr
static
std::string_view
toString(LogLevel const e);

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

constexpr
static
std::string_view
toString(SortSymbolBy const e);

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::string addons;

Description

The directory of template files the generators use to build the documentation.

Leave it unset to use the defaults that ship at share/mrdocs/addons in the MrDocs installation.

To customize the output, copy those defaults to your own directory and point this option at it.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::vector<std::string> addonsSupplemental;

Description

Optional list of supplemental addons directories that are loaded after the base addons (built-in or replacement).

Files in later supplemental directories override files from earlier ones and from the base addons.

Use this to add or override a few templates/helpers without copying the entire addons tree.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool autoBrief = true;

Description

Use the first line of the comment as the brief

When set to true, Mr.Docs uses the first line (until the first dot, question mark, or exclamation mark) of the comment as the brief of the symbol.

When set to false, a explicit

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool autoFunctionMetadata = true;

Description

When set to true, Mr.Docs automatically provides documentation for special functions, such as constructors, destructors, and operators.

It also provides documentation for missing documentation metadata, such as known types.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool autoFunctionObjects = true;

Description

When true, Mr.Docs automatically detects algorithm function objects (informally known as niebloids): variables whose type is a record whose only public non-special members are operator() overloads.

Set to false to disable auto-detection and rely solely on the

/

doc command.

The

command is still useful when auto-detection is enabled, to force treatment of types that fail auto-detection (e.g.

because they have extra public members); it may be placed on the variable or on the function-object record.

When a variable is treated as an algorithm function object, its documentation comes from the record's operator() overloads, falling back to the variable's own doc comment when operator() is undocumented; the record's own doc comment is not used.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool autoRelates = true;

Description

When set to true, Mr.Docs automatically finds non-member functions that are related to the current class.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::string baseUrl;

Description

The prefix for links to the source code.

MrDocs joins it with the path of each source file to build the link.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::string cmake;

Description

When the compilation-database option is a CMakeLists.txt file, these arguments are passed to the cmake command to generate the compilation_database.json.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::vector<std::string> cmdLineInputs;

Description

Positional inputs that drive the run.

Each path is dispatched by file name: an input ending in mrdocs.yml is read as a configuration file, and an input ending in compile_commands.json or CMakeLists.txt is read as a compilation database.

The dispatch is a convenience; prefer the explicit config and compilation-database flags so the invocation is unambiguous and easier to read in scripts and CI logs.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::string compilationDatabase;

Description

The path to a compilation database, or to a build script that generates one.

A compilation database is a JSON file of the compiler commands that build the source; MrDocs reads the compiler flags and source files from it to extract symbols.

You can also pass a build script such as CMakeLists.txt: MrDocs then looks for CMake on PATH or in CMAKE_ROOT, runs the script, and uses the database it produces.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

unsigned int concurrency = 0;

Description

The desired level of concurrency: 0 for hardware-suggested.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::string config;

Description

A YAML file holding the options for the run: the source code, the output directory, the compilation database, the generator, and the filters.

MrDocs reads it and applies the options it finds.

Synopsis

Declared in <mrdocs/Config.hpp>

std::string configYaml;

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool copycss = true;

Description

When linkcss is true, copy bundled and local stylesheet files into the output under stylesdir.

Remote URLs are not copied.

Set to false to skip copying.

Synopsis

Declared in <mrdocs/Config.hpp>

std::string cwdDir = ".";

Description

This string will always be native style and have a trailing directory separator.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::vector<std::string> defines;

Description

Additional defines passed to the compiler when building the source code.

These defines are added to the compilation database regardless of the strategy to generate it.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool embedded = false;

Description

Output an embeddable document, which excludes the header, the footer, and everything outside the body of the document.

This option is useful for producing documents that can be inserted into an external template.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool errorOnEmptyCorpus = true;

Description

When set to true, MrDocs treats an empty corpus as a hard error and exits with a failure status instead of emitting a warning and succeeding.

A corpus counts as empty when no symbols are extracted; because the global namespace is always present in the model, a corpus that contains only the global namespace and no other declaration is also treated as empty.

This usually means nothing was extracted, which is rarely intended in CI, so this turns that silent success into a detectable failure.

This escalation applies regardless of the warn-as-error option.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::vector<std::string> exclude;

Description

Symbols defined in files in these directories are not extracted even if they are in the list of include directories.

When relative, the paths are relative to the directory of the mrdocs configuration file.

For instance, "include/experimental" will exclude all files in the directory <config-dir>/include/experimental.

Exclusion is strict about symlinks: it matches the file path only as written and does not resolve symlinks.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::vector<PathGlobPattern> excludePatterns;

Description

Files matching these glob patterns are skipped, even when they sit inside an included directory.

The patterns are relative to the configuration file.

A single * matches everything in a directory; ** matches everything in a directory and its subdirectories.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::vector<SymbolGlobPattern> excludeSymbols;

Description

A symbol that matches one of these patterns is not extracted even if whitelisted by "include-symbols".

See the documentation for "include-symbols" for the pattern syntax.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool extractAll = true;

Description

When set to true, MrDocs extracts all symbols from the source code, even if no documentation is provided.

MrDocs can only identify whether a symbol is ultimated documented after extracting information from all translation units.

For this reason, when this option is set to false, it's still recommendable to provide file and symbol filters so that only the desired symbols are traversed and stored by MrDocs.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool extractAnonymousNamespaces = true;

Description

Determine whether symbols in anonymous namespaces should be extracted.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool extractEmptyNamespaces = false;

Description

Determine whether empty namespaces without documentation should be extracted.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool extractFriends = true;

Description

Determine whether friend functions and classes should be extracted.

When set to true, MrDocs extracts friend functions and classes.

When set to false, friend functions and classes are not extracted.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool extractImplicitSpecializations = true;

Description

When set to true, MrDocs extracts implicit template specializations that appear as base classes, treating them as dependencies.

This gives it the metadata it needs to resolve the derived class's inherited members, as controlled by the inherit-base-members option.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool extractLocalClasses = true;

Description

Determine whether records only defined locally in source files should be extracted.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool extractPrivate = false;

Description

Determine whether private class members should be extracted

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool extractPrivateBases = false;

Description

Determine whether private base classes should be extracted

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool extractPrivateVirtual = false;

Description

Determine whether private virtual methods of a class should be extracted

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool extractStatic = false;

Description

Determine whether static members of a file should be extracted.

This option does not refer to static members of a class.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::vector<PathGlobPattern> filePatterns;

Description

Only files whose names match these glob patterns are extracted.

The patterns are relative to the input directories.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

StringList generator;

Description

The generator is responsible for creating the documentation from the extracted symbols.

The generator uses the extracted symbols and the templates to create the documentation.

The built-in generators include adoc, html, xml, and noop (which extracts but writes no output, useful for checking extraction warnings); data-driven generators can be added by dropping a template folder under <addon>/generator/<name>/.

This option accepts a single generator (generator: xml), a list (generator: [xml, adoc]), or a comma-separated string (`generator: "xml,adoc"`); when more than one is given the documentation is produced once per generator.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool globalNamespaceIndex = true;

Description

When set to true, the page for the global namespace will recursively list all symbols in the documentation, not just those in the global namespace.

This makes the global namespace page act as an index for the entire project.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool ignoreFailures = false;

Description

When set to true, MrDocs continues to generate the documentation even if there are AST visitation failures.

AST visitation failures occur when the source code contains constructs that are not supported by MrDocs.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool ignoreMapErrors = false;

Description

When set to true, MrDocs continues to generate the documentation even if some files are not mapped correctly.

Files are not mapped correctly when the source file is not found or the compilation database does not contain the compiler flags for the source file.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::vector<SymbolGlobPattern> implementationDefined;

Description

Symbols matching these filters, and symbols in scopes that match, are tagged "implementation-defined".

Use it for symbols that belong to the project's private API.

An "implementation-defined" symbol has no page of its own, and any reference to it renders as "implementation-defined".

See include-symbols for the pattern syntax.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::vector<SymbolGlobPattern> includeSymbols;

Description

If any patterns are defined here, only symbols that match one of these patterns are extracted.

The patterns are applied to the fully qualified name of the symbol without any leading "::".

A single "*" will match all symbols in the namespace.

Double "**" will match all symbols in the namespace and its subnamespaces.

The patterns also support "?" for any chars, "[<chars>]" for charsets, "[]" for inverted charsets, and "{<glob>,...}" for alternatives.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::vector<std::string> includes;

Description

Directories added to the header search path.

Headers found there are part of the project and are checked for warnings and errors.

Reach for this option when MrDocs cannot find a header your code includes.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

BaseMemberInheritance inheritBaseMembers = BaseMemberInheritance::CopyDependencies;

Description

Determine how derived classes inherit members of base classes.

When set to never, derived classes do not inherit members of base classes and only the relationship is stored.

When set to reference, derived classes list members of base classes but references are still linked to the base class.

When set to copy-dependencies, a reference is created by default and a copy is created when the base class is a dependency.

When set to copy-all, a copy is created for each base symbol as if it was declared in the derived class.

If the base class is a dependency, the extraction mode is copied from the new parent.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::vector<std::string> input;

Description

Input directories to extract.

Only symbols defined in files in these directories are extracted.

The paths are relative to the mrdocs configuration file.

Inclusion is generous about symlinks: a file counts as being inside an input directory when its path matches the directory either as written or by its real (symlink-resolved) location.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool legibleNames = true;

Description

Use legible names for ids in the documentation.

When set to true, MrDocs uses legible names for symbols in the documentation.

These are symbols that are legible but still safe for URLs.

When the option is set to false, MrDocs uses a hash of the symbol ID.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::vector<std::string> libcIncludes;

Description

When use-system-libc is disabled, the C standard library headers are available in these paths.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool linkcss = false;

Description

When set to true, stylesheets are linked with <link> tags instead of being inlined.

Links use stylesdir plus the stylesheet name (e.g.

css/custom.css).

Local styles are copied unless copycss is false; remote URLs are linked as-is.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

LogLevel logLevel = LogLevel::Info;

Description

The reporting level determines the amount of information displayed during the generation of the documentation.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::vector<std::string> missingIncludePrefixes;

Description

Specifies path prefixes for include files that, if missing, will not cause documentation generation to fail.

Missing files with these prefixes are served as empty files from an in-memory file system, allowing processing to continue.

For example, use "llvm/" to forgive all includes from LLVM.

If any such path is specified, MrDocs will attempt to synthesize missing included types.

Only simple sets of non-conflicting inferred types can be synthesized.

For more complex types or for better control, provide a shim using the "missing-include-shims" option.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::map<std::string, std::string> missingIncludeShims;

Description

Specifies a map of include file paths to shim contents.

If a missing include file matches a forgiven prefix, MrDocs will use the shim content from this map as the file contents.

If no shim is provided for a forgiven file, an empty file is used by default.

Synopsis

Declared in <mrdocs/Config.hpp>

std::string mrdocsRootDir;

Description

This is the directory containing the mrdocs executable and the shared files.

This string will always be native style and have a trailing directory separator.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool multipage = true;

Description

Generates a multipage documentation.

The output directory must be a directory.

This option acts as a hint to the generator to create a multipage documentation.

Whether the hint is followed or not depends on the generator.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool noDefaultStyles = false;

Description

When set to true, the bundled stylesheet is not applied.

Combine with an empty stylesheets list to emit no styles at all.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::string output;

Description

Multipage generators expect a directory.

Single page generators expect a file or a directory where the file will be created.

If the directory does not exist, it will be created.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool overloads = true;

Description

When set to true, MrDocs detects function overloads and groups them as a single symbol type.

The documentation for this new symbol comes from the union of non-ambiguous metadata from the functions.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool recursive = true;

Description

Recursively include files.

When set to true, Mr.Docs includes files in subdirectories of the input directories.

When set to false, Mr.Docs includes only the files in the input directories.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

unsigned int report = -1;

Description

The reporting level determines the amount of information displayed during the generation of the documentation.

The value -1 delegates the decision to the log-level option.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::vector<SymbolGlobPattern> seeBelow;

Description

Symbols matching these filters, and symbols in scopes that match, are tagged "see-below" in the documentation.

Use it for symbols that belong to the project's private API but that users still interact with.

On such a symbol's page the implementation synopsis is rendered as "see-below" and the members of a scope, such as a namespace or record, are not listed, while the rest of the documentation appears as usual.

See include-symbols for the pattern syntax.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool sfinae = true;

Description

When set to true, MrDocs detects SFINAE expressions in the source code and extracts them as part of the documentation.

Expressions such as std::enable_if<...> are detected, removed, and documented as a requirement.

MrDocs uses an algorithm that extracts SFINAE infomation from types by identifying inspecting the primary template and specializations to detect the result type and the controlling expressions in a specialization.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool showEnumConstants = false;

Description

When set to true, MrDocs creates a page for each enum constant in the documentation.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool showNamespaces = true;

Description

When set to true, MrDocs creates a page for each namespace in the documentation.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool sortMembers = true;

Description

When set to true, sort the members of a record by the criterion determined in the sort-members-by option.

When set to false, the members are included in the declaration order they are extracted.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool sortMembersAssignment1St = true;

Description

When set to true, assignment operators are sorted first in the list of members of a record.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

SortSymbolBy sortMembersBy = SortSymbolBy::Name;

Description

If sort-members is set to true, determine how members of a record are sorted.

When set to name, members are sorted by name.

When set to location, members are sorted by their primary location in the source code, considering the short name of the path and the location in the file.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool sortMembersConversionLast = true;

Description

When set to true, conversion operators are sorted last in the list of members of a record or namespace.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool sortMembersCtors1St = true;

Description

When set to true, constructors are sorted first in the list of members of a record.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool sortMembersDtors1St = true;

Description

When set to true, destructors are sorted first in the list of members of a record.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool sortMembersRelationalLast = true;

Description

When set to true, relational operators are sorted last in the list of members of a record or namespace.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

SortSymbolBy sortNamespaceMembersBy = SortSymbolBy::Name;

Description

Although members of namespaces are always sorted, determine how members of a namespace are sorted.

When set to name, members are sorted by name.

When set to location, members are sorted by their primary location in the source code, considering the short name of the path and the location in the file.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::string sourceRoot;

Description

The root directory of the source tree.

It is the default location for input files and the base for the relative paths MrDocs forms from absolute ones.

Set it to the root of the git project so those relative paths can link back to the source files in the repository; templates build those links from the base-url option.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::vector<std::string> stdlibIncludes;

Description

When use-system-stdlib is disabled, the C++ standard library headers are available in these paths.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::string stylesdir;

Description

The directory MrDocs writes into the href of linked stylesheets when linkcss is true.

Defaults to css.

When local styles are copied, the directory is created under the output root, for example css/mrdocs-default.css.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::vector<std::string> stylesheets;

Description

Ordered list of stylesheet names or paths.

If empty, the bundled stylesheet is used.

Entries can be local paths or remote URLs; remote URLs are only linked when linkcss is true.

Inline mode embeds local styles; link mode emits <link> tags for each entry and copies local files.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::vector<std::string> systemIncludes;

Description

Directories added to the system header search path.

Headers found there are treated as system headers: they come from outside the project and are not checked for warnings or errors.

The standard library and other external headers usually live here.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

std::string tagfile;

Description

Specifies the full path (filename) where the generated tagfile should be saved.

If left empty, no tagfile will be generated.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool useSystemLibc = true;

Description

To achieve reproducible results, MrDocs bundles the LibC headers with its definitions.

To use the C standard library available in the system instead, set this option to true.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool useSystemStdlib = true;

Description

To achieve reproducible results, MrDocs bundles the LibC++ headers.

To use the C++ standard library available in the system instead, set this option to true.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool verbose = false;

Description

When set to true, MrDocs prints extra information as it generates the documentation.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool warnAsError = false;

Description

When set to true, MrDocs treats warnings as errors and stops the generation of the documentation.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool warnBrokenRef = true;

Description

When set to true, MrDocs outputs a warning message if a reference in the documentation is broken.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool warnIfDocError = true;

Description

When set to true, MrDocs outputs a warning message if the documentation of a symbol has errors such as duplicate parameters and parameters that don't exist.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool warnIfUndocEnumVal = true;

Description

When set to true, MrDocs outputs a warning message if an enum value is not documented.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool warnIfUndocumented = true;

Description

When set to true, MrDocs outputs a warning message if a symbol that passes all filters is not documented.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool warnNoParamdoc = true;

Description

When set to true, MrDocs outputs a warning message if a named function parameter is not documented.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool warnUnnamedParam = false;

Description

When set to true, MrDocs outputs a warning message if a documented function has a parameter that is not named.

Synopsis

Declared in <mrdocs/PublicSettings.hpp>

bool warnings = true;

Description

When set to true, MrDocs outputs warning messages during the generation of the documentation.

It is usually recommended to enable warnings while writing the documentation.

Synopsis

Declared in <mrdocs/Config.hpp>

virtual
~Config() noexcept = 0;

Synopsis

Declared in <mrdocs/Config.hpp>

virtual
dom::Object const&
object() const = 0;

Description

Parameters

Name	Description
settings	Normalized public settings.
dirs	Reference directories used to resolve relative paths.
threadPool	Thread pool that the resulting Config will own a reference to.

Synopsis

Declared in <mrdocs/Config.hpp>

Config() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Expression.hpp>

template<typename T>
struct ConstantExprInfo
    : ExprInfo

Base Classes

Name	Description
`ExprInfo`	Represents an expression

Type Aliases

Name	Description
`type`	The underlying type of the expression

Member Functions

Name	Description
`asExpr`	View this object as its base expression.
`operator<=>`	Three-way comparison operators

Data Members

Name	Description
`Value`	The expressions value, if it is known
`Written`	The expression, as written

Non-Member Functions

Name	Description
`merge`	Merge metadata from another expression.
`merge`	Merge metadata from another constant expression.

Synopsis

Declared in <mrdocs/Metadata/Expression.hpp>

using type = T;

Synopses

Declared in <mrdocs/Metadata/Expression.hpp>

Order constant expressions by written form and value.

auto
operator<=>(ConstantExprInfo const& rhs) const = default;

» more...

Order expressions by written form.

constexpr
auto
operator<=>(ExprInfo const& rhs) const = default;

» more...

Synopsis

Declared in <mrdocs/Metadata/Expression.hpp>

auto
operator<=>(ConstantExprInfo const& rhs) const = default;

Return Value

The relative order of the objects

Parameters

Name	Description
rhs	The right operand

Synopsis

Declared in <mrdocs/Metadata/Expression.hpp>

constexpr
auto
operator<=>(ExprInfo const& rhs) const = default;

Return Value

The relative order of the objects

Parameters

Name	Description
rhs	The right operand

Synopsis

Declared in <mrdocs/Metadata/Expression.hpp>

Optional<type> Value;

Description

The value of an expression will be unknown if it is e.g. dependent on a template parameter

Synopsis

Declared in <mrdocs/Metadata/TArg/ConstantTArg.hpp>

struct ConstantTArg final
    : TArgCommonBase<TArgKind::Constant>

Base Classes

Name	Description
`TArgCommonBase<TArgKind::Constant>`	CRTP base that fixes the argument kind.

Static Member Functions

Name
`isConstant`
`isTemplate`
`isType`

Data Members

Name	Description
`Value`	Template argument expression.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`toString`	Convert a template argument to a human-readable string.

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr
static
bool
isConstant() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr
static
bool
isTemplate() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr
static
bool
isType() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TArg/ConstantTArg.hpp>

ExprInfo Value;

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr static
TArgKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/TParam/ConstantTParam.hpp>

struct ConstantTParam final
    : TParamCommonBase<TParamKind::Constant>

Description

Before C++26, constant template parameters were called non-type template parameter in the standard wording. The terminology was changed by P2841R6 / PR#7587.

Base Classes

Name	Description
`TParamCommonBase<TParamKind::Constant>`	CRTP base that fixes the parameter kind.

Static Member Functions

Name
`isConstant`
`isTemplate`
`isType`

Data Members

Name	Description
`Type`	Type of the non-type template parameter

Static Data Members

Name
`kind_id`

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr
static
bool
isConstant() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr
static
bool
isTemplate() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr
static
bool
isType() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TParam/ConstantTParam.hpp>

Polymorphic<Type> Type = Polymorphic<struct Type>(AutoType{});

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr static
TParamKind kind_id;

Synopsis

Declared in <mrdocs/Corpus.hpp>

class Corpus;

Types

Name	Description
`TraverseOptions`	Options to traverse the members of an Symbol.
`iterator`	The iterator type for the index of all symbols.

Member Functions

Name	Description
`~Corpus` [destructor] [virtual]	Destructor.
`begin` [virtual]	Return the begin iterator for the index of all symbols.
`empty`	Whether the corpus contains any symbols.
`end` [virtual]	Return the end iterator for the index.
`exists`	Return true if an Symbol with the specified symbol ID exists.
`find` [virtual]	Return the Symbol with the matching ID, or nullptr.
`get`	Return the Symbol with the specified symbol ID.
`globalNamespace`	Return the metadata for the global namespace.
`lookup`	`lookup` overloads
`qualifiedName`	`qualifiedName` overloads
`size` [virtual]	Return the number of symbols in the corpus.
`traverse`	Visit the members of specified Symbol.
`visitIDs`	Visit the specified Symbol IDs

Static Member Functions

Name	Description
`build`	Build a Corpus from a configuration.

Data Members

Name	Description
`config`	The configuration used to generate this corpus.

Protected Member Functions

Name	Description
`Corpus` [constructor]	Create a corpus using the provided configuration.

Non-Member Functions

Name	Description
`getParents`	Return a list of the parent symbols of the specified Symbol.

Synopsis

Declared in <mrdocs/Corpus.hpp>

struct TraverseOptions;

Data Members

Name	Description
`ordered`	Whether to traverse in a stable order
`recursive`	Whether to skip inherited members whose parent is not the Symbol
`skipInherited`	Whether to skip inherited members whose parent is not the Symbol

Synopsis

Declared in <mrdocs/Corpus.hpp>

bool ordered = false;

Synopsis

Declared in <mrdocs/Corpus.hpp>

bool recursive = false;

Synopsis

Declared in <mrdocs/Corpus.hpp>

bool skipInherited = false;

Synopsis

Declared in <mrdocs/Corpus.hpp>

class iterator;

Description

The iterator is a forward iterator that iterates over all symbols in the index. It dereferences to a reference to a const Symbol.

The logic for incrementing the iterator is provided by the Corpus implementation via a function that retuns the next Symbol in the index, or nullptr if there are no more.

Type Aliases

Name	Description
`const_pointer`	Pointer to const value.
`const_reference`	Reference to const value.
`difference_type`	Signed difference type.
`pointer`	Pointer to value.
`reference`	Reference to value.
`size_type`	Unsigned size type.
`value_type`	Value type yielded by the iterator.

Member Functions

Name	Description
`iterator` [constructor]	Constructors
`operator=`	Copy assignment.
`operator*`	Dereference to the current symbol.
`operator++`	Increment operators
`operator->`	Pointer-like access to the current symbol.
`operator==`	Equality comparison.
`operator!=`	Inequality comparison.

Synopsis

Declared in <mrdocs/Corpus.hpp>

using const_pointer = value_type const*;

Synopsis

Declared in <mrdocs/Corpus.hpp>

using const_reference = value_type const&;

Synopsis

Declared in <mrdocs/Corpus.hpp>

using difference_type = std::ptrdiff_t;

Synopsis

Declared in <mrdocs/Corpus.hpp>

using pointer = value_type*;

Synopsis

Declared in <mrdocs/Corpus.hpp>

using reference = value_type&;

Synopsis

Declared in <mrdocs/Corpus.hpp>

using size_type = std::size_t;

Synopsis

Declared in <mrdocs/Corpus.hpp>

using value_type = Symbol const;

Synopses

Declared in <mrdocs/Corpus.hpp>

Default constructor.

constexpr
iterator() = default;

» more...

Copy constructor.

constexpr
iterator(iterator const& other) = default;

» more...

Construct an iterator from corpus storage pointers.

iterator(
    Corpus const* corpus,
    Symbol const* val,
    Symbol const*(* next)(Corpus const*, Symbol const*));

» more...

Parameters

Name	Description
corpus	The parent corpus.
val	The current symbol.
next	Function that advances to the next symbol.

Synopsis

Declared in <mrdocs/Corpus.hpp>

constexpr
iterator() = default;

Synopsis

Declared in <mrdocs/Corpus.hpp>

constexpr
iterator(iterator const& other) = default;

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Corpus.hpp>

iterator(
    Corpus const* corpus,
    Symbol const* val,
    Symbol const*(* next)(Corpus const*, Symbol const*));

Parameters

Name	Description
corpus	The parent corpus.
val	The current symbol.
next	Function that advances to the next symbol.

Synopsis

Declared in <mrdocs/Corpus.hpp>

constexpr
iterator&
operator=(iterator const& other) = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Corpus.hpp>

const_reference
operator*() const noexcept;

Return Value

Reference to the current Symbol.

Synopses

Declared in <mrdocs/Corpus.hpp>

Pre-increment.

iterator&
operator++() noexcept;

» more...

Post-increment.

iterator
operator++(int dummy) noexcept;

» more...

Return Value

*this advanced to next element.
Iterator prior to increment.

Parameters

Name	Description
dummy	Unused postfix increment discriminator.

Synopsis

Declared in <mrdocs/Corpus.hpp>

iterator&
operator++() noexcept;

Return Value

*this advanced to next element.

Synopsis

Declared in <mrdocs/Corpus.hpp>

iterator
operator++(int dummy) noexcept;

Return Value

Iterator prior to increment.

Parameters

Name	Description
dummy	Unused postfix increment discriminator.

Synopsis

Declared in <mrdocs/Corpus.hpp>

const_pointer
operator->() const noexcept;

Return Value

Pointer to the current Symbol.

Synopsis

Declared in <mrdocs/Corpus.hpp>

bool
operator==(iterator const& other) const noexcept;

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
other	The right operand

Synopsis

Declared in <mrdocs/Corpus.hpp>

bool
operator!=(iterator const& other) const noexcept;

Return Value

true if the objects are not equal, false otherwise

Parameters

Name	Description
other	The right operand

Synopsis

Declared in <mrdocs/Corpus.hpp>

virtual
~Corpus() noexcept;

Synopsis

Declared in <mrdocs/Corpus.hpp>

virtual
iterator
begin() const noexcept = 0;

Return Value

the begin iterator for the index of all symbols.

Synopsis

Declared in <mrdocs/Corpus.hpp>

bool
empty() const noexcept;

Description

Parameters

Name	Description
id	A unique identifier for a symbol.

Synopsis

Declared in <mrdocs/Corpus.hpp>

virtual
Symbol const*
find(SymbolID const& id) const noexcept = 0;

Return Value

the Symbol with the matching ID, or nullptr.

Parameters

Name	Description
id	A unique identifier for a symbol.

Synopsis

Declared in <mrdocs/Corpus.hpp>

template<class T = Symbol>
requires std::derived_from<T, Symbol>
T const&
get(SymbolID const& id) const noexcept;

Description

This function uses the find function to locate the Symbol with the specified symbol ID. The result is converted to the specified type T and returned.

The function exists can be used to determine if an Symbol with the specified symbol ID exists. If the id does not exist, the behavior is undefined.

If the Symbol is not of type T, the behavior is undefined.

Return Value

the Symbol with the specified symbol ID.

Parameters

Name	Description
id	A unique identifier for a symbol.

Synopsis

Declared in <mrdocs/Corpus.hpp>

NamespaceSymbol const&
globalNamespace() const noexcept;

Description

This function is equivalent to calling get with the symbol ID for the global namespace.

Return Value

the metadata for the global namespace.

Synopses

Declared in <mrdocs/Corpus.hpp>

Return the Symbol for the matching string in the global context.

Expected<Symbol const&>
lookup(std::string_view name) const;

» more...

Return the Symbol for the matching string in a given context.

virtual
Expected<Symbol const&>
lookup(
    SymbolID const& context,
    std::string_view name) const = 0;

» more...

Return Value

The Symbol for the symbol with the specified name in the global context, or an error if not found.
The Symbol for the symbol with the specified name in the specified context, or an error if not found. If multiple symbols match, one is returned arbitrarily. Use traverse to find all matching symbols.

Parameters

Name	Description
name	The name of the symbol to look up.
context	The context to look up the symbol in.

Synopsis

Declared in <mrdocs/Corpus.hpp>

Expected<Symbol const&>
lookup(std::string_view name) const;

Return Value

The Symbol for the symbol with the specified name in the global context, or an error if not found.

Parameters

Name	Description
name	The name of the symbol to look up.

Synopsis

Declared in <mrdocs/Corpus.hpp>

virtual
Expected<Symbol const&>
lookup(
    SymbolID const& context,
    std::string_view name) const = 0;

Return Value

The Symbol for the symbol with the specified name in the specified context, or an error if not found. If multiple symbols match, one is returned arbitrarily. Use traverse to find all matching symbols.

Parameters

Name	Description
context	The context to look up the symbol in.
name	The name of the symbol to look up.

Synopses

Declared in <mrdocs/Corpus.hpp>

Return the fully qualified name of I.

std::string
qualifiedName(Symbol const& I) const;

» more...

Populate temp with the fully qualified name of I.

virtual
void
qualifiedName(
    Symbol const& I,
    std::string& temp) const = 0;

» more...

Return the qualified name of I relative to context.

std::string
qualifiedName(
    Symbol const& I,
    SymbolID const& context) const;

» more...

Populate result with a qualified name relative to context. If context contains I, the name is relative; otherwise it is computed from the global namespace.

virtual
void
qualifiedName(
    Symbol const& I,
    SymbolID const& context,
    std::string& result) const = 0;

» more...

Parameters

Name	Description
I	The Symbol to get the qualified name for.
temp	The string to store the result in.
context	The context used to qualify the name.
result	Output string receiving the name.

Synopsis

Declared in <mrdocs/Corpus.hpp>

std::string
qualifiedName(Symbol const& I) const;

Return Value

the fully qualified name of I.

Parameters

Name	Description
I	Base class with common properties of all symbols

Synopsis

Declared in <mrdocs/Corpus.hpp>

virtual
void
qualifiedName(
    Symbol const& I,
    std::string& temp) const = 0;

Parameters

Name	Description
I	The Symbol to get the qualified name for.
temp	The string to store the result in.

Synopsis

Declared in <mrdocs/Corpus.hpp>

std::string
qualifiedName(
    Symbol const& I,
    SymbolID const& context) const;

Return Value

the qualified name of I relative to context.

Parameters

Name	Description
I	Base class with common properties of all symbols
context	A unique identifier for a symbol.

Synopsis

Declared in <mrdocs/Corpus.hpp>

virtual
void
qualifiedName(
    Symbol const& I,
    SymbolID const& context,
    std::string& result) const = 0;

Parameters

Name	Description
I	The Symbol to name.
context	The context used to qualify the name.
result	Output string receiving the name.

Synopsis

Declared in <mrdocs/Corpus.hpp>

virtual
std::size_t
size() const noexcept = 0;

Description

The global namespace is always counted when present, so a size of 1 means no declaration other than the global namespace was extracted.

Return Value

The number of symbols in the corpus.

Synopses

Declared in <mrdocs/Corpus.hpp>

Visit the members of specified Symbol.

template<
    std::derived_from<Symbol> T,
    class F,
    class... Args>
void
traverse(
    T const& I,
    F&& f,
    Args&&... args) const;

» more...

Visit the members of specified Symbol.

template<
    std::derived_from<Symbol> T,
    class F,
    class... Args>
void
traverse(
    TraverseOptions const& opts,
    T const& I,
    F&& f,
    Args&&... args) const;

» more...

Parameters

Name	Description
I	The Symbol to visit.
f	The function to invoke.
args	The arguments to pass to the function.
opts	The options to traverse.

Synopsis

Declared in <mrdocs/Corpus.hpp>

template<
    std::derived_from<Symbol> T,
    class F,
    class... Args>
void
traverse(
    T const& I,
    F&& f,
    Args&&... args) const;

Description

This function invokes the specified function f for each member of the specified Symbol I.

For each member of I, the function will invoke the function object fn with a type derived from Symbol as the first argument, followed by args....

The type of the first argument is determined by the SymbolKind of the Symbol object.

Parameters

Name	Description
I	The Symbol to visit.
f	The function to invoke.
args	The arguments to pass to the function.

Synopsis

Declared in <mrdocs/Corpus.hpp>

template<
    std::derived_from<Symbol> T,
    class F,
    class... Args>
void
traverse(
    TraverseOptions const& opts,
    T const& I,
    F&& f,
    Args&&... args) const;

Description

This function invokes the specified function f for each member of the specified Symbol I.

For each member of I, the function will invoke the function object fn with a type derived from Symbol as the first argument, followed by args....

The type of the first argument is determined by the SymbolKind of the Symbol object.

Parameters

Name	Description
opts	The options to traverse.
I	The Symbol to visit.
f	The function to invoke.
args	The arguments to pass to the function.

Synopsis

Declared in <mrdocs/Corpus.hpp>

template<
    range_of<SymbolID> R,
    class F,
    class... Args>
void
visitIDs(
    R&& range,
    F&& f,
    Args&&... args) const;

Description

This function invokes the specified function f for each member of the specified range of Symbol IDs.

For each member of I associated with the ID in range, the function will invoke the function object fn with a type derived from Symbol as the first argument, followed by args....

The type of the first argument is determined by the SymbolKind of the Symbol object.

Parameters

Name	Description
range	A range of SymbolID objects.
f	The function to invoke.
args	The arguments to pass to the function.

Synopsis

Declared in <mrdocs/Corpus.hpp>

static
Expected<std::unique_ptr<Corpus>>
build(std::shared_ptr<Config const> const& config);

Description

Drives extraction over the translation units described by the configuration. The compilation database is resolved from the configuration settings (a compile_commands.json path, a CMakeLists.txt plus cmake options, or a database synthesized from source-root and input).

Return Value

A unique pointer to the populated Corpus on success, otherwise an Error.

Parameters

Name	Description
config	The Config used for extraction, as returned by `Config::load`.

Synopsis

Declared in <mrdocs/Corpus.hpp>

Config const& config;

Synopsis

Declared in <mrdocs/Corpus.hpp>

explicit
Corpus(Config const& config_) noexcept;

Parameters

Name	Description
config_	The object to copy construct from

Synopsis

Declared in <mrdocs/Metadata/Type/DecltypeType.hpp>

struct DecltypeType final
    : TypeCommonBase<TypeKind::Decltype>

Base Classes

Name	Description
`TypeCommonBase<TypeKind::Decltype>`	CRTP base that ties a concrete type to a fixed TypeKind.

Static Member Functions

Name
`isArray`
`isAuto`
`isDecltype`
`isFunction`
`isLValueReference`
`isMemberPointer`
`isNamed`
`isPointer`
`isRValueReference`

Data Members

Name	Description
`Operand`	Operand expression for decltype.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`innerType`	Return the inner type.
`innerType`	Return the inner type.
`innerTypePtr`	Return the inner type.
`innerTypePtr`	Return the inner type.
`toString`	Render a type to a human-readable string.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isArray() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isAuto() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isDecltype() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isLValueReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isMemberPointer() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isNamed() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isPointer() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isRValueReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/DecltypeType.hpp>

ExprInfo Operand;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr static
TypeKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

struct DocComment;

Description

A complete documentation comment document consists of a sequence of text blocks. Blocks are the top-level structural units that might contain other blocks or inline elements. These are analogous to markdown blocks.

Inline elements (text, emphasis, links, code spans, etc.) live inside certain block types, like paragraphs or headings. Inlines can contain other inlines (e.g., emphasis contains text, link contains text), but they cannot directly contain blocks.

Some blocks contain metadata about the symbol being documented, such as parameters and return values. These blocks are parsed as usual, but are stored separately in the DocComment structure.

Each block in the document might contain:

No other blocks (leaf blocks)
Other blocks (container blocks: e.g. lists)

When they contain no other blocks, they might be:

Inlines only (e.g. paragraphs)
No inlines (e.g. horizontal rule)

Inline content elements contain other inlines but cannot contain blocks.

Member Functions

Name	Description
`DocComment` [constructor]	Constructors
`append`	Append blocks from another DocComment to this.
`empty`	Return true if this is empty
`operator==`	Equality compares all stored blocks.
`operator!=`	Inequality is the negation of equality.
`operator<=>`	Three-way comparison on the rendered block sequence.

Data Members

Name	Description
`Document`	The list of text blocks.
`IsFunctionObject`	True if the
`IsSeeBelow`	True if the
`brief`	A brief description of the symbol.
`exceptions`	The list of exceptions.
`params`	The list of parameters.
`postconditions`	The list of postconditions.
`preconditions`	The list of preconditions.
`related`	The list of "related" references.
`relates`	The list of "relates" references.
`returns`	The list of return type descriptions.
`sees`	The list of "see also" references.
`tparams`	The list of template parameters.

Non-Member Functions

Name	Description
`merge`	Append blocks from `other` into `I`, preserving order.

Synopses

Declared in <mrdocs/Metadata/DocComment.hpp>

Constructor.

DocComment() noexcept;

» more...

Constructor

explicit
DocComment(std::vector<Polymorphic<doc::Block>> blocks);

» more...

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

DocComment() noexcept;

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

explicit
DocComment(std::vector<Polymorphic<doc::Block>> blocks);

Parameters

Name	Description
blocks	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

void
append(DocComment&& other);

Parameters

Name	Description
other	A processed documentation comment attached to a declaration.

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

bool
empty() const noexcept;

Return Value

true if this is empty

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

constexpr
bool
operator==(DocComment const& rhs) const noexcept = default;

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
rhs	The right operand

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

bool
operator!=(DocComment const& rhs) const noexcept;

Return Value

true if the objects are not equal, false otherwise

Parameters

Name	Description
rhs	The right operand

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

auto
operator<=>(DocComment const& other) const noexcept;

Return Value

The relative order of the objects

Parameters

Name	Description
other	The right operand

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

std::vector<Polymorphic<doc::Block>> Document;

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

bool IsFunctionObject = false;

Description

(or

) command was used on this symbol.

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

bool IsSeeBelow = false;

Description

command was used on this symbol.

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

Optional<doc::BriefBlock> brief;

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

std::vector<doc::ThrowsBlock> exceptions;

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

std::vector<doc::ParamBlock> params;

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

std::vector<doc::PostconditionBlock> postconditions;

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

std::vector<doc::PreconditionBlock> preconditions;

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

std::vector<doc::ReferenceInline> related;

Description

These references are the inverse of the relates command.

They are calculated automatically by MrDocs and are rendered as Non-Member Functions.

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

std::vector<doc::ReferenceInline> relates;

Description

These references are created with the relates command.

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

std::vector<doc::ReturnsBlock> returns;

Description

Multiple return descriptions are allowed.

The results are concatenated in the order they appear in the source code.

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

std::vector<doc::SeeBlock> sees;

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

std::vector<doc::TParamBlock> tparams;

Synopsis

Declared in <mrdocs/Metadata/DomCorpus.hpp>

class DomCorpus;

Description

This class keeps a reference to the Corpus of extracted metadata, and provides a mechanism for constructing DOM nodes representing the metadata.

A Generator can subclass this object then uses it to create the Dom nodes used as input for rendering template engines.

Member Functions

Name	Description
`DomCorpus` [constructor]	Constructor.
`~DomCorpus` [destructor] [virtual]	Destructor.
`construct` [virtual]	Construct a lazy Dom object representing the specified symbol.
`get`	Return a Dom object representing the given symbol.
`getCorpus`	Returns the Corpus associated with the Dom.
`getDocComment` [virtual]	Return a Dom value representing the DocComment.
`operator*`	Returns the Corpus associated with the Dom.
`operator->`	Returns the Corpus associated with the Dom.

Non-Member Functions

Name	Description
`getParents`	Return a list of the parent symbols of the specified Info.

Synopsis

Declared in <mrdocs/Metadata/DomCorpus.hpp>

DomCorpus(Corpus const& corpus);

Description

Ownership of the specified Corpus is not transferred; the caller is responsible for ensuring the lifetime extension of the object.

Parameters

Name	Description
corpus	The Corpus whose metadata to use.

Synopsis

Declared in <mrdocs/Metadata/DomCorpus.hpp>

virtual
~DomCorpus();

Synopsis

Declared in <mrdocs/Metadata/DomCorpus.hpp>

virtual
dom::Object
construct(Symbol const& I) const;

Description

This function is called internally when a dom::Object representing a symbol needs to be constructed because it was not found in the cache.

Return Value

A container of key and value pairs.

Parameters

Name	Description
I	Base class with common properties of all symbols

Synopsis

Declared in <mrdocs/Metadata/DomCorpus.hpp>

dom::Value
get(SymbolID const& id) const;

Return Value

A value containing the symbol contents, or null if id is invalid.

Parameters

Name	Description
id	The id of the symbol to return.

Synopsis

Declared in <mrdocs/Metadata/DomCorpus.hpp>

Corpus const&
getCorpus() const;

Return Value

the Corpus associated with the Dom.

Synopsis

Declared in <mrdocs/Metadata/DomCorpus.hpp>

virtual
dom::Value
getDocComment(DocComment const& jd) const;

Description

The default implementation returns null. A Generator should override this member and return a value that has suitable strings in the generator's output format.

Return Value

a Dom value representing the DocComment.

Parameters

Name	Description
jd	A processed documentation comment attached to a declaration.

Synopsis

Declared in <mrdocs/Metadata/DomCorpus.hpp>

Corpus const&
operator*() const;

Return Value

the Corpus associated with the Dom.

Synopsis

Declared in <mrdocs/Metadata/DomCorpus.hpp>

Corpus const*
operator->() const;

Return Value

the Corpus associated with the Dom.

Synopsis

Declared in <mrdocs/Metadata/Symbol/EnumConstant.hpp>

struct EnumConstantSymbol final
    : SymbolCommonBase<SymbolKind::EnumConstant>

Base Classes

Name	Description
`SymbolCommonBase<SymbolKind::EnumConstant>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`EnumConstantSymbol` [constructor]	Construct an enum constant with its ID.

Static Member Functions

Name
`isConcept`
`isEnum`
`isEnumConstant`
`isFunction`
`isGuide`
`isNamespace`
`isNamespaceAlias`
`isOverloads`
`isRecord`
`isTypedef`
`isUsing`
`isVariable`

Data Members

Name	Description
`Initializer`	The initializer expression, if any

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`canMerge`	Check whether two symbols may be merged.
`getPrimaryLocation`	Determine a location to use when none is explicitly chosen.

Synopsis

Declared in <mrdocs/Metadata/Symbol/EnumConstant.hpp>

explicit
EnumConstantSymbol(SymbolID ID) noexcept;

Parameters

Name	Description
ID	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isConcept() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnum() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnumConstant() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isGuide() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespace() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespaceAlias() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isOverloads() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isRecord() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isTypedef() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isUsing() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isVariable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/EnumConstant.hpp>

ConstantExprInfo<uint64_t> Initializer;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr static
SymbolKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Enum.hpp>

struct EnumSymbol final
    : SymbolCommonBase<SymbolKind::Enum>

Base Classes

Name	Description
`SymbolCommonBase<SymbolKind::Enum>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`EnumSymbol` [constructor]	Construct an enum symbol with its ID.

Static Member Functions

Name
`isConcept`
`isEnum`
`isEnumConstant`
`isFunction`
`isGuide`
`isNamespace`
`isNamespaceAlias`
`isOverloads`
`isRecord`
`isTypedef`
`isUsing`
`isVariable`

Data Members

Name	Description
`Constants`	The members of this scope.
`Scoped`	Indicates whether this enum is scoped (e.g. enum class).
`UnderlyingType`	The underlying type of this enum, if explicitly specified.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`allMembers`	Return the list of enum constants for this symbol.
`canMerge`	Check whether two symbols may be merged.
`getPrimaryLocation`	Determine a location to use when none is explicitly chosen.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Enum.hpp>

explicit
EnumSymbol(SymbolID ID) noexcept;

Parameters

Name	Description
ID	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isConcept() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnum() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnumConstant() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isGuide() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespace() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespaceAlias() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isOverloads() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isRecord() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isTypedef() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isUsing() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isVariable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Enum.hpp>

std::vector<SymbolID> Constants;

Description

All members are enum constants.

Enum constants are independent symbol types that can be documented separately.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Enum.hpp>

bool Scoped = false;

Description

If true, the enumerators are accessed with the scope resolution operator (e.g. EnumName::Enumerator).

If false, the enumerators are accessed directly (e.g. Enumerator) in the parent context.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Enum.hpp>

Optional<Polymorphic<Type>> UnderlyingType = std::nullopt;

Description

If not specified, the underlying type is an implementation-defined integral type that can represent all the enumerator values defined in the enumeration.

For enum Foo : short { ... }; this will be represent short.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr static
SymbolKind kind_id;

Synopsis

Declared in <mrdocs/Support/Error.hpp>

class Error final

Member Functions

Name	Description
`Error` [constructor]	Constructor.
`operator=`	Assignment operators
`Throw`	`Throw` overloads
`failed`	Return true if this holds an error.
`location`	Return the source location.
`message`	Return the error string.
`reason`	Return the reason string.
`swap`	Swap the contents with another error.
`where`	Return the location string.
`operator bool`	Return true if this holds an error.
`operator==`	Return true if this equals rhs.

Friends

Name	Description
`mrdocs::swap`

Non-Member Functions

Name	Description
`formatError`	Return a formatted error.

Synopses

Declared in <mrdocs/Support/Error.hpp>

Constructor.

constexpr
Error() noexcept = default;

» more...

Constructor.

constexpr
Error(Error const& other) = default;

» more...

Constructor.

constexpr
Error(Error&& other) noexcept = default;

» more...

Constructor.

explicit
Error(std::exception const& ex);

» more...

Constructor.

explicit
Error(
    std::string reason,
    std::source_location loc = source_location::current());

» more...

Constructor.

explicit
Error(
    std::error_code const& ec,
    std::source_location loc = source_location::current());

» more...

Constructor.

Error(
    std::vector<Error> const& errors,
    std::source_location loc = source_location::current());

» more...

Parameters

Name	Description
reason	A string indicating the cause of the failure. This must not be empty.
loc	The source location where the error occurred.
ec	The error code.
errors	The list of errors to combine.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

constexpr
Error() noexcept = default;

Description

A default-constructed error is equivalent to success.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

constexpr
Error(Error const& other) = default;

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Error.hpp>

constexpr
Error(Error&& other) noexcept = default;

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Support/Error.hpp>

explicit
Error(std::exception const& ex);

Description

The constructed object will always indicate a failure, even if the message in the exception is empty.

Parameters

Name	Description
ex	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Error.hpp>

explicit
Error(
    std::string reason,
    std::source_location loc = source_location::current());

Parameters

Name	Description
reason	A string indicating the cause of the failure. This must not be empty.
loc	The source location where the error occurred.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

explicit
Error(
    std::error_code const& ec,
    std::source_location loc = source_location::current());

Parameters

Name	Description
ec	The error code.
loc	The source location where the error occurred.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

Error(
    std::vector<Error> const& errors,
    std::source_location loc = source_location::current());

Description

This constructs a new error from a list of zero or more errors. If the list is empty, or if all the errors in the list indicate success, then newly constructed object will indicate success.

Parameters

Name	Description
errors	The list of errors to combine.
loc	The source location where the error occurred.

Synopses

Declared in <mrdocs/Support/Error.hpp>

Assignment.

constexpr
Error&
operator=(Error const& other) = default;

» more...

Constructor.

constexpr
Error&
operator=(Error&& other) noexcept = default;

» more...

Synopsis

Declared in <mrdocs/Support/Error.hpp>

constexpr
Error&
operator=(Error const& other) = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Support/Error.hpp>

constexpr
Error&
operator=(Error&& other) noexcept = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to move assign from

Synopses

Declared in <mrdocs/Support/Error.hpp>

Throw Exception(*this)

[[noreturn]]
void
Throw() const &;

» more...

Throw Exception(std::move(*this))

[[noreturn]]
void
Throw() &&;

» more...

Preconditions

this->failed()

Synopsis

Declared in <mrdocs/Support/Error.hpp>

[[noreturn]]
void
Throw() const &;

Preconditions

this->failed()

Synopsis

Declared in <mrdocs/Support/Error.hpp>

[[noreturn]]
void
Throw() &&;

Preconditions

this->failed()

Synopsis

Declared in <mrdocs/Support/Error.hpp>

constexpr
bool
failed() const noexcept;

Return Value

true if this holds an error.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

constexpr
std::source_location const&
location() const noexcept;

Return Value

the source location.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

constexpr
std::string const&
message() const noexcept;

Return Value

the error string.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

constexpr
std::string const&
reason() const noexcept;

Return Value

the reason string.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

constexpr
void
swap(Error& rhs) noexcept;

Parameters

Name	Description
rhs	Holds the description of an error, or success.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

constexpr
std::string const&
where() const noexcept;

Return Value

the location string.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

constexpr
explicit
operator bool() const noexcept;

Return Value

true if this holds an error.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

constexpr
bool
operator==(Error const& rhs) const noexcept;

Return Value

true if this equals rhs.

Parameters

Name	Description
rhs	The right operand

Synopsis

Declared in <mrdocs/Support/Error.hpp>

class Exception final
    : public std::exception

Base Classes

Name	Description
`std::exception`	Base class for all library exceptions.

Member Functions

Name	Description
`Exception` [constructor]	Constructor.
`operator=`	Assignment operators
`error`	Return the Error stored in the exception.
`what` [virtual]	Return a null-terminated error string.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

explicit
Exception(Error err) noexcept;

Parameters

Name	Description
err	The object to construct from

Synopses

Declared in <bits/exception.h>

Assignment operator

constexpr
exception&
operator=(exception const& value) = default;

» more...

Assignment operator

constexpr
exception&
operator=(exception&& value) = default;

» more...

Synopsis

Declared in <bits/exception.h>

constexpr
exception&
operator=(exception const& value) = default;

Return Value

Base class for all library exceptions.

Parameters

Name	Description
value	The object to copy assign from

Synopsis

Declared in <bits/exception.h>

constexpr
exception&
operator=(exception&& value) = default;

Return Value

Base class for all library exceptions.

Parameters

Name	Description
value	The object to move assign from

Synopsis

Declared in <mrdocs/Support/Error.hpp>

Error const&
error() const noexcept;

Return Value

the Error stored in the exception.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

virtual
char const*
what() const noexcept override;

Return Value

a null-terminated error string.

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

template<class Agent>
class ExecutorGroup
    : public ExecutorGroupBase

Base Classes

Name	Description
`ExecutorGroupBase`	Base class that owns a pool of execution agents and a shared work queue.

Type Aliases

Name	Description
`arg_t`	Argument wrapper propagated from ThreadPool.

Member Functions

Name	Description
`ExecutorGroup` [constructor]	Construct a new executor group bound to a thread pool.
`async`	Submit work to be executed.
`emplace`	Construct a new agent in the group.
`wait`	Block until all work has completed.

Protected Types

Name	Description
`AnyAgent`	Type-erased agent holder used by the base class.
`Impl`	Opaque implementation shared by all ExecutorGroup instantiations.

Protected Member Functions

Name	Description
`post`	Queue work to run on the group agents.
`run`	Execute queued work until empty.

Protected Data Members

Name	Description
`agents_`	Agents owned by the group.
`impl_`	Opaque implementation pointer shared by all ExecutorGroup instantiations.
`work_`	Pending work posted to the group.

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

explicit
ExecutorGroup(ThreadPool& threadPool);

Parameters

Name	Description
threadPool	Pool that owns the worker threads.

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

template<
    class F,
    class... Args>
void
async(
    F&& f,
    Args&&... args);

Description

The function object must have this equivalent signature:


void( Agent&, Args... );

Parameters

Name	Description
f	The function to invoke.
args	Zero or more arguments to forward to the function.

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

template<class... Args>
void
emplace(Args&&... args);

Description

The behavior is undefined if there is any outstanding work or busy threads.

Parameters

Name	Description
args	Zero or more arguments to forward to the agent constructor.

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

class ExecutorGroupBase;

Type Aliases

Name	Description
`arg_t`	Argument wrapper propagated from ThreadPool.

Member Functions

Name	Description
`ExecutorGroupBase` [constructor]	Move-construct from another group.
`~ExecutorGroupBase` [destructor]	Destroy the executor group, waiting for outstanding work.
`wait`	Block until all work has completed.

Protected Types

Name	Description
`AnyAgent`	Type-erased agent holder used by the base class.
`Impl`	Opaque implementation shared by all ExecutorGroup instantiations.

Protected Member Functions

Name	Description
`ExecutorGroupBase` [constructor]	Construct with a backing thread pool.
`post`	Queue work to run on the group agents.
`run`	Execute queued work until empty.

Protected Data Members

Name	Description
`agents_`	Agents owned by the group.
`impl_`	Opaque implementation pointer shared by all ExecutorGroup instantiations.
`work_`	Pending work posted to the group.

Derived Classes

Name	Description
`ExecutorGroup`	A set of execution agents for performing concurrent work.

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

template<class T>
using arg_t = ThreadPool::arg_t<T>;

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

ExecutorGroupBase(ExecutorGroupBase&& other) noexcept;

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

~ExecutorGroupBase();

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

[[nodiscard]]
std::vector<Error>
wait() noexcept;

Return Value

Zero or more errors which were thrown from submitted work.

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

struct AnyAgent;

Member Functions

Name	Description
`~AnyAgent` [destructor] [virtual]	Virtual destructor to allow deleting through the base pointer.
`get` [virtual]	Return a pointer to the stored agent object.

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

virtual
~AnyAgent() = 0;

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

virtual
void*
get() noexcept = 0;

Return Value

a pointer to the stored agent object.

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

struct Impl;

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

explicit
ExecutorGroupBase(ThreadPool& value);

Parameters

Name	Description
value	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

void
post(any_callable<void(void*)> work);

Parameters

Name	Description
work	A movable, type-erased function object.

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

void
run(std::unique_lock<std::mutex> lock);

Parameters

Name	Description
lock	Held lock protecting the work queue.

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

std::vector<std::unique_ptr<AnyAgent>> agents_;

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

std::unique_ptr<Impl> impl_;

Synopsis

Declared in <mrdocs/Support/ExecutorGroup.hpp>

std::deque<any_callable<void(void*)>> work_;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<
    class T,
    class E = Error>
class Expected;

Description

Monadic result type holding either a value T or an unexpected error E.

Type Aliases

Name	Description
`error_type`	Type produced on failure.
`rebind`	Rebind to an `Expected` with a different value type and the same error type.
`unexpected_type`	Convenience alias for an Unexpected containing the error type.
`value_type`	Type produced on success.

Member Functions

Name	Description
`Expected` [constructor]	Constructors
`~Expected` [destructor]	Destructors
`operator=` [deleted]	Assignment operators
`and_then`	`and_then` overloads
`emplace`	`emplace` overloads
`error`	Access the stored error; precondition: !has_value().
`error_or`	`error_or` overloads
`has_value`	Return true when the Expected contains a value.
`operator*`	Dereference operators
`operator->`	Access value members through pointer syntax.
`or_else`	`or_else` overloads
`swap`	Swap the stored state with another Expected.
`transform`	`transform` overloads
`transform_error`	`transform_error` overloads
`value`	`value` overloads
`value_or`	`value_or` overloads
`operator bool`	Return true when the Expected contains a value.

Data Members

Name	Description
`unex_` [variant member]	Storage for the unexpected error.
`val_` [variant member]	Storage for the engaged value.

Friends

Name	Description
`mrdocs::swap`	Swap contents with another Expected.
`mrdocs::operator==`	Equality operator
`mrdocs::operator==`	Equality operator
`mrdocs::operator==`	Equality operator
`mrdocs::Expected`	A container holding an error or a value.

Non-Member Functions

Name	Description
`forEachFile`	Call a function for each file in a directory.
`forEachFile`	Visit each file in a directory.
`getSinglePageFullPath`	Return the full path for single page output.
`installGenerator`	Install a custom generator.
`parse`	Parse a string view
`files::createDirectory`	Create a directory.
`files::getFileText`	Return the contents of a file as a string.
`files::getFileType`	Return the file type or an error
`files::makeAbsolute`	Return an absolute path from a possibly relative path.
`files::requireAbsolute`	Return an error if pathName is not absolute.
`files::requireDirectory`	Return an error if the path is not a directory.
`js::registerHelper`	Register a JavaScript helper function
`lua::registerHelper`	Register a Lua helper function

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

using error_type = E;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
using rebind = Expected<U, error_type>;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

using unexpected_type = Unexpected<E>;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

using value_type = T;

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Construct an engaged Expected with a default-initialized value.

constexpr
Expected() noexcept(std::is_nothrow_default_constructible_v<T>)
requires std::is_default_constructible_v<T>;

» more...

Default copy constructor.

Expected(Expected const& other) = default;

» more...

Copy-construct, handling non-trivial alternatives.

constexpr
Expected(Expected const& x) noexcept(std::is_nothrow_copy_constructible_v<T> && std::is_nothrow_copy_constructible_v<E>)
requires std::is_copy_constructible_v<T> &&
        std::is_copy_constructible_v<E> &&
        (!std::is_trivially_copy_constructible_v<T> ||
         !std::is_trivially_copy_constructible_v<E>);

» more...

Construct from another Expected with potentially different types.

template<
    class U,
    class G>
requires std::is_constructible_v<T, U const&> &&
        std::is_constructible_v<E, G const&> &&
        (!constructible_from_expected<U, G>)
constexpr
explicit(explicit_conv<const U &, const G &>)
Expected(Expected<U, G> const& x) noexcept(std::is_nothrow_constructible_v<T, const U &> && std::is_nothrow_constructible_v<E, const G &>);

» more...

Default move constructor. Default move constructor.

Expected(Expected&& other) = default;

» more...

Move-construct, handling non-trivial alternatives.

constexpr
Expected(Expected&& x) noexcept(std::is_nothrow_move_constructible_v<T> && std::is_nothrow_move_constructible_v<E>)
requires std::is_move_constructible_v<T> &&
        std::is_move_constructible_v<E> &&
        (!std::is_trivially_move_constructible_v<T> ||
         !std::is_trivially_move_constructible_v<E>);

» more...

Move-construct from another Expected with potentially different types.

template<
    class U,
    class G>
requires std::is_constructible_v<T, U> &&
        std::is_constructible_v<E, G> &&
        (!constructible_from_expected<U, G>)
constexpr
explicit(explicit_conv<U, G>)
Expected(Expected<U, G>&& x) noexcept(std::is_nothrow_constructible_v<T, U> && std::is_nothrow_constructible_v<E, G>);

» more...

Construct a disengaged Expected from an unexpected error (copy).

template<class G = E>
requires std::is_constructible_v<E, G const&>
constexpr
explicit(!std::is_convertible_v<const G &, E>)
Expected(Unexpected<G> const& u) noexcept(std::is_nothrow_constructible_v<E, const G &>);

» more...

Construct an engaged Expected from a convertible value.

template<class U = T>
requires (!std::is_same_v<std::remove_cvref_t<U>, Expected>) &&
        (!std::is_same_v<std::remove_cvref_t<U>, std::in_place_t>) &&
        (!detail::isUnexpected<std::remove_cvref_t<U>>) &&
        std::is_constructible_v<T, U>
constexpr
explicit(!std::is_convertible_v<U, T>)
Expected(U&& v) noexcept(std::is_nothrow_constructible_v<T, U>);

» more...

Construct a disengaged Expected from an unexpected error (move).

template<class G = E>
requires std::is_constructible_v<E, G>
constexpr
explicit(!std::is_convertible_v<G, E>)
Expected(Unexpected<G>&& u) noexcept(std::is_nothrow_constructible_v<E, G>);

» more...

Construct an engaged Expected in-place.

template<class... Args>
requires std::is_constructible_v<T, Args...>
constexpr
explicit
Expected(
    std::in_place_t,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<T, Args...>);

» more...

Construct a disengaged Expected holding an error.

template<class... Args>
requires std::is_constructible_v<E, Args...>
constexpr
explicit
Expected(
    unexpect_t,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<E, Args...>);

» more...

Construct an engaged Expected from an initializer list.

template<
    class U,
    class... Args>
requires std::is_constructible_v<T, std::initializer_list<U>&, Args...>
constexpr
explicit
Expected(
    std::in_place_t,
    std::initializer_list<U> il,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<T, std::initializer_list<U> &, Args...>);

» more...

Construct a disengaged Expected from an initializer list.

template<
    class U,
    class... Args>
requires std::is_constructible_v<E, std::initializer_list<U>&, Args...>
constexpr
explicit
Expected(
    unexpect_t,
    std::initializer_list<U> il,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<E, std::initializer_list<U> &, Args...>);

» more...

Parameters

Name	Description
args	Arguments forwarded to the value constructor.
il	Initializer list forwarded to the value constructor.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Expected() noexcept(std::is_nothrow_default_constructible_v<T>)
requires std::is_default_constructible_v<T>;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

Expected(Expected const& other) = default;

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Expected(Expected const& x) noexcept(std::is_nothrow_copy_constructible_v<T> && std::is_nothrow_copy_constructible_v<E>)
requires std::is_copy_constructible_v<T> &&
        std::is_copy_constructible_v<E> &&
        (!std::is_trivially_copy_constructible_v<T> ||
         !std::is_trivially_copy_constructible_v<E>);

Description

Copy-construct from another void Expected.

Parameters

Name	Description
x	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<
    class U,
    class G>
requires std::is_constructible_v<T, U const&> &&
        std::is_constructible_v<E, G const&> &&
        (!constructible_from_expected<U, G>)
constexpr
explicit(explicit_conv<const U &, const G &>)
Expected(Expected<U, G> const& x) noexcept(std::is_nothrow_constructible_v<T, const U &> && std::is_nothrow_constructible_v<E, const G &>);

Parameters

Name	Description
x	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

Expected(Expected&& other) = default;

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Expected(Expected&& x) noexcept(std::is_nothrow_move_constructible_v<T> && std::is_nothrow_move_constructible_v<E>)
requires std::is_move_constructible_v<T> &&
        std::is_move_constructible_v<E> &&
        (!std::is_trivially_move_constructible_v<T> ||
         !std::is_trivially_move_constructible_v<E>);

Description

Move-construct from another void Expected.

Parameters

Name	Description
x	The object to move construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<
    class U,
    class G>
requires std::is_constructible_v<T, U> &&
        std::is_constructible_v<E, G> &&
        (!constructible_from_expected<U, G>)
constexpr
explicit(explicit_conv<U, G>)
Expected(Expected<U, G>&& x) noexcept(std::is_nothrow_constructible_v<T, U> && std::is_nothrow_constructible_v<E, G>);

Parameters

Name	Description
x	The object to move construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class G = E>
requires std::is_constructible_v<E, G const&>
constexpr
explicit(!std::is_convertible_v<const G &, E>)
Expected(Unexpected<G> const& u) noexcept(std::is_nothrow_constructible_v<E, const G &>);

Parameters

Name	Description
u	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U = T>
requires (!std::is_same_v<std::remove_cvref_t<U>, Expected>) &&
        (!std::is_same_v<std::remove_cvref_t<U>, std::in_place_t>) &&
        (!detail::isUnexpected<std::remove_cvref_t<U>>) &&
        std::is_constructible_v<T, U>
constexpr
explicit(!std::is_convertible_v<U, T>)
Expected(U&& v) noexcept(std::is_nothrow_constructible_v<T, U>);

Parameters

Name	Description
v	The object to move construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class G = E>
requires std::is_constructible_v<E, G>
constexpr
explicit(!std::is_convertible_v<G, E>)
Expected(Unexpected<G>&& u) noexcept(std::is_nothrow_constructible_v<E, G>);

Parameters

Name	Description
u	The object to move construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class... Args>
requires std::is_constructible_v<T, Args...>
constexpr
explicit
Expected(
    std::in_place_t,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<T, Args...>);

Parameters

Name	Description
args	Arguments forwarded to the value constructor.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class... Args>
requires std::is_constructible_v<E, Args...>
constexpr
explicit
Expected(
    unexpect_t,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<E, Args...>);

Parameters

Name	Description
args	Arguments forwarded to the error constructor.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<
    class U,
    class... Args>
requires std::is_constructible_v<T, std::initializer_list<U>&, Args...>
constexpr
explicit
Expected(
    std::in_place_t,
    std::initializer_list<U> il,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<T, std::initializer_list<U> &, Args...>);

Parameters

Name	Description
il	Initializer list forwarded to the value constructor.
args	Additional arguments forwarded to the value constructor.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<
    class U,
    class... Args>
requires std::is_constructible_v<E, std::initializer_list<U>&, Args...>
constexpr
explicit
Expected(
    unexpect_t,
    std::initializer_list<U> il,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<E, std::initializer_list<U> &, Args...>);

Parameters

Name	Description
il	Initializer list forwarded to the error constructor.
args	Additional arguments forwarded to the error constructor.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Defaulted trivial destructor when both alternatives are trivial.

constexpr
~Expected() = default;

» more...

Destroy the active alternative when a non-trivial destructor is required.

constexpr
~Expected()
requires (!std::is_trivially_destructible_v<T>)
        || (!std::is_trivially_destructible_v<E>);

» more...

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
~Expected() = default;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
~Expected()
requires (!std::is_trivially_destructible_v<T>)
        || (!std::is_trivially_destructible_v<E>);

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Copy-assign from another Expected.

Expected&
operator=(Expected const& other) = delete;

» more...

Assign from another Expected with compatible value/error types.

constexpr
Expected&
operator=(Expected const& x) noexcept(std::is_nothrow_copy_constructible_v<T> && std::is_nothrow_copy_constructible_v<E> && std::is_nothrow_copy_assignable_v<T> && std::is_nothrow_copy_assignable_v<E>)
requires std::is_copy_assignable_v<T> &&
        std::is_copy_constructible_v<T> &&
        std::is_copy_assignable_v<E> &&
        std::is_copy_constructible_v<E> &&
        (std::is_nothrow_move_constructible_v<T> ||
         std::is_nothrow_move_constructible_v<E>);

» more...

Move-assign from another Expected with compatible value/error types.

constexpr
Expected&
operator=(Expected&& x) noexcept(std::is_nothrow_move_constructible_v<T> && std::is_nothrow_move_constructible_v<E> && std::is_nothrow_move_assignable_v<T> && std::is_nothrow_move_assignable_v<E>)
requires std::is_move_assignable_v<T> &&
        std::is_move_constructible_v<T> &&
        std::is_move_assignable_v<E> &&
        std::is_move_constructible_v<E> &&
        (std::is_nothrow_move_constructible_v<T> ||
         std::is_nothrow_move_constructible_v<E>);

» more...

Assign a new unexpected error from lvalue.

template<class G>
requires std::is_constructible_v<E, G const&> &&
        std::is_assignable_v<E&, G const&> &&
        (std::is_nothrow_constructible_v<E, G const&> ||
         std::is_nothrow_move_constructible_v<T> ||
         std::is_nothrow_move_constructible_v<E>)
constexpr
Expected&
operator=(Unexpected<G> const& e);

» more...

Assign a new value, reconstructing if currently disengaged.

template<class U = T>
requires (!std::is_same_v<Expected, std::remove_cvref_t<U>>) &&
        (!detail::isUnexpected<std::remove_cvref_t<U>>) &&
        std::is_constructible_v<T, U> &&
        std::is_assignable_v<T&, U> &&
        (std::is_nothrow_constructible_v<T, U> ||
         std::is_nothrow_move_constructible_v<T> ||
         std::is_nothrow_move_constructible_v<E>)
constexpr
Expected&
operator=(U&& v);

» more...

Assign a new unexpected error from rvalue.

template<class G>
requires std::is_constructible_v<E, G> &&
        std::is_assignable_v<E&, G> &&
        (std::is_nothrow_constructible_v<E, G> ||
         std::is_nothrow_move_constructible_v<T> ||
         std::is_nothrow_move_constructible_v<E>)
constexpr
Expected&
operator=(Unexpected<G>&& e);

» more...

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

Expected&
operator=(Expected const& other) = delete;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Expected&
operator=(Expected const& x) noexcept(std::is_nothrow_copy_constructible_v<T> && std::is_nothrow_copy_constructible_v<E> && std::is_nothrow_copy_assignable_v<T> && std::is_nothrow_copy_assignable_v<E>)
requires std::is_copy_assignable_v<T> &&
        std::is_copy_constructible_v<T> &&
        std::is_copy_assignable_v<E> &&
        std::is_copy_constructible_v<E> &&
        (std::is_nothrow_move_constructible_v<T> ||
         std::is_nothrow_move_constructible_v<E>);

Return Value

Reference to the current object

Parameters

Name	Description
x	The object to copy assign from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Expected&
operator=(Expected&& x) noexcept(std::is_nothrow_move_constructible_v<T> && std::is_nothrow_move_constructible_v<E> && std::is_nothrow_move_assignable_v<T> && std::is_nothrow_move_assignable_v<E>)
requires std::is_move_assignable_v<T> &&
        std::is_move_constructible_v<T> &&
        std::is_move_assignable_v<E> &&
        std::is_move_constructible_v<E> &&
        (std::is_nothrow_move_constructible_v<T> ||
         std::is_nothrow_move_constructible_v<E>);

Return Value

Reference to the current object

Parameters

Name	Description
x	The object to move assign from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class G>
requires std::is_constructible_v<E, G const&> &&
        std::is_assignable_v<E&, G const&> &&
        (std::is_nothrow_constructible_v<E, G const&> ||
         std::is_nothrow_move_constructible_v<T> ||
         std::is_nothrow_move_constructible_v<E>)
constexpr
Expected&
operator=(Unexpected<G> const& e);

Return Value

Reference to the current object

Parameters

Name	Description
e	The object to copy assign from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U = T>
requires (!std::is_same_v<Expected, std::remove_cvref_t<U>>) &&
        (!detail::isUnexpected<std::remove_cvref_t<U>>) &&
        std::is_constructible_v<T, U> &&
        std::is_assignable_v<T&, U> &&
        (std::is_nothrow_constructible_v<T, U> ||
         std::is_nothrow_move_constructible_v<T> ||
         std::is_nothrow_move_constructible_v<E>)
constexpr
Expected&
operator=(U&& v);

Return Value

Reference to the current object

Parameters

Name	Description
v	The object to move assign from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class G>
requires std::is_constructible_v<E, G> &&
        std::is_assignable_v<E&, G> &&
        (std::is_nothrow_constructible_v<E, G> ||
         std::is_nothrow_move_constructible_v<T> ||
         std::is_nothrow_move_constructible_v<E>)
constexpr
Expected&
operator=(Unexpected<G>&& e);

Return Value

Reference to the current object

Parameters

Name	Description
e	The object to move assign from

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Invoke f when engaged, propagate error otherwise.

template<class Fn>
requires std::is_constructible_v<E, E&>
constexpr
auto
and_then(Fn&& f) &;

» more...

Invoke f when engaged (const lvalue), propagate error otherwise.

template<class Fn>
requires std::is_constructible_v<E, E const&>
constexpr
auto
and_then(Fn&& f) const &;

» more...

Invoke f when engaged (rvalue), propagate error otherwise.

template<class Fn>
requires std::is_constructible_v<E, E>
constexpr
auto
and_then(Fn&& f) &&;

» more...

Invoke f when engaged (const rvalue), propagate error otherwise.

template<class Fn>
requires std::is_constructible_v<E, const E>
constexpr
auto
and_then(Fn&& f) const &&;

» more...

Return Value

Result of f or this error.

Parameters

Name	Description
f	Continuation that returns another Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<E, E&>
constexpr
auto
and_then(Fn&& f) &;

Return Value

Result of f or this error.

Parameters

Name	Description
f	Continuation that returns another Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<E, E const&>
constexpr
auto
and_then(Fn&& f) const &;

Return Value

Result of f or this error.

Parameters

Name	Description
f	Continuation that returns another Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<E, E>
constexpr
auto
and_then(Fn&& f) &&;

Return Value

Result of f or this error.

Parameters

Name	Description
f	Continuation that returns another Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<E, const E>
constexpr
auto
and_then(Fn&& f) const &&;

Return Value

Result of f or this error.

Parameters

Name	Description
f	Continuation that returns another Expected.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Reconstruct the value in-place, discarding any current state.

template<class... Args>
requires std::is_nothrow_constructible_v<T, Args...>
constexpr
T&
emplace(Args&&... args) noexcept;

» more...

Reconstruct the value from an initializer list.

template<
    class U,
    class... Args>
requires std::is_nothrow_constructible_v<
            T, std::initializer_list<U>&, Args...>
constexpr
T&
emplace(
    std::initializer_list<U> il,
    Args&&... args) noexcept;

» more...

Return Value

Reference to the newly emplaced value.

Parameters

Name	Description
args	Arguments forwarded to the value constructor.
il	Initializer list forwarded to the value constructor.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class... Args>
requires std::is_nothrow_constructible_v<T, Args...>
constexpr
T&
emplace(Args&&... args) noexcept;

Return Value

Reference to the newly emplaced value.

Parameters

Name	Description
args	Arguments forwarded to the value constructor.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<
    class U,
    class... Args>
requires std::is_nothrow_constructible_v<
            T, std::initializer_list<U>&, Args...>
constexpr
T&
emplace(
    std::initializer_list<U> il,
    Args&&... args) noexcept;

Return Value

Reference to the newly emplaced value.

Parameters

Name	Description
il	Initializer list forwarded to the value constructor.
args	Additional constructor arguments.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Access the stored error; precondition: !has_value().

constexpr
E const&
error() const & noexcept;

» more...

Access the stored error; precondition: !has_value().

constexpr
E&
error() & noexcept;

» more...

Access the stored error; precondition: !has_value().

constexpr
E const&&
error() const && noexcept;

» more...

Access the stored error; precondition: !has_value().

constexpr
E&&
error() && noexcept;

» more...

Return Value

Reference to the contained error.
Rvalue reference to the contained error.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
E const&
error() const & noexcept;

Return Value

Reference to the contained error.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
E&
error() & noexcept;

Return Value

Reference to the contained error.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
E const&&
error() const && noexcept;

Return Value

Rvalue reference to the contained error.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
E&&
error() && noexcept;

Return Value

Rvalue reference to the contained error.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Return the contained error or a fallback copy.

template<class G = E>
constexpr
E
error_or(G&& e) const &;

» more...

Return the contained error or a fallback move.

template<class G = E>
constexpr
E
error_or(G&& e) &&;

» more...

Return Value

Contained error or the fallback converted to E.

Parameters

Name	Description
e	Fallback error to use when engaged.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class G = E>
constexpr
E
error_or(G&& e) const &;

Return Value

Contained error or the fallback converted to E.

Parameters

Name	Description
e	Fallback error to use when engaged.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class G = E>
constexpr
E
error_or(G&& e) &&;

Return Value

Contained error or the fallback converted to E.

Parameters

Name	Description
e	Fallback error to use when engaged.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
constexpr
bool
has_value() const noexcept;

Return Value

true when the Expected contains a value.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Dereference to a const lvalue value reference.

[[nodiscard]]
constexpr
T const&
operator*() const & noexcept;

» more...

Dereference to an lvalue value reference.

[[nodiscard]]
constexpr
T&
operator*() & noexcept;

» more...

Dereference to a const rvalue value reference.

[[nodiscard]]
constexpr
T const&&
operator*() const && noexcept;

» more...

Dereference to an rvalue value reference.

[[nodiscard]]
constexpr
T&&
operator*() && noexcept;

Access value members through pointer syntax.

[[nodiscard]]
constexpr
T const*
operator->() const noexcept;

» more...

Access value members through pointer syntax.

[[nodiscard]]
constexpr
T*
operator->() noexcept;

Invoke f when in error, otherwise return current value.

template<class Fn>
requires std::is_constructible_v<T, T&>
constexpr
auto
or_else(Fn&& f) &;

» more...

Invoke f when in error (const lvalue).

template<class Fn>
requires std::is_constructible_v<T, T const&>
constexpr
auto
or_else(Fn&& f) const &;

» more...

Invoke f when in error (rvalue).

template<class Fn>
requires std::is_constructible_v<T, T>
constexpr
auto
or_else(Fn&& f) &&;

» more...

Invoke f when in error (const rvalue).

template<class Fn>
requires std::is_constructible_v<T, const T>
constexpr
auto
or_else(Fn&& f) const &&;

» more...

Return Value

Current value or result of f.

Parameters

Name	Description
f	Recovery function returning an Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<T, T&>
constexpr
auto
or_else(Fn&& f) &;

Return Value

Current value or result of f.

Parameters

Name	Description
f	Recovery function returning an Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<T, T const&>
constexpr
auto
or_else(Fn&& f) const &;

Return Value

Current value or result of f.

Parameters

Name	Description
f	Recovery function returning an Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<T, T>
constexpr
auto
or_else(Fn&& f) &&;

Return Value

Current value or result of f.

Parameters

Name	Description
f	Recovery function returning an Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<T, const T>
constexpr
auto
or_else(Fn&& f) const &&;

Return Value

Current value or result of f.

Parameters

Name	Description
f	Recovery function returning an Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
void
swap(Expected& x) noexcept(std::is_nothrow_move_constructible_v<T> && std::is_nothrow_move_constructible_v<E> && std::is_nothrow_swappable_v<T &> && std::is_nothrow_swappable_v<E &>)
requires std::is_swappable_v<T> &&
        std::is_swappable_v<E> &&
        std::is_move_constructible_v<T> &&
        std::is_move_constructible_v<E> &&
        (std::is_nothrow_move_constructible_v<T> ||
         std::is_nothrow_move_constructible_v<E>);

Parameters

Name	Description
x	A container holding an error or a value.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Map the contained value, propagate error.

template<class Fn>
requires std::is_constructible_v<E, E&>
constexpr
auto
transform(Fn&& f) &;

» more...

Map the contained value (const overload), propagate error.

template<class Fn>
requires std::is_constructible_v<E, E const&>
constexpr
auto
transform(Fn&& f) const &;

» more...

Map the contained value (rvalue), propagate error.

template<class Fn>
requires std::is_constructible_v<E, E>
constexpr
auto
transform(Fn&& f) &&;

» more...

Map the contained value (const rvalue), propagate error.

template<class Fn>
requires std::is_constructible_v<E, const E>
constexpr
auto
transform(Fn&& f) const &&;

» more...

Return Value

Expected holding the mapped value or the original error.

Parameters

Name	Description
f	Mapping function applied to the value.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<E, E&>
constexpr
auto
transform(Fn&& f) &;

Return Value

Expected holding the mapped value or the original error.

Parameters

Name	Description
f	Mapping function applied to the value.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<E, E const&>
constexpr
auto
transform(Fn&& f) const &;

Return Value

Expected holding the mapped value or the original error.

Parameters

Name	Description
f	Mapping function applied to the value.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<E, E>
constexpr
auto
transform(Fn&& f) &&;

Return Value

Expected holding the mapped value or the original error.

Parameters

Name	Description
f	Mapping function applied to the value.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<E, const E>
constexpr
auto
transform(Fn&& f) const &&;

Return Value

Expected holding the mapped value or the original error.

Parameters

Name	Description
f	Mapping function applied to the value.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Map the contained error, preserve value.

template<class Fn>
requires std::is_constructible_v<T, T&>
constexpr
auto
transform_error(Fn&& f) &;

» more...

Map the contained error (const lvalue), preserve value.

template<class Fn>
requires std::is_constructible_v<T, T const&>
constexpr
auto
transform_error(Fn&& f) const &;

» more...

Map the contained error (rvalue), preserve value.

template<class Fn>
requires std::is_constructible_v<T, T>
constexpr
auto
transform_error(Fn&& f) &&;

» more...

Map the contained error (const rvalue), preserve value.

template<class Fn>
requires std::is_constructible_v<T, const T>
constexpr
auto
transform_error(Fn&& f) const &&;

» more...

Return Value

Expected holding the original value or mapped error.

Parameters

Name	Description
f	Mapping function applied to the error.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<T, T&>
constexpr
auto
transform_error(Fn&& f) &;

Return Value

Expected holding the original value or mapped error.

Parameters

Name	Description
f	Mapping function applied to the error.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<T, T const&>
constexpr
auto
transform_error(Fn&& f) const &;

Return Value

Expected holding the original value or mapped error.

Parameters

Name	Description
f	Mapping function applied to the error.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<T, T>
constexpr
auto
transform_error(Fn&& f) &&;

Return Value

Expected holding the original value or mapped error.

Parameters

Name	Description
f	Mapping function applied to the error.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<T, const T>
constexpr
auto
transform_error(Fn&& f) const &&;

Return Value

Expected holding the original value or mapped error.

Parameters

Name	Description
f	Mapping function applied to the error.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Access the stored value or throw BadExpectedAccess.

constexpr
T const&
value() const &;

» more...

Access the stored value or throw BadExpectedAccess.

constexpr
T&
value() &;

» more...

Access the stored value or throw BadExpectedAccess (rvalue overload).

constexpr
T const&&
value() const &&;

» more...

Access the stored value or throw BadExpectedAccess (rvalue overload).

constexpr
T&&
value() &&;

» more...

Return Value

Reference to the contained value.
Rvalue reference to the contained value.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
T const&
value() const &;

Return Value

Reference to the contained value.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
T&
value() &;

Return Value

Reference to the contained value.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
T const&&
value() const &&;

Return Value

Rvalue reference to the contained value.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
T&&
value() &&;

Return Value

Rvalue reference to the contained value.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Return the contained value or a fallback copy.

template<class U>
constexpr
T
value_or(U&& v) const & noexcept(std::is_nothrow_copy_constructible_v<T> && std::is_nothrow_convertible_v<U, T>);

» more...

Return the contained value or a fallback move.

template<class U>
constexpr
T
value_or(U&& v) && noexcept(std::is_nothrow_move_constructible_v<T> && std::is_nothrow_convertible_v<U, T>);

» more...

Return Value

Contained value or the fallback converted to T.

Parameters

Name	Description
v	Fallback value to use when disengaged.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
constexpr
T
value_or(U&& v) const & noexcept(std::is_nothrow_copy_constructible_v<T> && std::is_nothrow_convertible_v<U, T>);

Return Value

Contained value or the fallback converted to T.

Parameters

Name	Description
v	Fallback value to use when disengaged.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
constexpr
T
value_or(U&& v) && noexcept(std::is_nothrow_move_constructible_v<T> && std::is_nothrow_convertible_v<U, T>);

Return Value

Contained value or the fallback converted to T.

Parameters

Name	Description
v	Fallback value to use when disengaged.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
constexpr
explicit
operator bool() const noexcept;

Return Value

true when the Expected contains a value.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

E unex_;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

T val_;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<
    class T,
    class E>
requires std::is_void_v<T>
class Expected<T, E>;

Type Aliases

Name	Description
`error_type`	Error type stored when disengaged.
`rebind`	Rebind to another value type with the same error type.
`unexpected_type`	Alias for the unexpected wrapper.
`value_type`	Value type for this specialization (always void).

Member Functions

Name	Description
`Expected` [constructor]	Constructors
`~Expected` [destructor]	Destructors
`operator=` [deleted]	Assignment operators
`and_then`	`and_then` overloads
`emplace`	Reset to engaged state (no error).
`error`	`error` overloads
`error_or`	`error_or` overloads
`has_value`	Return true when the Expected holds a value.
`operator*`	Ensure the Expected is engaged; throws if it holds an error.
`or_else`	`or_else` overloads
`swap`	Swap states with another void Expected.
`transform`	`transform` overloads
`transform_error`	`transform_error` overloads
`value`	`value` overloads
`operator bool`	Return true when the Expected holds a value.

Data Members

Name	Description
`unex_` [variant member]	Stored unexpected error.
`void_` [variant member]	Placeholder for the engaged state.

Friends

Name	Description
`mrdocs::swap`	Swap contents with another Expected.
`mrdocs::operator==`	Equality operator
`mrdocs::operator==`	Equality operator
`mrdocs::Expected`	A container holding an error or a value.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

using error_type = E;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
using rebind = Expected<U, error_type>;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

using unexpected_type = Unexpected<E>;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

using value_type = T;

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Construct an engaged Expected<void>.

constexpr
Expected() noexcept;

» more...

Default copy constructor.

Expected(Expected const& other) = default;

» more...

Copy-construct with explicit error handling for non-trivial E.

constexpr
Expected(Expected const& x) noexcept(std::is_nothrow_copy_constructible_v<E>)
requires std::is_copy_constructible_v<E> &&
        (!std::is_trivially_copy_constructible_v<E>);

» more...

Default move constructor.

Expected(Expected&& other) = default;

» more...

Move-construct with explicit error handling for non-trivial E.

constexpr
Expected(Expected&& x) noexcept(std::is_nothrow_move_constructible_v<E>)
requires std::is_move_constructible_v<E> &&
        (!std::is_trivially_move_constructible_v<E>);

» more...

Construct an engaged Expected with in-place tag.

constexpr
explicit
Expected(std::in_place_t value) noexcept;

» more...

Construct a disengaged Expected from an unexpected error (copy).

template<class G = E>
requires std::is_constructible_v<E, G const&>
constexpr
explicit(!std::is_convertible_v<const G &, E>)
Expected(Unexpected<G> const& u) noexcept(std::is_nothrow_constructible_v<E, const G &>);

» more...

Construct a disengaged Expected from an unexpected error (move).

template<class G = E>
requires std::is_constructible_v<E, G>
constexpr
explicit(!std::is_convertible_v<G, E>)
Expected(Unexpected<G>&& u) noexcept(std::is_nothrow_constructible_v<E, G>);

» more...

Copy-construct from a compatible Expected carrying void.

template<
    class U,
    class G>
requires std::is_void_v<U> &&
        std::is_constructible_v<E, G const&> &&
        (!constructible_from_expected<U, G>)
constexpr
explicit(!std::is_convertible_v<const G &, E>)
Expected(Expected<U, G> const& x) noexcept(std::is_nothrow_constructible_v<E, const G &>);

» more...

Move-construct from a compatible Expected carrying void.

template<
    class U,
    class G>
requires std::is_void_v<U> &&
        std::is_constructible_v<E, G> &&
        (!constructible_from_expected<U, G>)
constexpr
explicit(!std::is_convertible_v<G, E>)
Expected(Expected<U, G>&& x) noexcept(std::is_nothrow_constructible_v<E, G>);

» more...

Construct a disengaged Expected from error arguments.

template<class... Args>
requires std::is_constructible_v<E, Args...>
constexpr
explicit
Expected(
    unexpect_t,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<E, Args...>);

» more...

Construct a disengaged Expected from an initializer list of errors.

template<
    class U,
    class... Args>
requires std::is_constructible_v<E, std::initializer_list<U>&, Args...>
constexpr
explicit
Expected(
    unexpect_t,
    std::initializer_list<U> il,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<E, std::initializer_list<U> &, Args...>);

» more...

Parameters

Name	Description
args	Arguments forwarded to the error constructor.
il	Initializer list forwarded to the error constructor.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Expected() noexcept;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

Expected(Expected const& other) = default;

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Expected(Expected const& x) noexcept(std::is_nothrow_copy_constructible_v<E>)
requires std::is_copy_constructible_v<E> &&
        (!std::is_trivially_copy_constructible_v<E>);

Parameters

Name	Description
x	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

Expected(Expected&& other) = default;

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Expected(Expected&& x) noexcept(std::is_nothrow_move_constructible_v<E>)
requires std::is_move_constructible_v<E> &&
        (!std::is_trivially_move_constructible_v<E>);

Parameters

Name	Description
x	The object to move construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
explicit
Expected(std::in_place_t value) noexcept;

Parameters

Name	Description
value	The object to construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class G = E>
requires std::is_constructible_v<E, G const&>
constexpr
explicit(!std::is_convertible_v<const G &, E>)
Expected(Unexpected<G> const& u) noexcept(std::is_nothrow_constructible_v<E, const G &>);

Parameters

Name	Description
u	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class G = E>
requires std::is_constructible_v<E, G>
constexpr
explicit(!std::is_convertible_v<G, E>)
Expected(Unexpected<G>&& u) noexcept(std::is_nothrow_constructible_v<E, G>);

Parameters

Name	Description
u	The object to move construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<
    class U,
    class G>
requires std::is_void_v<U> &&
        std::is_constructible_v<E, G const&> &&
        (!constructible_from_expected<U, G>)
constexpr
explicit(!std::is_convertible_v<const G &, E>)
Expected(Expected<U, G> const& x) noexcept(std::is_nothrow_constructible_v<E, const G &>);

Parameters

Name	Description
x	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<
    class U,
    class G>
requires std::is_void_v<U> &&
        std::is_constructible_v<E, G> &&
        (!constructible_from_expected<U, G>)
constexpr
explicit(!std::is_convertible_v<G, E>)
Expected(Expected<U, G>&& x) noexcept(std::is_nothrow_constructible_v<E, G>);

Parameters

Name	Description
x	The object to move construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class... Args>
requires std::is_constructible_v<E, Args...>
constexpr
explicit
Expected(
    unexpect_t,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<E, Args...>);

Parameters

Name	Description
args	Arguments forwarded to the error constructor.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<
    class U,
    class... Args>
requires std::is_constructible_v<E, std::initializer_list<U>&, Args...>
constexpr
explicit
Expected(
    unexpect_t,
    std::initializer_list<U> il,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<E, std::initializer_list<U> &, Args...>);

Parameters

Name	Description
il	Initializer list forwarded to the error constructor.
args	Additional arguments forwarded to the error constructor.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Defaulted trivial destructor.

constexpr
~Expected() = default;

» more...

Destroy the stored error when non-trivial.

constexpr
~Expected()
requires (!std::is_trivially_destructible_v<E>);

» more...

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
~Expected() = default;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
~Expected()
requires (!std::is_trivially_destructible_v<E>);

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Copy assignment disabled to keep semantics explicit.

Expected&
operator=(Expected const& other) = delete;

» more...

Copy-assign from another void Expected.

constexpr
Expected&
operator=(Expected const& x) noexcept(std::is_nothrow_copy_constructible_v<E> && std::is_nothrow_copy_assignable_v<E>)
requires std::is_copy_constructible_v<E> &&
        std::is_copy_assignable_v<E>;

» more...

Move-assign from another void Expected.

constexpr
Expected&
operator=(Expected&& x) noexcept(std::is_nothrow_move_constructible_v<E> && std::is_nothrow_move_assignable_v<E>)
requires std::is_move_constructible_v<E> &&
        std::is_move_assignable_v<E>;

» more...

Assign a new unexpected error (lvalue).

template<class G>
requires std::is_constructible_v<E, G const&> &&
        std::is_assignable_v<E&, G const&>
constexpr
Expected&
operator=(Unexpected<G> const& e);

» more...

Assign a new unexpected error (rvalue).

template<class G>
requires std::is_constructible_v<E, G> &&
        std::is_assignable_v<E&, G>
constexpr
Expected&
operator=(Unexpected<G>&& e);

» more...

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

Expected&
operator=(Expected const& other) = delete;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Expected&
operator=(Expected const& x) noexcept(std::is_nothrow_copy_constructible_v<E> && std::is_nothrow_copy_assignable_v<E>)
requires std::is_copy_constructible_v<E> &&
        std::is_copy_assignable_v<E>;

Return Value

Reference to the current object

Parameters

Name	Description
x	The object to copy assign from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Expected&
operator=(Expected&& x) noexcept(std::is_nothrow_move_constructible_v<E> && std::is_nothrow_move_assignable_v<E>)
requires std::is_move_constructible_v<E> &&
        std::is_move_assignable_v<E>;

Return Value

Reference to the current object

Parameters

Name	Description
x	The object to move assign from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class G>
requires std::is_constructible_v<E, G const&> &&
        std::is_assignable_v<E&, G const&>
constexpr
Expected&
operator=(Unexpected<G> const& e);

Return Value

Reference to the current object

Parameters

Name	Description
e	The object to copy assign from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class G>
requires std::is_constructible_v<E, G> &&
        std::is_assignable_v<E&, G>
constexpr
Expected&
operator=(Unexpected<G>&& e);

Return Value

Reference to the current object

Parameters

Name	Description
e	The object to move assign from

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Invoke f when engaged, propagate error otherwise.

template<class Fn>
requires std::is_constructible_v<E, E&>
constexpr
auto
and_then(Fn&& f) &;

» more...

Invoke f when engaged (const lvalue), propagate error otherwise.

template<class Fn>
requires std::is_constructible_v<E, E const&>
constexpr
auto
and_then(Fn&& f) const &;

» more...

Invoke f when engaged (rvalue), propagate error otherwise.

template<class Fn>
requires std::is_constructible_v<E, E>
constexpr
auto
and_then(Fn&& f) &&;

» more...

Invoke f when engaged (const rvalue), propagate error otherwise.

template<class Fn>
requires std::is_constructible_v<E, const E>
constexpr
auto
and_then(Fn&& f) const &&;

» more...

Return Value

Result of f or this error.

Parameters

Name	Description
f	Continuation returning another Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<E, E&>
constexpr
auto
and_then(Fn&& f) &;

Return Value

Result of f or this error.

Parameters

Name	Description
f	Continuation returning another Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<E, E const&>
constexpr
auto
and_then(Fn&& f) const &;

Return Value

Result of f or this error.

Parameters

Name	Description
f	Continuation returning another Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<E, E>
constexpr
auto
and_then(Fn&& f) &&;

Return Value

Result of f or this error.

Parameters

Name	Description
f	Continuation returning another Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<E, const E>
constexpr
auto
and_then(Fn&& f) const &&;

Return Value

Result of f or this error.

Parameters

Name	Description
f	Continuation returning another Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
void
emplace() noexcept;

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Return a const reference to the contained error; precondition: disengaged.

constexpr
E const&
error() const & noexcept;

» more...

Return a reference to the contained error; precondition: disengaged.

constexpr
E&
error() & noexcept;

» more...

Return an rvalue reference to the contained error; precondition: disengaged.

constexpr
E const&&
error() const && noexcept;

» more...

Return an rvalue reference to the contained error; precondition: disengaged.

constexpr
E&&
error() && noexcept;

» more...

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
E const&
error() const & noexcept;

Return Value

a const reference to the contained error; precondition: disengaged.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
E&
error() & noexcept;

Return Value

a reference to the contained error; precondition: disengaged.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
E const&&
error() const && noexcept;

Return Value

an rvalue reference to the contained error; precondition: disengaged.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
E&&
error() && noexcept;

Return Value

an rvalue reference to the contained error; precondition: disengaged.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Return the error or a fallback copy.

template<class G = E>
constexpr
E
error_or(G&& e) const &;

» more...

Return the error or a fallback move.

template<class G = E>
constexpr
E
error_or(G&& e) &&;

» more...

Return Value

Contained error or the fallback converted to E.

Parameters

Name	Description
e	Fallback to return if engaged.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class G = E>
constexpr
E
error_or(G&& e) const &;

Return Value

Contained error or the fallback converted to E.

Parameters

Name	Description
e	Fallback to return if engaged.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class G = E>
constexpr
E
error_or(G&& e) &&;

Return Value

Contained error or the fallback converted to E.

Parameters

Name	Description
e	Fallback to return if engaged.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
constexpr
bool
has_value() const noexcept;

Return Value

true when the Expected holds a value.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
void
operator*() const noexcept;

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Invoke f when in error, otherwise return current value.

template<class Fn>
constexpr
auto
or_else(Fn&& f) &;

» more...

Invoke f when in error (const lvalue), otherwise return current value.

template<class Fn>
constexpr
auto
or_else(Fn&& f) const &;

» more...

Invoke f when in error (rvalue), otherwise return current value.

template<class Fn>
constexpr
auto
or_else(Fn&& f) &&;

» more...

Invoke f when in error (const rvalue), otherwise return current value.

template<class Fn>
constexpr
auto
or_else(Fn&& f) const &&;

» more...

Return Value

Current value or result of f.

Parameters

Name	Description
f	Recovery function returning an Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
or_else(Fn&& f) &;

Return Value

Current value or result of f.

Parameters

Name	Description
f	Recovery function returning an Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
or_else(Fn&& f) const &;

Return Value

Current value or result of f.

Parameters

Name	Description
f	Recovery function returning an Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
or_else(Fn&& f) &&;

Return Value

Current value or result of f.

Parameters

Name	Description
f	Recovery function returning an Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
or_else(Fn&& f) const &&;

Return Value

Current value or result of f.

Parameters

Name	Description
f	Recovery function returning an Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
void
swap(Expected& x) noexcept(std::is_nothrow_swappable_v<E &> && std::is_nothrow_move_constructible_v<E>)
requires std::is_swappable_v<E> &&
        std::is_move_constructible_v<E>;

Parameters

Name	Description
x	Other instance to exchange with.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Transform the contained error type when engaged (lvalue).

template<class Fn>
requires std::is_constructible_v<E, E&>
constexpr
auto
transform(Fn&& f) &;

» more...

Transform the contained error type when engaged (const lvalue).

template<class Fn>
requires std::is_constructible_v<E, E const&>
constexpr
auto
transform(Fn&& f) const &;

» more...

Transform the contained error type when engaged (rvalue).

template<class Fn>
requires std::is_constructible_v<E, E>
constexpr
auto
transform(Fn&& f) &&;

» more...

Transform the contained error type when engaged (const rvalue).

template<class Fn>
requires std::is_constructible_v<E, const E>
constexpr
auto
transform(Fn&& f) const &&;

» more...

Return Value

New Expected produced from f or the existing error.

Parameters

Name	Description
f	Transformation to apply.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<E, E&>
constexpr
auto
transform(Fn&& f) &;

Return Value

New Expected produced from f or the existing error.

Parameters

Name	Description
f	Transformation to apply.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<E, E const&>
constexpr
auto
transform(Fn&& f) const &;

Return Value

New Expected produced from f or the existing error.

Parameters

Name	Description
f	Transformation to apply.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<E, E>
constexpr
auto
transform(Fn&& f) &&;

Return Value

New Expected produced from f or the existing error.

Parameters

Name	Description
f	Transformation to apply.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
requires std::is_constructible_v<E, const E>
constexpr
auto
transform(Fn&& f) const &&;

Return Value

New Expected produced from f or the existing error.

Parameters

Name	Description
f	Transformation to apply.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Transform the stored error value when disengaged.

template<class Fn>
constexpr
auto
transform_error(Fn&& f) &;

» more...

Transform the stored error value when disengaged (const lvalue).

template<class Fn>
constexpr
auto
transform_error(Fn&& f) const &;

» more...

Transform the stored error value when disengaged (rvalue).

template<class Fn>
constexpr
auto
transform_error(Fn&& f) &&;

» more...

Transform the stored error value when disengaged (const rvalue).

template<class Fn>
constexpr
auto
transform_error(Fn&& f) const &&;

» more...

Return Value

Expected containing the transformed error or the current value.

Parameters

Name	Description
f	Transformation to apply.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
transform_error(Fn&& f) &;

Return Value

Expected containing the transformed error or the current value.

Parameters

Name	Description
f	Transformation to apply.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
transform_error(Fn&& f) const &;

Return Value

Expected containing the transformed error or the current value.

Parameters

Name	Description
f	Transformation to apply.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
transform_error(Fn&& f) &&;

Return Value

Expected containing the transformed error or the current value.

Parameters

Name	Description
f	Transformation to apply.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
transform_error(Fn&& f) const &&;

Return Value

Expected containing the transformed error or the current value.

Parameters

Name	Description
f	Transformation to apply.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Ensure the Expected is engaged; throws BadExpectedAccess if not.

constexpr
void
value() const &;

» more...

Ensure the Expected is engaged; throws BadExpectedAccess if not (rvalue overload).

constexpr
void
value() &&;

» more...

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
void
value() const &;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
void
value() &&;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
constexpr
explicit
operator bool() const noexcept;

Return Value

true when the Expected holds a value.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

E unex_;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

engaged_state void_;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<
    class T,
    class E>
class Expected<T&, E>;

Type Aliases

Name	Description
`error_type`	Error type carried when disengaged.
`rebind`	Rebind the reference to another value type while keeping `E`.
`unexpected_type`	Convenience alias for the unexpected wrapper.
`value_type`	Referenced value type.

Member Functions

Name	Description
`Expected` [constructor]	Constructors
`~Expected` [destructor]	Destroy the held error when disengaged.
`operator=`	Assignment operators
`and_then`	`and_then` overloads
`emplace`	`emplace` overloads
`error`	`error` overloads
`error_or`	`error_or` overloads
`has_value`	Check whether the Expected currently contains a reference.
`operator*`	Dereference operators
`operator->`	Access the bound reference pointer; undefined if disengaged.
`or_else`	`or_else` overloads
`swap`	Swap state with another reference Expected.
`transform`	`transform` overloads
`transform_error`	`transform_error` overloads
`value`	`value` overloads
`value_or`	`value_or` overloads
`operator bool`	Return true when a reference is bound.

Data Members

Name	Description
`p_` [variant member]	Pointer to the referenced value when engaged.
`unex_` [variant member]	Stored unexpected error when disengaged.

Friends

Name	Description
`mrdocs::operator==`	Equality operator
`mrdocs::operator==`	Equality operator
`mrdocs::operator==`	Equality operator
`mrdocs::swap`

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

using error_type = E;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
using rebind = Expected<U, error_type>;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

using unexpected_type = Unexpected<E>;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

using value_type = T&;

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Construct a disengaged Expected with no bound reference.

constexpr
Expected() noexcept;

» more...

Copy-construct from another reference Expected.

constexpr
Expected(Expected const& other) = default;

» more...

Move-construct from another reference Expected.

constexpr
Expected(Expected&& other) = default;

» more...

Bind to an lvalue result, marking the expected engaged.

template<class U>
requires (!std::is_same_v<std::remove_cvref_t<U>, Expected>
             && !std::is_same_v<std::remove_cvref_t<U>, std::in_place_t>
             && !detail::isUnexpected<std::remove_cvref_t<U>> && ok_bind_v<U&>)
constexpr
explicit(!std::is_convertible_v<U &, R>)
Expected(U& u) noexcept(std::is_nothrow_constructible_v<R, U &>);

» more...

Bind to the result stored inside another Expected value.

template<class U>
requires detail::ok_bind_ref_v<R, U&>
constexpr
explicit(!std::is_convertible_v<U &, R>)
Expected(Expected<U, E>& other) noexcept(std::is_nothrow_constructible_v<R, U &> && std::is_nothrow_copy_constructible_v<E>);

» more...

Copy-construct from another reference Expected.

template<class U>
requires detail::ok_bind_ref_v<R, U&>
constexpr
explicit(!std::is_convertible_v<U &, R>)
Expected(Expected<U&, E> const& other) noexcept(std::is_nothrow_constructible_v<R, U &> && std::is_nothrow_copy_constructible_v<E>);

» more...

Construct from an unexpected error (copy).

template<class G = E>
requires std::is_constructible_v<E, G const&>
constexpr
explicit(!std::is_convertible_v<const G &, E>)
Expected(Unexpected<G> const& u) noexcept(std::is_nothrow_constructible_v<E, const G &>);

» more...

Deleted: binding a reference Expected from a temporary would dangle.

template<class U>
requires (!std::is_same_v<std::remove_cvref_t<U>, Expected>
             && !std::is_same_v<std::remove_cvref_t<U>, std::in_place_t>
             && !detail::isUnexpected<std::remove_cvref_t<U>>
             && !ok_bind_v<U &&>)
constexpr
Expected(U&& u) = delete;

» more...

Deleted: rebinding from a temporary Expected<U, E> would dangle.

template<class U>
constexpr
Expected(Expected<U, E>&& value) = delete;

» more...

Move-construct from another reference Expected.

template<class U>
requires detail::ok_bind_ref_v<R, U&>
constexpr
explicit(!std::is_convertible_v<U &, R>)
Expected(Expected<U&, E>&& other) noexcept(std::is_nothrow_constructible_v<R, U &> && std::is_nothrow_move_constructible_v<E>);

» more...

Construct from an unexpected error (move).

template<class G = E>
requires std::is_constructible_v<E, G>
constexpr
explicit(!std::is_convertible_v<G, E>)
Expected(Unexpected<G>&& u) noexcept(std::is_nothrow_constructible_v<E, G>);

» more...

Invoke a factory to obtain the bound reference in-place.

template<class Fn>
constexpr
explicit
Expected(
    /* implementation-defined */ tag,
    Fn&& fn);

» more...

Bind in-place to an existing lvalue.

template<class U>
requires ok_bind_v<U&>
constexpr
explicit
Expected(
    std::in_place_t tag,
    U& u) noexcept;

» more...

Construct an unexpected state by invoking a factory.

template<class Fn>
constexpr
explicit
Expected(
    /* implementation-defined */ tag,
    Fn&& fn);

» more...

Construct a disengaged Expected from error arguments.

template<class... Args>
requires std::is_constructible_v<E, Args...>
constexpr
explicit
Expected(
    unexpect_t tag,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<E, Args...>);

» more...

Construct a disengaged Expected from an initializer list.

template<
    class U,
    class... Args>
requires std::is_constructible_v<E, std::initializer_list<U>&, Args...>
constexpr
explicit
Expected(
    unexpect_t tag,
    std::initializer_list<U> il,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<E, std::initializer_list<U> &, Args...>);

» more...

Parameters

Name	Description
other	Source instance providing the lvalue.
u	Unexpected wrapper to copy.
fn	Callable that returns a bindable lvalue.
tag	Tag selecting in-place construction.
args	Arguments forwarded to the error constructor.
il	Initializer list forwarded to the error constructor.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Expected() noexcept;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Expected(Expected const& other) = default;

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Expected(Expected&& other) = default;

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
requires (!std::is_same_v<std::remove_cvref_t<U>, Expected>
             && !std::is_same_v<std::remove_cvref_t<U>, std::in_place_t>
             && !detail::isUnexpected<std::remove_cvref_t<U>> && ok_bind_v<U&>)
constexpr
explicit(!std::is_convertible_v<U &, R>)
Expected(U& u) noexcept(std::is_nothrow_constructible_v<R, U &>);

Parameters

Name	Description
u	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
requires detail::ok_bind_ref_v<R, U&>
constexpr
explicit(!std::is_convertible_v<U &, R>)
Expected(Expected<U, E>& other) noexcept(std::is_nothrow_constructible_v<R, U &> && std::is_nothrow_copy_constructible_v<E>);

Parameters

Name	Description
other	Source instance providing the lvalue.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
requires detail::ok_bind_ref_v<R, U&>
constexpr
explicit(!std::is_convertible_v<U &, R>)
Expected(Expected<U&, E> const& other) noexcept(std::is_nothrow_constructible_v<R, U &> && std::is_nothrow_copy_constructible_v<E>);

Parameters

Name	Description
other	Source instance to bind to.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class G = E>
requires std::is_constructible_v<E, G const&>
constexpr
explicit(!std::is_convertible_v<const G &, E>)
Expected(Unexpected<G> const& u) noexcept(std::is_nothrow_constructible_v<E, const G &>);

Parameters

Name	Description
u	Unexpected wrapper to copy.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
requires (!std::is_same_v<std::remove_cvref_t<U>, Expected>
             && !std::is_same_v<std::remove_cvref_t<U>, std::in_place_t>
             && !detail::isUnexpected<std::remove_cvref_t<U>>
             && !ok_bind_v<U &&>)
constexpr
Expected(U&& u) = delete;

Parameters

Name	Description
u	Temporary value (deleted).

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
constexpr
Expected(Expected<U, E>&& value) = delete;

Parameters

Name	Description
value	The object to move construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
requires detail::ok_bind_ref_v<R, U&>
constexpr
explicit(!std::is_convertible_v<U &, R>)
Expected(Expected<U&, E>&& other) noexcept(std::is_nothrow_constructible_v<R, U &> && std::is_nothrow_move_constructible_v<E>);

Parameters

Name	Description
other	Source instance to bind to.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class G = E>
requires std::is_constructible_v<E, G>
constexpr
explicit(!std::is_convertible_v<G, E>)
Expected(Unexpected<G>&& u) noexcept(std::is_nothrow_constructible_v<E, G>);

Parameters

Name	Description
u	Unexpected wrapper to move from.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
explicit
Expected(
    /* implementation-defined */ tag,
    Fn&& fn);

Parameters

Name	Description
fn	Callable that returns a bindable lvalue.
tag	The object to construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
requires ok_bind_v<U&>
constexpr
explicit
Expected(
    std::in_place_t tag,
    U& u) noexcept;

Parameters

Name	Description
tag	Tag selecting in-place construction.
u	Lvalue to bind this Expected to.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
explicit
Expected(
    /* implementation-defined */ tag,
    Fn&& fn);

Parameters

Name	Description
fn	Callable that produces an error value.
tag	The object to construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class... Args>
requires std::is_constructible_v<E, Args...>
constexpr
explicit
Expected(
    unexpect_t tag,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<E, Args...>);

Parameters

Name	Description
tag	Tag selecting unexpected construction.
args	Arguments forwarded to the error constructor.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<
    class U,
    class... Args>
requires std::is_constructible_v<E, std::initializer_list<U>&, Args...>
constexpr
explicit
Expected(
    unexpect_t tag,
    std::initializer_list<U> il,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<E, std::initializer_list<U> &, Args...>);

Parameters

Name	Description
tag	Tag selecting unexpected construction.
il	Initializer list forwarded to the error constructor.
args	Additional arguments forwarded to the error constructor.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
~Expected();

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Copy-assign, rebinding or copying the error.

constexpr
Expected&
operator=(Expected const& other) = default;

» more...

Move-assign, rebinding or moving the error.

constexpr
Expected&
operator=(Expected&& other) = default;

» more...

Assign a new binding from an lvalue.

template<class U>
requires ok_bind_v<U&>
constexpr
Expected&
operator=(U& u) noexcept(std::is_nothrow_constructible_v<R, U &>);

» more...

Bind to the value contained in another Expected instance.

template<class U>
requires detail::ok_bind_ref_v<R, U&>
constexpr
Expected&
operator=(Expected<U, E>& other);

» more...

Assign from another reference Expected (copy).

template<class U>
requires detail::ok_bind_ref_v<R, U&>
constexpr
Expected&
operator=(Expected<U&, E> const& other);

» more...

Replace the stored state with an unexpected error (copy).

template<class G>
requires std::is_constructible_v<E, G const&>
             && std::is_assignable_v<E&, G const&>
constexpr
Expected&
operator=(Unexpected<G> const& e);

» more...

Deleted: rebinding from a temporary would dangle.

template<class U>
requires (!ok_bind_v<U &&>)
constexpr
Expected&
operator=(U&& u) = delete;

» more...

Deleted: cannot bind to a temporary Expected holding a value.

template<class U>
constexpr
Expected&
operator=(Expected<U, E>&& value) = delete;

» more...

Assign from another reference Expected (move).

template<class U>
requires detail::ok_bind_ref_v<R, U&>
constexpr
Expected&
operator=(Expected<U&, E>&& other);

» more...

Replace the stored state with an unexpected error (move).

template<class G>
requires std::is_constructible_v<E, G> && std::is_assignable_v<E&, G>
constexpr
Expected&
operator=(Unexpected<G>&& e);

» more...

Parameters

Name	Description
other	Source lvalue Expected to bind to.
e	Unexpected wrapper to copy from.
u	Temporary value (deleted).

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Expected&
operator=(Expected const& other) = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Expected&
operator=(Expected&& other) = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to move assign from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
requires ok_bind_v<U&>
constexpr
Expected&
operator=(U& u) noexcept(std::is_nothrow_constructible_v<R, U &>);

Return Value

Reference to the current object

Parameters

Name	Description
u	The object to copy assign from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
requires detail::ok_bind_ref_v<R, U&>
constexpr
Expected&
operator=(Expected<U, E>& other);

Return Value

Reference to the current object

Parameters

Name	Description
other	Source lvalue Expected to bind to.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
requires detail::ok_bind_ref_v<R, U&>
constexpr
Expected&
operator=(Expected<U&, E> const& other);

Return Value

Reference to the current object

Parameters

Name	Description
other	Source instance to bind to or copy error from.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class G>
requires std::is_constructible_v<E, G const&>
             && std::is_assignable_v<E&, G const&>
constexpr
Expected&
operator=(Unexpected<G> const& e);

Return Value

Reference to the current object

Parameters

Name	Description
e	Unexpected wrapper to copy from.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
requires (!ok_bind_v<U &&>)
constexpr
Expected&
operator=(U&& u) = delete;

Return Value

Reference to the current object

Parameters

Name	Description
u	Temporary value (deleted).

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
constexpr
Expected&
operator=(Expected<U, E>&& value) = delete;

Return Value

Reference to the current object

Parameters

Name	Description
value	The object to move assign from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
requires detail::ok_bind_ref_v<R, U&>
constexpr
Expected&
operator=(Expected<U&, E>&& other);

Return Value

Reference to the current object

Parameters

Name	Description
other	Source instance to bind to or move error from.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class G>
requires std::is_constructible_v<E, G> && std::is_assignable_v<E&, G>
constexpr
Expected&
operator=(Unexpected<G>&& e);

Return Value

Reference to the current object

Parameters

Name	Description
e	Unexpected wrapper to move from.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Invoke f with the bound reference when engaged.

template<class Fn>
constexpr
auto
and_then(Fn&& f) &;

» more...

Invoke f with the bound reference when engaged (const lvalue).

template<class Fn>
constexpr
auto
and_then(Fn&& f) const &;

» more...

Invoke f with the bound reference when engaged (rvalue).

template<class Fn>
constexpr
auto
and_then(Fn&& f) &&;

» more...

Invoke f with the bound reference when engaged (const rvalue).

template<class Fn>
constexpr
auto
and_then(Fn&& f) const &&;

» more...

Return Value

Result of f or current error.

Parameters

Name	Description
f	Continuation producing another Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
and_then(Fn&& f) &;

Return Value

Result of f or current error.

Parameters

Name	Description
f	Continuation producing another Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
and_then(Fn&& f) const &;

Return Value

Result of f or current error.

Parameters

Name	Description
f	Continuation producing another Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
and_then(Fn&& f) &&;

Return Value

Result of f or current error.

Parameters

Name	Description
f	Continuation producing another Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
and_then(Fn&& f) const &&;

Return Value

Result of f or current error.

Parameters

Name	Description
f	Continuation producing another Expected.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Rebind to a new lvalue, returning the stored reference.

template<class U>
requires ok_bind_v<U&>
constexpr
T&
emplace(U& u) noexcept;

» more...

Deleted: cannot bind reference Expected to a temporary.

template<class U>
requires (!ok_bind_v<U &&>)
constexpr
T&
emplace(U&& u) = delete;

» more...

Return Value

Bound reference.

Parameters

Name	Description
u	Reference to bind to.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
requires ok_bind_v<U&>
constexpr
T&
emplace(U& u) noexcept;

Return Value

Bound reference.

Parameters

Name	Description
u	Reference to bind to.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
requires (!ok_bind_v<U &&>)
constexpr
T&
emplace(U&& u) = delete;

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Access the stored error; requires disengaged state.

[[nodiscard]]
constexpr
E&
error() & noexcept;

» more...

Access the stored error (const lvalue).

[[nodiscard]]
constexpr
E const&
error() const & noexcept;

» more...

Access the stored error (rvalue).

[[nodiscard]]
constexpr
E&&
error() && noexcept;

» more...

Access the stored error (const rvalue).

[[nodiscard]]
constexpr
E const&&
error() const && noexcept;

» more...

Return Value

Reference to the stored error.
Rvalue reference to the stored error.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
constexpr
E&
error() & noexcept;

Return Value

Reference to the stored error.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
constexpr
E const&
error() const & noexcept;

Return Value

Reference to the stored error.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
constexpr
E&&
error() && noexcept;

Return Value

Rvalue reference to the stored error.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
constexpr
E const&&
error() const && noexcept;

Return Value

Rvalue reference to the stored error.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Return the stored error or the provided fallback (copy).

template<class G = E>
constexpr
E
error_or(G&& g) const &;

» more...

Return the stored error or the provided fallback (move).

template<class G = E>
constexpr
E
error_or(G&& g) &&;

» more...

Return Value

Error value.

Parameters

Name	Description
g	Fallback error to return when engaged.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class G = E>
constexpr
E
error_or(G&& g) const &;

Return Value

Error value.

Parameters

Name	Description
g	Fallback error to return when engaged.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class G = E>
constexpr
E
error_or(G&& g) &&;

Return Value

Error value.

Parameters

Name	Description
g	Fallback error to move when engaged.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
constexpr
bool
has_value() const noexcept;

Return Value

true if a reference is bound.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Dereference the bound reference.

[[nodiscard]]
constexpr
T&
operator*() & noexcept;

» more...

Dereference the bound reference (const).

[[nodiscard]]
constexpr
T const&
operator*() const & noexcept;

» more...

Dereference the bound reference, preserving value category.

[[nodiscard]]
constexpr
T&&
operator*() && noexcept;

» more...

Dereference the bound reference, preserving value category (const rvalue).

[[nodiscard]]
constexpr
T const&&
operator*() const && noexcept;

Access the bound reference pointer; undefined if disengaged.

[[nodiscard]]
constexpr
T*
operator->() noexcept;

» more...

Access the bound reference pointer; undefined if disengaged.

[[nodiscard]]
constexpr
T const*
operator->() const noexcept;

Recover with f if disengaged, otherwise return this value.

template<class Fn>
constexpr
Expected
or_else(Fn&& f) &;

» more...

Recover with f if disengaged (const lvalue).

template<class Fn>
constexpr
Expected
or_else(Fn&& f) const &;

» more...

Recover with f if disengaged (rvalue).

template<class Fn>
constexpr
Expected
or_else(Fn&& f) &&;

» more...

Recover with f if disengaged (const rvalue).

template<class Fn>
constexpr
Expected
or_else(Fn&& f) const &&;

» more...

Parameters

Name	Description
f	Recovery function returning an Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
Expected
or_else(Fn&& f) &;

Return Value

Expected specialization for lvalue references. Holds either a bound reference to T or an unexpected error E.

Parameters

Name	Description
f	Recovery function returning an Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
Expected
or_else(Fn&& f) const &;

Return Value

Expected specialization for lvalue references. Holds either a bound reference to T or an unexpected error E.

Parameters

Name	Description
f	Recovery function returning an Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
Expected
or_else(Fn&& f) &&;

Return Value

Expected specialization for lvalue references. Holds either a bound reference to T or an unexpected error E.

Parameters

Name	Description
f	Recovery function returning an Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
Expected
or_else(Fn&& f) const &&;

Return Value

Expected specialization for lvalue references. Holds either a bound reference to T or an unexpected error E.

Parameters

Name	Description
f	Recovery function returning an Expected.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
void
swap(Expected& x) noexcept(std::is_nothrow_move_constructible_v<E> && std::is_nothrow_swappable_v<E &>)
requires std::is_swappable_v<E>;

Parameters

Name	Description
x	Other instance to exchange with.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Transform the bound value when engaged.

template<class Fn>
constexpr
auto
transform(Fn&& f) &;

» more...

Transform the bound value when engaged (const lvalue).

template<class Fn>
constexpr
auto
transform(Fn&& f) const &;

» more...

Transform the bound value when engaged (rvalue).

template<class Fn>
constexpr
auto
transform(Fn&& f) &&;

» more...

Transform the bound value when engaged (const rvalue).

template<class Fn>
constexpr
auto
transform(Fn&& f) const &&;

» more...

Return Value

Expected containing transformed value or current error.

Parameters

Name	Description
f	Transformation applied to the bound reference.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
transform(Fn&& f) &;

Return Value

Expected containing transformed value or current error.

Parameters

Name	Description
f	Transformation applied to the bound reference.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
transform(Fn&& f) const &;

Return Value

Expected containing transformed value or current error.

Parameters

Name	Description
f	Transformation applied to the bound reference.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
transform(Fn&& f) &&;

Return Value

Expected containing transformed value or current error.

Parameters

Name	Description
f	Transformation applied to the bound reference.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
transform(Fn&& f) const &&;

Return Value

Expected containing transformed value or current error.

Parameters

Name	Description
f	Transformation applied to the bound reference.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Transform the stored error when disengaged.

template<class Fn>
constexpr
auto
transform_error(Fn&& f) &;

» more...

Transform the stored error when disengaged (const lvalue).

template<class Fn>
constexpr
auto
transform_error(Fn&& f) const &;

» more...

Transform the stored error when disengaged (rvalue).

template<class Fn>
constexpr
auto
transform_error(Fn&& f) &&;

» more...

Transform the stored error when disengaged (const rvalue).

template<class Fn>
constexpr
auto
transform_error(Fn&& f) const &&;

» more...

Return Value

Expected with transformed error or current value.

Parameters

Name	Description
f	Transformation applied to the error.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
transform_error(Fn&& f) &;

Return Value

Expected with transformed error or current value.

Parameters

Name	Description
f	Transformation applied to the error.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
transform_error(Fn&& f) const &;

Return Value

Expected with transformed error or current value.

Parameters

Name	Description
f	Transformation applied to the error.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
transform_error(Fn&& f) &&;

Return Value

Expected with transformed error or current value.

Parameters

Name	Description
f	Transformation applied to the error.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Fn>
constexpr
auto
transform_error(Fn&& f) const &&;

Return Value

Expected with transformed error or current value.

Parameters

Name	Description
f	Transformation applied to the error.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Return the bound reference or throw on disengaged state.

constexpr
T&
value() &;

» more...

Return the bound reference or throw on disengaged state (const lvalue).

constexpr
T const&
value() const &;

» more...

Return the bound reference or throw on disengaged state (rvalue).

constexpr
T&&
value() &&;

» more...

Return the bound reference or throw on disengaged state (const rvalue).

constexpr
T const&&
value() const &&;

» more...

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
T&
value() &;

Return Value

the bound reference or throw on disengaged state.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
T const&
value() const &;

Return Value

the bound reference or throw on disengaged state (const lvalue).

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
T&&
value() &&;

Return Value

the bound reference or throw on disengaged state (rvalue).

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
T const&&
value() const &&;

Return Value

the bound reference or throw on disengaged state (const rvalue).

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Return the bound value or a fallback copy when disengaged.

template<class U>
constexpr
std::remove_reference_t<T>
value_or(U&& u) const &;

» more...

Return the bound value or a fallback move when disengaged.

template<class U>
constexpr
std::remove_reference_t<T>
value_or(U&& u) &&;

» more...

Return Value

Bound value or fallback copy.
Bound value or fallback.

Parameters

Name	Description
u	Fallback value to return if no reference is bound.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
constexpr
std::remove_reference_t<T>
value_or(U&& u) const &;

Return Value

Bound value or fallback copy.

Parameters

Name	Description
u	Fallback value to return if no reference is bound.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class U>
constexpr
std::remove_reference_t<T>
value_or(U&& u) &&;

Return Value

Bound value or fallback.

Parameters

Name	Description
u	Fallback value to move if no reference is bound.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
constexpr
explicit
operator bool() const noexcept;

Return Value

true when a reference is bound.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

T* p_;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

E unex_;

Synopsis

Declared in <mrdocs/Metadata/Specifiers/ExplicitInfo.hpp>

struct ExplicitInfo;

Member Functions

Name	Description
`operator<=>`	Compare explicit-specifier info.

Data Members

Name	Description
`Implicit`	Whether an explicit-specifier was user-written.
`Kind`	The evaluated exception specification.
`Operand`	The operand of the explicit-specifier, if any.

Non-Member Functions

Name	Description
`toString`	Convert ExplicitInfo to a string.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/ExplicitInfo.hpp>

constexpr
auto
operator<=>(ExplicitInfo const& rhs) const = default;

Return Value

The relative order of the objects

Parameters

Name	Description
rhs	The right operand

Synopsis

Declared in <mrdocs/Metadata/Specifiers/ExplicitInfo.hpp>

bool Implicit = true;

Synopsis

Declared in <mrdocs/Metadata/Specifiers/ExplicitInfo.hpp>

ExplicitKind Kind = ExplicitKind::False;

Synopsis

Declared in <mrdocs/Metadata/Specifiers/ExplicitInfo.hpp>

std::string Operand;

Synopsis

Declared in <mrdocs/Metadata/Expression.hpp>

struct ExprInfo;

Member Functions

Name	Description
`asExpr`	View this object as its base expression.
`operator<=>`	Order expressions by written form.

Data Members

Name	Description
`Written`	The expression, as written

Non-Member Functions

Name	Description
`merge`	Merge metadata from another expression.

Derived Classes

Name	Description
`ConstantExprInfo`	Represents an expression with a (possibly known) value

Synopses

Declared in <mrdocs/Metadata/Expression.hpp>

View this object as its base expression.

ExprInfo&
asExpr() noexcept;

» more...

View this object as its base expression.

ExprInfo const&
asExpr() const noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/Expression.hpp>

ExprInfo&
asExpr() noexcept;

Return Value

Represents an expression

Synopsis

Declared in <mrdocs/Metadata/Expression.hpp>

ExprInfo const&
asExpr() const noexcept;

Return Value

Represents an expression

Synopsis

Declared in <mrdocs/Metadata/Expression.hpp>

constexpr
auto
operator<=>(ExprInfo const& rhs) const = default;

Return Value

The relative order of the objects

Parameters

Name	Description
rhs	The right operand

Synopsis

Declared in <mrdocs/Metadata/Expression.hpp>

std::string Written;

Synopsis

Declared in <mrdocs/Support/Error.hpp>

template<class... Args>
struct FormatString;

Member Functions

Name	Description
`FormatString` [constructor]	Capture a format string and its originating location.

Data Members

Name	Description
`fs`	Format string view.
`loc`	Originating source location for diagnostics.

Non-Member Functions

Name	Description
`formatError`	Return a formatted error.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

template<class T>
FormatString(
    T const& fs_,
    std::source_location loc_ = source_location::current());

Parameters

Name	Description
fs_	The format string to copy.
loc_	Source location where formatting is requested.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

std::string_view fs;

Synopsis

Declared in <mrdocs/Support/Error.hpp>

std::source_location loc;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Friend.hpp>

struct FriendInfo final

Description

Friendship is not transitive
Friendship is not inherited
Access specifiers do not affect the meaning of friend declarations

The friends of a record are stored directly in the record's metadata.

If the friend declaration is documented, the documentation is stored in the befriended symbol's metadata rather than in the relationship.

Data Members

Name	Description
`Type`	Befriended type.
`id`	Befriended symbol.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Friend.hpp>

Optional<Polymorphic<Type>> Type = std::nullopt;

Description

This member is nullable and only used when befriending a type.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Friend.hpp>

SymbolID id = = SymbolID::invalid;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

struct FunctionSymbol final
    : SymbolCommonBase<SymbolKind::Function>

Base Classes

Name	Description
`SymbolCommonBase<SymbolKind::Function>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`FunctionSymbol` [constructor]	Construct a function symbol with its ID.
`operator<=>`	Compare functions by signature, qualifiers, and metadata.

Static Member Functions

Name
`isConcept`
`isEnum`
`isEnumConstant`
`isFunction`
`isGuide`
`isNamespace`
`isNamespaceAlias`
`isOverloads`
`isRecord`
`isTypedef`
`isUsing`
`isVariable`

Data Members

Name	Description
`Attributes`	Collected attributes attached to the declaration.
`Constexpr`	constexpr/consteval specifier.
`Explicit`	explicit-specifier information.
`FuncClass`	The class of function this is
`FunctionObjectImpl`	Back-reference to the function object implementation type.
`HasOverrideAttr`	True when annotated with override.
`HasTrailingReturn`	True when using a trailing return type.
`IsConst`	True when qualified const.
`IsDefaulted`	True when this declaration is implicitly defaulted.
`IsDeleted`	True when this declaration is deleted.
`IsDeletedAsWritten`	True when deleted as written (vs deduced).
`IsExplicitObjectMemberFunction`	True when explicit object parameter syntax is used.
`IsExplicitlyDefaulted`	True when explicitly defaulted with `= default`.
`IsFinal`	True when final-qualified.
`IsNoReturn`	True when marked [[noreturn]]or equivalent.
`IsNodiscard`	True when declared [[nodiscard]].
`IsPure`	True when the function is pure virtual.
`IsRecordMethod`	True when this is a non-static member function.
`IsVariadic`	True when the function is variadic.
`IsVirtual`	True when declared virtual (after overrides).
`IsVirtualAsWritten`	True when explicitly written virtual.
`IsVolatile`	True when qualified volatile.
`Noexcept`	Exception specification for the function.
`OverloadedOperator`	Overloaded operator kind, if any.
`Params`	List of parameters.
`RefQualifier`	Reference qualifier on the member function, if any.
`Requires`	Constrained requires-clause if present.
`ReturnType`	Info about the return type of this function.
`StorageClass`	Storage class specifier.
`Template`	When present, this function is a template or specialization.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`canMerge`	Check whether two symbols may be merged.
`getPrimaryLocation`	Determine a location to use when none is explicitly chosen.
`isCopyAssignment`	Check whether a function is a copy assignment operator.
`isCopyConstructor`	Check whether a function is a copy constructor.
`isDefaultConstructor`	Check whether a function is a default constructor.
`isMoveAssignment`	Check whether a function is a move assignment operator.
`isMoveConstructor`	Check whether a function is a move constructor.
`isSpecialMemberFunction`	Check whether a function is a special member function.
`overrides`	Determine if one function would override the other

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

explicit
FunctionSymbol(SymbolID const& ID) noexcept;

Parameters

Name	Description
ID	The object to copy construct from

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

std::strong_ordering
operator<=>(FunctionSymbol const& other) const;

Return Value

The relative order of the objects

Parameters

Name	Description
other	The right operand

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isConcept() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnum() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnumConstant() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isGuide() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespace() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespaceAlias() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isOverloads() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isRecord() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isTypedef() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isUsing() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isVariable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

std::vector<std::string> Attributes;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

ConstexprKind Constexpr = ConstexprKind::None;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

ExplicitInfo Explicit;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

FunctionClass FuncClass = FunctionClass::Normal;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

Optional<SymbolID> FunctionObjectImpl;

Description

When set, this function was synthesized from a function object variable: the function does not participate in ADL and taking its address is undefined behavior.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool HasOverrideAttr = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool HasTrailingReturn = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool IsConst = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool IsDefaulted = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool IsDeleted = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool IsDeletedAsWritten = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool IsExplicitObjectMemberFunction = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool IsExplicitlyDefaulted = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool IsFinal = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool IsNoReturn = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool IsNodiscard = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool IsPure = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool IsRecordMethod = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool IsVariadic = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool IsVirtual = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool IsVirtualAsWritten = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool IsVolatile = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

NoexceptInfo Noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

OperatorKind OverloadedOperator = OperatorKind::None;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

std::vector<Param> Params;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

ReferenceKind RefQualifier = ReferenceKind::None;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

ExprInfo Requires;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

Polymorphic<Type> ReturnType = Polymorphic<Type>(AutoType{});

Description

If the function has a deduced return type, this contains auto to indicate that.

By default, we also use auto in the member to indicate an unknown return type.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

StorageClassKind StorageClass = StorageClassKind::None;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

Optional<TemplateInfo> Template;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr static
SymbolKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/Type/FunctionType.hpp>

struct FunctionType final
    : TypeCommonBase<TypeKind::Function>

Base Classes

Name	Description
`TypeCommonBase<TypeKind::Function>`	CRTP base that ties a concrete type to a fixed TypeKind.

Static Member Functions

Name
`isArray`
`isAuto`
`isDecltype`
`isFunction`
`isLValueReference`
`isMemberPointer`
`isNamed`
`isPointer`
`isRValueReference`

Data Members

Name	Description
`ExceptionSpec`	Exception specification information.
`IsVariadic`	True when this function type is variadic.
`ParamTypes`	Parameter types in declaration order.
`RefQualifier`	Reference qualifier (if present).
`ReturnType`	Return type, defaults to `auto` when unknown.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`innerType`	Return the inner type.
`innerType`	Return the inner type.
`innerTypePtr`	Return the inner type.
`innerTypePtr`	Return the inner type.
`toString`	Render a type to a human-readable string.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isArray() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isAuto() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isDecltype() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isLValueReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isMemberPointer() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isNamed() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isPointer() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isRValueReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/FunctionType.hpp>

NoexceptInfo ExceptionSpec;

Synopsis

Declared in <mrdocs/Metadata/Type/FunctionType.hpp>

bool IsVariadic = false;

Synopsis

Declared in <mrdocs/Metadata/Type/FunctionType.hpp>

std::vector<Polymorphic<Type>> ParamTypes;

Synopsis

Declared in <mrdocs/Metadata/Type/FunctionType.hpp>

ReferenceKind RefQualifier = ReferenceKind::None;

Synopsis

Declared in <mrdocs/Metadata/Type/FunctionType.hpp>

Polymorphic<Type> ReturnType = Polymorphic<Type>(AutoType{});

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr static
TypeKind kind_id;

Synopsis

Declared in <mrdocs/Generator.hpp>

class Generator;

Member Functions

Name	Description
`~Generator` [destructor] [virtual]	Destructor.
`build`	Build reference documentation for the corpus.
`buildOne`	`buildOne` overloads
`buildOneString`	Build the reference as a single page to a string.
`displayName` [virtual]	Return the display name of the generator.
`fileExtension` [virtual]	Return the extension or tag of the generator.
`id` [virtual]	Return the symbolic name of the generator.

Non-Member Functions

Name	Description
`findGenerator`	Find a generator by its id.

Synopsis

Declared in <mrdocs/Generator.hpp>

virtual
~Generator() noexcept;

Synopses

Declared in <mrdocs/Generator.hpp>

Build reference documentation for the corpus.

Expected<void>
build(Corpus const& corpus) const;

» more...

Build reference documentation for the corpus.

virtual
Expected<void>
build(
    std::string_view outputPath,
    Corpus const& corpus) const;

» more...

Return Value

The error, if any occurred.

Parameters

Name	Description
corpus	The symbols to emit. The generator may modify the contents of the object before returning.
outputPath	A directory or filename.

Synopsis

Declared in <mrdocs/Generator.hpp>

Expected<void>
build(Corpus const& corpus) const;

Description

This function invokes the generator to emit the documentation using the corpus configuration options to determine the output location.

Return Value

The error, if any occurred.

Parameters

Name	Description
corpus	The symbols to emit. The generator may modify the contents of the object before returning.

Synopsis

Declared in <mrdocs/Generator.hpp>

virtual
Expected<void>
build(
    std::string_view outputPath,
    Corpus const& corpus) const;

Description

This function invokes the generator to emit the documentation using outputPath as a parameter indicating where the output should go. This can be a directory or a filename depending on the generator and how it is configured.

The default implentation assumes the output is single-page and emits the file reference.ext using buildOne to generate the content.

The typical implementation will have behavior similar to the default implementation if the output is single-page, or will iterate over the symbols in the corpus to generate multiple files if the output is multi-page.

Return Value

The error, if any occurred.

Parameters

Name	Description
outputPath	A directory or filename.
corpus	The symbols to emit. The generator may modify the contents of the object before returning.

Synopses

Declared in <mrdocs/Generator.hpp>

Build the reference as a single page to a file.

Expected<void>
buildOne(
    std::string_view fileName,
    Corpus const& corpus) const;

» more...

Build reference documentation for the corpus.

virtual
Expected<void>
buildOne(
    std::ostream& os,
    Corpus const& corpus) const = 0;

» more...

Return Value

The error, if any occurred.

Parameters

Name	Description
fileName	The file to write. If the file already exists, it will be overwritten.
corpus	The metadata to emit.
os	The stream to write to.

Synopsis

Declared in <mrdocs/Generator.hpp>

Expected<void>
buildOne(
    std::string_view fileName,
    Corpus const& corpus) const;

Thread Safety

Different corpus object: may be called concurrently.
Same corpus object: may not be called concurrently.

Return Value

The error, if any occurred.

Parameters

Name	Description
fileName	The file to write. If the file already exists, it will be overwritten.
corpus	The metadata to emit.

Synopsis

Declared in <mrdocs/Generator.hpp>

virtual
Expected<void>
buildOne(
    std::ostream& os,
    Corpus const& corpus) const = 0;

Description

This function invokes the generator to emit the full documentation to an output stream, as a single entity.

Thread Safety

Different corpus object: may be called concurrently.
Same corpus object: may not be called concurrently.

Return Value

The error, if any occurred.

Parameters

Name	Description
os	The stream to write to.
corpus	The metadata to emit.

Synopsis

Declared in <mrdocs/Generator.hpp>

Expected<void>
buildOneString(
    std::string& dest,
    Corpus const& corpus) const;

Return Value

The error, if any occurred.

Parameters

Name	Description
dest	The string to hold the result. For the duration of the call, this must not be accessed by any other threads.
corpus	The metadata to emit.

Synopsis

Declared in <mrdocs/Generator.hpp>

virtual
std::string_view
displayName() const noexcept = 0;

Return Value

the display name of the generator.

Synopsis

Declared in <mrdocs/Generator.hpp>

virtual
std::string_view
fileExtension() const noexcept = 0;

Description

This should be in all lower case. Examples of tags are:

"adoc" Asciidoctor
"xml" XML
"html" HTML

The returned string should not include a leading period.

Return Value

the extension or tag of the generator.

Synopsis

Declared in <mrdocs/Generator.hpp>

virtual
std::string_view
id() const noexcept = 0;

Description

This is a short, unique string which identifies the generator in command line options and in configuration files.

Return Value

the symbolic name of the generator.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

class GlobPattern;

Description

"*" matches all characters except delimiters.
"**" matches all characters
"?" matches any single character.
"[<chars>]" matches one character in the bracket.
"[<char>-<char>]" matches one character in the bracket range.
"[]" or "[!<chars>]" matches one character not in the bracket.
"{<glob>,...}" matches one of the globs in the list.
"" escapes the next character so it is treated as a literal.

Nested brace expansions "{<glob>,"{<glob>,...}",...}" are not supported.

Member Functions

Name	Description
`GlobPattern` [constructor]	Constructors
`~GlobPattern` [destructor]	Destructor
`operator=`	Assignment operators
`isLiteral`	Checks if the glob pattern is a literal string.
`match`	Matches the given string against the glob pattern.
`matchPatternPrefix`	Matches the start of a given string against the glob pattern.
`pattern`	Returns the glob pattern.

Static Member Functions

Name	Description
`create`	`create` overloads

Synopses

Declared in <mrdocs/Support/Glob.hpp>

Construct an empty GlobPattern.

GlobPattern();

» more...

Copy constructor

GlobPattern(GlobPattern const& other);

» more...

Move constructor

GlobPattern(GlobPattern&& other) noexcept;

» more...

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

GlobPattern();

Description

An empty GlobPattern will never match any string.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

GlobPattern(GlobPattern const& other);

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

GlobPattern(GlobPattern&& other) noexcept;

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

~GlobPattern();

Synopses

Declared in <mrdocs/Support/Glob.hpp>

Copy assignment

GlobPattern&
operator=(GlobPattern const& other);

» more...

Move assignment

GlobPattern&
operator=(GlobPattern&& other) noexcept;

» more...

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

GlobPattern&
operator=(GlobPattern const& other);

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

GlobPattern&
operator=(GlobPattern&& other) noexcept;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to move assign from

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

bool
isLiteral() const;

Description

This function determines if the glob pattern does not contain any special characters. In other words, it matches a single string.

Return Value

true if the glob pattern is a literal string, false otherwise.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

bool
match(
    std::string_view str,
    char delimiter) const;

Return Value

true if the string matches the pattern, false otherwise.

Parameters

Name	Description
str	The string to match against the pattern.
delimiter	The character that `*` does not match.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

bool
matchPatternPrefix(
    std::string_view prefix,
    char delimiter) const;

Description

This function determines if the given string with the specified prefix can potentially match the glob pattern.

If the string matches the start of the pattern without failure, even if there are characters left in the string or the pattern, the function returns true.

Return Value

true if the string prefix matches the pattern, false otherwise.

Parameters

Name	Description
prefix	The string to match against the pattern.
delimiter	The character that `*` does not match.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

std::string_view
pattern() const;

Return Value

The glob pattern as a string view.

Synopses

Declared in <mrdocs/Support/Glob.hpp>

Create a glob pattern without limiting subpattern count.

static
Expected<GlobPattern>
create(std::string_view pattern);

» more...

Constructs a GlobPattern with the given pattern.

static
Expected<GlobPattern>
create(
    std::string_view pattern,
    Optional<std::size_t> maxSubGlobs);

» more...

Return Value

Compiled pattern or an error.
The constructed GlobPattern, or an error if the pattern is invalid.

Parameters

Name	Description
pattern	Glob expression to compile.
maxSubGlobs	The maximum number of subpatterns allowed. If the pattern contains more subpatterns than this value, an error is returned. If not specified, there is no limit.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

static
Expected<GlobPattern>
create(std::string_view pattern);

Return Value

Compiled pattern or an error.

Parameters

Name	Description
pattern	Glob expression to compile.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

static
Expected<GlobPattern>
create(
    std::string_view pattern,
    Optional<std::size_t> maxSubGlobs);

Return Value

The constructed GlobPattern, or an error if the pattern is invalid.

Parameters

Name	Description
pattern	The glob pattern to use for matching.
maxSubGlobs	The maximum number of subpatterns allowed. If the pattern contains more subpatterns than this value, an error is returned. If not specified, there is no limit.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Guide.hpp>

struct GuideSymbol final
    : SymbolCommonBase<SymbolKind::Guide>

Base Classes

Name	Description
`SymbolCommonBase<SymbolKind::Guide>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`GuideSymbol` [constructor]	Construct a deduction guide symbol with its ID.
`operator<=>`	Compare guides by params/deduced/template/explicit.

Static Member Functions

Name
`isConcept`
`isEnum`
`isEnumConstant`
`isFunction`
`isGuide`
`isNamespace`
`isNamespaceAlias`
`isOverloads`
`isRecord`
`isTypedef`
`isUsing`
`isVariable`

Data Members

Name	Description
`Deduced`	The pattern for the deduced specialization.
`Explicit`	The explicit-specifier, if any.
`Params`	The parameters of the deduction guide.
`Template`	Template head, if any.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`canMerge`	Check whether two symbols may be merged.
`getPrimaryLocation`	Determine a location to use when none is explicitly chosen.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Guide.hpp>

explicit
GuideSymbol(SymbolID ID) noexcept;

Parameters

Name	Description
ID	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/Symbol/Guide.hpp>

std::strong_ordering
operator<=>(GuideSymbol const& other) const;

Return Value

The relative order of the objects

Parameters

Name	Description
other	The right operand

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isConcept() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnum() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnumConstant() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isGuide() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespace() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespaceAlias() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isOverloads() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isRecord() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isTypedef() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isUsing() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isVariable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Guide.hpp>

Polymorphic<Type> Deduced = Polymorphic<Type>(AutoType{});

Description

This is always a SpecializationType.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Guide.hpp>

ExplicitInfo Explicit;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Guide.hpp>

std::vector<Param> Params;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Guide.hpp>

Optional<TemplateInfo> Template;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr static
SymbolKind kind_id;

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

class Handlebars;

Description

This class implements a handlebars template environment.

It is analogous to the complete state held by the handlebars.js module, including registered helpers and partials.

In the general case, handlebars.js provides a global Handlebars environment where helpers and partials are registered:


{.js}
      let template = Handlebars.compile("{{foo}}");
      let result = template({foo: "bar"});

but also provides a way to create a new isolated environment with its own helpers and partials:


{.js}
      let OtherHandlebars = Handlebars.create();
      let template = OtherHandlebars.compile("{{foo}}");
      let result = template({foo: "bar"});

In this implementation, however, there's no global environment. A new environment needs to be created explicitly be instantiating this class:


{.cpp}
      Handlebars env;
      dom::Object context;
      context["foo"] = "bar";
      std::string result = env.render("{{ foo }}", context);
      assert(result == "bar");

A handlebars template can be rendered using the context data provided as a dom::Value, which is usually a dom::Object at the first level when calling render.

In the most general case, the result can returned as a string or rendered directly to a buffer or stream. The render function provides an overload that allows the caller to provide an output stream where the template will be rendered directly without allocating a string:


{.cpp}
      Handlebars env;
      dom::Object context;
      context["foo"] = "bar";
      env.render_to(std::cout, "{{ foo }}", context);
      // prints "bar" to stdout


{.cpp}
      Handlebars env;
      dom::Object context;
      context["foo"] = "bar";
      std::string result;
      env.render_to(result, "{{ foo }}", context);
      assert(result == "bar");

Design considerations:

The following notes include some design considerations for the current implementation of this class. These are intended to describe the current state of the class rather than to provide the final specification of the class behavior.

Compiled templates:

Unlike handlebars.js, this implementation renders the template directly to the output stream, without requiring an intermediary object to store a representation of the compiled template (Handlebars.precompile) or an intermediary callable object required to ultimately render the template (Handlebars.precompile).

The rationale is that there is not much benefit in pre-compiling templates in C++, since both iterating the input string and a pre-compiled template would have very similar costs even in optimal implementations of the compiled template.

The most significant benefit of pre-compiling templates in C++ would be the faster identification of the ends of blocks, which would allow the engine iterate the block only once. For this reason, compiled templates will still be considered in a future version of this sub-library.

Also note that compiled templates cannot avoid exceptions, because a compiled template can still invoke a helper that throws exceptions and evaluate dynamic expressions that cannot be identified during the first pass.

Incremental rendering and compilation:

Although this is not supported by handlebars.js, it's common for C++ template engines to support incremental rendering, where the template is compiled or rendered in chunks as it is parsed. This implementation does not yet support this feature.

This is useful for streaming templates, where the template is rendered to a stream as it is parsed, without requiring the entire template to be parsed and compiled before rendering starts.

There are two types of incremental rendering and compilation supported by this implementation:

Incremental rendering of a partial template input to a stream
Incremental rendering into an output buffer of fixed size

In each of these cases, the template is rendered in chunks until the end of the partial template is reached or the output buffer is full.

In a scenario with compiled templates, the complexity of incremental rendering needs to be implemented for both compilation and rendering.

The main difficulty to implement incremental rendering for handlebars.js is that helpers can be invoked from anywhere in the template, and most content is actually rendered by helpers. This means that helpers would need to be able to interoperate with whatever mechanism is designed to support suspension in this recursive-coroutine-like interface.

Error propagation:

The main logic to render a template is implemented in the render function, does not throws by itself. How identifying the next tag in a template string, the algorithms uses a loose implementation where unclosed tags are rendered as-is instead of throwing errors.

However, helpers are allowed to throw exceptions to propagate errors, so the render function is not noexcept.

For this reason, exceptions thrown by helpers are in fact exceptional conditions that should be handled by the caller. In general, exceptions can be avoided completely by not throwing exceptions from helpers.

Types

Name	Description
`Tag`	Internal representation of a parsed Handlebars tag.

Member Functions

Name	Description
`Handlebars` [constructor]	Construct a handlebars environment
`registerHelper`	Register a helper accessible by any template in the environment.
`registerLogger`	Register a logger
`registerPartial`	Register a partial
`render`	Render a handlebars template
`render_to`	Render a handlebars template
`try_render`	Render a handlebars template
`try_render_to`	Render a handlebars template
`unregisterHelper`	Unregister a helper
`unregisterPartial`	Unregister a partial

Non-Member Functions

Name	Description
`helpers::registerAntoraHelpers`	Register all the Antora helpers into a Handlebars instance
`helpers::registerBuiltinHelpers`	Register all the built-in helpers into a Handlebars instance
`helpers::registerConstructorHelpers`	Register contructor helpers into a Handlebars instance
`helpers::registerContainerHelpers`	Register helpers to manipulate composite data types
`helpers::registerLogicalHelpers`	Register logical helpers into a Handlebars instance
`helpers::registerMathHelpers`	Register math helpers into a Handlebars instance
`helpers::registerStringHelpers`	Register string helpers into a Handlebars instance
`helpers::registerTypeHelpers`	Register type helpers into a Handlebars instance
`js::registerHelper`	Register a JavaScript helper function
`lua::registerHelper`	Register a Lua helper function

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

struct Tag;

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

Handlebars();

Description

This constructor creates a new handlebars environment with the built-in helpers and default logger.

Each environment has its own helpers and partials. Multiple environments are only necessary for use cases that demand distinct helpers or partials.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
registerHelper(
    std::string_view name,
    dom::Function const& helper);

Description

The helper type is a type erased function of type dom::Function, which receives the resolved template arguments as parameters as a dom::Value for each parameter.

The helper function also receives an object populated with variables that are accessible in the current context as its N+1-th parameter. This object contains information about the current context and is useful for helpers that want to change the current context or render internal blocks.

As all instances of dom::Function, the helper should also return a dom::Value. If the function semantics does not require a return value, the function should return a dom::Value of type dom::Kind::Undefined.

When the helper is used in an subexpression, the dom::Value return value is used as the intermediary result. When the helper is used in a block or a final expression, the dom::Value return value will be formatted to the output.

Parameters

Name	Description
name	The name of the helper in the handlebars template
helper	The helper function

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
registerLogger(dom::Function fn);

Description

This function registers a logger with the handlebars environment. A logger is a function that is called from the built-in "log" helper function.

The logger can also be called from any helper through the HandlebarsCallback parameter.

The logger function is called with a dom::Value indicating the current level and a dom::Array containing values to be logged.

Parameters

Name	Description
fn	The logger function

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
registerPartial(
    std::string_view name,
    std::string_view text);

Description

This function registers a partial with the handlebars environment.

A partial is a template that can be referenced from another template. The partial is rendered in the context of the template that references it.

For instance, a partial can be used to render a header or footer that is common to several pages. It can also be used to render a list of items that is used in several places.

The following example template uses the partial item to render a list of items:


{.handlebars}
        <ul>
        {{#each items}}
            {{> item}}
        {{/each}}
        </ul>

Parameters

Name	Description
name	The name of the partial
text	The content of the partial

Synopses

Declared in <mrdocs/Support/Handlebars.hpp>

std::string
render(std::string_view templateText) const;

» more...

std::string
render(
    std::string_view templateText,
    dom::Value const& context) const;

» more...

Render a handlebars template

std::string
render(
    std::string_view templateText,
    dom::Value const& context,
    HandlebarsOptions const& options) const;

» more...

Return Value

The rendered text

Parameters

Name	Description
templateText	The handlebars template text
context	The data to render
options	The options to use

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

std::string
render(std::string_view templateText) const;

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

std::string
render(
    std::string_view templateText,
    dom::Value const& context) const;

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

std::string
render(
    std::string_view templateText,
    dom::Value const& context,
    HandlebarsOptions const& options) const;

Description

This function renders the specified handlebars template and returns the result as a string.

The context data to render is passed as a dom::Value, which is usually a dom::Object at the first level. When the context is not an object, it is accessed from the handlebars template with the this keyword.

Return Value

The rendered text

Parameters

Name	Description
templateText	The handlebars template text
context	The data to render
options	The options to use

Synopses

Declared in <mrdocs/Support/Handlebars.hpp>

void
render_to(
    OutputRef& out,
    std::string_view templateText) const;

» more...

void
render_to(
    OutputRef& out,
    std::string_view templateText,
    dom::Value const& context) const;

» more...

Render a handlebars template

void
render_to(
    OutputRef& out,
    std::string_view templateText,
    dom::Value const& context,
    HandlebarsOptions const& options) const;

» more...

Return Value

The rendered text

Parameters

Name	Description
out	The output stream reference
templateText	The handlebars template text
context	The data to render
options	The options to use

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
render_to(
    OutputRef& out,
    std::string_view templateText) const;

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
render_to(
    OutputRef& out,
    std::string_view templateText,
    dom::Value const& context) const;

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
render_to(
    OutputRef& out,
    std::string_view templateText,
    dom::Value const& context,
    HandlebarsOptions const& options) const;

Description

This function renders the specified handlebars template and writes the result to the specified output stream.

The output stream can be any type convertible to OutputRef, which is a reference to a stream that can be written to with the << operator.

Return Value

The rendered text

Parameters

Name	Description
out	The output stream reference
templateText	The handlebars template text
context	The data to render
options	The options to use

Synopses

Declared in <mrdocs/Support/Handlebars.hpp>

Expected<std::string, HandlebarsError>
try_render(std::string_view templateText) const;

» more...

Expected<std::string, HandlebarsError>
try_render(
    std::string_view templateText,
    dom::Value const& context) const;

» more...

Render a handlebars template

Expected<std::string, HandlebarsError>
try_render(
    std::string_view templateText,
    dom::Value const& context,
    HandlebarsOptions const& options) const;

» more...

Return Value

The rendered text

Parameters

Name	Description
templateText	The handlebars template text
context	The data to render
options	The options to use

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

Expected<std::string, HandlebarsError>
try_render(std::string_view templateText) const;

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

Expected<std::string, HandlebarsError>
try_render(
    std::string_view templateText,
    dom::Value const& context) const;

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

Expected<std::string, HandlebarsError>
try_render(
    std::string_view templateText,
    dom::Value const& context,
    HandlebarsOptions const& options) const;

Description

This function renders the specified handlebars template and writes the result to the specified output stream.

The output stream can be any type convertible to OutputRef, which is a reference to a stream that can be written to with the << operator.

Return Value

The rendered text

Parameters

Name	Description
templateText	The handlebars template text
context	The data to render
options	The options to use

Synopses

Declared in <mrdocs/Support/Handlebars.hpp>

Expected<void, HandlebarsError>
try_render_to(
    OutputRef& out,
    std::string_view templateText) const;

» more...

Expected<void, HandlebarsError>
try_render_to(
    OutputRef& out,
    std::string_view templateText,
    dom::Value const& context) const;

» more...

Render a handlebars template

Expected<void, HandlebarsError>
try_render_to(
    OutputRef& out,
    std::string_view templateText,
    dom::Value const& context,
    HandlebarsOptions const& options) const;

» more...

Return Value

The rendered text

Parameters

Name	Description
out	The output stream reference
templateText	The handlebars template text
context	The data to render
options	The options to use

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

Expected<void, HandlebarsError>
try_render_to(
    OutputRef& out,
    std::string_view templateText) const;

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

Expected<void, HandlebarsError>
try_render_to(
    OutputRef& out,
    std::string_view templateText,
    dom::Value const& context) const;

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

Expected<void, HandlebarsError>
try_render_to(
    OutputRef& out,
    std::string_view templateText,
    dom::Value const& context,
    HandlebarsOptions const& options) const;

Description

This function renders the specified handlebars template and writes the result to the specified output stream.

The output stream can be any type convertible to OutputRef, which is a reference to a stream that can be written to with the << operator.

Return Value

The rendered text

Parameters

Name	Description
out	The output stream reference
templateText	The handlebars template text
context	The data to render
options	The options to use

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
unregisterHelper(std::string_view name);

Description

This function unregisters a helper with the handlebars environment.

Parameters

Name	Description
name	The name of the helper

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
unregisterPartial(std::string_view name);

Description

This function unregisters a partial with the handlebars environment.

Parameters

Name	Description
name	The name of the partial

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

struct HandlebarsError
    : std::runtime_error

Description

An error returned or thrown by Handlebars environment when an error occurs during template rendering.

The error message will be the same as the error message returned by Handlebars.js.

The object will also contain the line, column and position of the error in the template. These can be used to by the caller to provide more detailed error messages.

Base Classes

Name	Description
`std::runtime_error`	One of two subclasses of exception.

Member Functions

Name	Description
`HandlebarsError` [constructor]	Constructors
`operator=`	Assignment operators
`what` [virtual]	Returns a C-style character string describing the general cause of the current error (the same string passed to the ctor).

Data Members

Name	Description
`column`	Column of the error in the template.
`line`	Line number in the template where the error occurred.
`pos`	Absolute character position of the error.

Synopses

Declared in <mrdocs/Support/Handlebars.hpp>

Construct an error with a message.

HandlebarsError(std::string_view msg);

» more...

Construct an error with location information.

HandlebarsError(
    std::string_view msg,
    std::size_t line_,
    std::size_t column_,
    std::size_t pos_);

» more...

Parameters

Name	Description
msg	Description of the failure.
line_	Line number where it occurred.
column_	Column number where it occurred.
pos_	Absolute character position.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

HandlebarsError(std::string_view msg);

Parameters

Name	Description
msg	Description of the failure.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

HandlebarsError(
    std::string_view msg,
    std::size_t line_,
    std::size_t column_,
    std::size_t pos_);

Parameters

Name	Description
msg	Description of the failure.
line_	Line number where it occurred.
column_	Column number where it occurred.
pos_	Absolute character position.

Synopses

Declared in <stdexcept>

Assignment operator

runtime_error&
operator=(runtime_error const& value) noexcept;

» more...

Assignment operator

runtime_error&
operator=(runtime_error&& value) noexcept;

» more...

Synopsis

Declared in <stdexcept>

runtime_error&
operator=(runtime_error const& value) noexcept;

Return Value

One of two subclasses of exception.

Parameters

Name	Description
value	The object to copy assign from

Synopsis

Declared in <stdexcept>

runtime_error&
operator=(runtime_error&& value) noexcept;

Return Value

One of two subclasses of exception.

Parameters

Name	Description
value	The object to move assign from

Synopsis

Declared in <stdexcept>

virtual
char const*
what() const noexcept;

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

std::size_t column = static_cast<std::size_t>(-1);

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

std::size_t line = static_cast<std::size_t>(-1);

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

std::size_t pos = static_cast<std::size_t>(-1);

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

struct HandlebarsOptions;

Description

This struct is analogous to the Handlebars.compile options.

Data Members

Name	Description
`assumeObjects`	Removes object existence checks when traversing paths
`compat`	Enable recursive field lookup
`data`	Custom private data object
`escapeFunction`	Function to escape entities
`explicitPartialContext`	Disables implicit context for partials
`ignoreStandalone`	Disables standalone tag removal when set to true
`noEscape`	Escape HTML entities or entities defined by the escape function
`preventIndent`	Disable the auto-indent feature
`strict`	Templates will throw rather than ignore missing fields
`trackIds`	Enable tracking of ids

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

bool assumeObjects = false;

Description

This is a subset of strict mode that generates optimized templates when the data inputs are known to be safe.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

bool compat = false;

Description

When enabled, fields will be looked up recursively in objects and arrays.

This mode should be used to enable complete compatibility with Mustache templates.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

dom::Value data = nullptr;

Description

This variable can be used to pass in an object to define custom private variables.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

std::function<void(OutputRef&, std::string_view)> escapeFunction = static_cast<void(*)(OutputRef&, std::string_view)>(HTMLEscape);

Description

It's initialized with a reference to the HTMLEscape function overload that takes an OutputRef and a string_view. This function can be replaced with a custom function that escapes entities in a different way.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

bool explicitPartialContext = false;

Description

When enabled, partials that are not passed a context value will execute against an empty object.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

bool ignoreStandalone = false;

Description

By default, Handlebars removes whitespace around block and partial expressions. For instance, the partial:


{.handlebars}
        A

and the template:


{.handlebars}
        <div>
            {{> partial}}
        </div>

will render as:


{.html}
        <div>
            A</div>

because the whitespace up to the newline after the partial is removed.

A double newline is required to ensure that the whitespace is not removed. For instance, the template:


{.handlebars}
        <div>
            {{> partial}}

        </div>

will render as:


{.html}
        <div>
            A
        </div>

This can be disabled by setting this option to true.

When set, blocks and partials that are on their own line will not remove the whitespace on that line.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

bool noEscape = false;

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

bool preventIndent = false;

Description

By default, an indented partial-call causes the output of the whole partial being indented by the same amount.

For instance, the partial:


{.handlebars}
        A
        B
        C

and the template:


{.handlebars}
        <div>
            {{> partial}}
        </div>

will render as:


{.html}
        <div>
            A
            B
            C
        </div>

because the partial is indented by the same amount as the partial call.

This can be disabled by setting this option to true. In this case, the partial above would be rendered as:


{.html}
        <div>
            A
        B
        C
        </div>

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

bool strict = false;

Description

Run in strict mode. In this mode, templates will throw rather than silently ignore missing fields.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

bool trackIds = false;

Description

When enabled, the ids of the expressions are tracked and passed to the helpers.

Helpers often use this information to update the context path to the current expression, which can later be used to look up the value of the expression with ".." segments.

Synopsis

Declared in <mrdocs/Metadata/Name/IdentifierName.hpp>

struct IdentifierName final
    : Name

Description

This class is used to represent an identifier that could be in the corpus or not.

When the symbol is in the corpus, the id field will be set to the symbol ID of the symbol.

When the symbol is not in the corpus, the id field will be set to SymbolID::invalid.

Base Classes

Name	Description
`Name`	Represents a name for a named `Type`

Member Functions

Name	Description
`IdentifierName` [constructor]	Default-construct an identifier with kind Identifier.
`asName`	`asName` overloads
`operator==`	Equality compares all fields.
`operator<=>`	Three-way comparison operators

Data Members

Name	Description
`Identifier`	The unqualified name.
`Kind`	The kind of name this is.
`Prefix`	The parent name info, if any.
`id`	The SymbolID of the named symbol, if it exists.

Non-Member Functions

Name	Description
`toString`	Convert the name to a human-readable string.

Synopsis

Declared in <mrdocs/Metadata/Name/IdentifierName.hpp>

constexpr
IdentifierName() noexcept;

Synopses

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

Compare identifiers by their base name state.

auto
operator<=>(IdentifierName const& other) const;

» more...

Order names by kind, identifier, id, and prefix.

std::strong_ordering
operator<=>(Name const& other) const;

» more...

Synopsis

Declared in <mrdocs/Metadata/Name/IdentifierName.hpp>

auto
operator<=>(IdentifierName const& other) const;

Return Value

The relative order of the objects

Parameters

Name	Description
other	The right operand

Synopsis

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

std::strong_ordering
operator<=>(Name const& other) const;

Return Value

The relative order of the objects

Parameters

Name	Description
other	The right operand

Synopsis

Declared in <mrdocs/Metadata/Type/LValueReferenceType.hpp>

struct LValueReferenceType final
    : TypeCommonBase<TypeKind::LValueReference>

Base Classes

Name	Description
`TypeCommonBase<TypeKind::LValueReference>`	CRTP base that ties a concrete type to a fixed TypeKind.

Static Member Functions

Name
`isArray`
`isAuto`
`isDecltype`
`isFunction`
`isLValueReference`
`isMemberPointer`
`isNamed`
`isPointer`
`isRValueReference`

Data Members

Name	Description
`PointeeType`	The referenced type.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`innerType`	Return the inner type.
`innerType`	Return the inner type.
`innerTypePtr`	Return the inner type.
`innerTypePtr`	Return the inner type.
`toString`	Render a type to a human-readable string.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isArray() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isAuto() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isDecltype() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isLValueReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isMemberPointer() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isNamed() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isPointer() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isRValueReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/LValueReferenceType.hpp>

Polymorphic<Type> PointeeType = Polymorphic<Type>(AutoType{});

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr static
TypeKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Location.hpp>

struct Location;

Member Functions

Name	Description
`Location` [constructor]	Construct a location with optional fields.

Data Members

Name	Description
`ColumnNumber`	Column number within the line
`Documented`	Whether this location has documentation.
`FullPath`	The full file path
`LineNumber`	Line number within the file
`ShortPath`	The file path relative to one of the search directories
`SourcePath`	The file path relative to the source-root directory

Non-Member Functions

Name	Description
`getPrimaryLocation`	Determine a location to use when none is explicitly chosen.
`getPrimaryLocation`	Choose the best location to display for a symbol.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Location.hpp>

constexpr
Location(
    std::string_view const full_path = {},
    std::string_view const short_path = {},
    std::string_view const source_path = {},
    unsigned int const line = 0,
    unsigned int const col = 0,
    bool const documented = false);

Parameters

Name	Description
full_path	Absolute path to the file on disk.
short_path	Repository- or search-root relative path, may be empty.
source_path	Path relative to the documented source root.
line	Line number within the file.
col	Column number within the line.
documented	Whether the location already carries user documentation.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Location.hpp>

unsigned int ColumnNumber = 0;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Location.hpp>

bool Documented = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Location.hpp>

std::string FullPath;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Location.hpp>

unsigned int LineNumber = 0;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Location.hpp>

std::string ShortPath;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Location.hpp>

std::string SourcePath;

Synopsis

Declared in <mrdocs/Metadata/Type/MemberPointerType.hpp>

struct MemberPointerType final
    : TypeCommonBase<TypeKind::MemberPointer>

Base Classes

Name	Description
`TypeCommonBase<TypeKind::MemberPointer>`	CRTP base that ties a concrete type to a fixed TypeKind.

Static Member Functions

Name
`isArray`
`isAuto`
`isDecltype`
`isFunction`
`isLValueReference`
`isMemberPointer`
`isNamed`
`isPointer`
`isRValueReference`

Data Members

Name	Description
`ParentType`	Containing class type.
`PointeeType`	Pointee type being referenced.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`innerType`	Return the inner type.
`innerType`	Return the inner type.
`innerTypePtr`	Return the inner type.
`innerTypePtr`	Return the inner type.
`toString`	Render a type to a human-readable string.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isArray() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isAuto() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isDecltype() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isLValueReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isMemberPointer() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isNamed() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isPointer() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isRValueReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/MemberPointerType.hpp>

Polymorphic<Type> ParentType = Polymorphic<Type>(AutoType{});

Synopsis

Declared in <mrdocs/Metadata/Type/MemberPointerType.hpp>

Polymorphic<Type> PointeeType = Polymorphic<Type>(AutoType{});

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr static
TypeKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

struct Name;

Description

When the Type is a named type, this class represents the name of the type.

It also includes the symbol ID of the named type, so that it can be referenced in the documentation.

This allows the Type to store either a Name or a SpecializationName, which contains the arguments for a template specialization without requiring the application to extract an unnecessary symbol.

Member Functions

Name	Description
`~Name` [destructor] [virtual]	Virtual destructor for polymorphic cleanup.
`asName`	`asName` overloads
`operator==`	Equality compares all fields.
`operator<=>`	Order names by kind, identifier, id, and prefix.

Data Members

Name	Description
`Identifier`	The unqualified name.
`Kind`	The kind of name this is.
`Prefix`	The parent name info, if any.
`id`	The SymbolID of the named symbol, if it exists.

Protected Member Functions

Name	Description
`Name` [constructor]	Constructors

Non-Member Functions

Name	Description
`toString`	Convert the name to a human-readable string.

Derived Classes

Name	Description
`IdentifierName`	Represents an identifier
`SpecializationName`	Represents a (possibly qualified) symbol name with template arguments.

Synopsis

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

constexpr
virtual
~Name() = default;

Synopses

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

View as a const Name reference.

constexpr
Name const&
asName() const noexcept;

» more...

View as a mutable Name reference.

constexpr
Name&
asName() noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

constexpr
Name const&
asName() const noexcept;

Return Value

Represents a name for a named Type

Synopsis

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

constexpr
Name&
asName() noexcept;

Return Value

Represents a name for a named Type

Synopsis

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

bool
operator==(Name const& other) const;

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
other	The right operand

Synopsis

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

std::strong_ordering
operator<=>(Name const& other) const;

Return Value

The relative order of the objects

Parameters

Name	Description
other	The right operand

Synopsis

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

std::string Identifier;

Synopsis

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

NameKind Kind;

Synopsis

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

Optional<Polymorphic<Name>> Prefix = std::nullopt;

Description

This recursively includes information about the parent, such as the symbol ID and potentially template arguments, when the parent is a SpecializationName.

This is particularly useful because the parent of id could be a primary template. In this case, the Prefix will contain this primary template information and the template arguments.

Synopsis

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

SymbolID id = = SymbolID::invalid;

Synopses

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

Construct an identifier name.

constexpr
Name() noexcept;

» more...

Construct with an explicit name kind.

constexpr
explicit
Name(NameKind const kind) noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

constexpr
Name() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

constexpr
explicit
Name(NameKind const kind) noexcept;

Parameters

Name	Description
kind	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/Type/NamedType.hpp>

struct NamedType final
    : TypeCommonBase<TypeKind::Named>

Base Classes

Name	Description
`TypeCommonBase<TypeKind::Named>`	CRTP base that ties a concrete type to a fixed TypeKind.

Static Member Functions

Name
`isArray`
`isAuto`
`isDecltype`
`isFunction`
`isLValueReference`
`isMemberPointer`
`isNamed`
`isPointer`
`isRValueReference`

Data Members

Name	Description
`FundamentalType`	Fundamental kind if this named type is a built-in.
`Name`	The name of the type (identifier or specialization).

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`innerType`	Return the inner type.
`innerType`	Return the inner type.
`innerTypePtr`	Return the inner type.
`innerTypePtr`	Return the inner type.
`toString`	Render a type to a human-readable string.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isArray() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isAuto() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isDecltype() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isLValueReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isMemberPointer() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isNamed() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isPointer() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isRValueReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/NamedType.hpp>

Optional<FundamentalTypeKind> FundamentalType;

Synopsis

Declared in <mrdocs/Metadata/Type/NamedType.hpp>

Polymorphic<Name> Name = Polymorphic<struct Name>(std::in_place_type<IdentifierName>);

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr static
TypeKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/Symbol/NamespaceAlias.hpp>

struct NamespaceAliasSymbol final
    : SymbolCommonBase<SymbolKind::NamespaceAlias>

Base Classes

Name	Description
`SymbolCommonBase<SymbolKind::NamespaceAlias>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`NamespaceAliasSymbol` [constructor]	Create an alias symbol bound to an ID.

Static Member Functions

Name
`isConcept`
`isEnum`
`isEnumConstant`
`isFunction`
`isGuide`
`isNamespace`
`isNamespaceAlias`
`isOverloads`
`isRecord`
`isTypedef`
`isUsing`
`isVariable`

Data Members

Name	Description
`AliasedSymbol`	The aliased symbol.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`canMerge`	Check whether two symbols may be merged.
`getPrimaryLocation`	Determine a location to use when none is explicitly chosen.

Synopsis

Declared in <mrdocs/Metadata/Symbol/NamespaceAlias.hpp>

explicit
NamespaceAliasSymbol(SymbolID const& ID) noexcept;

Parameters

Name	Description
ID	The object to copy construct from

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isConcept() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnum() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnumConstant() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isGuide() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespace() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespaceAlias() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isOverloads() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isRecord() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isTypedef() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isUsing() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isVariable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/NamespaceAlias.hpp>

IdentifierName AliasedSymbol;

Description

This is another namespace that might or might not be in the same project.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr static
SymbolKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

struct NamespaceSymbol final
    : SymbolCommonBase<SymbolKind::Namespace>

Base Classes

Name	Description
`SymbolCommonBase<SymbolKind::Namespace>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`NamespaceSymbol` [constructor]	Create a namespace symbol bound to an ID.
`operator<=>`	Compare namespaces by attributes and member lists.

Static Member Functions

Name
`isConcept`
`isEnum`
`isEnumConstant`
`isFunction`
`isGuide`
`isNamespace`
`isNamespaceAlias`
`isOverloads`
`isRecord`
`isTypedef`
`isUsing`
`isVariable`

Data Members

Name	Description
`IsAnonymous`	Whether this represents an unnamed namespace.
`IsInline`	Whether this declaration is inline.
`Members`	The members of this namespace.
`UsingDirectives`	Namespaces nominated by using-directives.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`allMembers`	View all members of the namespace across tranches.
`canMerge`	Check whether two symbols may be merged.
`getPrimaryLocation`	Determine a location to use when none is explicitly chosen.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

explicit
NamespaceSymbol(SymbolID const& ID) noexcept;

Parameters

Name	Description
ID	The object to copy construct from

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

std::strong_ordering
operator<=>(NamespaceSymbol const& rhs) const;

Return Value

The relative order of the objects

Parameters

Name	Description
rhs	The right operand

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isConcept() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnum() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnumConstant() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isGuide() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespace() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespaceAlias() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isOverloads() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isRecord() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isTypedef() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isUsing() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isVariable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

bool IsAnonymous = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

bool IsInline = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

NamespaceTranche Members;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

std::vector<Name> UsingDirectives;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr static
SymbolKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

struct NamespaceTranche;

Data Members

Name	Description
`Concepts`	Concepts.
`Enums`	Enumerations.
`Functions`	Functions and overload sets.
`Guides`	Deduction guides.
`NamespaceAliases`	Namespace aliases declared here.
`Namespaces`	Nested namespaces.
`Records`	Record types (classes/structs).
`Typedefs`	Typedef or using declarations.
`Usings`	Using-declarations that introduce members.
`Variables`	Variables.

Non-Member Functions

Name	Description
`allMembers`	Join all tranche member lists into a single view.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

std::vector<SymbolID> Concepts;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

std::vector<SymbolID> Enums;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

std::vector<SymbolID> Functions;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

std::vector<SymbolID> Guides;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

std::vector<SymbolID> NamespaceAliases;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

std::vector<SymbolID> Namespaces;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

std::vector<SymbolID> Records;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

std::vector<SymbolID> Typedefs;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

std::vector<SymbolID> Usings;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

std::vector<SymbolID> Variables;

Synopsis

Declared in <mrdocs/Metadata/Specifiers/NoexceptInfo.hpp>

struct NoexceptInfo;

Member Functions

Name	Description
`operator<=>`	Compare noexcept-specifier info.

Data Members

Name	Description
`Implicit`	Whether a noexcept-specifier was user-written.
`Kind`	The evaluated exception specification.
`Operand`	The operand of the noexcept-specifier, if any.

Non-Member Functions

Name	Description
`toString`	Convert NoexceptInfo to a string.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/NoexceptInfo.hpp>

constexpr
auto
operator<=>(NoexceptInfo const& rhs) const = default;

Return Value

The relative order of the objects

Parameters

Name	Description
rhs	The right operand

Synopsis

Declared in <mrdocs/Metadata/Specifiers/NoexceptInfo.hpp>

bool Implicit = true;

Synopsis

Declared in <mrdocs/Metadata/Specifiers/NoexceptInfo.hpp>

NoexceptKind Kind = NoexceptKind::False;

Synopsis

Declared in <mrdocs/Metadata/Specifiers/NoexceptInfo.hpp>

std::string Operand;

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<class T>
class Optional;

Description

Design

If nullable_traits<T> exists, the null state is encoded inside T (via sentinel or clearable-empty semantics). Storage is exactly one T.
Otherwise, this falls back to std::optional<T> and uses its discriminator.

This single implementation uses a conditional storage type plus if constexpr on has_nullable_traits_v<T> to select the appropriate behavior at compile time.

Type Aliases

Name	Description
`value_type`	Value type stored by this Optional.

Member Functions

Name	Description
`Optional` [constructor]	Constructors
`operator=`	Assignment operators
`emplace`	In-place construct a new value, replacing any existing one.
`has_value`	True if engaged (contains a value).
`operator*`	Dereference-like access.
`operator->`	Pointer-like access.
`reset`	Reset to the null state. *
`value`	Value access. Preconditions: has_value() is true.
`operator bool`	Contextual bool.

Static Member Functions

Name	Description
`is_inlined`	Determine if the value is inlined via nullable traits.

Non-Member Functions

Name	Description
`getOperatorReadableName`	Return the human-readable name of the operator
`getPrimaryLocation`	Determine a location to use when none is explicitly chosen.
`getPrimaryLocation`	Choose the best location to display for a symbol.
`innerType`	Return the inner type.
`innerType`	Return the inner type.
`operator!=`	Compares an Optional to a value for inequality. Returns true if the Optional is disengaged or its value does not equal rhs.
`operator!=`	Compares two Optional values for inequality. Returns true if their engagement states differ or their contained values are not equal.
`operator<`	Checks if the Optional is less than a value. Returns true if the Optional is disengaged or its value is less than rhs.
`operator<`	Checks if the left Optional is less than the right Optional. Returns true if the right is engaged and either the left is disengaged or its value is less.
`operator<=`	Checks if the Optional is less than or equal to a value. Returns true if the Optional is disengaged or its value is less than or equal to rhs.
`operator<=`	Checks if the left Optional is less than or equal to the right Optional. Returns true if the left is disengaged or the right is engaged and the left's value is less or equal.
`operator<=>`	Performs a three-way comparison between an Optional and a value. If the Optional is engaged, compares its value to v; otherwise, returns less.
`operator<=>`	Performs a three-way comparison between two Optional values. If both are engaged, compares their contained values; otherwise, compares engagement state.
`operator<=>`	Performs a three-way comparison between an Optional and std::nullopt. Returns std::strong_ordering::greater if engaged, std::strong_ordering::equal if disengaged.
`operator==`	Compares two Optional values for equality. Returns true if both are engaged and their contained values are equal, or both are disengaged.
`operator==`	Compares an engaged Optional to a value for equality. Returns true if the Optional is engaged and its value equals rhs.
`operator==`	Checks if the Optional is disengaged (equal to std::nullopt). Returns true if the Optional does not contain a value.
`operator>`	Checks if the Optional is greater than a value. Returns true if the Optional is engaged and its value is greater than rhs.
`operator>`	Checks if the left Optional is greater than the right Optional. Returns true if the left is engaged and either the right is disengaged or its value is greater.
`operator>=`	Checks if the left Optional is greater than or equal to the right Optional. Returns true if the right is disengaged or the left is engaged and its value is greater or equal.
`operator>=`	Checks if the Optional is greater than or equal to a value. Returns true if the Optional is engaged and its value is greater than or equal to rhs.
`swap`	Swap two Optional references.
`dom::stringOrNull`	Return a non-empty string, or a null.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

using value_type = T;

Synopses

Declared in <mrdocs/ADT/Optional.hpp>

Default-constructs to the “null” state.

constexpr
Optional() noexcept(default_ctor_noex_());

» more...

Copy constructor

constexpr
Optional(Optional const& other) = default;

» more...

Construct from another Optional with a convertible contained value.

template<typename U>
requires (!std::is_same_v<T, U>) && std::is_constructible_v<T, U const&>
            && ConstructFromContainedValue<U>
constexpr
explicit(!std::is_convertible_v<const U &, T>)
Optional(Optional<U> const& t) noexcept(std::is_nothrow_constructible_v<T, const U &>);

» more...

Move constructor

constexpr
Optional(Optional&& other) = default;

» more...

Construct from another Optional rvalue with a convertible value.

template<typename U>
requires (!std::is_same_v<T, U>)
            && std::is_constructible_v<T, U> && ConstructFromContainedValue<U>
constexpr
explicit(!std::is_convertible_v<U, T>)
Optional(Optional<U>&& t) noexcept(std::is_nothrow_constructible_v<T, U>);

» more...

Construct from std::nullopt

constexpr
Optional(std::nullopt_t value) noexcept(default_ctor_noex_());

» more...

Construct from std::optional lvalue with convertible value.

template<typename U>
requires std::is_constructible_v<T, U const&> &&
        ConstructFromContainedValue<U>
constexpr
explicit(!std::is_convertible_v<const U &, T>)
Optional(std::optional<U> const& t) noexcept(std::is_nothrow_constructible_v<T, const U &>);

» more...

Construct from a value.

template<typename U = std::remove_cv_t<T>>
requires (!std::is_same_v<Optional, std::remove_cvref_t<U>>)
            && (!std::is_same_v<std::in_place_t, std::remove_cvref_t<U>>)
            && std::is_constructible_v<T, U>
            && NotConstructingBoolFromOptional<U>
constexpr
explicit(!std::is_convertible_v<U, T>)
Optional(U&& u) noexcept(std::is_nothrow_constructible_v<T, U>);

» more...

Construct from std::optional rvalue with convertible value.

template<typename U>
requires std::is_constructible_v<T, U> &&
        ConstructFromContainedValue<U>
constexpr
explicit(!std::is_convertible_v<U, T>)
Optional(std::optional<U>&& t) noexcept(std::is_nothrow_constructible_v<T, U>);

» more...

In-place construct the contained value.

template<typename... Args>
requires std::is_constructible_v<T, Args...>
constexpr
explicit
Optional(
    std::in_place_t,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<T, Args...>);

» more...

In-place construct the contained value from an initializer list.

template<
    typename U,
    typename... Args>
requires std::is_constructible_v<T, std::initializer_list<U>&, Args...>
constexpr
explicit
Optional(
    std::in_place_t,
    std::initializer_list<U> il,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<T, std::initializer_list<U> &, Args...>);

» more...

Parameters

Name	Description
t	Source optional.
u	The value to store. It must be convertible to T.
args	Arguments forwarded to T's constructor.
il	Initializer list forwarded to T's constructor.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
Optional() noexcept(default_ctor_noex_());

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
Optional(Optional const& other) = default;

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<typename U>
requires (!std::is_same_v<T, U>) && std::is_constructible_v<T, U const&>
            && ConstructFromContainedValue<U>
constexpr
explicit(!std::is_convertible_v<const U &, T>)
Optional(Optional<U> const& t) noexcept(std::is_nothrow_constructible_v<T, const U &>);

Parameters

Name	Description
t	Source optional.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
Optional(Optional&& other) = default;

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<typename U>
requires (!std::is_same_v<T, U>)
            && std::is_constructible_v<T, U> && ConstructFromContainedValue<U>
constexpr
explicit(!std::is_convertible_v<U, T>)
Optional(Optional<U>&& t) noexcept(std::is_nothrow_constructible_v<T, U>);

Parameters

Name	Description
t	Source optional.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
Optional(std::nullopt_t value) noexcept(default_ctor_noex_());

Parameters

Name	Description
value	The object to construct from

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<typename U>
requires std::is_constructible_v<T, U const&> &&
        ConstructFromContainedValue<U>
constexpr
explicit(!std::is_convertible_v<const U &, T>)
Optional(std::optional<U> const& t) noexcept(std::is_nothrow_constructible_v<T, const U &>);

Parameters

Name	Description
t	Source optional.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<typename U = std::remove_cv_t<T>>
requires (!std::is_same_v<Optional, std::remove_cvref_t<U>>)
            && (!std::is_same_v<std::in_place_t, std::remove_cvref_t<U>>)
            && std::is_constructible_v<T, U>
            && NotConstructingBoolFromOptional<U>
constexpr
explicit(!std::is_convertible_v<U, T>)
Optional(U&& u) noexcept(std::is_nothrow_constructible_v<T, U>);

Parameters

Name	Description
u	The value to store. It must be convertible to T.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<typename U>
requires std::is_constructible_v<T, U> &&
        ConstructFromContainedValue<U>
constexpr
explicit(!std::is_convertible_v<U, T>)
Optional(std::optional<U>&& t) noexcept(std::is_nothrow_constructible_v<T, U>);

Parameters

Name	Description
t	Source optional.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<typename... Args>
requires std::is_constructible_v<T, Args...>
constexpr
explicit
Optional(
    std::in_place_t,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<T, Args...>);

Parameters

Name	Description
args	Arguments forwarded to T's constructor.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename U,
    typename... Args>
requires std::is_constructible_v<T, std::initializer_list<U>&, Args...>
constexpr
explicit
Optional(
    std::in_place_t,
    std::initializer_list<U> il,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<T, std::initializer_list<U> &, Args...>);

Parameters

Name	Description
il	Initializer list forwarded to T's constructor.
args	Additional arguments forwarded to T's constructor.

Synopses

Declared in <mrdocs/ADT/Optional.hpp>

Copy assignment.

constexpr
Optional&
operator=(Optional const& other) = default;

» more...

Assign from another Optional with convertible contained value.

template<typename U>
requires (!std::is_same_v<T, U>)
            && std::is_constructible_v<T, const U&>
            && std::is_assignable_v<T&, const U&>
            && (!detail::ConvertsFromOptional<T, U>::value)
            && (!detail::AssignsFromOptional<T, U>::value)
constexpr
Optional&
operator=(Optional<U> const& u) noexcept(std::is_nothrow_constructible_v<T, const U &> && std::is_nothrow_assignable_v<T &, const U &>);

» more...

Move assignment.

constexpr
Optional&
operator=(Optional&& other) = default;

» more...

Assign from another Optional rvalue with convertible contained value.

template<typename U>
requires (!std::is_same_v<T, U>)
            && std::is_constructible_v<T, U>
            && std::is_assignable_v<T&, U>
            && (!detail::ConvertsFromOptional<T, U>::value)
            && (!detail::AssignsFromOptional<T, U>::value)
constexpr
Optional&
operator=(Optional<U>&& u) noexcept(std::is_nothrow_constructible_v<T, U> && std::is_nothrow_assignable_v<T &, U>);

» more...

Reset to disengaged state from nullptr tag.

constexpr
Optional&
operator=(std::nullptr_t value) noexcept(reset_noex_());

» more...

Assign from std::optional lvalue with convertible value.

template<typename U>
requires (!std::is_same_v<T, U>)
            && std::is_constructible_v<T, const U&>
            && std::is_assignable_v<T&, const U&>
            && (!detail::ConvertsFromOptional<T, U>::value)
            && (!detail::AssignsFromOptional<T, U>::value)
constexpr
Optional&
operator=(std::optional<U> const& u) noexcept(std::is_nothrow_constructible_v<T, const U &> && std::is_nothrow_assignable_v<T &, const U &>);

» more...

Assign from a value.

template<typename U = std::remove_cv_t<T>>
requires (!std::is_same_v<Optional, std::remove_cvref_t<U>>)
            && std::is_constructible_v<T, U> && std::is_assignable_v<T&, U>
constexpr
Optional&
operator=(U&& u) noexcept(std::is_nothrow_constructible_v<T, U> && std::is_nothrow_assignable_v<T &, U>);

» more...

Assign from std::optional rvalue with convertible value.

template<typename U>
requires (!std::is_same_v<T, U>)
            && std::is_constructible_v<T, U>
            && std::is_assignable_v<T&, U>
            && (!detail::ConvertsFromOptional<T, U>::value)
            && (!detail::AssignsFromOptional<T, U>::value)
constexpr
Optional&
operator=(std::optional<U>&& u) noexcept(std::is_nothrow_constructible_v<T, U> && std::is_nothrow_assignable_v<T &, U>);

» more...

Return Value

*this.

Parameters

Name	Description
u	Source optional.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
Optional&
operator=(Optional const& other) = default;

Return Value

*this.

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<typename U>
requires (!std::is_same_v<T, U>)
            && std::is_constructible_v<T, const U&>
            && std::is_assignable_v<T&, const U&>
            && (!detail::ConvertsFromOptional<T, U>::value)
            && (!detail::AssignsFromOptional<T, U>::value)
constexpr
Optional&
operator=(Optional<U> const& u) noexcept(std::is_nothrow_constructible_v<T, const U &> && std::is_nothrow_assignable_v<T &, const U &>);

Return Value

Reference to the current object

Parameters

Name	Description
u	Source optional.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
Optional&
operator=(Optional&& other) = default;

Return Value

*this.

Parameters

Name	Description
other	The object to move assign from

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<typename U>
requires (!std::is_same_v<T, U>)
            && std::is_constructible_v<T, U>
            && std::is_assignable_v<T&, U>
            && (!detail::ConvertsFromOptional<T, U>::value)
            && (!detail::AssignsFromOptional<T, U>::value)
constexpr
Optional&
operator=(Optional<U>&& u) noexcept(std::is_nothrow_constructible_v<T, U> && std::is_nothrow_assignable_v<T &, U>);

Return Value

Reference to the current object

Parameters

Name	Description
u	Source optional.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
Optional&
operator=(std::nullptr_t value) noexcept(reset_noex_());

Return Value

*this.

Parameters

Name	Description
value	The object to assign from

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<typename U>
requires (!std::is_same_v<T, U>)
            && std::is_constructible_v<T, const U&>
            && std::is_assignable_v<T&, const U&>
            && (!detail::ConvertsFromOptional<T, U>::value)
            && (!detail::AssignsFromOptional<T, U>::value)
constexpr
Optional&
operator=(std::optional<U> const& u) noexcept(std::is_nothrow_constructible_v<T, const U &> && std::is_nothrow_assignable_v<T &, const U &>);

Return Value

Reference to the current object

Parameters

Name	Description
u	Source optional.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<typename U = std::remove_cv_t<T>>
requires (!std::is_same_v<Optional, std::remove_cvref_t<U>>)
            && std::is_constructible_v<T, U> && std::is_assignable_v<T&, U>
constexpr
Optional&
operator=(U&& u) noexcept(std::is_nothrow_constructible_v<T, U> && std::is_nothrow_assignable_v<T &, U>);

Return Value

Reference to the current object

Parameters

Name	Description
u	The value to store. It must be convertible to T.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<typename U>
requires (!std::is_same_v<T, U>)
            && std::is_constructible_v<T, U>
            && std::is_assignable_v<T&, U>
            && (!detail::ConvertsFromOptional<T, U>::value)
            && (!detail::AssignsFromOptional<T, U>::value)
constexpr
Optional&
operator=(std::optional<U>&& u) noexcept(std::is_nothrow_constructible_v<T, U> && std::is_nothrow_assignable_v<T &, U>);

Return Value

Reference to the current object

Parameters

Name	Description
u	Source optional.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<class... Args>
requires std::is_constructible_v<T, Args...>
constexpr
value_type&
emplace(Args&&... args) noexcept(std::is_nothrow_constructible_v<T, Args...>);

Return Value

A reference to the newly constructed value.

Parameters

Name	Description
args	The arguments to forward to T's constructor.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
bool
has_value() const noexcept(has_value_noex_());

Return Value

true if the optional contains a value.

Synopses

Declared in <mrdocs/ADT/Optional.hpp>

Dereference-like access.

constexpr
value_type&
operator*() noexcept;

» more...

Dereference-like access.

constexpr
value_type const&
operator*() const noexcept;

Pointer-like access.

constexpr
value_type*
operator->() noexcept;

» more...

Pointer-like access.

constexpr
value_type const*
operator->() const noexcept;

constexpr
void
reset() noexcept(reset_noex_());

Synopses

Declared in <mrdocs/ADT/Optional.hpp>

Value access. Preconditions: has_value() is true.

constexpr
value_type&
value() & noexcept;

» more...

Value access. Preconditions: has_value() is true.

constexpr
value_type const&
value() const & noexcept;

» more...

Value access. Preconditions: has_value() is true.

constexpr
value_type&&
value() && noexcept;

» more...

Value access. Preconditions: has_value() is true.

constexpr
value_type const&&
value() const && noexcept;

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<class T>
class Optional<T&>;

Description

Stores a pointer to an externally owned object; the disengaged state is nullptr.

Type Aliases

Name	Description
`value_type`	Referenced value type.

Member Functions

Name	Description
`Optional` [constructor]	Constructors
`operator=`	Assignment operators
`emplace`	Bind to a new referenced value.
`has_value`	Check whether the optional holds a reference.
`operator*`	Dereference the referenced object.
`operator->`	Return pointer to the referenced object.
`reset`	Disengage the optional.
`swap`	Exchange the contained value with another Optional.
`value`	`value` overloads
`operator bool`	Return true when the optional holds a reference.

Static Member Functions

Name	Description
`is_inlined`	Return true because Optional<T&> never allocates storage.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

using value_type = T;

Synopses

Declared in <mrdocs/ADT/Optional.hpp>

Construct an empty optional reference.

constexpr
Optional() noexcept = default;

» more...

Copy constructor.

constexpr
Optional(Optional const& other) noexcept = default;

» more...

Move constructor.

constexpr
Optional(Optional&& other) noexcept = default;

» more...

Construct disengaged from std::nullopt.

constexpr
Optional(std::nullopt_t value) noexcept;

» more...

Construct from another Optional holding a related reference.

template<class U>
requires ok_bind_v<U&>
constexpr
explicit(!std::is_convertible_v<U &, T &>)
Optional(Optional<U>& rhs) noexcept(std::is_nothrow_constructible_v<T &, U &>);

» more...

Construct from std::optional lvalue.

template<class U>
requires ok_bind_v<U&>
constexpr
Optional(std::optional<U>& o) noexcept(std::is_nothrow_constructible_v<T &, U &>);

» more...

Construct from a const Optional holding a related reference.

template<class U>
requires ok_bind_v<U const&>
constexpr
explicit(!std::is_convertible_v<const U &, T &>)
Optional(Optional<U> const& rhs) noexcept(std::is_nothrow_constructible_v<T &, const U &>);

» more...

Construct from const std::optional lvalue.

template<class U>
requires ok_bind_v<U const&>
constexpr
Optional(std::optional<U> const& o) noexcept(std::is_nothrow_constructible_v<T &, const U &>);

» more...

Bind to a referenceable object.

template<class U>
requires (
        !std::is_same_v<std::remove_cvref_t<U>, Optional> &&
        !std::is_same_v<std::remove_cvref_t<U>, std::in_place_t> &&
        ok_bind_v<U>)
constexpr
explicit(!std::is_convertible_v<U, T &>)
Optional(U&& u) noexcept(std::is_nothrow_constructible_v<T &, U>);

» more...

Parameters

Name	Description
rhs	Optional to bind to if engaged.
o	Source optional to bind if engaged.
u	Object to bind to.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
Optional() noexcept = default;

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
Optional(Optional const& other) noexcept = default;

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
Optional(Optional&& other) noexcept = default;

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
Optional(std::nullopt_t value) noexcept;

Parameters

Name	Description
value	The object to construct from

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<class U>
requires ok_bind_v<U&>
constexpr
explicit(!std::is_convertible_v<U &, T &>)
Optional(Optional<U>& rhs) noexcept(std::is_nothrow_constructible_v<T &, U &>);

Parameters

Name	Description
rhs	Optional to bind to if engaged.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<class U>
requires ok_bind_v<U&>
constexpr
Optional(std::optional<U>& o) noexcept(std::is_nothrow_constructible_v<T &, U &>);

Parameters

Name	Description
o	Source optional to bind if engaged.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<class U>
requires ok_bind_v<U const&>
constexpr
explicit(!std::is_convertible_v<const U &, T &>)
Optional(Optional<U> const& rhs) noexcept(std::is_nothrow_constructible_v<T &, const U &>);

Parameters

Name	Description
rhs	Optional to bind to if engaged.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<class U>
requires ok_bind_v<U const&>
constexpr
Optional(std::optional<U> const& o) noexcept(std::is_nothrow_constructible_v<T &, const U &>);

Parameters

Name	Description
o	Source optional to bind if engaged.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<class U>
requires (
        !std::is_same_v<std::remove_cvref_t<U>, Optional> &&
        !std::is_same_v<std::remove_cvref_t<U>, std::in_place_t> &&
        ok_bind_v<U>)
constexpr
explicit(!std::is_convertible_v<U, T &>)
Optional(U&& u) noexcept(std::is_nothrow_constructible_v<T &, U>);

Parameters

Name	Description
u	Object to bind to.

Synopses

Declared in <mrdocs/ADT/Optional.hpp>

Copy assignment.

constexpr
Optional&
operator=(Optional const& other) noexcept = default;

» more...

Move assignment.

constexpr
Optional&
operator=(Optional&& other) noexcept = default;

» more...

Reset from std::nullopt.

constexpr
Optional&
operator=(std::nullopt_t value) noexcept;

» more...

Assign from another Optional reference.

template<class U>
requires ok_bind_v<U&>
constexpr
Optional&
operator=(Optional<U>& rhs) noexcept(std::is_nothrow_constructible_v<T &, U &>);

» more...

Assign from a const Optional reference.

template<class U>
requires ok_bind_v<U const&>
constexpr
Optional&
operator=(Optional<U> const& rhs) noexcept(std::is_nothrow_constructible_v<T &, const U &>);

» more...

Assign from a referenceable value.

template<class U>
requires ok_bind_v<U>
constexpr
Optional&
operator=(U&& u) noexcept(std::is_nothrow_constructible_v<T &, U>);

» more...

Assign from a movable Optional reference.

template<class U>
requires ok_bind_v<U>
constexpr
Optional&
operator=(Optional<U>&& rhs) noexcept(std::is_nothrow_constructible_v<T &, U>);

» more...

Return Value

*this.

Parameters

Name	Description
rhs	Source optional.
u	Reference to bind.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
Optional&
operator=(Optional const& other) noexcept = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
Optional&
operator=(Optional&& other) noexcept = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to move assign from

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
Optional&
operator=(std::nullopt_t value) noexcept;

Return Value

Reference to the current object

Parameters

Name	Description
value	The object to assign from

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<class U>
requires ok_bind_v<U&>
constexpr
Optional&
operator=(Optional<U>& rhs) noexcept(std::is_nothrow_constructible_v<T &, U &>);

Return Value

*this.

Parameters

Name	Description
rhs	Source optional.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<class U>
requires ok_bind_v<U const&>
constexpr
Optional&
operator=(Optional<U> const& rhs) noexcept(std::is_nothrow_constructible_v<T &, const U &>);

Return Value

*this.

Parameters

Name	Description
rhs	Source optional.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<class U>
requires ok_bind_v<U>
constexpr
Optional&
operator=(U&& u) noexcept(std::is_nothrow_constructible_v<T &, U>);

Return Value

*this.

Parameters

Name	Description
u	Reference to bind.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<class U>
requires ok_bind_v<U>
constexpr
Optional&
operator=(Optional<U>&& rhs) noexcept(std::is_nothrow_constructible_v<T &, U>);

Return Value

*this.

Parameters

Name	Description
rhs	Source optional.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<class U>
requires ok_bind_v<U>
constexpr
value_type&
emplace(U&& u) noexcept(std::is_nothrow_constructible_v<T &, U>);

Return Value

Reference to the bound value.

Parameters

Name	Description
u	Referenceable value to bind.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
bool
has_value() const noexcept;

Return Value

true if engaged.

Synopses

Declared in <mrdocs/ADT/Optional.hpp>

Dereference the referenced object.

constexpr
value_type&
operator*() noexcept;

» more...

Dereference the referenced object.

constexpr
value_type const&
operator*() const noexcept;

Return pointer to the referenced object.

constexpr
value_type*
operator->() noexcept;

» more...

Return pointer to the referenced object.

constexpr
value_type const*
operator->() const noexcept;

constexpr
void
reset() noexcept;

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
void
swap(Optional& other) noexcept;

Parameters

Name	Description
other	Optional to swap with.

Synopses

Declared in <mrdocs/ADT/Optional.hpp>

Access the referenced object.

constexpr
value_type&
value() & noexcept;

» more...

Access the referenced object.

constexpr
value_type const&
value() const & noexcept;

» more...

Access the referenced object (rvalue overload).

constexpr
value_type&
value() && noexcept;

» more...

Access the referenced object (const rvalue overload).

constexpr
value_type const&
value() const && noexcept;

» more...

Return Value

Reference to the bound value.
Const reference to the bound value.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
value_type&
value() & noexcept;

Return Value

Reference to the bound value.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
value_type const&
value() const & noexcept;

Return Value

Const reference to the bound value.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
value_type&
value() && noexcept;

Return Value

Reference to the bound value.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
value_type const&
value() const && noexcept;

Return Value

Const reference to the bound value.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
explicit
operator bool() const noexcept;

Return Value

true when the optional holds a reference.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
static
bool
is_inlined() noexcept;

Return Value

true always.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

class OutputRef;

Description

This class is used to internally pass an output stream to the handlebars environment.

It allows many types to be used as output streams, including std::string, std::ostream, llvm::raw_string_ostream, and others.

Member Functions

Name	Description
`OutputRef` [constructor]	Constructors
`getIndent`	Return the current indentation level.
`setIndent`	Set the indentation level applied to writes.

Friends

Name	Description
`mrdocs::operator<<`	Write to output
`mrdocs::operator<<`	Write to output
`mrdocs::operator<<`	Write to output
`mrdocs::operator<<`	Write to output
`mrdocs::Handlebars`	A handlebars environment

Non-Member Functions

Name	Description
`HTMLEscape`	HTML escapes the specified string

Synopses

Declared in <mrdocs/Support/Handlebars.hpp>

Constructor for std::ostream& output

template</* implementation-defined */ Os>
requires std::is_convertible_v<Os*, std::ostream*> &&
        (!detail::StdLHROStreamable<Os>)
OutputRef(Os& os);

» more...

Constructor for llvm::raw_string_ostream output

template</* implementation-defined */ Os>
requires std::is_convertible_v<Os*, std::ostream*>
OutputRef(Os& os);

» more...

Constructor for std::string output

template</* implementation-defined */ St>
requires std::same_as<typename St::value_type, char>
OutputRef(St& st);

» more...

Parameters

Name	Description
os	The output stream to write to
st	The string to append to

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

template</* implementation-defined */ Os>
requires std::is_convertible_v<Os*, std::ostream*> &&
        (!detail::StdLHROStreamable<Os>)
OutputRef(Os& os);

Parameters

Name	Description
os	The output stream to write to

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

template</* implementation-defined */ Os>
requires std::is_convertible_v<Os*, std::ostream*>
OutputRef(Os& os);

Parameters

Name	Description
os	The output stream to write to

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

template</* implementation-defined */ St>
requires std::same_as<typename St::value_type, char>
OutputRef(St& st);

Parameters

Name	Description
st	The string to append to

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

std::size_t
getIndent() const noexcept;

Return Value

the current indentation level.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
setIndent(std::size_t indent);

Parameters

Name	Description
indent	Number of spaces to indent.

Synopsis

Declared in <mrdocs/ADT/Overload.hpp>

template<class... Ts>
struct Overload
    : Ts...

Description

This is the canonical "overloaded pattern" implemented as a class template. It inherits from all provided callables and brings in their operator()s, so the resulting object can be called with whichever overload matches.

Typical use-cases include visiting std::variant and building small ad-hoc pattern-matching style dispatchers.


auto f = fn::makeOverload(
 [](int i) { return i * 2; },
 [](const std::string& s) { return s.size(); }
);
auto a = f(21);        // calls int overload
auto b = f(std::string("hello")); // calls string overload

Base Classes

Name	Description
`Ts...`

Member Functions

Name	Description
`Overload` [constructor]	Constructs an Overload from the given callables.

Non-Member Functions

Name	Description
`makeOverload`	Factory function that creates an Overload from the given callables.

Template Parameters

Name	Description
Ts	The callable types to combine (lambdas, function objects, etc.)

Synopsis

Declared in <mrdocs/ADT/Overload.hpp>

constexpr
explicit
Overload(Ts... xs) noexcept((std::is_nothrow_move_constructible_v<Ts> && ...));

Parameters

Name	Description
xs	The callables to store.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Overloads.hpp>

struct OverloadsSymbol final
    : SymbolCommonBase<SymbolKind::Overloads>

Base Classes

Name	Description
`SymbolCommonBase<SymbolKind::Overloads>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`OverloadsSymbol` [constructor]	Constructors

Static Member Functions

Name
`isConcept`
`isEnum`
`isEnumConstant`
`isFunction`
`isGuide`
`isNamespace`
`isNamespaceAlias`
`isOverloads`
`isRecord`
`isTypedef`
`isUsing`
`isVariable`

Data Members

Name	Description
`FuncClass`	The class of the functions.
`Members`	The members of the overload set.
`OverloadedOperator`	The overloaded operator, if any.
`ReturnType`	Info about the return type of these function overloads.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`addMember`	Append a new function overload to the set.
`allMembers`	Access the list of overload members.
`canMerge`	Check whether two symbols may be merged.
`getPrimaryLocation`	Determine a location to use when none is explicitly chosen.

Synopses

Declared in <mrdocs/Metadata/Symbol/Overloads.hpp>

Create an empty overload set for the given ID.

explicit
OverloadsSymbol(SymbolID const& ID) noexcept;

» more...

Create an overload set under the given parent and name.

explicit
OverloadsSymbol(
    SymbolID const& Parent,
    std::string_view Name,
    AccessKind Access,
    bool isStatic) noexcept;

» more...

Parameters

Name	Description
Parent	Owning symbol ID.
Name	Unqualified name shared by the overloads.
Access	Access specifier when the overloads are members.
isStatic	Whether the overload set refers to static functions.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Overloads.hpp>

explicit
OverloadsSymbol(SymbolID const& ID) noexcept;

Parameters

Name	Description
ID	The object to copy construct from

Synopsis

Declared in <mrdocs/Metadata/Symbol/Overloads.hpp>

explicit
OverloadsSymbol(
    SymbolID const& Parent,
    std::string_view Name,
    AccessKind Access,
    bool isStatic) noexcept;

Parameters

Name	Description
Parent	Owning symbol ID.
Name	Unqualified name shared by the overloads.
Access	Access specifier when the overloads are members.
isStatic	Whether the overload set refers to static functions.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isConcept() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnum() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnumConstant() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isGuide() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespace() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespaceAlias() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isOverloads() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isRecord() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isTypedef() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isUsing() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isVariable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Overloads.hpp>

FunctionClass FuncClass = FunctionClass::Normal;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Overloads.hpp>

std::vector<SymbolID> Members;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Overloads.hpp>

OperatorKind OverloadedOperator = OperatorKind::None;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Overloads.hpp>

Polymorphic<Type> ReturnType = Polymorphic<Type>(AutoType{});

Description

If all overloads have the same return type, this contains that type. Otherwise, it contains auto to indicate that the return type varies according to the parameters.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr static
SymbolKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Param.hpp>

struct Param final

Member Functions

Name	Description
`Param` [constructor]	Constructors

Data Members

Name	Description
`Default`	The default argument for this parameter, if any
`Name`	The parameter name.
`Type`	The type of this parameter

Synopses

Declared in <mrdocs/Metadata/Symbol/Param.hpp>

Create an empty parameter with an auto type.

constexpr
Param() = default;

» more...

Construct a parameter with type, name, and default expression.

Param(
    Polymorphic<Type>&& type,
    std::string&& name,
    std::string&& def_arg);

» more...

Parameters

Name	Description
type	Parameter type.
name	Parameter identifier.
def_arg	Default argument expression, if present.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Param.hpp>

constexpr
Param() = default;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Param.hpp>

Param(
    Polymorphic<Type>&& type,
    std::string&& name,
    std::string&& def_arg);

Parameters

Name	Description
type	Parameter type.
name	Parameter identifier.
def_arg	Default argument expression, if present.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Param.hpp>

Optional<std::string> Default;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Param.hpp>

Optional<std::string> Name;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Param.hpp>

Polymorphic<Type> Type = Polymorphic<struct Type>(AutoType{});

Synopsis

Declared in <mrdocs/Support/Parse.hpp>

struct ParseResult;

Description

This class holds the result of a parse operation. The structure is similar to std::from_chars_result, where we have a ptr member that points to the first character not parsed, and a ec member that holds the error code.

If parsing was successful, then ec stores a default constructed Error object, which indicates success. The operator bool can also be used to check for success.

The typical format of a parsing function is:


ParseResult
parseType(
    char const* first,
    char const* last,
    Type& value);

where more parameters can be defined as needed for parsing options.

Member Functions

Name	Description
`operator bool`	Return true if parsing succeeded.

Data Members

Name	Description
`ec`	Error status for the parse operation.
`ptr`	Pointer to the first unparsed character.

Friends

Name	Description
`mrdocs::operator==`	Equality operator

Non-Member Functions

Name	Description
`parse`	Parse a string view

Synopsis

Declared in <mrdocs/Support/Parse.hpp>

constexpr
explicit
operator bool() const noexcept;

Return Value

true when ec is not a failure.

Synopsis

Declared in <mrdocs/Support/Parse.hpp>

Error ec;

Synopsis

Declared in <mrdocs/Support/Parse.hpp>

char const* ptr;

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

class PathGlobPattern;

Description

A glob pattern matcher where "*" does not match path separators. The pattern "**" can be used to match any number of path separators.

Member Functions

Name	Description
`PathGlobPattern` [constructor]	Construct an empty PathGlobPattern.
`isLiteral`	Checks if the glob pattern is a literal string.
`match`	Matches the given string against the glob pattern.
`matchPatternPrefix`	Matches the start of a given string against the glob pattern.
`pattern`	Returns the glob pattern.

Static Member Functions

Name	Description
`create`	Constructs a PathGlobPattern with the given pattern.

Synopses

Declared in <mrdocs/Support/Glob.hpp>

Construct an empty PathGlobPattern.

constexpr
PathGlobPattern() = default;

» more...

Construct an empty PathGlobPattern.

explicit
PathGlobPattern(GlobPattern glob);

» more...

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

constexpr
PathGlobPattern() = default;

Description

An empty PathGlobPattern will never match any string.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

explicit
PathGlobPattern(GlobPattern glob);

Description

An empty PathGlobPattern will never match any string.

Parameters

Name	Description
glob	The object to construct from

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

bool
isLiteral() const;

Description

This function determines if the glob pattern does not contain any special characters. In other words, it matches a single string.

Return Value

true if the glob pattern is a literal string, false otherwise.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

bool
match(std::string_view const str) const;

Return Value

true if the string matches the pattern, false otherwise.

Parameters

Name	Description
str	The string to match against the pattern.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

bool
matchPatternPrefix(std::string_view prefix) const;

Description

This function determines if the given string with the specified prefix can potentially match the glob pattern.

If the string matches the start of the pattern without failure, even if there are characters left in the string or the pattern, the function returns true.

Return Value

true if the string prefix matches the pattern, false otherwise.

Parameters

Name	Description
prefix	The string to match against the pattern.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

std::string_view
pattern() const;

Return Value

The glob pattern as a string view.

Synopses

Declared in <mrdocs/Support/Glob.hpp>

Constructs a PathGlobPattern with the given pattern.

static
Expected<PathGlobPattern>
create(std::string_view const pattern);

» more...

Constructs a PathGlobPattern with the given pattern.

static
Expected<PathGlobPattern>
create(
    std::string_view const pattern,
    Optional<std::size_t> maxSubGlobs);

» more...

Parameters

Name	Description
pattern	The glob pattern to use for matching.
maxSubGlobs	The maximum number of subpatterns allowed.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

static
Expected<PathGlobPattern>
create(std::string_view const pattern);

Return Value

A container holding an error or a value.

Parameters

Name	Description
pattern	The glob pattern to use for matching.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

static
Expected<PathGlobPattern>
create(
    std::string_view const pattern,
    Optional<std::size_t> maxSubGlobs);

Return Value

A container holding an error or a value.

Parameters

Name	Description
pattern	The glob pattern to use for matching.
maxSubGlobs	The maximum number of subpatterns allowed.

Synopsis

Declared in <mrdocs/Metadata/Type/PointerType.hpp>

struct PointerType final
    : TypeCommonBase<TypeKind::Pointer>

Base Classes

Name	Description
`TypeCommonBase<TypeKind::Pointer>`	CRTP base that ties a concrete type to a fixed TypeKind.

Static Member Functions

Name
`isArray`
`isAuto`
`isDecltype`
`isFunction`
`isLValueReference`
`isMemberPointer`
`isNamed`
`isPointer`
`isRValueReference`

Data Members

Name	Description
`PointeeType`	The pointee type, defaults to `auto` when unknown.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`innerType`	Return the inner type.
`innerType`	Return the inner type.
`innerTypePtr`	Return the inner type.
`innerTypePtr`	Return the inner type.
`toString`	Render a type to a human-readable string.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isArray() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isAuto() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isDecltype() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isLValueReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isMemberPointer() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isNamed() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isPointer() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isRValueReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/PointerType.hpp>

Polymorphic<Type> PointeeType = Polymorphic<Type>(AutoType{});

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr static
TypeKind kind_id;

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

template<class T>
class Polymorphic;

Description

This class supports polymorphic objects with value-like semantics.

It implements a tweaked version of std::polymorphic, based on the reference implementation for P3019R14. Differences are: It implements comparison operators with a very project-specific design. Fixed allocator, not parametrizable. No initializer_list constructor.

Deep copies

To copy polymorphic objects, the class uses the copy constructor of the owned derived-type object when copying to another value. Similarly, to allow the correct destruction of derived objects, it uses the destructor of the owned derived-type object in the destructor.

Type Aliases

Name	Description
`const_pointer`	Const pointer to the held object.
`pointer`	Mutable pointer to the held object.
`value_type`	Base value type.

Member Functions

Name	Description
`Polymorphic` [constructor]	Constructors
`~Polymorphic` [destructor]	Destructor.
`operator=`	Assignment operators
`operator*`	Dereference operators
`operator->`	Member access operators
`valueless_after_move`	Return true if the object has been moved-from and is disengaged.

Friends

Name	Description
`mrdocs::swap`
`mrdocs::nullable_traits`	nullable_traits<T> defines how to treat a T as “nullable” without an external engaged bit.

Non-Member Functions

Name	Description
`CompareDerived`	Compares two polymorphic objects that have visit functions
`cast`	Dynamic cast returning const reference; asserts on failure.
`cast`	Dynamic cast returning reference; asserts on failure.
`cast_or_null`	Dynamic cast pointer; returns nullptr when pp is null.
`cast_or_null`	Dynamic cast pointer; returns nullptr when pp is null (const).
`dyn_cast`	Dynamic cast returning pointer or nullptr.
`dyn_cast`	Dynamic cast returning pointer or nullptr (const overload).
`dyn_cast_or_null`	Dynamic cast if pointer is non-null and engaged, else nullptr (const).
`dyn_cast_or_null`	Dynamic cast if pointer is non-null and engaged, else nullptr.
`innerType`	Return the inner type.
`innerType`	Return the inner type.
`innermostType`	Return the innermost type (mutable overload).
`innermostType`	Return the innermost type.
`isa`	Return true if the polymorphic object holds a value of type To.
`isa_or_null`	Return true if pointer is non-null and referent is of type To.
`operator<=>`	Compare polymorphic template arguments.
`operator<=>`	Compare two polymorphic names by visitor dispatch.
`operator<=>`	Compare polymorphic template parameters.
`operator<=>`	Three-way comparison of two polymorphic objects.
`operator<=>`	Compare two polymorphic types by visitor dispatch.
`operator==`	Equality for two polymorphic types.
`operator==`	Equality comparison of two polymorphic objects.
`operator==`	Equality for two polymorphic names.
`operator==`	Equality for polymorphic template arguments.
`operator==`	Equality helper for polymorphic template parameters.
`doc::isEmpty`	Determine if the inline is empty
`doc::isEmpty`	Determine if the inline is empty
`doc::ltrim`	Removes leading whitespace from the inline element.
`doc::ltrim`	Removes leading whitespace from the block.
`doc::operator<=>`	Three-way comparison between polymorphic block wrappers.
`doc::operator<=>`	Three-way comparison for polymorphic inline elements.
`doc::operator==`	Equality delegates to the three-way comparison.
`doc::operator==`	Equality delegates to the three-way comparison.
`doc::rtrim`	Removes trailing whitespace from the block.
`doc::rtrim`	Removes trailing whitespace from the inline element.
`doc::trim`	Removes leading and trailing whitespace from the block.
`doc::trim`	Removes leading and trailing whitespace from the inline element.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

using const_pointer = T const*;

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

using pointer = T*;

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

using value_type = T;

Synopses

Declared in <mrdocs/ADT/Polymorphic.hpp>

Copy constructor.

constexpr
Polymorphic(Polymorphic const& V);

» more...

Move constructor.

constexpr
Polymorphic(Polymorphic&& V) noexcept;

» more...

Forwarding constructor from a derived U.

template<class U>
constexpr
explicit
Polymorphic(U&& u)
requires (!std::same_as<Polymorphic, std::remove_cvref_t<U>>) &&
                 std::copy_constructible<std::remove_cvref_t<U>> &&
                 std::derived_from<std::remove_cvref_t<U>, T>;

» more...

In-place constructor for a specific derived U.

template<
    class U,
    class... Ts>
constexpr
explicit
Polymorphic(
    std::in_place_type_t<U>,
    Ts&&... ts)
requires std::same_as<std::remove_cvref_t<U>, U> &&
                 std::constructible_from<U, Ts&&...> &&
                 std::copy_constructible<U> && std::derived_from<U, T>;

» more...

Parameters

Name	Description
V	Source object.
ts	Arguments to forward to U's constructor.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

constexpr
Polymorphic(Polymorphic const& V);

Parameters

Name	Description
V	Source object.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

constexpr
Polymorphic(Polymorphic&& V) noexcept;

Parameters

Name	Description
V	Source object (emptied on return).

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

template<class U>
constexpr
explicit
Polymorphic(U&& u)
requires (!std::same_as<Polymorphic, std::remove_cvref_t<U>>) &&
                 std::copy_constructible<std::remove_cvref_t<U>> &&
                 std::derived_from<std::remove_cvref_t<U>, T>;

Parameters

Name	Description
u	The object to move construct from

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

template<
    class U,
    class... Ts>
constexpr
explicit
Polymorphic(
    std::in_place_type_t<U>,
    Ts&&... ts)
requires std::same_as<std::remove_cvref_t<U>, U> &&
                 std::constructible_from<U, Ts&&...> &&
                 std::copy_constructible<U> && std::derived_from<U, T>;

Parameters

Name	Description
ts	Arguments to forward to U's constructor.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

constexpr
~Polymorphic();

Synopses

Declared in <mrdocs/ADT/Polymorphic.hpp>

Copy assignment.

constexpr
Polymorphic&
operator=(Polymorphic const& V);

» more...

Move assignment.

constexpr
Polymorphic&
operator=(Polymorphic&& V) noexcept;

» more...

Return Value

*this.

Parameters

Name	Description
V	Source object.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

constexpr
Polymorphic&
operator=(Polymorphic const& V);

Return Value

*this.

Parameters

Name	Description
V	Source object.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

constexpr
Polymorphic&
operator=(Polymorphic&& V) noexcept;

Return Value

*this.

Parameters

Name	Description
V	Source object (emptied on return).

Synopses

Declared in <mrdocs/ADT/Polymorphic.hpp>

Dereference to the held object.

[[nodiscard]]
constexpr
T&
operator*() noexcept;

» more...

Dereference to the held object (const).

[[nodiscard]]
constexpr
T const&
operator*() const noexcept;

» more...

Return Value

Reference to the contained value.
Const reference to the contained value.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

[[nodiscard]]
constexpr
T&
operator*() noexcept;

Return Value

Reference to the contained value.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

[[nodiscard]]
constexpr
T const&
operator*() const noexcept;

Return Value

Const reference to the contained value.

Synopses

Declared in <mrdocs/ADT/Polymorphic.hpp>

Pointer-like access to the held object.

[[nodiscard]]
constexpr
pointer
operator->() noexcept;

» more...

Pointer-like access to the held object (const).

[[nodiscard]]
constexpr
const_pointer
operator->() const noexcept;

struct RValueReferenceType final
    : TypeCommonBase<TypeKind::RValueReference>

Base Classes

Name	Description
`TypeCommonBase<TypeKind::RValueReference>`	CRTP base that ties a concrete type to a fixed TypeKind.

Static Member Functions

Name
`isArray`
`isAuto`
`isDecltype`
`isFunction`
`isLValueReference`
`isMemberPointer`
`isNamed`
`isPointer`
`isRValueReference`

Data Members

Name	Description
`PointeeType`	The referenced type, defaults to `auto` when unknown.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`innerType`	Return the inner type.
`innerType`	Return the inner type.
`innerTypePtr`	Return the inner type.
`innerTypePtr`	Return the inner type.
`toString`	Render a type to a human-readable string.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isArray() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isAuto() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isDecltype() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isLValueReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isMemberPointer() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isNamed() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isPointer() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isRValueReference() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Type/RValueReferenceType.hpp>

Polymorphic<Type> PointeeType = Polymorphic<Type>(AutoType{});

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr static
TypeKind kind_id;

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

template<class Container>
class RangeFor;

Types

Name	Description
`iterator`	Iterator yielding RangeFor::value_type proxies with first/last flags.
`value_type`	Proxy describing an element plus first/last flags.

Type Aliases

Name	Description
`const_pointer`	Pointer to const proxy.
`const_reference`	Reference to const proxy.
`difference_type`	Signed distance type.
`pointer`	Pointer to proxy.
`reference`	Reference to proxy.
`size_type`	Unsigned size type.

Member Functions

Name	Description
`RangeFor` [constructor]	Construct a range wrapper over a container.
`begin`	Iterator to first element.
`end`	Iterator past the last element.

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

using const_pointer = value_type const*;

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

using const_reference = value_type const&;

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

using difference_type = std::ptrdiff_t;

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

using pointer = value_type*;

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

using reference = value_type&;

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

using size_type = std::size_t;

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

class iterator;

Type Aliases

Name	Description
`iterator_category`	Iterator category forwarded from container.
`pointer`	Pointer type (unused).
`reference`	Reference type.
`size_type`	Size type alias.
`value_type`	Proxy value type.

Member Functions

Name	Description
`iterator` [constructor]	Constructors
`operator=`	Copy assignment.
`operator*`	Dereference to proxy value.
`operator++`	Increment operators
`operator->`	Return proxy for current element.
`operator==`	Equality comparison.
`operator!=`	Inequality comparison.

Friends

Name	Description
`mrdocs::RangeFor::value_type`	Proxy describing an element plus first/last flags.
`mrdocs::RangeFor`	Range adapter to expose first/last flags inside range-for loops.

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

using iterator_category = std::iterator_traits<Container::iterator>::iterator_category;

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

using pointer = void;

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

using reference = value_type;

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

using size_type = std::size_t;

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

using value_type = RangeFor<Container>::value_type;

Synopses

Declared in <mrdocs/Support/RangeFor.hpp>

Default constructor.

iterator() = default;

» more...

Copy constructor.

iterator(iterator const& other) = default;

» more...

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

iterator() = default;

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

iterator(iterator const& other) = default;

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

iterator&
operator=(iterator const& other) = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

reference
operator*() const noexcept;

Return Value

Reference type.

Synopses

Declared in <mrdocs/Support/RangeFor.hpp>

Pre-increment.

iterator&
operator++() noexcept;

» more...

Post-increment.

iterator
operator++(int unused) noexcept;

» more...

Return Value

*this advanced to next element.
Iterator prior to increment.

Parameters

Name	Description
unused	Dummy parameter for postfix form.

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

iterator&
operator++() noexcept;

Return Value

*this advanced to next element.

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

iterator
operator++(int unused) noexcept;

Return Value

Iterator prior to increment.

Parameters

Name	Description
unused	Dummy parameter for postfix form.

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

reference
operator->() const noexcept;

Return Value

proxy for current element.

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

bool
operator==(iterator const& it) const noexcept;

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
it	The right operand

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

bool
operator!=(iterator const& it) const noexcept;

Return Value

true if the objects are not equal, false otherwise

Parameters

Name	Description
it	The right operand

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

struct value_type;

Description

Reference to current element.

Member Functions

Name	Description
`operator->`	Access members through pointer syntax.

Data Members

Name	Description
`first`	True if this element is the first in the range.
`last`	True if this element is the last in the range.
`value`	The contained value.

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

value_type const*
operator->() const noexcept;

Return Value

Pointer to this proxy.

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

bool const first;

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

bool const last;

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

Container::value_type const& value;

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

explicit
RangeFor(Container const& C) noexcept;

Parameters

Name	Description
C	Container to iterate.

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

iterator
begin() const noexcept;

Return Value

Iterator yielding RangeFor::value_type proxies with first/last flags.

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

iterator
end() const noexcept;

Return Value

Iterator yielding RangeFor::value_type proxies with first/last flags.

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordInterface.hpp>

class RecordInterface;

Description

This class represents the public, protected, and private interfaces of a record. It is used to generate the "interface" value of the DOM for symbols that represent records or namespaces.

The interface is not part of the Corpus. It is a temporary structure generated to aggregate the symbols of a record. This structure is provided to the user via the DOM.

While the members of a Namespace are directly represented with a Tranche, the members of a Record are represented with an Interface.

Data Members

Name	Description
`Private`	The aggregated private interfaces.
`Protected`	The aggregated protected interfaces.
`Public`	The aggregated public interfaces.

Non-Member Functions

Name	Description
`allMembers`	Flatten all public/protected/private members.

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordInterface.hpp>

RecordTranche Private;

Description

This tranche contains all private members of a record or namespace.

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordInterface.hpp>

RecordTranche Protected;

Description

This tranche contains all protected members of a record or namespace.

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordInterface.hpp>

RecordTranche Public;

Description

This tranche contains all public members of a record or namespace.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Record.hpp>

struct RecordSymbol final
    : SymbolCommonBase<SymbolKind::Record>

Base Classes

Name	Description
`SymbolCommonBase<SymbolKind::Record>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`RecordSymbol` [constructor]	Create a record symbol bound to an ID.
`operator<=>`	Compare records including bases, members, and flags.

Static Member Functions

Name
`isConcept`
`isEnum`
`isEnumConstant`
`isFunction`
`isGuide`
`isNamespace`
`isNamespaceAlias`
`isOverloads`
`isRecord`
`isTypedef`
`isUsing`
`isVariable`

Data Members

Name	Description
`Bases`	List of immediate bases.
`Derived`	List of derived classes
`Friends`	List of friends.
`Interface`	Lists of members.
`IsFinal`	Whether the class is marked `final`.
`IsFinalDestructor`	Whether the destructor is marked `final`.
`IsTypeDef`	Whether the record originated from a typedef-style declaration.
`KeyKind`	Kind of record this is (class, struct, or union).
`Template`	When present, this record is a template or specialization.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`allMembers`	View all record members across access levels.
`canMerge`	Check whether two symbols may be merged.
`getPrimaryLocation`	Determine a location to use when none is explicitly chosen.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Record.hpp>

explicit
RecordSymbol(SymbolID const& ID) noexcept;

Parameters

Name	Description
ID	The object to copy construct from

Synopsis

Declared in <mrdocs/Metadata/Symbol/Record.hpp>

std::strong_ordering
operator<=>(RecordSymbol const& other) const;

Return Value

The relative order of the objects

Parameters

Name	Description
other	The right operand

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isConcept() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnum() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnumConstant() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isGuide() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespace() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespaceAlias() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isOverloads() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isRecord() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isTypedef() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isUsing() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isVariable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Record.hpp>

std::vector<BaseInfo> Bases;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Record.hpp>

std::vector<SymbolID> Derived;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Record.hpp>

std::vector<FriendInfo> Friends;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Record.hpp>

RecordInterface Interface;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Record.hpp>

bool IsFinal = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Record.hpp>

bool IsFinalDestructor = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Record.hpp>

bool IsTypeDef = false;

Description

Things like anonymous structs in a typedef:


typedef struct { ... } foo_t;

are converted into records with the typedef as the Name + this flag set.

NOTE

Alias-declarations are not yet distinguished here.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Record.hpp>

RecordKeyKind KeyKind = RecordKeyKind::Struct;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Record.hpp>

Optional<TemplateInfo> Template;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr static
SymbolKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordTranche.hpp>

struct RecordTranche;

Description

This struct represents a collection of symbols that share the same access specifier within a record.

It includes one vector for each info type allowed in a record, and individual vectors for static functions, types, and function overloads.

Data Members

Name	Description
`Concepts`	Member concepts.
`Enums`	Enumerations.
`Functions`	Member functions.
`Guides`	Deduction guides in the class scope.
`NamespaceAliases`	Namespace aliases declared with this access.
`Records`	Nested records.
`StaticFunctions`	Static member functions.
`StaticVariables`	Static data members.
`Typedefs`	Typedefs and using aliases.
`Usings`	Using-declarations that pull members into the class.
`Variables`	Data members.

Non-Member Functions

Name	Description
`allMembers`	Join every member list into a single view.

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordTranche.hpp>

std::vector<SymbolID> Concepts;

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordTranche.hpp>

std::vector<SymbolID> Enums;

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordTranche.hpp>

std::vector<SymbolID> Functions;

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordTranche.hpp>

std::vector<SymbolID> Guides;

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordTranche.hpp>

std::vector<SymbolID> NamespaceAliases;

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordTranche.hpp>

std::vector<SymbolID> Records;

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordTranche.hpp>

std::vector<SymbolID> StaticFunctions;

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordTranche.hpp>

std::vector<SymbolID> StaticVariables;

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordTranche.hpp>

std::vector<SymbolID> Typedefs;

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordTranche.hpp>

std::vector<SymbolID> Usings;

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordTranche.hpp>

std::vector<SymbolID> Variables;

Synopsis

Declared in <mrdocs/Config/ReferenceDirectories.hpp>

struct ReferenceDirectories;

Description

These are the main reference directories used to resolve paths in the application.

All other reference directories come directly from the configuration file.

Data Members

Name	Description
`cwd`	Absolute path to the current working directory.
`mrdocsRoot`	Absolute path to the MrDocs repository root.

Synopsis

Declared in <mrdocs/Config/ReferenceDirectories.hpp>

std::string cwd;

Synopsis

Declared in <mrdocs/Config/ReferenceDirectories.hpp>

std::string mrdocsRoot;

Synopsis

Declared in <mrdocs/Support/ScopeExit.hpp>

template<class F>
class ScopeExit;

Member Functions

Name	Description
`ScopeExit` [constructor]	Construct with a callable to invoke on scope exit.
`~ScopeExit` [destructor]	Invoke the stored callable if the guard was not dismissed.
`dismiss`	Prevent the callable from running on destruction.

Synopsis

Declared in <mrdocs/Support/ScopeExit.hpp>

explicit
ScopeExit(F onExitScope);

Parameters

Name	Description
onExitScope	Callable executed unless dismissed.

Synopsis

Declared in <mrdocs/Support/ScopeExit.hpp>

~ScopeExit();

Synopsis

Declared in <mrdocs/Support/ScopeExit.hpp>

void
dismiss();

Synopsis

Declared in <mrdocs/Support/ScopeExit.hpp>

template<class T>
class ScopeExitRestore;

Member Functions

Name	Description
`ScopeExitRestore` [constructor]	Constructors
`~ScopeExitRestore` [destructor]	Restore the previous value unless dismissed.
`dismiss`	Prevent restoration on destruction.

Synopses

Declared in <mrdocs/Support/ScopeExit.hpp>

Restore ref to its previous value when the scope ends

explicit
ScopeExitRestore(T& ref);

» more...

Temporarily set ref to next and restore it when the scope ends

template<std::convertible_to<T> T2>
explicit
ScopeExitRestore(
    T& ref,
    T2 next);

» more...

Parameters

Name	Description
ref	The variable to modify and eventually restore.
next	The temporary value assigned to `ref` for the scope.

Synopsis

Declared in <mrdocs/Support/ScopeExit.hpp>

explicit
ScopeExitRestore(T& ref);

Description

Store the current value of ref and restore it when this object goes out of scope, unless dismiss() is called.

Parameters

Name	Description
ref	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/ScopeExit.hpp>

template<std::convertible_to<T> T2>
explicit
ScopeExitRestore(
    T& ref,
    T2 next);

Description

Store the current value of ref, set it to next, and restore the previous value when this object goes out of scope, unless dismiss() is called.

Parameters

Name	Description
ref	The variable to modify and eventually restore.
next	The temporary value assigned to `ref` for the scope.

Synopsis

Declared in <mrdocs/Support/ScopeExit.hpp>

~ScopeExitRestore();

Synopsis

Declared in <mrdocs/Support/ScopeExit.hpp>

void
dismiss();

Synopsis

Declared in <mrdocs/Metadata/Symbol/Source.hpp>

struct SourceInfo;

Member Functions

Name	Description
`SourceInfo` [constructor]	Construct with no locations.
`~SourceInfo` [destructor] [virtual]	Polymorphic base needs a virtual destructor.

Data Members

Name	Description
`DefLoc`	Location where the entity was defined
`Loc`	Locations where the entity was declared.

Non-Member Functions

Name	Description
`getPrimaryLocation`	Choose the best location to display for a symbol.
`merge`	Merge, transferring ownership from the right-hand side.
`merge`	Merge the location sets, preferring existing def/primary.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Source.hpp>

constexpr
SourceInfo() = default;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Source.hpp>

constexpr
virtual
~SourceInfo() = default;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Source.hpp>

Optional<Location> DefLoc;

Description

KRYSTIAN NOTE: this is used for entities which cannot be redeclared -- regardless of whether such a declaration is actually a definition (e.g. alias-declarations and typedef declarations are never definition).

Synopsis

Declared in <mrdocs/Metadata/Symbol/Source.hpp>

std::vector<Location> Loc;

Description

This does not include the definition.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

class SourceLocation;

Member Functions

Name	Description
`SourceLocation` [constructor]	Build a location wrapper from a `source_location`.
`column`	Column number (1-based) within the file.
`file_name`	File name associated with the location.
`function_name`	Function name captured at the location.
`line`	Line number (1-based) within the file.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

SourceLocation(std::source_location const& loc) noexcept;

Parameters

Name	Description
loc	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Error.hpp>

uint_least32_t
column() const noexcept;

Return Value

One-based column index.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

std::string_view
file_name() const noexcept;

Return Value

Path of the source file.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

std::string_view
function_name() const noexcept;

Return Value

Name of the function where the location was recorded.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

uint_least32_t
line() const noexcept;

Return Value

One-based line index.

Synopsis

Declared in <mrdocs/Metadata/Name/SpecializationName.hpp>

struct SpecializationName final
    : Name

Base Classes

Name	Description
`Name`	Represents a name for a named `Type`

Member Functions

Name	Description
`SpecializationName` [constructor]	Construct an empty specialization name.
`asName`	`asName` overloads
`operator==`	Equality compares all fields.
`operator<=>`	Three-way comparison operators

Data Members

Name	Description
`Identifier`	The unqualified name.
`Kind`	The kind of name this is.
`Prefix`	The parent name info, if any.
`TemplateArgs`	The template arguments.
`id`	The SymbolID of the named symbol, if it exists.
`specializationID`	The SymbolID of the named symbol, if it exists.

Non-Member Functions

Name	Description
`toString`	Convert the name to a human-readable string.

Synopsis

Declared in <mrdocs/Metadata/Name/SpecializationName.hpp>

constexpr
SpecializationName() noexcept;

Synopses

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

Compare specialization names by base name and template arguments.

auto
operator<=>(SpecializationName const& other) const;

» more...

Order names by kind, identifier, id, and prefix.

std::strong_ordering
operator<=>(Name const& other) const;

» more...

Synopsis

Declared in <mrdocs/Metadata/Name/SpecializationName.hpp>

auto
operator<=>(SpecializationName const& other) const;

Return Value

The relative order of the objects

Parameters

Name	Description
other	The right operand

Synopsis

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

std::strong_ordering
operator<=>(Name const& other) const;

Return Value

The relative order of the objects

Parameters

Name	Description
other	The right operand

Synopsis

Declared in <mrdocs/Metadata/Name/SpecializationName.hpp>

std::vector<Polymorphic<TArg>> TemplateArgs;

Synopsis

Declared in <mrdocs/Metadata/Name/SpecializationName.hpp>

SymbolID specializationID = = SymbolID::invalid;

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

struct SplitLinesView
    : std::ranges::view_interface<SplitLinesView>

Base Classes

Name	Description
`std::ranges::view_interface<SplitLinesView>`

Types

Name	Description
`Iterator`	Iterator over lines produced by SplitLinesView.

Member Functions

Name	Description
`SplitLinesView` [constructor]	Constructors
`back`
`begin`	Return an iterator to the first line.
`cbegin`
`cend`
`data`
`empty`
`end`	Return the end sentinel for the view.
`front`
`operator[]`	Subscript operators
`size`
`operator bool`	Conversion operators

Data Members

Name	Description
`sv_`	Underlying string to split.

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

struct Iterator;

Type Aliases

Name	Description
`difference_type`	Signed distance type for the iterator.
`value_type`	Line view type exposed by the iterator.

Member Functions

Name	Description
`Iterator` [constructor]	Constructors
`findBreak`	Compute the next line break position.
`operator*`	Return the current line segment.
`operator++`	Increment operators

Data Members

Name	Description
`atEnd`	Flag indicating the end iterator.
`cur`	Start of the current line.
`nextBreak`	Index of the next break delimiter or npos.
`sv`	Reference to the source string.

Friends

Name	Description
`mrdocs::operator==`	Equality operator

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

using difference_type = std::ptrdiff_t;

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

using value_type = std::string_view;

Synopses

Declared in <mrdocs/Support/SplitLines.hpp>

Construct an end iterator.

constexpr
Iterator() = default;

» more...

Construct a begin or end iterator.

constexpr
explicit
Iterator(
    std::string_view s,
    bool begin);

» more...

Parameters

Name	Description
s	Source string.
begin	If true, position at the first line; otherwise create end iterator.

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

constexpr
Iterator() = default;

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

constexpr
explicit
Iterator(
    std::string_view s,
    bool begin);

Parameters

Name	Description
s	Source string.
begin	If true, position at the first line; otherwise create end iterator.

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

constexpr
std::size_t
findBreak(std::size_t from) const noexcept;

Return Value

Offset of the next break or npos.

Parameters

Name	Description
from	Index to start searching.

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

constexpr
value_type
operator*() const noexcept;

Return Value

View of the current line.

Synopses

Declared in <mrdocs/Support/SplitLines.hpp>

Advance to the next line.

constexpr
Iterator&
operator++() noexcept;

» more...

Advance to the next line (post-increment).

constexpr
void
operator++(int unused);

» more...

Return Value

Reference to this iterator.

Parameters

Name	Description
unused	Dummy parameter for postfix form.

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

constexpr
Iterator&
operator++() noexcept;

Return Value

Reference to this iterator.

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

constexpr
void
operator++(int unused);

Parameters

Name	Description
unused	Dummy parameter for postfix form.

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

bool atEnd = false;

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

std::size_t cur = 0;

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

std::size_t nextBreak = 0;

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

std::string_view sv = {};

Synopses

Declared in <mrdocs/Support/SplitLines.hpp>

Construct an empty view.

constexpr
SplitLinesView() = default;

» more...

Construct a view over sv.

constexpr
explicit
SplitLinesView(std::string_view sv);

» more...

Parameters

Name	Description
sv	String to split into lines.

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

constexpr
SplitLinesView() = default;

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

constexpr
explicit
SplitLinesView(std::string_view sv);

Parameters

Name	Description
sv	String to split into lines.

Synopses

Declared in <bits/ranges_util.h>

constexpr
decltype(auto)
back()
requires bidirectional_range<_Derived> && common_range<_Derived>;

» more...

constexpr
decltype(auto)
back() const
requires bidirectional_range<const _Derived>
	&& common_range<const _Derived>;

» more...

Synopsis

Declared in <bits/ranges_util.h>

constexpr
decltype(auto)
back()
requires bidirectional_range<_Derived> && common_range<_Derived>;

Synopsis

Declared in <bits/ranges_util.h>

constexpr
decltype(auto)
back() const
requires bidirectional_range<const _Derived>
	&& common_range<const _Derived>;

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

constexpr
Iterator
begin() const noexcept;

Return Value

Iterator positioned at the first line.

Synopses

Declared in <bits/ranges_util.h>

constexpr
auto
cbegin()
requires input_range<_Derived>;

» more...

constexpr
auto
cbegin() const
requires input_range<const _Derived>;

» more...

Synopsis

Declared in <bits/ranges_util.h>

constexpr
auto
cbegin()
requires input_range<_Derived>;

Synopsis

Declared in <bits/ranges_util.h>

constexpr
auto
cbegin() const
requires input_range<const _Derived>;

Synopses

Declared in <bits/ranges_util.h>

constexpr
auto
cend()
requires input_range<_Derived>;

» more...

constexpr
auto
cend() const
requires input_range<const _Derived>;

» more...

Synopsis

Declared in <bits/ranges_util.h>

constexpr
auto
cend()
requires input_range<_Derived>;

Synopsis

Declared in <bits/ranges_util.h>

constexpr
auto
cend() const
requires input_range<const _Derived>;

Synopses

Declared in <bits/ranges_util.h>

constexpr
auto
data() noexcept(noexcept(ranges::begin(_M_derived())))
requires contiguous_iterator<iterator_t<_Derived>>;

» more...

constexpr
auto
data() const noexcept(noexcept(ranges::begin(_M_derived())))
requires range<const _Derived>
	&& contiguous_iterator<iterator_t<const _Derived>>;

» more...

Synopsis

Declared in <bits/ranges_util.h>

constexpr
auto
data() noexcept(noexcept(ranges::begin(_M_derived())))
requires contiguous_iterator<iterator_t<_Derived>>;

Synopsis

Declared in <bits/ranges_util.h>

constexpr
auto
data() const noexcept(noexcept(ranges::begin(_M_derived())))
requires range<const _Derived>
	&& contiguous_iterator<iterator_t<const _Derived>>;

Synopses

Declared in <bits/ranges_util.h>

constexpr
bool
empty() noexcept(noexcept(_S_empty(_M_derived())))
requires forward_range<_Derived> && (!sized_range<_Derived>);

» more...

constexpr
bool
empty() const noexcept(noexcept(_S_empty(_M_derived())))
requires forward_range<const _Derived> && (!sized_range<const _Derived>);

» more...

Synopsis

Declared in <bits/ranges_util.h>

constexpr
bool
empty() noexcept(noexcept(_S_empty(_M_derived())))
requires forward_range<_Derived> && (!sized_range<_Derived>);

Synopsis

Declared in <bits/ranges_util.h>

constexpr
bool
empty() const noexcept(noexcept(_S_empty(_M_derived())))
requires forward_range<const _Derived> && (!sized_range<const _Derived>);

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

constexpr
std::default_sentinel_t
end() const noexcept;

Return Value

Default sentinel representing the end.

Synopses

Declared in <bits/ranges_util.h>

constexpr
decltype(auto)
front()
requires forward_range<_Derived>;

» more...

constexpr
decltype(auto)
front() const
requires forward_range<const _Derived>;

» more...

Synopsis

Declared in <bits/ranges_util.h>

constexpr
decltype(auto)
front()
requires forward_range<_Derived>;

Synopsis

Declared in <bits/ranges_util.h>

constexpr
decltype(auto)
front() const
requires forward_range<const _Derived>;

Synopses

Declared in <bits/ranges_util.h>

template<random_access_range _Range = SplitLinesView>
constexpr
decltype(auto)
operator[](range_difference_t<_Range> __n);

» more...

template<random_access_range _Range = SplitLinesView const>
constexpr
decltype(auto)
operator[](range_difference_t<_Range> __n) const;

» more...

Synopsis

Declared in <bits/ranges_util.h>

template<random_access_range _Range = SplitLinesView>
constexpr
decltype(auto)
operator[](range_difference_t<_Range> __n);

Synopsis

Declared in <bits/ranges_util.h>

template<random_access_range _Range = SplitLinesView const>
constexpr
decltype(auto)
operator[](range_difference_t<_Range> __n) const;

Synopses

Declared in <bits/ranges_util.h>

constexpr
auto
size() noexcept(noexcept(_S_size(_M_derived())))
requires forward_range<_Derived>
	&& sized_sentinel_for<sentinel_t<_Derived>, iterator_t<_Derived>>;

» more...

constexpr
auto
size() const noexcept(noexcept(_S_size(_M_derived())))
requires forward_range<const _Derived>
	&& sized_sentinel_for<sentinel_t<const _Derived>,
			      iterator_t<const _Derived>>;

» more...

Synopsis

Declared in <bits/ranges_util.h>

constexpr
auto
size() noexcept(noexcept(_S_size(_M_derived())))
requires forward_range<_Derived>
	&& sized_sentinel_for<sentinel_t<_Derived>, iterator_t<_Derived>>;

Synopsis

Declared in <bits/ranges_util.h>

constexpr
auto
size() const noexcept(noexcept(_S_size(_M_derived())))
requires forward_range<const _Derived>
	&& sized_sentinel_for<sentinel_t<const _Derived>,
			      iterator_t<const _Derived>>;

Synopses

Declared in <bits/ranges_util.h>

Conversion to bool

constexpr
explicit
operator bool() noexcept(noexcept(ranges::empty(_M_derived())))
requires requires { ranges::empty(_M_derived()); };

» more...

Conversion to bool

constexpr
explicit
operator bool() const noexcept(noexcept(ranges::empty(_M_derived())))
requires requires { ranges::empty(_M_derived()); };

» more...

Synopsis

Declared in <bits/ranges_util.h>

constexpr
explicit
operator bool() noexcept(noexcept(ranges::empty(_M_derived())))
requires requires { ranges::empty(_M_derived()); };

Return Value

The object converted to bool

Synopsis

Declared in <bits/ranges_util.h>

constexpr
explicit
operator bool() const noexcept(noexcept(ranges::empty(_M_derived())))
requires requires { ranges::empty(_M_derived()); };

Return Value

The object converted to bool

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

std::string_view sv_;

Synopsis

Declared in <mrdocs/ADT/UnorderedStringMap.hpp>

struct StringHash;

Type Aliases

Name	Description
`hash_type`	Underlying hash implementation.
`is_transparent`	Marker for heterogeneous lookup.

Member Functions

Name	Description
`operator()`	Function call operators

Synopsis

Declared in <mrdocs/ADT/UnorderedStringMap.hpp>

using hash_type = std::hash<std::string_view>;

Synopsis

Declared in <mrdocs/ADT/UnorderedStringMap.hpp>

using is_transparent = void;

Synopses

Declared in <mrdocs/ADT/UnorderedStringMap.hpp>

Hash string_view input.

std::size_t
operator()(std::string_view str) const;

» more...

Hash std::string input.

std::size_t
operator()(std::string const& str) const;

» more...

Hash C-string input.

std::size_t
operator()(char const* str) const;

» more...

Return Value

Hash value of the string view.
Hash value of the string.

Synopsis

Declared in <mrdocs/ADT/UnorderedStringMap.hpp>

std::size_t
operator()(std::string_view str) const;

Return Value

Hash value of the string view.

Parameters

Name	Description
str	The right operand

Synopsis

Declared in <mrdocs/ADT/UnorderedStringMap.hpp>

std::size_t
operator()(std::string const& str) const;

Return Value

Hash value of the string.

Parameters

Name	Description
str	The right operand

Synopsis

Declared in <mrdocs/ADT/UnorderedStringMap.hpp>

std::size_t
operator()(char const* str) const;

Return Value

Hash value of the string.

Parameters

Name	Description
str	The right operand

Synopsis

Declared in <mrdocs/Support/StringList.hpp>

struct StringList;

Description

A configuration option of this type can be written as a single scalar (generator: xml), a YAML sequence (generator: [xml, adoc]), or a comma-separated scalar (generator: "xml,adoc"). All three forms normalize to the same list of strings.

The type models a range of std::string, so generic configuration code (normalization, DOM exposure) treats it like any other list of strings.

Member Functions

Name	Description
`StringList` [constructor]	Constructors
`begin`	`begin` overloads
`empty`	Return `true` if the list has no strings.
`end`	`end` overloads
`size`	Return the number of strings.
`splitCommaSeparated`	Expand comma-separated entries in place.

Data Members

Name	Description
`values`	The individual strings, in order.

Synopses

Declared in <mrdocs/Support/StringList.hpp>

Construct an empty list.

constexpr
StringList() = default;

» more...

Construct from a braced list of strings.

StringList(std::initializer_list<std::string> il);

» more...

Construct from a vector of strings.

StringList(std::vector<std::string> v);

» more...

Parameters

Name	Description
il	The strings to store.
v	The strings to store.

Synopsis

Declared in <mrdocs/Support/StringList.hpp>

constexpr
StringList() = default;

Synopsis

Declared in <mrdocs/Support/StringList.hpp>

StringList(std::initializer_list<std::string> il);

Parameters

Name	Description
il	The strings to store.

Synopsis

Declared in <mrdocs/Support/StringList.hpp>

StringList(std::vector<std::string> v);

Parameters

Name	Description
v	The strings to store.

Synopses

Declared in <mrdocs/Support/StringList.hpp>

Return an iterator to the first string.

auto
begin();

» more...

Return a const iterator to the first string.

auto
begin() const;

» more...

Synopsis

Declared in <mrdocs/Support/StringList.hpp>

auto
begin();

Return Value

an iterator to the first string.

Synopsis

Declared in <mrdocs/Support/StringList.hpp>

auto
begin() const;

Return Value

a const iterator to the first string.

Synopsis

Declared in <mrdocs/Support/StringList.hpp>

bool
empty() const noexcept;

Return Value

true if the list has no strings.

Synopses

Declared in <mrdocs/Support/StringList.hpp>

Return an iterator past the last string.

auto
end();

» more...

Return a const iterator past the last string.

auto
end() const;

» more...

Synopsis

Declared in <mrdocs/Support/StringList.hpp>

auto
end();

Return Value

an iterator past the last string.

Synopsis

Declared in <mrdocs/Support/StringList.hpp>

auto
end() const;

Return Value

a const iterator past the last string.

Synopsis

Declared in <mrdocs/Support/StringList.hpp>

std::size_t
size() const noexcept;

Return Value

the number of strings.

Synopsis

Declared in <mrdocs/Support/StringList.hpp>

void
splitCommaSeparated();

Description

Each element is split on commas, surrounding whitespace is trimmed, and empty tokens are dropped. This lets a single element such as "xml,adoc" become two entries.

Synopsis

Declared in <mrdocs/Support/StringList.hpp>

std::vector<std::string> values;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

struct Symbol;

Member Functions

Name	Description
`~Symbol` [destructor] [virtual]	Polymorphic base needs a virtual destructor.
`asInfo`	`asInfo` overloads

Data Members

Name	Description
`Access`	Declaration access.
`Extraction`	Determine why a symbol is extracted.
`IsCopyFromInherited`	Whether this a copy of an inherited method, as produced when `inherit-base-members` is not `never`.
`Kind`	Kind of declaration.
`Loc`	The source location information.
`Name`	The unqualified name.
`Parent`	The parent symbol, if any.
`doc`	The extracted documentation for this declaration.
`id`	The unique identifier for this symbol.

Protected Member Functions

Name	Description
`Symbol` [constructor]	Constructors

Non-Member Functions

Name	Description
`canMerge`	Check whether two symbols may be merged.
`getPrimaryLocation`	Determine a location to use when none is explicitly chosen.

Derived Classes

Name	Description
`SymbolCommonBase`	Base class for providing variant discriminator functions.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr
virtual
~Symbol() = default;

Synopses

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

View this instance as a const Symbol reference.

constexpr
Symbol const&
asInfo() const noexcept;

» more...

View this instance as a mutable Symbol reference.

constexpr
Symbol&
asInfo() noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr
Symbol const&
asInfo() const noexcept;

Return Value

Base class with common properties of all symbols

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr
Symbol&
asInfo() noexcept;

Return Value

Base class with common properties of all symbols

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

AccessKind Access = AccessKind::None;

Description

Class members use:

AccessKind::Public,
AccessKind::Protected, and
AccessKind::Private.

Namespace members use AccessKind::None.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

ExtractionMode Extraction = ExtractionMode::Dependency;

Description

This flag distinguishes Info from its dependencies and indicates why it was extracted.

Non-dependencies can be extracted in normal mode, see-below mode, or implementation-defined mode.

A dependency is a symbol that does not meet the configured conditions for extraction, but had to be extracted due to it being used transitively by a primary Info.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

bool IsCopyFromInherited = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

SymbolKind Kind = SymbolKind::None;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

SourceInfo Loc;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

std::string Name;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

SymbolID Parent;

Description

This is the parent namespace or record where the symbol is defined.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

Optional<DocComment> doc;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

SymbolID id;

Synopses

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

Default constructor for derived types.

constexpr
Symbol() = default;

» more...

Copy constructor.

constexpr
Symbol(Symbol const& Other) = default;

» more...

Move constructor.

constexpr
Symbol(Symbol&& Other) = default;

» more...

Construct a Symbol.

explicit
Symbol(
    SymbolKind const kind,
    SymbolID const& ID) noexcept;

» more...

Parameters

Name	Description
kind	The kind of symbol
ID	The unique identifier for this symbol

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr
Symbol() = default;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr
Symbol(Symbol const& Other) = default;

Parameters

Name	Description
Other	The object to copy construct from

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr
Symbol(Symbol&& Other) = default;

Parameters

Name	Description
Other	The object to move construct from

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

explicit
Symbol(
    SymbolKind const kind,
    SymbolID const& ID) noexcept;

Parameters

Name	Description
kind	The kind of symbol
ID	The unique identifier for this symbol

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

template<SymbolKind K>
struct SymbolCommonBase
    : Symbol

Description

This offers functions that return a boolean at compile-time, indicating if the most-derived class is a certain type.

Base Classes

Name	Description
`Symbol`	Base class with common properties of all symbols

Member Functions

Name	Description
`asInfo`	`asInfo` overloads

Data Members

Name	Description
`Access`	Declaration access.
`Extraction`	Determine why a symbol is extracted.
`IsCopyFromInherited`	Whether this a copy of an inherited method, as produced when `inherit-base-members` is not `never`.
`Kind`	Kind of declaration.
`Loc`	The source location information.
`Name`	The unqualified name.
`Parent`	The parent symbol, if any.
`doc`	The extracted documentation for this declaration.
`id`	The unique identifier for this symbol.

Static Data Members

Name	Description
`kind_id`	The variant discriminator constant of the most-derived class.

Protected Member Functions

Name	Description
`SymbolCommonBase` [constructor]	Constructors

Friends

Name	Description
`mrdocs::mrdocs_member_descriptor_fn`
`mrdocs::mrdocs_base_descriptor_fn`

Non-Member Functions

Name	Description
`canMerge`	Check whether two symbols may be merged.
`getPrimaryLocation`	Determine a location to use when none is explicitly chosen.

Derived Classes

Name	Description
`ConceptSymbol`	Info for concepts.
`EnumConstantSymbol`	Info for enum constants.
`EnumSymbol`	Metadata for an enumeration declaration.
`FunctionSymbol`	Metadata for a function or method.
`GuideSymbol`	Info for deduction guides.
`NamespaceAliasSymbol`	Info for namespace aliases.
`NamespaceSymbol`	Describes a namespace and its members.
`OverloadsSymbol`	Represents a set of function overloads.
`RecordSymbol`	Metadata for struct, class, or union.
`TypedefSymbol`	Info for typedef and using declarations.
`UsingSymbol`	Info for using declarations.
`VariableSymbol`	A variable.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

inline constexpr static
SymbolKind kind_id = K;

Description

It only distinguishes from Symbol::kind in that it is a constant.

Synopses

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

Default constructor.

SymbolCommonBase() = default;

» more...

Construct bound to an ID.

constexpr
explicit
SymbolCommonBase(SymbolID const& ID);

» more...

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

SymbolCommonBase() = default;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr
explicit
SymbolCommonBase(SymbolID const& ID);

Parameters

Name	Description
ID	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

class SymbolGlobPattern;

Description

A glob pattern matcher where "*" does not match "::". The pattern "**" can be used to match any number of "::".

Member Functions

Name	Description
`SymbolGlobPattern` [constructor]	Construct an empty SymbolGlobPattern.
`isLiteral`	Checks if the glob pattern is a literal string.
`match`	Matches the given string against the glob pattern.
`matchPatternPrefix`	Matches the start of a given string against the glob pattern.
`pattern`	Returns the glob pattern.

Static Member Functions

Name	Description
`create`	Constructs a SymbolGlobPattern with the given pattern.

Synopses

Declared in <mrdocs/Support/Glob.hpp>

Construct an empty SymbolGlobPattern.

constexpr
SymbolGlobPattern() = default;

» more...

Construct an empty SymbolGlobPattern.

explicit
SymbolGlobPattern(GlobPattern glob);

» more...

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

constexpr
SymbolGlobPattern() = default;

Description

An empty SymbolGlobPattern will never match any string.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

explicit
SymbolGlobPattern(GlobPattern glob);

Description

An empty SymbolGlobPattern will never match any string.

Parameters

Name	Description
glob	The object to construct from

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

bool
isLiteral() const;

Description

This function determines if the glob pattern does not contain any special characters. In other words, it matches a single string.

Return Value

true if the glob pattern is a literal string, false otherwise.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

bool
match(std::string_view const str) const;

Return Value

true if the string matches the pattern, false otherwise.

Parameters

Name	Description
str	The string to match against the pattern.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

bool
matchPatternPrefix(std::string_view prefix) const;

Description

This function determines if the given string with the specified prefix can potentially match the glob pattern.

If the string matches the start of the pattern without failure, even if there are characters left in the string or the pattern, the function returns true.

Return Value

true if the string prefix matches the pattern, false otherwise.

Parameters

Name	Description
prefix	The string to match against the pattern.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

std::string_view
pattern() const;

Return Value

The glob pattern as a string view.

Synopses

Declared in <mrdocs/Support/Glob.hpp>

Constructs a SymbolGlobPattern with the given pattern.

static
Expected<SymbolGlobPattern>
create(std::string_view const pattern);

» more...

Constructs a SymbolGlobPattern with the given pattern.

static
Expected<SymbolGlobPattern>
create(
    std::string_view const pattern,
    Optional<std::size_t> maxSubGlobs);

» more...

Parameters

Name	Description
pattern	The glob pattern to use for matching.
maxSubGlobs	The maximum number of subpatterns allowed.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

static
Expected<SymbolGlobPattern>
create(std::string_view const pattern);

Return Value

A container holding an error or a value.

Parameters

Name	Description
pattern	The glob pattern to use for matching.

Synopsis

Declared in <mrdocs/Support/Glob.hpp>

static
Expected<SymbolGlobPattern>
create(
    std::string_view const pattern,
    Optional<std::size_t> maxSubGlobs);

Return Value

A container holding an error or a value.

Parameters

Name	Description
pattern	The glob pattern to use for matching.
maxSubGlobs	The maximum number of subpatterns allowed.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

class SymbolID;

Description

This is calculated as the SHA1 digest of the USR. A USRs is a string that provides an unambiguous reference to a symbol.

Type Aliases

Name	Description
`value_type`	Underlying byte storage.

Member Functions

Name	Description
`SymbolID` [constructor]	Constructors
`begin`	Return an iterator to the first byte of the SymbolID.
`data`	Return the raw data for this SymbolID.
`end`	Return an iterator to one past the last byte of the SymbolID.
`size`	Return the size of the SymbolID.
`operator std::string_view`	Return a string view of the SymbolID.
`operator bool`	Return true if this is a valid SymbolID.
`operator==`	Compare two SymbolIDs for equality.
`operator<=>`	Compare two SymbolIDs with strong ordering.

Static Member Functions

Name	Description
`createFromString`	Construct a SymbolID by hashing a string

Static Data Members

Name	Description
`global`	Sentinel ID representing the global namespace.
`invalid`	Sentinel ID used to represent “no symbol.”

Non-Member Functions

Name	Description
`getParents`	Return a list of the parent symbols of the specified Symbol.
`toBase16Str`	Convert a SymbolID to a string

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

using value_type = uint8_t;

Synopses

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

Construct a zero-initialized identifier.

constexpr
SymbolID() = default;

» more...

Construct a SymbolID from a null-terminated string.

template<std::convertible_to<value_type> Char>
constexpr
SymbolID(Char const* src);

» more...

Parameters

Name	Description
src	The string to construct from.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

constexpr
SymbolID() = default;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

template<std::convertible_to<value_type> Char>
constexpr
SymbolID(Char const* src);

Description

This function constructs a SymbolID from a string. The string must be exactly 20 characters long.

Parameters

Name	Description
src	The string to construct from.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

constexpr
auto
begin() const noexcept;

Return Value

an iterator to the first byte of the SymbolID.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

constexpr
auto
data() const noexcept;

Return Value

the raw data for this SymbolID.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

constexpr
auto
end() const noexcept;

Return Value

an iterator to one past the last byte of the SymbolID.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

constexpr
std::size_t
size() const noexcept;

Description

constexpr
bool
operator==(SymbolID const& other) const noexcept = default;

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
other	The right operand

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

auto
operator<=>(SymbolID const& other) const noexcept;

Return Value

The relative order of the objects

Parameters

Name	Description
other	The right operand

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

static
SymbolID
createFromString(std::string_view input);

Return Value

The SymbolID created by hashing the string.

Parameters

Name	Description
input	The string to hash.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

inline constexpr static
SymbolID global = "\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF"
    "\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF";

Description

Symbol ID of the global namespace.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

inline constexpr static
SymbolID invalid = SymbolID();

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

struct TArg;

Member Functions

Name	Description
`~TArg` [destructor] [virtual]	Polymorphic base needs a virtual destructor.
`asTArg`	`asTArg` overloads

Data Members

Name	Description
`IsPackExpansion`	Whether this template argument is a parameter expansion.
`Kind`	The kind of template argument this is.

Protected Member Functions

Name	Description
`TArg` [constructor]	Constructors

Non-Member Functions

Name	Description
`toString`	Convert a template argument to a human-readable string.

Derived Classes

Name	Description
`TArgCommonBase`	CRTP base that fixes the argument kind.

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr
virtual
~TArg() = default;

Synopses

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

View this object as a TArg reference.

constexpr
TArg const&
asTArg() const noexcept;

» more...

View this object as a mutable TArg reference.

constexpr
TArg&
asTArg() noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr
TArg const&
asTArg() const noexcept;

Return Value

Base class for any template argument.

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr
TArg&
asTArg() noexcept;

Return Value

Base class for any template argument.

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

bool IsPackExpansion = false;

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

TArgKind Kind = TArgKind::Type;

Synopses

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

Defaulted base constructor.

constexpr
TArg() noexcept = default;

» more...

Construct with a specific argument kind.

constexpr
TArg(TArgKind kind) noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr
TArg() noexcept = default;

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr
TArg(TArgKind kind) noexcept;

Parameters

Name	Description
kind	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

template<TArgKind K>
struct TArgCommonBase
    : TArg

Base Classes

Name	Description
`TArg`	Base class for any template argument.

Member Functions

Name	Description
`asTArg`	`asTArg` overloads

Static Member Functions

Name	Description
`isConstant`	Test whether the kind is a non-type constant argument.
`isTemplate`	Test whether the kind is a template argument.
`isType`	Test whether the kind is a type argument.

Data Members

Name	Description
`IsPackExpansion`	Whether this template argument is a parameter expansion.
`Kind`	The kind of template argument this is.

Static Data Members

Name	Description
`kind_id`	Static discriminator for the concrete argument.

Protected Member Functions

Name	Description
`TArgCommonBase` [constructor]	Construct with the fixed kind.

Friends

Name	Description
`mrdocs::mrdocs_member_descriptor_fn`
`mrdocs::mrdocs_base_descriptor_fn`

Non-Member Functions

Name	Description
`toString`	Convert a template argument to a human-readable string.

Derived Classes

Name	Description
`ConstantTArg`	Non-type template argument.
`TemplateTArg`	Template template argument.
`TypeTArg`	Type template argument.

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr
static
bool
isConstant() noexcept;

Return Value

true if kind_id equals TypeKind::Constant.

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr
static
bool
isTemplate() noexcept;

Return Value

true if kind_id equals TypeKind::Template.

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr
static
bool
isType() noexcept;

Return Value

true if kind_id equals TypeKind::Type.

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

inline constexpr static
TArgKind kind_id = K;

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr
TArgCommonBase() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

struct TParam;

Member Functions

Name	Description
`~TParam` [destructor] [virtual]	Polymorphic base needs a virtual destructor.
`asTParam`	`asTParam` overloads

Data Members

Name	Description
`Default`	The default template argument, if any
`IsParameterPack`	Whether this template parameter is a parameter pack
`Kind`	The kind of template parameter this is
`Name`	The template parameters name, if any

Protected Member Functions

Name	Description
`TParam` [constructor]	Constructors

Derived Classes

Name	Description
`TParamCommonBase`	CRTP base that fixes the parameter kind.

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr
virtual
~TParam() = default;

Synopses

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

View this object as a TParam reference.

constexpr
TParam const&
asTParam() const noexcept;

» more...

View this object as a mutable TParam reference.

constexpr
TParam&
asTParam() noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr
TParam const&
asTParam() const noexcept;

Return Value

Base class for a template parameter declaration.

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr
TParam&
asTParam() noexcept;

Return Value

Base class for a template parameter declaration.

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

Optional<Polymorphic<TArg>> Default = std::nullopt;

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

bool IsParameterPack = false;

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

TParamKind Kind = TParamKind::Type;

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

std::string Name;

Synopses

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

Defaulted base constructor.

constexpr
TParam() noexcept = default;

» more...

Construct with a fixed parameter kind.

constexpr
TParam(TParamKind kind) noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr
TParam() noexcept = default;

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr
TParam(TParamKind kind) noexcept;

Parameters

Name	Description
kind	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

template<TParamKind K>
struct TParamCommonBase
    : TParam

Base Classes

Name	Description
`TParam`	Base class for a template parameter declaration.

Member Functions

Name	Description
`asTParam`	`asTParam` overloads

Static Member Functions

Name	Description
`isConstant`	True if the parameter is a non-type parameter.
`isTemplate`	True if the parameter is a template template parameter.
`isType`	True if the parameter is a type parameter.

Data Members

Name	Description
`Default`	The default template argument, if any
`IsParameterPack`	Whether this template parameter is a parameter pack
`Kind`	The kind of template parameter this is
`Name`	The template parameters name, if any

Static Data Members

Name	Description
`kind_id`	Static discriminator for the concrete parameter.

Protected Member Functions

Name	Description
`TParamCommonBase` [constructor]	Construct with the fixed kind.

Friends

Name	Description
`mrdocs::mrdocs_member_descriptor_fn`
`mrdocs::mrdocs_base_descriptor_fn`

Derived Classes

Name	Description
`ConstantTParam`	A constant template parameter
`TemplateTParam`	Template template parameter.
`TypeTParam`	Type template parameter.

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr
static
bool
isConstant() noexcept;

Return Value

true when kind_id equals TParamKind::Constant.

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr
static
bool
isTemplate() noexcept;

Return Value

true when kind_id equals TParamKind::Template.

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr
static
bool
isType() noexcept;

Return Value

true when kind_id equals TParamKind::Type.

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

inline constexpr static
TParamKind kind_id = K;

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr
TParamCommonBase() noexcept;

Synopsis

Declared in <mrdocs/Support/ThreadPool.hpp>

class TaskGroup;

Member Functions

Name	Description
`TaskGroup` [constructor]	Constructor.
`~TaskGroup` [destructor]	Destructor.
`async`	Submit work to be executed.
`wait`	Block until all work has completed.

Synopsis

Declared in <mrdocs/Support/ThreadPool.hpp>

explicit
TaskGroup(ThreadPool& threadPool);

Parameters

Name	Description
threadPool	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/ThreadPool.hpp>

~TaskGroup();

Synopsis

Declared in <mrdocs/Support/ThreadPool.hpp>

template<class F>
void
async(F&& f);

Description

The signature of the submitted function object should be void(void).

Parameters

Name	Description
f	The function object to execute.

Synopsis

Declared in <mrdocs/Support/ThreadPool.hpp>

[[nodiscard]]
std::vector<Error>
wait();

Return Value

Zero or more errors which were thrown from submitted work.

Synopsis

Declared in <mrdocs/Metadata/Template.hpp>

struct TemplateInfo final

Member Functions

Name	Description
`specializationKind`	Deduce which specialization category this info represents.

Data Members

Name	Description
`Args`	Bound arguments for specializations.
`Params`	Template parameter list.
`Primary`	Primary template ID for partial and explicit specializations.
`Requires`	The requires-clause for the template parameter list, if any.

Non-Member Functions

Name	Description
`merge`	Merge partial template info, filling missing pieces.

Synopsis

Declared in <mrdocs/Metadata/Template.hpp>

TemplateSpecKind
specializationKind() const noexcept;

Return Value

The kind of template or specialization.

Synopsis

Declared in <mrdocs/Metadata/Template.hpp>

std::vector<Polymorphic<TArg>> Args;

Synopsis

Declared in <mrdocs/Metadata/Template.hpp>

std::vector<Polymorphic<TParam>> Params;

Synopsis

Declared in <mrdocs/Metadata/Template.hpp>

SymbolID Primary = = SymbolID::invalid;

Synopsis

Declared in <mrdocs/Metadata/Template.hpp>

ExprInfo Requires;

Synopsis

Declared in <mrdocs/Metadata/TArg/TemplateTArg.hpp>

struct TemplateTArg final
    : TArgCommonBase<TArgKind::Template>

Base Classes

Name	Description
`TArgCommonBase<TArgKind::Template>`	CRTP base that fixes the argument kind.

Static Member Functions

Name
`isConstant`
`isTemplate`
`isType`

Data Members

Name	Description
`Name`	Name of the referenced template.
`Template`	SymbolID of the referenced template.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`toString`	Convert a template argument to a human-readable string.

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr
static
bool
isConstant() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr
static
bool
isTemplate() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr
static
bool
isType() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TArg/TemplateTArg.hpp>

std::string Name;

Synopsis

Declared in <mrdocs/Metadata/TArg/TemplateTArg.hpp>

SymbolID Template;

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr static
TArgKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/TParam/TemplateTParam.hpp>

struct TemplateTParam final
    : TParamCommonBase<TParamKind::Template>

Base Classes

Name	Description
`TParamCommonBase<TParamKind::Template>`	CRTP base that fixes the parameter kind.

Static Member Functions

Name
`isConstant`
`isTemplate`
`isType`

Data Members

Name	Description
`Params`	Template parameters for the template-template parameter

Static Data Members

Name
`kind_id`

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr
static
bool
isConstant() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr
static
bool
isTemplate() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr
static
bool
isType() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TParam/TemplateTParam.hpp>

std::vector<Polymorphic<TParam>> Params;

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr static
TParamKind kind_id;

Synopsis

Declared in <mrdocs/Support/ThreadPool.hpp>

class ThreadPool;

Types

Name	Description
`arg_ty`	Helper that preserves lvalue-ref and constness for references.
`arg_ty<T&>`	Alias returning the preserved argument type.

Type Aliases

Name	Description
`arg_t`	Helper that forwards argument qualifiers.

Member Functions

Name	Description
`ThreadPool` [constructor]	Constructor.
`~ThreadPool` [destructor]	Destructor.
`async`	Submit work to be executed.
`forEach`	Invoke a function object for each element of a range.
`getThreadCount`	Return the number of threads in the pool.
`wait`	Block until all work has completed.

Friends

Name	Description
`mrdocs::TaskGroup`	A subset of possible work in a thread pool.

Synopsis

Declared in <mrdocs/Support/ThreadPool.hpp>

template<class T>
using arg_t = arg_ty<T>::type;

Synopsis

Declared in <mrdocs/Support/ThreadPool.hpp>

template<class T>
struct arg_ty;

Type Aliases

Name	Description
`type`	Resulting adjusted type.

Synopsis

Declared in <mrdocs/Support/ThreadPool.hpp>

using type = T;

Synopsis

Declared in <mrdocs/Support/ThreadPool.hpp>

template<class T>
struct arg_ty<T&>;

Type Aliases

Name	Description
`type`	Resulting adjusted type.

Return Value

Argument type with reference/const qualifiers preserved.

Template Parameters

Name	Description
T	Original argument type.

Synopsis

Declared in <mrdocs/Support/ThreadPool.hpp>

using type = std::conditional_t<std::is_const_v<T>, T, T&>;

Synopses

Declared in <mrdocs/Support/ThreadPool.hpp>

Constructor.

explicit
ThreadPool();

» more...

Constructor.

explicit
ThreadPool(unsigned int concurrency);

» more...

Synopsis

Declared in <mrdocs/Support/ThreadPool.hpp>

explicit
ThreadPool();

Description

Default constructed thread pools have concurrency equal to one and never spawn new threads. Submitted work blocks the caller until the work is complete.

Synopsis

Declared in <mrdocs/Support/ThreadPool.hpp>

explicit
ThreadPool(unsigned int concurrency);

Parameters

Name	Description
concurrency	The value to construct from

Synopsis

Declared in <mrdocs/Support/ThreadPool.hpp>

~ThreadPool();

Synopsis

Declared in <mrdocs/Support/ThreadPool.hpp>

template<class F>
void
async(F&& f);

Description

The signature of the submitted function object should be void(void).

Parameters

Name	Description
f	The function object to execute.

Synopsis

Declared in <mrdocs/Support/ThreadPool.hpp>

template<
    class Range,
    class F>
[[nodiscard]]
std::vector<Error>
forEach(
    Range&& range,
    F const& f);

Return Value

Zero or more errors which were thrown from submitted work.

Parameters

Name	Description
range	The range of elements to process.
f	The function object to invoke.

Synopsis

Declared in <mrdocs/Support/ThreadPool.hpp>

unsigned int
getThreadCount() const noexcept;

Return Value

the number of threads in the pool.

Synopsis

Declared in <mrdocs/Support/ThreadPool.hpp>

void
wait();

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

struct Type;

Description

This class represents a type that may have qualifiers (e.g. const, volatile).

This base class is used to store the kind of type. Derived classes are used to store the type information according to the kind.

Member Functions

Name	Description
`asType`	`asType` overloads
`namedSymbol`	Return the symbol named by this type.

Data Members

Name	Description
`Constraints`	The constraints associated with the type
`IsConst`	The const qualifier
`IsPackExpansion`	Whether this is the pattern of a pack expansion.
`IsVolatile`	The volatile qualifier
`Kind`	The kind of Type this is

Protected Member Functions

Name	Description
`Type` [constructor]	Construct with a concrete type kind.
`~Type` [destructor] [virtual]	Virtual destructor for polymorphic base.

Non-Member Functions

Name	Description
`innerType`	Return the inner type.
`innerType`	Return the inner type.
`innerTypePtr`	Return the inner type.
`innerTypePtr`	Return the inner type.
`toString`	Render a type to a human-readable string.

Derived Classes

Name	Description
`TypeCommonBase`	CRTP base that ties a concrete type to a fixed TypeKind.

Synopses

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

View as const Type.

constexpr
Type const&
asType() const noexcept;

» more...

View as mutable Type.

constexpr
Type&
asType() noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
Type const&
asType() const noexcept;

Return Value

A possibly qualified type.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
Type&
asType() noexcept;

Return Value

A possibly qualified type.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

SymbolID
namedSymbol() const noexcept;

Return Value

the symbol named by this type.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

std::vector<ExprInfo> Constraints;

Description

This represents the constraints associated with the type, such as SFINAE constraints.

For instance, if SFINAE detection is enabled, the expression std::enable_if_t<std::is_integral_v<T>, T> will have type T (NamedType) and constraints {std::is_integral_v<T>}.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

bool IsConst = false;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

bool IsPackExpansion = false;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

bool IsVolatile = false;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

TypeKind Kind;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
Type(TypeKind kind) noexcept;

Parameters

Name	Description
kind	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
virtual
~Type() = default;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

template<TypeKind K>
struct TypeCommonBase
    : Type

Base Classes

Name	Description
`Type`	A possibly qualified type.

Member Functions

Name	Description
`asType`	`asType` overloads
`namedSymbol`	Return the symbol named by this type.

Static Member Functions

Name	Description
`isArray`	True when this is an array type.
`isAuto`	True when this concrete kind is auto.
`isDecltype`	True when this concrete kind is decltype.
`isFunction`	True when this is a function type.
`isLValueReference`	True when this is an lvalue reference.
`isMemberPointer`	True when this is a member pointer.
`isNamed`	True when this concrete kind is a named type.
`isPointer`	True when this is a pointer type.
`isRValueReference`	True when this is an rvalue reference.

Data Members

Name	Description
`Constraints`	The constraints associated with the type
`IsConst`	The const qualifier
`IsPackExpansion`	Whether this is the pattern of a pack expansion.
`IsVolatile`	The volatile qualifier
`Kind`	The kind of Type this is

Static Data Members

Name	Description
`kind_id`	Static discriminator for the concrete type.

Protected Member Functions

Name	Description
`TypeCommonBase` [constructor]	Construct the base with the fixed kind.

Friends

Name	Description
`mrdocs::mrdocs_member_descriptor_fn`
`mrdocs::mrdocs_base_descriptor_fn`

Non-Member Functions

Name	Description
`innerType`	Return the inner type.
`innerType`	Return the inner type.
`innerTypePtr`	Return the inner type.
`innerTypePtr`	Return the inner type.
`toString`	Render a type to a human-readable string.

Derived Classes

Name	Description
`ArrayType`	C++ array type (bounded or unbounded).
`AutoType`	Represents `auto` or `decltype(auto)` placeholder type.
`DecltypeType`	`decltype(expr)` type wrapper.
`FunctionType`	Function type with parameters, qualifiers, and noexcept info.
`LValueReferenceType`	An lvalue reference type.
`MemberPointerType`	Pointer-to-member type (object or function).
`NamedType`	A type identified by name (possibly fundamental).
`PointerType`	Pointer type wrapper.
`RValueReferenceType`	An rvalue reference type.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isArray() noexcept;

Return Value

true if kind_id is TypeKind::Array.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isAuto() noexcept;

Return Value

true if kind_id is TypeKind::Auto.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isDecltype() noexcept;

Return Value

true if kind_id is TypeKind::Decltype.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isFunction() noexcept;

Return Value

true if kind_id is TypeKind::Function.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isLValueReference() noexcept;

Return Value

true if kind_id is TypeKind::LValueReference.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isMemberPointer() noexcept;

Return Value

true if kind_id is TypeKind::MemberPointer.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isNamed() noexcept;

Return Value

true if kind_id is TypeKind::Named.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isPointer() noexcept;

Return Value

true if kind_id is TypeKind::Pointer.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
static
bool
isRValueReference() noexcept;

Return Value

true if kind_id is TypeKind::RValueReference.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

inline constexpr static
TypeKind kind_id = K;

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

constexpr
TypeCommonBase() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TArg/TypeTArg.hpp>

struct TypeTArg final
    : TArgCommonBase<TArgKind::Type>

Base Classes

Name	Description
`TArgCommonBase<TArgKind::Type>`	CRTP base that fixes the argument kind.

Static Member Functions

Name
`isConstant`
`isTemplate`
`isType`

Data Members

Name	Description
`Type`	Template argument type.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`toString`	Convert a template argument to a human-readable string.

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr
static
bool
isConstant() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr
static
bool
isTemplate() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr
static
bool
isType() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TArg/TypeTArg.hpp>

Polymorphic<Type> Type = Polymorphic<struct Type>(AutoType{});

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

constexpr static
TArgKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/TParam/TypeTParam.hpp>

struct TypeTParam final
    : TParamCommonBase<TParamKind::Type>

Base Classes

Name	Description
`TParamCommonBase<TParamKind::Type>`	CRTP base that fixes the parameter kind.

Static Member Functions

Name
`isConstant`
`isTemplate`
`isType`

Data Members

Name	Description
`Constraint`	The type-constraint for the parameter, if any.
`KeyKind`	Keyword (class/typename) the parameter uses

Static Data Members

Name
`kind_id`

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr
static
bool
isConstant() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr
static
bool
isTemplate() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr
static
bool
isType() noexcept;

Synopsis

Declared in <mrdocs/Metadata/TParam/TypeTParam.hpp>

Optional<Polymorphic<Name>> Constraint = std::nullopt;

Synopsis

Declared in <mrdocs/Metadata/TParam/TypeTParam.hpp>

TParamKeyKind KeyKind = TParamKeyKind::Class;

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

constexpr static
TParamKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Typedef.hpp>

struct TypedefSymbol final
    : SymbolCommonBase<SymbolKind::Typedef>

Base Classes

Name	Description
`SymbolCommonBase<SymbolKind::Typedef>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`TypedefSymbol` [constructor]	Create a typedef symbol bound to an ID.
`operator<=>`	Compare typedef symbols, including alias target and template.

Static Member Functions

Name
`isConcept`
`isEnum`
`isEnumConstant`
`isFunction`
`isGuide`
`isNamespace`
`isNamespaceAlias`
`isOverloads`
`isRecord`
`isTypedef`
`isUsing`
`isVariable`

Data Members

Name	Description
`IsUsing`	Indicates if this is a new C++ "using"-style typedef
`Template`	Template information when the alias is templated.
`Type`	The aliased type.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`canMerge`	Check whether two symbols may be merged.
`getPrimaryLocation`	Determine a location to use when none is explicitly chosen.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Typedef.hpp>

explicit
TypedefSymbol(SymbolID ID) noexcept;

Parameters

Name	Description
ID	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/Symbol/Typedef.hpp>

std::strong_ordering
operator<=>(TypedefSymbol const& other) const;

Return Value

The relative order of the objects

Parameters

Name	Description
other	The right operand

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isConcept() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnum() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnumConstant() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isGuide() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespace() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespaceAlias() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isOverloads() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isRecord() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isTypedef() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isUsing() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isVariable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Typedef.hpp>

bool IsUsing = false;

Description


using MyVector = std::vector<int>

False means it's a C-style typedef:


typedef std::vector<int> MyVector;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Typedef.hpp>

Optional<TemplateInfo> Template;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Typedef.hpp>

Polymorphic<Type> Type = Polymorphic<struct Type>(NamedType{});

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr static
SymbolKind kind_id;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class E>
class Unexpected;

Member Functions

Name	Description
`Unexpected` [constructor]	Constructors
`operator=`	Assignment operators
`error`	`error` overloads
`swap`	Swap the contained error with another instance.

Friends

Name	Description
`mrdocs::swap`
`mrdocs::operator==`	Equality operator

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Copy constructor.

constexpr
Unexpected(Unexpected const& other) = default;

» more...

Move constructor.

constexpr
Unexpected(Unexpected&& other) = default;

» more...

Construct from an error value convertible to E.

template<class Er = E>
requires (!std::is_same_v<std::remove_cvref_t<Er>, Unexpected>) &&
      (!std::is_same_v<std::remove_cvref_t<Er>, std::in_place_t>) &&
        std::is_constructible_v<E, Er>
constexpr
explicit
Unexpected(Er&& e) noexcept(std::is_nothrow_constructible_v<E, Er>);

» more...

In-place construct the error value with arguments.

template<class... Args>
requires std::is_constructible_v<E, Args...>
constexpr
explicit
Unexpected(
    std::in_place_t in_place,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<E, Args...>);

» more...

In-place construct the error value from an initializer list.

template<
    class U,
    class... Args>
requires std::is_constructible_v<E, std::initializer_list<U>&, Args...>
constexpr
explicit
Unexpected(
    std::in_place_t in_place,
    std::initializer_list<U> il,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<E, std::initializer_list<U> &, Args...>);

» more...

Parameters

Name	Description
e	Error value to store.
in_place	Tag selecting in-place construction.
args	Arguments forwarded to `E`'s constructor.
il	Initializer list for the error.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Unexpected(Unexpected const& other) = default;

Parameters

Name	Description
other	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Unexpected(Unexpected&& other) = default;

Parameters

Name	Description
other	The object to move construct from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class Er = E>
requires (!std::is_same_v<std::remove_cvref_t<Er>, Unexpected>) &&
      (!std::is_same_v<std::remove_cvref_t<Er>, std::in_place_t>) &&
        std::is_constructible_v<E, Er>
constexpr
explicit
Unexpected(Er&& e) noexcept(std::is_nothrow_constructible_v<E, Er>);

Parameters

Name	Description
e	Error value to store.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class... Args>
requires std::is_constructible_v<E, Args...>
constexpr
explicit
Unexpected(
    std::in_place_t in_place,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<E, Args...>);

Parameters

Name	Description
in_place	Tag selecting in-place construction.
args	Arguments forwarded to `E`'s constructor.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<
    class U,
    class... Args>
requires std::is_constructible_v<E, std::initializer_list<U>&, Args...>
constexpr
explicit
Unexpected(
    std::in_place_t in_place,
    std::initializer_list<U> il,
    Args&&... args) noexcept(std::is_nothrow_constructible_v<E, std::initializer_list<U> &, Args...>);

Parameters

Name	Description
in_place	Tag selecting in-place construction.
il	Initializer list for the error.
args	Additional constructor arguments.

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Copy assignment.

constexpr
Unexpected&
operator=(Unexpected const& other) = default;

» more...

Move assignment.

constexpr
Unexpected&
operator=(Unexpected&& other) = default;

» more...

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Unexpected&
operator=(Unexpected const& other) = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to copy assign from

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
Unexpected&
operator=(Unexpected&& other) = default;

Return Value

Reference to the current object

Parameters

Name	Description
other	The object to move assign from

Synopses

Declared in <mrdocs/Support/Expected.hpp>

Return a const reference to the stored error.

[[nodiscard]]
constexpr
E const&
error() const & noexcept;

» more...

Return a reference to the stored error.

[[nodiscard]]
constexpr
E&
error() & noexcept;

» more...

Return a const rvalue reference to the stored error.

[[nodiscard]]
constexpr
E const&&
error() const && noexcept;

» more...

Return a rvalue reference to the stored error.

[[nodiscard]]
constexpr
E&&
error() && noexcept;

» more...

Return Value

Const reference to E.
Reference to E.
Const rvalue reference to E.
Rvalue reference to E.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
constexpr
E const&
error() const & noexcept;

Return Value

Const reference to E.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
constexpr
E&
error() & noexcept;

Return Value

Reference to E.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
constexpr
E const&&
error() const && noexcept;

Return Value

Const rvalue reference to E.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
constexpr
E&&
error() && noexcept;

Return Value

Rvalue reference to E.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
void
swap(Unexpected& other) noexcept(std::is_nothrow_swappable_v<E>)
requires std::is_swappable_v<E>;

Parameters

Name	Description
other	Holds an unexpected error value for Expected.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Using.hpp>

struct UsingSymbol final
    : SymbolCommonBase<SymbolKind::Using>

Description

For instance, the following code:


using A::f; // where f is a function in namespace A

would be represented by a UsingSymbol object.

Using-declarations can be used to introduce namespace members into other namespaces and block scopes, or to introduce base class members into derived class definitions, or to introduce enumerators into namespaces, block, and class scopes.

Base Classes

Name	Description
`SymbolCommonBase<SymbolKind::Using>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`UsingSymbol` [constructor]	Create a using-declaration symbol bound to an ID.

Static Member Functions

Name
`isConcept`
`isEnum`
`isEnumConstant`
`isFunction`
`isGuide`
`isNamespace`
`isNamespaceAlias`
`isOverloads`
`isRecord`
`isTypedef`
`isUsing`
`isVariable`

Data Members

Name	Description
`Class`	The using declaration.
`IntroducedName`	The symbol being introduced.
`ShadowDeclarations`	The shadow declarations.

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`allMembers`	Access declarations introduced by this using-declaration.
`canMerge`	Check whether two symbols may be merged.
`getPrimaryLocation`	Determine a location to use when none is explicitly chosen.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Using.hpp>

explicit
UsingSymbol(SymbolID ID) noexcept;

Parameters

Name	Description
ID	The object to construct from

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isConcept() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnum() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnumConstant() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isGuide() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespace() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespaceAlias() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isOverloads() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isRecord() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isTypedef() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isUsing() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isVariable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Using.hpp>

UsingClass Class = UsingClass::Normal;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Using.hpp>

Polymorphic<Name> IntroducedName = Polymorphic<struct Name>(std::in_place_type<IdentifierName>);

Description

This is the symbol that is being "used" or introduced into the current scope.

Note that this can be a qualified name, such as A::f in the example above.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Using.hpp>

std::vector<SymbolID> ShadowDeclarations;

Description

A using declaration can refer to and introduce multiple symbols into the current context.

These multiple symbols are considered a special case of declarations: "shadow declarations".

This typically happens when there are conflicting symbol names in the scope being introduced, such as:

Overloaded functions: the base namespace contains overloaded functions. Name conflicts: the base scope contains a function and a type. Enums: a using enum declaration can refer to multiple enumerators.

Also note that more shadow declarations can be introduced later in the same scope, after the using declaration.

The shadow declarations here are only those that are shadowed at the point where the using declaration is located.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr static
SymbolKind kind_id;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

struct VariableSymbol final
    : SymbolCommonBase<SymbolKind::Variable>

Description

This includes variables at namespace or record scope.

Base Classes

Name	Description
`SymbolCommonBase<SymbolKind::Variable>`	Base class for providing variant discriminator functions.

Member Functions

Name	Description
`VariableSymbol` [constructor]	Create a variable symbol bound to an ID.
`operator<=>`	Compare variables by type, flags, and initializer.

Static Member Functions

Name
`isConcept`
`isEnum`
`isEnumConstant`
`isFunction`
`isGuide`
`isNamespace`
`isNamespaceAlias`
`isOverloads`
`isRecord`
`isTypedef`
`isUsing`
`isVariable`

Data Members

Name	Description
`Attributes`	Raw attribute spellings attached to the variable.
`BitfieldWidth`	The width of the bitfield
`HasNoUniqueAddress`	Whether the variable uses [[no_unique_address]].
`Initializer`	The default member initializer, if any.
`IsBitfield`	Whether the field is a bitfield
`IsConstexpr`	Whether the variable is `constexpr`.
`IsConstinit`	Whether the variable is `constinit`.
`IsDeprecated`	Whether the variable is marked deprecated.
`IsInline`	Whether the variable is declared `inline`.
`IsMaybeUnused`	Whether the variable carries `[[maybe_unused]]`.
`IsMutable`	Whether the field is declared mutable
`IsRecordField`	True if this variable is a data member of a record.
`IsThreadLocal`	Whether the variable is `thread_local`.
`IsVariant`	Whether the field is a variant member
`StorageClass`	Storage class specifier applied to the variable.
`Template`	The template information, if any.
`Type`	The type of the variable

Static Data Members

Name
`kind_id`

Non-Member Functions

Name	Description
`canMerge`	Check whether two symbols may be merged.
`getPrimaryLocation`	Determine a location to use when none is explicitly chosen.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

explicit
VariableSymbol(SymbolID const& ID) noexcept;

Parameters

Name	Description
ID	The object to copy construct from

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

std::strong_ordering
operator<=>(VariableSymbol const& other) const;

Return Value

The relative order of the objects

Parameters

Name	Description
other	The right operand

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isConcept() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnum() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isEnumConstant() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isFunction() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isGuide() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespace() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isNamespaceAlias() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isOverloads() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isRecord() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isTypedef() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isUsing() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolNodes.inc>

constexpr
static
bool
isVariable() noexcept;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

std::vector<std::string> Attributes;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

ConstantExprInfo<uint64_t> BitfieldWidth;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

bool HasNoUniqueAddress = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

ExprInfo Initializer;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

bool IsBitfield = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

bool IsConstexpr = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

bool IsConstinit = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

bool IsDeprecated = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

bool IsInline = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

bool IsMaybeUnused = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

bool IsMutable = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

bool IsRecordField = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

bool IsThreadLocal = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

bool IsVariant = false;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

StorageClassKind StorageClass = StorageClassKind::None;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

Optional<TemplateInfo> Template;

Synopsis

Declared in <mrdocs/Metadata/Symbol/Variable.hpp>

Polymorphic<Type> Type = Polymorphic<struct Type>(NamedType{});

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

constexpr static
SymbolKind kind_id;

Synopsis

Declared in <mrdocs/Support/Visitor.hpp>

template<
    typename Base,
    typename Fn,
    typename... Args>
class Visitor;

Description

This class is used to implement the visitor pattern. It stores a reference to an object of type Base, and a function object Fn which is called with the derived type as the first argument, followed by Args.

The visitor is constructed with the object to visit, the function object, and the arguments to pass to the function object.

The method visit is a template which accepts a derived type of Base. It calls the function object with the derived type as the first argument, followed by the arguments passed to the constructor.

Member Functions

Name	Description
`Visitor` [constructor]	Constructor
`visit`	Visit a derived type

Template Parameters

Name	Description
Base	The base type of the object
Fn	The function object type
Args	The argument types

Synopsis

Declared in <mrdocs/Support/Visitor.hpp>

Visitor(
    Base&& obj,
    Fn&& fn,
    Args&&... args);

Parameters

Name	Description
obj	The object to visit
fn	The function object to call
args	The arguments to pass to the function object

Synopsis

Declared in <mrdocs/Support/Visitor.hpp>

template<std::derived_from<std::remove_cvref_t<Base>> Derived>
decltype(auto)
visit();

Description

This method calls the function object with the derived type as the first argument, followed by the arguments passed to the constructor.

Return Value

The result of calling the function object

Template Parameters

Name	Description
Derived	The derived type to visit

Synopsis

Declared in <mrdocs/ADT/Overload.hpp>

template<class F>
class YCombinator;

Description

YCombinator stores a callable F and exposes operator() that forwards arguments to F, prepending a reference to *this so that F can recurse.

Overloads are provided for &, const&, &&, const&& to preserve value category.

auto fact = fn::yCombinator( []self, int n) -> long long { return n <= 1 ? 1 : n * self(n - 1); }); auto r = fact(10);

Member Functions

Name	Description
`YCombinator` [constructor]	Constructs a YCombinator from the given callable.
`operator()`	Function call operators

Non-Member Functions

Name	Description
`yCombinator`	Factory that creates a YCombinator from a callable.

Template Parameters

Name	Description
F	The callable to wrap.

Synopsis

Declared in <mrdocs/ADT/Overload.hpp>

constexpr
explicit
YCombinator(F f) noexcept(std::is_nothrow_move_constructible_v<F>);

Parameters

Name	Description
f	The callable to store.

Synopses

Declared in <mrdocs/ADT/Overload.hpp>

Invokes the stored callable, passing *this as the first parameter.

template<class... Args>
constexpr
decltype(auto)
operator()(Args&&... args) &;

» more...

Const lvalue overload of operator().

template<class... Args>
constexpr
decltype(auto)
operator()(Args&&... args) const &;

» more...

Rvalue overload of operator().

template<class... Args>
constexpr
decltype(auto)
operator()(Args&&... args) &&;

» more...

Const rvalue overload of operator().

template<class... Args>
constexpr
decltype(auto)
operator()(Args&&... args) const &&;

» more...

Return Value

Whatever the callable returns.

Parameters

Name	Description
args	The arguments to forward to the callable after the self reference.

Synopsis

Declared in <mrdocs/ADT/Overload.hpp>

template<class... Args>
constexpr
decltype(auto)
operator()(Args&&... args) &;

Return Value

Whatever the callable returns.

Parameters

Name	Description
args	The arguments to forward to the callable after the self reference.

Synopsis

Declared in <mrdocs/ADT/Overload.hpp>

template<class... Args>
constexpr
decltype(auto)
operator()(Args&&... args) const &;

Return Value

Whatever the callable returns.

Parameters

Name	Description
args	The arguments to forward to the callable after the self reference.

Synopsis

Declared in <mrdocs/ADT/Overload.hpp>

template<class... Args>
constexpr
decltype(auto)
operator()(Args&&... args) &&;

Return Value

Whatever the callable returns.

Parameters

Name	Description
args	The arguments to forward to the callable after the self reference.

Synopsis

Declared in <mrdocs/ADT/Overload.hpp>

template<class... Args>
constexpr
decltype(auto)
operator()(Args&&... args) const &&;

Return Value

Whatever the callable returns.

Parameters

Name	Description
args	The arguments to forward to the callable after the self reference.

Synopsis

Declared in <mrdocs/Support/TypeTraits.hpp>

template<
    typename From,
    typename To>
struct add_const_from
    : std::conditional<std::is_const_v<std::remove_reference_t<From>>, add_reference_from_t<To, std::remove_reference_t<To> const>, To>

Base Classes

Name	Description
`std::conditional<std::is_const_v<std::remove_reference_t<From>>, add_reference_from_t<To, std::remove_reference_t<To> const>, To>`

Derived Classes

Name	Description
`add_cv_from`	Propagate both const and volatile qualifiers from `From` to `To`.

Synopsis

Declared in <mrdocs/Support/TypeTraits.hpp>

template<
    typename From,
    typename To>
struct add_cv_from
    : add_const_from<From, add_volatile_from_t<From, To>>

Base Classes

Name	Description
`add_const_from<From, add_volatile_from_t<From, To>>`	Propagate const qualification from `From` to `To`, keeping references.

Synopsis

Declared in <mrdocs/Support/TypeTraits.hpp>

template<
    typename From,
    typename To>
struct add_cvref_from
    : add_reference_from<From, add_cv_from_t<From, To>>

Base Classes

Name	Description
`add_reference_from<From, add_cv_from_t<From, To>>`	Propagate reference qualification from `From` to `To`.

Synopsis

Declared in <mrdocs/Support/TypeTraits.hpp>

template<
    typename From,
    typename To>
struct add_lvalue_reference_from
    : std::conditional<std::is_lvalue_reference_v<From>, std::add_lvalue_reference_t<To>, To>

Base Classes

Name	Description
`std::conditional<std::is_lvalue_reference_v<From>, std::add_lvalue_reference_t<To>, To>`

Derived Classes

Name	Description
`add_reference_from`	Propagate reference qualification from `From` to `To`.

Synopsis

Declared in <mrdocs/Support/TypeTraits.hpp>

template<
    typename From,
    typename To>
struct add_reference_from
    : add_lvalue_reference_from<From, add_rvalue_reference_from_t<From, To>>

Base Classes

Name	Description
`add_lvalue_reference_from<From, add_rvalue_reference_from_t<From, To>>`	Propagate lvalue-reference from `From` to `To` if present.

Derived Classes

Name	Description
`add_cvref_from`	Propagate cv-qualification and reference category from `From` to `To`.

Synopsis

Declared in <mrdocs/Support/TypeTraits.hpp>

template<
    typename From,
    typename To>
struct add_rvalue_reference_from
    : std::conditional<std::is_rvalue_reference_v<From>, std::add_rvalue_reference_t<To>, To>

Base Classes

Name	Description
`std::conditional<std::is_rvalue_reference_v<From>, std::add_rvalue_reference_t<To>, To>`

Synopsis

Declared in <mrdocs/Support/TypeTraits.hpp>

template<
    typename From,
    typename To>
struct add_volatile_from
    : std::conditional<std::is_volatile_v<std::remove_reference_t<From>>, add_reference_from_t<To, std::remove_reference_t<To> volatile>, To>

Base Classes

Name	Description
`std::conditional<std::is_volatile_v<std::remove_reference_t<From>>, add_reference_from_t<To, std::remove_reference_t<To> volatile>, To>`

Synopsis

Declared in <mrdocs/Support/any_callable.hpp>

template<class>
class any_callable;

Description

Usage:


any_callable<void(void)> f;

Synopsis

Declared in <mrdocs/Support/any_callable.hpp>

template<
    class R,
    class... Args>
class any_callable<R(Args...)>;

Member Functions

Name	Description
`any_callable` [constructor] [deleted]	Constructors
`operator()`	Invoke the stored callable.

Synopses

Declared in <mrdocs/Support/any_callable.hpp>

Deleted default constructor to prevent empty call targets.

any_callable() = delete;

» more...

Construct from a callable object matching the signature.

template<class Callable>
requires std::is_invocable_r_v<R, Callable, Args...>
any_callable(Callable&& f);

» more...

Parameters

Name	Description
f	Callable to store; must satisfy `R(Args...)`.

Synopsis

Declared in <mrdocs/Support/any_callable.hpp>

any_callable() = delete;

Synopsis

Declared in <mrdocs/Support/any_callable.hpp>

template<class Callable>
requires std::is_invocable_r_v<R, Callable, Args...>
any_callable(Callable&& f);

Parameters

Name	Description
f	Callable to store; must satisfy `R(Args...)`.

Synopsis

Declared in <mrdocs/Support/any_callable.hpp>

R
operator()(Args&&... args) const;

Return Value

Result of the wrapped callable.

Parameters

Name	Description
args	Arguments forwarded to the callable.

Synopsis

Declared in <mrdocs/Support/TypeTraits.hpp>

template<
    typename T,
    typename U>
struct make_dependent;

Type Aliases

Name	Description
`type`	Make a type dependent on another template parameter.

Synopsis

Declared in <mrdocs/Support/TypeTraits.hpp>

using type = T;

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

template<class T>
struct nullable_traits;

Description

This trait is the canonical place to encode nullability semantics used by any optional-like type.

It exposes the minimal operations needed by an optional:

is_null(const T&): test if a value is null.
null(): create a null value.
make_null(T&): turn an existing value into null.

Users may explicitly specialize nullable_traits for their types to define the desired semantics.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Location.hpp>

template<>
struct nullable_traits<Location>;

Description

Semantics

The “null” (sentinel) state is any Location whose ShortPath is empty.
Creating a null value produces a Location with all fields defaulted and ShortPath empty.
Making an existing value null clears ShortPath and resets the other fields to their defaults.

Rationale

This mirrors the old LocationEmptyPredicate, which treated an empty ShortPath as “empty/null.”

Static Member Functions

Name	Description
`is_null`	Test if the location is null (empty ShortPath).
`make_null`	Reset a location to the null sentinel state.
`null`	Create a null location sentinel.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Location.hpp>

constexpr
static
bool
is_null(Location const& v) noexcept;

Return Value

True when ShortPath is empty.

Parameters

Name	Description
v	Source location of a symbol or entity.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Location.hpp>

constexpr
static
void
make_null(Location& v) noexcept;

Parameters

Name	Description
v	Source location of a symbol or entity.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Location.hpp>

constexpr
static
Location
null() noexcept;

Return Value

Location with every field cleared.

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

template<class T>
requires (!HasSentinel<T> && ClearableContainerLike<T>)
struct nullable_traits<T>;

Description

Delegates null handling to sentinel_traits<T>.

nullable_traits for clearable empty types.

Treats the empty state as null, creates null via default construction, and erases via clear().

Return true if v is empty.

Static Member Functions

Name	Description
`is_null`	Return true if `v` matches the sentinel for `T.`
`make_null`	Overwrite `v` with the sentinel null value.
`null`	Return the sentinel value representing null.

Return Value

true when the container is empty.

Parameters

Name	Description
v	Value to test.

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

constexpr
static
bool
is_null(T const& v) noexcept(noexcept(v.empty()));

Return Value

true when v equals the sentinel.

Parameters

Name	Description
v	Value to test.

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

constexpr
static
void
make_null(T& v) noexcept(noexcept(v.clear()));

Description

Clear v to its null (empty) state.

Parameters

Name	Description
v	Value to clear.

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

constexpr
static
T
null() noexcept(std::is_nothrow_default_constructible_v<T>);

Description

Construct a null value using the default constructor.

Return Value

Sentinel value for T.
Default-constructed T.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

template<class T>
struct nullable_traits<Polymorphic<T>>;

Description

Only this friend specialization can create/reset the null state.

Static Member Functions

Name	Description
`is_null`	Return true if the polymorphic value is disengaged.
`make_null`	Reset the polymorphic value to null.
`null`	Return a null polymorphic instance.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

constexpr
static
bool
is_null(Polymorphic<T> const& v) noexcept;

Return Value

true when v does not hold an object.

Parameters

Name	Description
v	Value to test.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

constexpr
static
void
make_null(Polymorphic<T>& v) noexcept;

Parameters

Name	Description
v	Value to clear.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

constexpr
static
Polymorphic<T>
null() noexcept;

Return Value

Disengaged Polymorphic.

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

template<class T>
struct sentinel_traits;

Description

Users may specialize this trait for their own types to declare a sentinel-based null representation.

When enabled, nullable semantics can be implemented in terms of the sentinel without storing a separate engaged/disengaged flag.

Contract for specializations:

Provide static constexpr T sentinel() noexcept; which returns the distinguished null value.
Provide static constexpr bool is_sentinel(const T&) noexcept; which recognizes the null value.

If a type does not have a well-defined sentinel, leave the primary template in effect.

Notes

Built-in pointer types and std::nullptr_t are pre-specialized to use nullptr as the sentinel.

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

template<>
struct sentinel_traits<std::nullptr_t>;

Static Member Functions

Name	Description
`is_sentinel`	Return true if the value equals the sentinel.
`sentinel`	Return the sentinel value for std::nullptr_t.

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

constexpr
static
bool
is_sentinel(std::nullptr_t) noexcept;

Return Value

Always true because the sentinel is unique.

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

constexpr
static
std::nullptr_t
sentinel() noexcept;

Return Value

the sentinel value for std::nullptr_t.

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

template<std::floating_point T>
requires std::is_enum_v<T> &&
         (requires { T::unknown; } ||
          requires { T::Unknown; } ||
          requires { T::UNKNOWN; } ||
          requires { T::none; } ||
          requires { T::None; } ||
          requires { T::NONE; })
struct sentinel_traits<T>;

Description

Uses the maximum representable value (~0u) as the sentinel, which corresponds to -1 when converted.

sentinel_traits specialization for floating-point types.

Uses a quiet NaN as the sentinel value. This assumes that T supports NaN and that it is distinguishable from all ordinary values.

Return the floating-point NaN sentinel.

sentinel_traits specialization for enums with a well-known "null" enumerator.

If the enum defines Unknown, UNKNOWN, None, or NONE, this trait uses that enumerator as the sentinel. This requires that such an enumerator exists and is accessible from the scope of T.

Return the enum sentinel value.

Static Member Functions

Name	Description
`is_sentinel`	Return true if the value equals the sentinel.
`sentinel`	Return the sentinel value (~0u).

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

constexpr
static
bool
is_sentinel(T v) noexcept;

Description

Return true if v is the NaN sentinel.

Return true if v equals the sentinel value.

Return Value

true when v equals the sentinel.
true when v is NaN.
true when v matches the sentinel enumerator.

Parameters

Name	Description
v	Value to test.

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

constexpr
static
T
sentinel() noexcept;

Return Value

the sentinel value (~0u).

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

template<class T>
struct sentinel_traits<T*>;

Description

Uses nullptr as the sentinel value.

Static Member Functions

Name	Description
`is_sentinel`	Return true if the pointer equals the sentinel.
`sentinel`	Return the sentinel pointer value (nullptr).

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

constexpr
static
bool
is_sentinel(T const* p) noexcept;

Return Value

true when p is nullptr.

Parameters

Name	Description
p	Pointer to test.

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

constexpr
static
T*
sentinel() noexcept;

Return Value

the sentinel pointer value (nullptr).

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

struct unexpect_t;

Member Functions

Name	Description
`unexpect_t` [constructor]	Default constructor.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
explicit
unexpect_t() = default;

Synopsis

Declared in <mrdocs/Support/unlock_guard.hpp>

class unlock_guard;

Member Functions

Name	Description
`unlock_guard` [constructor]	Constructor.
`~unlock_guard` [destructor]	Destructor.

Synopsis

Declared in <mrdocs/Support/unlock_guard.hpp>

explicit
unlock_guard(std::mutex& m);

Parameters

Name	Description
m	The object to copy construct from

Synopsis

Declared in <mrdocs/Support/unlock_guard.hpp>

~unlock_guard();

Synopsis

Declared in <mrdocs/Metadata/Specifiers/AccessKind.hpp>

enum class AccessKind : int;

Description

None is set to zero since it is the most frequently occurring access, and it is elided by the bitstream encoder because it has an all-zero bit pattern. This improves compression in the bitstream.

None is used for namespace members and friend; such declarations have no access.

Members

Name	Description
`None`	Unspecified access
`Public`	Public access
`Protected`	Protected access
`Private`	Private access

Non-Member Functions

Name	Description
`toString`	Convert access specifier to its string form.

Synopsis

Declared in <mrdocs/Metadata/Type/AutoKind.hpp>

enum class AutoKind : int;

Description

This is either auto or decltype(auto).

Members

Name	Description
`Auto`	The `auto` keyword
`DecltypeAuto`	The `decltype(auto)` keyword

Non-Member Functions

Name	Description
`toString`	Convert an auto-kind to its spelling.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/ConstexprKind.hpp>

enum class ConstexprKind : int;

Description

[dcl.spec.general]p2: At most one of the constexpr, consteval, and constinit keywords shall appear in a decl-specifier-seq

Members

Name	Description
`None`	No `constexpr` or `consteval` specifier
`Constexpr`	The `constexpr` specifier
`Consteval`	The `consteval` specifier only valid for functions

Non-Member Functions

Name	Description
`toString`	Convert a constexpr/consteval specifier kind to a string.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/ExplicitKind.hpp>

enum class ExplicitKind : int;

Members

Name	Description
`False`	No explicit-specifier or explicit-specifier evaluated to false
`True`	explicit-specifier evaluates to true
`Dependent`	Dependent explicit-specifier

Non-Member Functions

Name	Description
`toString`	Convert an explicit kind to its string form.

Synopsis

Declared in <mrdocs/Metadata/Symbol/ExtractionMode.hpp>

enum class ExtractionMode : int;

Description

The enum constants are ordered by specificity, with the least specific at the beginning and the most specific at the end.

Members

Name	Description
`Regular`	We're extracting the current symbol because it passes all filters.
`SeeBelow`	We're extracting the current symbol because it passes all filters, but we should also tag it as see-below because it passes one of the see-below filters. This symbol has its own page but it has no details and no child members.
`ImplementationDefined`	We're extracting the current symbol because it passes all filters, but we should also tag it as implementation-defined because one of its parents matches the implementation-defined filter. This symbol has no page and other symbols that depend on it will just render /implementation-defined/.
`Dependency`	We're extracting the current symbol even though it doesn't pass all filters because it's a direct dependency of a symbol that does pass all filters and needs information about it (e.g.: base classes outside the filters). This symbol has no page and it might even deleted from the corpus if no other symbol depends on it after we extracted the information we wanted from it in post-processing steps.

Non-Member Functions

Name	Description
`leastSpecific`	Compare ExtractionModes and returns the least specific
`merge`	Merge two ExtractionMode values.
`mostSpecific`	Compare ExtractionModes and returns the most specific

Synopsis

Declared in <mrdocs/Metadata/Symbol/FileKind.hpp>

enum class FileKind : int;

Members

Name	Description
`Source`	File in the source directory
`System`	File in a system include directory
`Other`	File outside the source directory

Synopsis

Declared in <mrdocs/Metadata/Symbol/FunctionClass.hpp>

enum class FunctionClass : int;

Members

Name	Description
`Normal`	The function is a normal function.
`Constructor`	The function is a constructor.
`Conversion`	The function is a conversion operator.
`Destructor`	The function is a destructor.

Synopsis

Declared in <mrdocs/Metadata/Type/FundamentalTypeKind.hpp>

enum class FundamentalTypeKind : int;

Members

Name	Description
`Void`	void
`Nullptr`	std::nullptr_t
`Bool`	bool
`Char`	char
`SignedChar`	signed char
`UnsignedChar`	unsigned char
`Char8`	char8_t
`Char16`	char16_t
`Char32`	char32_t
`WChar`	wchar_t
`Short`	short / short int / signed short / signed short int
`UnsignedShort`	unsigned short / unsigned short int
`Int`	int / signed / signed int
`UnsignedInt`	unsigned / unsigned int
`Long`	long / long int / signed long / signed long int
`UnsignedLong`	unsigned long / unsigned long int
`LongLong`	long long / long long int / signed long long / signed long long int
`UnsignedLongLong`	unsigned long long / unsigned long long int
`Float`	float
`Double`	double
`LongDouble`	long double

Non-Member Functions

Name	Description
`makeChar`	Apply the "char" specifier to the type
`makeLong`	Apply the "long" specifier to the type
`makeShort`	Apply the "short" specifier to the type
`makeSigned`	Apply the "signed" specifier to the type
`makeUnsigned`	Apply the "unsigned" specifier to the type
`toString`	Convert a FundamentalTypeKind to a string.

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/ListKind.hpp>

enum class ListKind : int;

Members

Name	Description
`Unordered`	A bulleted list with no inherent ordering.
`Ordered`	A numbered list where item order matters.

Synopsis

Declared in <mrdocs/Metadata/Name/NameKind.hpp>

enum class NameKind : int;

Synopsis

Declared in <mrdocs/Metadata/Specifiers/NoexceptKind.hpp>

enum class NoexceptKind : int;

Members

Name	Description
`False`	Potentially-throwing exception specification
`True`	Non-throwing exception specification
`Dependent`	Dependent exception specification

Non-Member Functions

Name	Description
`toString`	Convert a noexcept kind to its string form.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/OperatorKind.hpp>

enum class OperatorKind : int;

Members

Name	Description
`None`	No operator
`New`	The `new` Operator
`Delete`	The `delete` Operator
`ArrayNew`	The `new[]` Operator
`ArrayDelete`	The `delete[]` Operator
`Plus`	The + Operator
`Minus`	The - Operator
`Star`	The * Operator
`Slash`	The / Operator
`Percent`	The % Operator
`Caret`	The ^ Operator
`Amp`	The & Operator
`Pipe`	The \| Operator
`Tilde`	The ~ Operator
`Equal`	The ! Operator
`PlusEqual`	The += Operator
`MinusEqual`	The -= Operator
`StarEqual`	The *= Operator
`SlashEqual`	The /= Operator
`PercentEqual`	The %= Operator
`CaretEqual`	The ^= Operator
`AmpEqual`	The &= Operator
`PipeEqual`	The \|= Operator
`LessLess`	The << Operator
`GreaterGreater`	The >> Operator
`LessLessEqual`	The <<= Operator
`GreaterGreaterEqual`	The >>= Operator
`Exclaim`	The ! Operator
`EqualEqual`	The == Operator
`ExclaimEqual`	The != Operator
`Less`	The < Operator
`LessEqual`	The <= Operator
`Greater`	The > Operator
`GreaterEqual`	The >= Operator
`Spaceship`	The <=> Operator
`AmpAmp`	The && Operator
`PipePipe`	The \|\| Operator
`PlusPlus`	The ++ Operator
`MinusMinus`	The -- Operator
`Comma`	The , Operator
`ArrowStar`	The ->* Operator
`Arrow`	The -> Operator
`Call`	The () Operator
`Subscript`	The []Operator
`Conditional`	The `? :` Operator
`Coawait`	The `coawait` Operator

Non-Member Functions

Name	Description
`getOperatorKind`	Return the short name of an operator as a string.
`getOperatorKindFromSuffix`	Return the short name of an operator as a string.
`getOperatorName`	Return the name of an operator as a string.
`getOperatorReadableName`	Return the human-readable name of the operator
`getSafeOperatorName`	Return the safe name of an operator as a string.
`getShortOperatorName`	Return the short name of an operator as a string.
`isBinaryOperator`	Determines whether the operator is potentially binary.
`isUnaryOperator`	Determines whether the operator is potentially unary.

Synopsis

Declared in <mrdocs/Metadata/Type/QualifierKind.hpp>

enum QualifierKind;

Members

Name	Description
`None`	No qualifiers
`Const`	The const qualifier
`Volatile`	The volatile qualifier

Non-Member Functions

Name	Description
`toString`	Convert a cv/ref qualifier kind to its string form.

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordKeyKind.hpp>

enum class RecordKeyKind : int;

Members

Name	Description
`Struct`	A struct.
`Class`	A C++ class.
`Union`	A C-style Union

Non-Member Functions

Name	Description
`getDefaultAccessString`	Return the default accessibility for a record key kind.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/ReferenceKind.hpp>

enum class ReferenceKind : int;

Members

Name	Description
`None`	Not a reference
`LValue`	An L-Value reference
`RValue`	An R-Value reference

Non-Member Functions

Name	Description
`toString`	Convert a reference kind to its string representation.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/StorageClassKind.hpp>

enum class StorageClassKind : int;

Description

[dcl.stc]p1: At most one storage-class-specifier shall appear in a given decl-specifier-seq, except that thread_local may appear with static or extern.

Members

Name	Description
`None`	No storage class specifier
`Extern`	thread_local storage-class-specifier
`Static`	mutable storage-class-specifier
`Auto`	auto storage-class-specifier (removed in C++11) only valid for variables
`Register`	register storage-class-specifier (removed in C++17) only valid for variables

Non-Member Functions

Name	Description
`toString`	Convert a storage class kind to its string form.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolKind.hpp>

enum class SymbolKind : int;

Members

Name	Description
`None`	Kind is not specified.

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgKind.hpp>

enum class TArgKind : int;

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamKeyKind.hpp>

enum class TParamKeyKind : int;

Members

Name	Description
`Class`	Class keyword
`Typename`	Typename keyword

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamKind.hpp>

enum class TParamKind : int;

Synopsis

Declared in <mrdocs/Metadata/DocComment/Block/TableAlignmentKind.hpp>

enum class TableAlignmentKind : int;

Members

Name	Description
`None`	No explicit alignment; renderer default applies.
`Left`	Align content to the left edge.
`Center`	Center the content.
`Right`	Align content to the right edge.

Synopsis

Declared in <mrdocs/Metadata/Template.hpp>

enum class TemplateSpecKind : int;

Members

Name	Description
`Primary`	Primary template
`Explicit`	Full template specialization
`Partial`	Partial template specialization

Non-Member Functions

Name	Description
`toString`	Convert the specialization kind to a readable string.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeKind.hpp>

enum class TypeKind : int;

Description

NOTE

TypeKind is intentionally NOT registered with MRDOCS_DESCRIBE_ENUM. Describing it would make the reflection- driven XML writer emit a redundant <kind>...</kind> child into every type element (NamedType, LValueReferenceType, ...), which would churn every XML golden test for no semantic gain. Code that needs a string form for a TypeKind value calls toString below; the script side of mrdocs.set falls back to toString for polymorphic kind: matching when the discriminator enum is undescribed, so script names (lvalue-reference, ...) match the DOM and Handlebars side and differ only from the XML writer's tag form (l-value-reference, ...).

Non-Member Functions

Name	Description
`toString`	Convert a TypeKind to its string representation.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Using.hpp>

enum class UsingClass : int;

Description

This indicates whether the using declaration is a normal using, a using typename, or a using enum.

Members

Name	Description
`Normal`	Using declaration class.
`Typename`	Using typename declaration class.
`Enum`	Using enum declaration class.

Synopses

Declared in <mrdocs/ADT/Polymorphic.hpp>

Compares two polymorphic objects that have visit functions

template<class Base>
requires (!detail::IsPolymorphic<Base>) && detail::CanVisitCompare<Base>
auto
CompareDerived(
    Base const& lhs,
    Base const& rhs);

» more...

Compares two polymorphic objects that have visit functions

template<class Base>
requires detail::CanVisitCompare<Base>
auto
CompareDerived(
    Polymorphic<Base> const& lhs,
    Polymorphic<Base> const& rhs);

» more...

Return Value

true if the two Polymorphic objects are equal, otherwise false.

Template Parameters

Name	Description
Base	The type of the Polymorphic.

Parameters

Name	Description
lhs	The first Polymorphic to compare.
rhs	The second Polymorphic to compare.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

template<class Base>
requires (!detail::IsPolymorphic<Base>) && detail::CanVisitCompare<Base>
auto
CompareDerived(
    Base const& lhs,
    Base const& rhs);

Description

This function compares two Polymorphic objects that have visit functions for the Base type.

The visit function is used to compare the two objects if they are of the same derived type.

If the two objects are of different derived types, the comparison is based on the type_info of the derived types.

If any of the objects is empty, the comparison is based on the emptiness of the objects.

Return Value

true if the two Polymorphic objects are equal, otherwise false.

Template Parameters

Name	Description
Base	The type of the Polymorphic.

Parameters

Name	Description
lhs	The first Polymorphic to compare.
rhs	The second Polymorphic to compare.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

template<class Base>
requires detail::CanVisitCompare<Base>
auto
CompareDerived(
    Polymorphic<Base> const& lhs,
    Polymorphic<Base> const& rhs);

Description

This function compares two Polymorphic objects that have visit functions for the Base type.

The visit function is used to compare the two objects if they are of the same derived type.

If the two objects are of different derived types, the comparison is based on the type_info of the derived types.

If any of the objects is empty, the comparison is based on the emptiness of the objects.

Return Value

true if the two Polymorphic objects are equal, otherwise false.

Template Parameters

Name	Description
Base	The type of the Polymorphic.

Parameters

Name	Description
lhs	The first Polymorphic to compare.
rhs	The second Polymorphic to compare.

Synopses

Declared in <mrdocs/Support/Handlebars.hpp>

HTML escapes the specified string.

std::string
HTMLEscape(std::string_view str);

» more...

HTML escapes the specified string

void
HTMLEscape(
    OutputRef& out,
    std::string_view str);

» more...

Return Value

The escaped string.

Parameters

Name	Description
str	The string to escape.
out	The output stream reference where the escaped string will be written.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

std::string
HTMLEscape(std::string_view str);

Description

This function HTML escapes the specified string, making it safe for rendering as text within HTML content.

Replaces &, <, >, ", ', , =` with the HTML entity equivalent value for string values.

The output of all expressions except for triple-braced expressions are passed through this method. Helpers should also use this method when returning HTML content via a SafeString instance, to prevent possible code injection.

Helper values created by the SafeString function are left untouched by the template and are not passed through this function.

Return Value

The escaped string.

Parameters

Name	Description
str	The string to escape.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
HTMLEscape(
    OutputRef& out,
    std::string_view str);

Description

This function HTML escapes the specified string, making it safe for rendering as text within HTML content.

Replaces &, <, >, ", ', , =` with the HTML entity equivalent value for string values.

The output of all expressions except for triple-braced expressions are passed through this method. Helpers should also use this method when returning HTML content via a SafeString instance, to prevent possible code injection.

Helper values created by the SafeString function are left untouched by the template and are not passed through this function.

This function has the same behavior as the corresponding utility function in the Handlebars.js library.

Parameters

Name	Description
out	The output stream reference where the escaped string will be written.
str	The string to escape.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Overloads.hpp>

void
addMember(
    OverloadsSymbol& I,
    FunctionSymbol const& Member);

Parameters

Name	Description
I	Represents a set of function overloads.
Member	Metadata for a function or method.

Synopsis

Declared in <mrdocs/Support/MapReflectedType.hpp>

template<
    typename T,
    typename IO>
void
addMetaObject(IO& io);

Description

Creates a $meta object containing:

type: The unqualified C++ class name (e.g., "FunctionSymbol").
bases: Array of base class names (e.g., ["Symbol", "SourceInfo"]).

Template Parameters

Name	Description
T	The type whose metadata to add.

Parameters

Name	Description
io	The lazy object IO to map into.

Synopses

Declared in <mrdocs/Metadata/Symbol/Enum.hpp>

Return the list of enum constants for this symbol.

auto&
allMembers(EnumSymbol const& T);

» more...

View all members of the namespace across tranches.

auto
allMembers(NamespaceSymbol const& T);

» more...

Join all tranche member lists into a single view.

auto
allMembers(NamespaceTranche const& T);

» more...

Access the list of overload members.

auto&
allMembers(OverloadsSymbol const& T);

» more...

Flatten all public/protected/private members.

auto
allMembers(RecordInterface const& T);

» more...

View all record members across access levels.

auto
allMembers(RecordSymbol const& T);

» more...

Join every member list into a single view.

auto
allMembers(RecordTranche const& T);

» more...

Access declarations introduced by this using-declaration.

auto&
allMembers(UsingSymbol const& T);

» more...

Return Value

Lazy view across every member bucket.
Lazy view spanning every category stored in the tranche.
Reference to the ID list backing this set.
View concatenating the three access tranches.
Lazy view traversing every tranche.
Lazy view spanning all member categories.
Reference to the underlying shadow list.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Enum.hpp>

auto&
allMembers(EnumSymbol const& T);

Return Value

the list of enum constants for this symbol.

Parameters

Name	Description
T	Metadata for an enumeration declaration.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

auto
allMembers(NamespaceSymbol const& T);

Return Value

Lazy view across every member bucket.

Parameters

Name	Description
T	Describes a namespace and its members.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Namespace.hpp>

auto
allMembers(NamespaceTranche const& T);

Return Value

Lazy view spanning every category stored in the tranche.

Parameters

Name	Description
T	Buckets the members that appear inside a namespace.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Overloads.hpp>

auto&
allMembers(OverloadsSymbol const& T);

Return Value

Reference to the ID list backing this set.

Parameters

Name	Description
T	Represents a set of function overloads.

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordInterface.hpp>

auto
allMembers(RecordInterface const& T);

Return Value

View concatenating the three access tranches.

Parameters

Name	Description
T	The aggregated interface for a given struct, class, or union.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Record.hpp>

auto
allMembers(RecordSymbol const& T);

Return Value

Lazy view traversing every tranche.

Parameters

Name	Description
T	Metadata for struct, class, or union.

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordTranche.hpp>

auto
allMembers(RecordTranche const& T);

Return Value

Lazy view spanning all member categories.

Parameters

Name	Description
T	A group of members that have the same access specifier.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Using.hpp>

auto&
allMembers(UsingSymbol const& T);

Return Value

Reference to the underlying shadow list.

Parameters

Name	Description
T	Info for using declarations.

Synopsis

Declared in <mrdocs/Support/Assert.hpp>

void
assert_failed(
    char const* msg,
    char const* file,
    uint_least32_t line);

Parameters

Name	Description
msg	Expression string that failed.
file	Source file where the assertion triggered.
line	Line within the source file.

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

template<
    DocCommentNodeTraversable T,
    class F>
void
bottomUpTraverse(
    T& node,
    F&& func);

Parameters

Name	Description
node	Root node to traverse.
func	Visitor invoked after children are visited.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

bool
canMerge(
    Symbol const& I,
    Symbol const& Other);

Return Value

True when kinds and IDs match.

Parameters

Name	Description
I	Base class with common properties of all symbols
Other	Base class with common properties of all symbols

Synopses

Declared in <mrdocs/ADT/Polymorphic.hpp>

Dynamic cast returning reference; asserts on failure.

template<
    class To,
    class From>
requires ( std::derived_from<std::remove_cvref_t<To>, std::remove_cvref_t<From>> )
[[nodiscard]]
std::remove_reference_t<To>&
cast(Polymorphic<From>& p);

» more...

Dynamic cast returning const reference; asserts on failure.

template<
    class To,
    class From>
requires ( std::derived_from<std::remove_cvref_t<To>, std::remove_cvref_t<From>> )
[[nodiscard]]
std::remove_reference_t<To> const&
cast(Polymorphic<From> const& p);

» more...

Return Value

Reference to the contained object cast to To.
Const reference to the contained object cast to To.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

template<
    class To,
    class From>
requires ( std::derived_from<std::remove_cvref_t<To>, std::remove_cvref_t<From>> )
[[nodiscard]]
std::remove_reference_t<To>&
cast(Polymorphic<From>& p);

Return Value

Reference to the contained object cast to To.

Parameters

Name	Description
p	A polymorphic value-type.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

template<
    class To,
    class From>
requires ( std::derived_from<std::remove_cvref_t<To>, std::remove_cvref_t<From>> )
[[nodiscard]]
std::remove_reference_t<To> const&
cast(Polymorphic<From> const& p);

Return Value

Const reference to the contained object cast to To.

Parameters

Name	Description
p	A polymorphic value-type.

Synopses

Declared in <mrdocs/ADT/Polymorphic.hpp>

Dynamic cast pointer; returns nullptr when pp is null.

template<
    class To,
    class From>
requires ( std::derived_from<std::remove_cvref_t<To>, std::remove_cvref_t<From>> )
[[nodiscard]]
std::add_pointer_t<std::remove_reference_t<To>>
cast_or_null(Polymorphic<From>* pp);

» more...

Dynamic cast pointer; returns nullptr when pp is null (const).

template<
    class To,
    class From>
requires ( std::derived_from<std::remove_cvref_t<To>, std::remove_cvref_t<From>> )
[[nodiscard]]
std::add_pointer_t<std::remove_reference_t<To> const>
cast_or_null(Polymorphic<From> const* pp);

» more...

Return Value

Pointer to To when the cast succeeds, otherwise nullptr.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

template<
    class To,
    class From>
requires ( std::derived_from<std::remove_cvref_t<To>, std::remove_cvref_t<From>> )
[[nodiscard]]
std::add_pointer_t<std::remove_reference_t<To>>
cast_or_null(Polymorphic<From>* pp);

Return Value

Pointer to To when the cast succeeds, otherwise nullptr.

Parameters

Name	Description
pp	A polymorphic value-type.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

template<
    class To,
    class From>
requires ( std::derived_from<std::remove_cvref_t<To>, std::remove_cvref_t<From>> )
[[nodiscard]]
std::add_pointer_t<std::remove_reference_t<To> const>
cast_or_null(Polymorphic<From> const* pp);

Return Value

Pointer to To when the cast succeeds, otherwise nullptr.

Parameters

Name	Description
pp	A polymorphic value-type.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

std::strong_ordering
compareSymbolNames(
    std::string_view symbolName0,
    std::string_view symbolName1) noexcept;

Description

This function returns true if the string s0 is less than the string s1. The comparison is first made without regard to case, unless the strings compare equal and then they are compared with lowercase letters coming before uppercase letters.

Return Value

The result of the comparison.

Parameters

Name	Description
symbolName0	The first symbol name to compare.
symbolName1	The second symbol name to compare.

Synopses

Declared in <mrdocs/Support/Algorithm.hpp>

Determine if a range contains a specific element.

template<
    class T,
    class U>
requires std::equality_comparable_with<T, U>
bool
contains(
    std::initializer_list<T> const& range,
    U const& el);

» more...

Determine if a range contains a specific element.

template<
    std::ranges::range Range,
    class El>
requires std::equality_comparable_with<El, std::ranges::range_value_t<Range>>
bool
contains(
    Range&& range,
    El const& el);

» more...

Return Value

True if the element is found, false otherwise.

Parameters

Name	Description
range	The range to search.
el	The element to search for.

Synopsis

Declared in <mrdocs/Support/Algorithm.hpp>

template<
    class T,
    class U>
requires std::equality_comparable_with<T, U>
bool
contains(
    std::initializer_list<T> const& range,
    U const& el);

Return Value

True if the element is found, false otherwise.

Parameters

Name	Description
range	The range to search.
el	The element to search for.

Synopsis

Declared in <mrdocs/Support/Algorithm.hpp>

template<
    std::ranges::range Range,
    class El>
requires std::equality_comparable_with<El, std::ranges::range_value_t<Range>>
bool
contains(
    Range&& range,
    El const& el);

Return Value

True if the element is found, false otherwise.

Parameters

Name	Description
range	The range to search.
el	The element to search for.

Synopses

Declared in <mrdocs/Support/Algorithm.hpp>

Determine if a range contains any of the specified elements.

template<
    std::ranges::range Range,
    std::ranges::range Els>
requires std::equality_comparable_with<std::ranges::range_value_t<Els>, std::ranges::range_value_t<Range>>
bool
contains_any(
    Range const& range,
    Els const& els);

» more...

Determine if a range contains any of the specified elements.

template<
    std::ranges::range Range,
    class El>
requires std::equality_comparable_with<El, std::ranges::range_value_t<Range>>
bool
contains_any(
    Range const& range,
    std::initializer_list<El> const& els);

» more...

Return Value

True if any of the elements are found, false otherwise.

Parameters

Name	Description
range	The range to search.
els	The elements to search for.

Synopsis

Declared in <mrdocs/Support/Algorithm.hpp>

template<
    std::ranges::range Range,
    std::ranges::range Els>
requires std::equality_comparable_with<std::ranges::range_value_t<Els>, std::ranges::range_value_t<Range>>
bool
contains_any(
    Range const& range,
    Els const& els);

Return Value

True if any of the elements are found, false otherwise.

Parameters

Name	Description
range	The range to search.
els	The elements to search for.

Synopsis

Declared in <mrdocs/Support/Algorithm.hpp>

template<
    std::ranges::range Range,
    class El>
requires std::equality_comparable_with<El, std::ranges::range_value_t<Range>>
bool
contains_any(
    Range const& range,
    std::initializer_list<El> const& els);

Return Value

True if any of the elements are found, false otherwise.

Parameters

Name	Description
range	The range to search.
els	The elements to search for.

Synopsis

Declared in <mrdocs/Support/Algorithm.hpp>

template<
    std::ranges::range Range,
    class El>
requires std::equality_comparable_with<El, std::ranges::range_value_t<Range>>
bool
contains_n(
    Range const& range,
    El const& el,
    std::size_t n);

Return Value

True if the element is found, false otherwise.

Parameters

Name	Description
range	The range to search.
el	The element to search for.
n	The number of instances to search for.

Synopses

Declared in <mrdocs/Support/Algorithm.hpp>

Determine if a range contains at least N instances of any of the specified elements.

template<
    std::ranges::range Range,
    std::ranges::range Els>
requires std::equality_comparable_with<std::ranges::range_value_t<Els>, std::ranges::range_value_t<Range>>
bool
contains_n_any(
    Range const& range,
    Els const& els,
    std::size_t n);

» more...

Determine if a range contains at least N instances of any of the specified elements.

template<
    std::ranges::range Range,
    class El>
requires std::equality_comparable_with<El, std::ranges::range_value_t<Range>>
bool
contains_n_any(
    Range const& range,
    std::initializer_list<El> const& els,
    std::size_t n);

» more...

Return Value

True if the element is found, false otherwise.

Parameters

Name	Description
range	The range to search.
els	The elements to search for.
n	The number of instances to search for.

Synopsis

Declared in <mrdocs/Support/Algorithm.hpp>

template<
    std::ranges::range Range,
    std::ranges::range Els>
requires std::equality_comparable_with<std::ranges::range_value_t<Els>, std::ranges::range_value_t<Range>>
bool
contains_n_any(
    Range const& range,
    Els const& els,
    std::size_t n);

Return Value

True if the element is found, false otherwise.

Parameters

Name	Description
range	The range to search.
els	The elements to search for.
n	The number of instances to search for.

Synopsis

Declared in <mrdocs/Support/Algorithm.hpp>

template<
    std::ranges::range Range,
    class El>
requires std::equality_comparable_with<El, std::ranges::range_value_t<Range>>
bool
contains_n_any(
    Range const& range,
    std::initializer_list<El> const& els,
    std::size_t n);

Return Value

True if the element is found, false otherwise.

Parameters

Name	Description
range	The range to search.
els	The elements to search for.
n	The number of instances to search for.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolKind.hpp>

consteval
std::underlying_type_t<SymbolKind>
countSymbolKind();

Return Value

Number of SymbolKind values generated from SymbolNodes.inc.

Synopses

Declared in <mrdocs/Support/Handlebars.hpp>

Create child data objects.

dom::Object
createFrame(dom::Object const& parent);

» more...

dom::Object
createFrame(dom::Value const& parent);

» more...

dom::Object
createFrame(
    dom::Object const& child,
    dom::Object const& parent);

» more...

Return Value

The overlay object

Parameters

Name	Description
parent	The underlying frame object

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

dom::Object
createFrame(dom::Object const& parent);

Description

This function can be used by block helpers to create child data objects.

The child data object is an overlay frame object implementation that will first look for a value in the child object and if not found will look in the parent object.

Helpers that modify the data state should create a new frame object when doing so, to isolate themselves and avoid corrupting the state of any parents.

Generally, only one frame needs to be created per helper execution. For example, the each iterator creates a single frame which is reused for all child execution.

Return Value

The overlay object

Parameters

Name	Description
parent	The underlying frame object

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

dom::Object
createFrame(dom::Value const& parent);

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

dom::Object
createFrame(
    dom::Object const& child,
    dom::Object const& parent);

Synopses

Declared in <mrdocs/ADT/Polymorphic.hpp>

Dynamic cast returning pointer or nullptr.

template<
    class To,
    class From>
requires ( std::derived_from<std::remove_cvref_t<To>, std::remove_cvref_t<From>> )
[[nodiscard]]
std::add_pointer_t<std::remove_reference_t<To>>
dyn_cast(Polymorphic<From>& p) noexcept;

» more...

Dynamic cast returning pointer or nullptr (const overload).

template<
    class To,
    class From>
requires ( std::derived_from<std::remove_cvref_t<To>, std::remove_cvref_t<From>> )
[[nodiscard]]
std::add_pointer_t<std::remove_reference_t<To> const>
dyn_cast(Polymorphic<From> const& p) noexcept;

» more...

Return Value

Pointer to To if the dynamic cast succeeds, otherwise nullptr.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

template<
    class To,
    class From>
requires ( std::derived_from<std::remove_cvref_t<To>, std::remove_cvref_t<From>> )
[[nodiscard]]
std::add_pointer_t<std::remove_reference_t<To>>
dyn_cast(Polymorphic<From>& p) noexcept;

Return Value

Pointer to To if the dynamic cast succeeds, otherwise nullptr.

Parameters

Name	Description
p	A polymorphic value-type.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

template<
    class To,
    class From>
requires ( std::derived_from<std::remove_cvref_t<To>, std::remove_cvref_t<From>> )
[[nodiscard]]
std::add_pointer_t<std::remove_reference_t<To> const>
dyn_cast(Polymorphic<From> const& p) noexcept;

Return Value

Pointer to To if the dynamic cast succeeds, otherwise nullptr.

Parameters

Name	Description
p	A polymorphic value-type.

Synopses

Declared in <mrdocs/ADT/Polymorphic.hpp>

Dynamic cast if pointer is non-null and engaged, else nullptr.

template<
    class To,
    class From>
requires ( std::derived_from<std::remove_cvref_t<To>, std::remove_cvref_t<From>> )
[[nodiscard]]
std::add_pointer_t<std::remove_reference_t<To>>
dyn_cast_or_null(Polymorphic<From>* pp) noexcept;

» more...

Dynamic cast if pointer is non-null and engaged, else nullptr (const).

template<
    class To,
    class From>
requires ( std::derived_from<std::remove_cvref_t<To>, std::remove_cvref_t<From>> )
[[nodiscard]]
std::add_pointer_t<std::remove_reference_t<To> const>
dyn_cast_or_null(Polymorphic<From> const* pp) noexcept;

» more...

Return Value

Pointer to To when the cast succeeds, otherwise nullptr.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

template<
    class To,
    class From>
requires ( std::derived_from<std::remove_cvref_t<To>, std::remove_cvref_t<From>> )
[[nodiscard]]
std::add_pointer_t<std::remove_reference_t<To>>
dyn_cast_or_null(Polymorphic<From>* pp) noexcept;

Return Value

Pointer to To when the cast succeeds, otherwise nullptr.

Parameters

Name	Description
pp	A polymorphic value-type.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

template<
    class To,
    class From>
requires ( std::derived_from<std::remove_cvref_t<To>, std::remove_cvref_t<From>> )
[[nodiscard]]
std::add_pointer_t<std::remove_reference_t<To> const>
dyn_cast_or_null(Polymorphic<From> const* pp) noexcept;

Return Value

Pointer to To when the cast succeeds, otherwise nullptr.

Parameters

Name	Description
pp	A polymorphic value-type.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
bool
endsWithOneOf(
    std::string_view s,
    std::string_view chars) noexcept;

Return Value

if a string ends with one of the specified characters

Parameters

Name	Description
s	The string to check.
chars	The characters to check for.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

void
escapeExpression(
    OutputRef out,
    std::string_view str,
    HandlebarsOptions const& opt);

Synopsis

Declared in <mrdocs/Generator.hpp>

Generator const*
findGenerator(std::string_view id) noexcept;

Thread Safety

This function is thread-safe and may be called concurrently from multiple threads.

Return Value

A pointer to the generator, or nullptr if no generator with the given id exists.

Parameters

Name	Description
id	The symbolic name of the generator. The name must be an exact match, including case.

Synopsis

Declared in <mrdocs/Support/Algorithm.hpp>

template<
    std::ranges::range Range,
    std::ranges::range Els>
requires std::equality_comparable_with<std::ranges::range_value_t<Els>, std::ranges::range_value_t<Range>>
auto
find_last_of(
    Range&& range,
    Els&& els);

Return Value

An iterator to the last element found, or std::ranges::end(range) if not found.

Parameters

Name	Description
range	The range to search.
els	The elements to search for.

Synopses

Declared in <mrdocs/Support/Path.hpp>

Call a function for each file in a directory.

Expected<void>
forEachFile(
    std::string_view dirPath,
    bool recursive,
    AnyFileVisitor& visitor);

» more...

Visit each file in a directory.

template<class Visitor>
Expected<void>
forEachFile(
    std::string_view dirPath,
    bool recursive,
    Visitor&& visitor);

» more...

Return Value

An error if any occurred.

Parameters

Name	Description
dirPath	The path to the directory.
recursive	If true, files in subdirectories are also visited, recursively.
visitor	The visitor to invoke for each file.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

Expected<void>
forEachFile(
    std::string_view dirPath,
    bool recursive,
    AnyFileVisitor& visitor);

Description

This will iterate all the regular files in a directory and invoke the visitor with the path.

Return Value

An error if any occurred.

Parameters

Name	Description
dirPath	The path to the directory.
recursive	If true, files in subdirectories are also visited, recursively.
visitor	The visitor to invoke for each file.

Synopsis

Declared in <mrdocs/Support/Path.hpp>

template<class Visitor>
Expected<void>
forEachFile(
    std::string_view dirPath,
    bool recursive,
    Visitor&& visitor);

Return Value

An error if any occurred.

Parameters

Name	Description
dirPath	The path to the directory.
recursive	If true, files in subdirectories are also visited, recursively.
visitor	A callable object which is invoked for each file. This visitor might return `void` or `Expected<void>`.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

template<class... Args>
Error
formatError(
    FormatString<Args...> fs,
    Args&&... args);

Return Value

a formatted error.

Parameters

Name	Description
fs	The format string. This must not be empty.
args	Zero or more values to substitute into the format string.

Synopsis

Declared in <mrdocs/Metadata/Type/FundamentalTypeKind.hpp>

bool
fromString(
    std::string_view str,
    FundamentalTypeKind& kind) noexcept;

Description

This function converts a string to a FundamentalTypeKind.

All variations of the type specifiers are supported.

However, the "long long" specifier cannot be split into two separate specifiers.

Return Value

true if the string was successfully converted

Parameters

Name	Description
str	The string to convert
kind [out]	The resulting FundamentalTypeKind

Synopsis

Declared in <mrdocs/Metadata/Symbol/Record.hpp>

constexpr
std::string_view
getDefaultAccessString(RecordKeyKind const& kind) noexcept;

Return Value

the default accessibility for a record key kind.

Parameters

Name	Description
kind	The kind of record: struct, class, or union.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/OperatorKind.hpp>

OperatorKind
getOperatorKind(std::string_view name) noexcept;

Return Value

The OperatorKind, or OperatorKind::None if not recognized.

Parameters

Name	Description
name	The operator name, e.g. `operator+`, `operator++`, `operator[]`, etc.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/OperatorKind.hpp>

OperatorKind
getOperatorKindFromSuffix(std::string_view suffix) noexcept;

Return Value

The OperatorKind, or OperatorKind::None if not recognized.

Parameters

Name	Description
suffix	The operator suffix, e.g. `+`, `++`, `[]`, etc.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/OperatorKind.hpp>

std::string_view
getOperatorName(
    OperatorKind kind,
    bool include_keyword = false) noexcept;

Return Value

the name of an operator as a string.

Parameters

Name	Description
kind	The kind of operator.
include_keyword	Whether the name should be prefixed with the `operator` keyword.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/OperatorKind.hpp>

Optional<std::string_view>
getOperatorReadableName(
    OperatorKind kind,
    int nParams);

Return Value

The readable name, or nullopt if the operator is not recognized.

Parameters

Name	Description
kind	The kind of operator.
nParams	The number of parameters the operator takes.

Synopses

Declared in <mrdocs/Corpus.hpp>

Return a list of the parent symbols of the specified Symbol.

std::vector<SymbolID>
getParents(
    Corpus const& C,
    Symbol const& I);

» more...

Return a list of the parent symbols of the specified Info.

dom::Array
getParents(
    DomCorpus const& C,
    Symbol const& I);

» more...

Synopsis

Declared in <mrdocs/Corpus.hpp>

std::vector<SymbolID>
getParents(
    Corpus const& C,
    Symbol const& I);

Return Value

a list of the parent symbols of the specified Symbol.

Parameters

Name	Description
C	The collection of declarations in extracted form.
I	Base class with common properties of all symbols

Synopsis

Declared in <mrdocs/Metadata/DomCorpus.hpp>

dom::Array
getParents(
    DomCorpus const& C,
    Symbol const& I);

Return Value

a list of the parent symbols of the specified Info.

Parameters

Name	Description
C	Front-end factory for producing Dom nodes.
I	Base class with common properties of all symbols

Synopses

Declared in <mrdocs/Metadata/Symbol/Source.hpp>

Determine a location to use when none is explicitly chosen.

Optional<Location>
getPrimaryLocation(Symbol const& I);

» more...

Choose the best location to display for a symbol.

Optional<Location>
getPrimaryLocation(
    SourceInfo const& I,
    bool preferDefinition);

» more...

Return Value

The preferred location if available.

Parameters

Name	Description
I	Source info to examine.
preferDefinition	If true, favor a definition location.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

Optional<Location>
getPrimaryLocation(Symbol const& I);

Return Value

a location to use when none is explicitly chosen.

Parameters

Name	Description
I	Base class with common properties of all symbols

Synopsis

Declared in <mrdocs/Metadata/Symbol/Source.hpp>

Optional<Location>
getPrimaryLocation(
    SourceInfo const& I,
    bool preferDefinition);

Return Value

The preferred location if available.

Parameters

Name	Description
I	Source info to examine.
preferDefinition	If true, favor a definition location.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/OperatorKind.hpp>

std::string_view
getSafeOperatorName(
    OperatorKind kind,
    bool include_keyword = false) noexcept;

Return Value

the safe name of an operator as a string.

Parameters

Name	Description
kind	The kind of operator.
include_keyword	Whether the name should be prefixed with `operator_`.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/OperatorKind.hpp>

std::string_view
getShortOperatorName(OperatorKind kind) noexcept;

Return Value

the short name of an operator as a string.

Parameters

Name	Description
kind	Operator kinds

Synopsis

Declared in <mrdocs/Generator.hpp>

Expected<std::string>
getSinglePageFullPath(
    std::string_view outputPath,
    std::string_view extension);

Description

This function determines the full path for a single-page output file based on the provided outputPath and file extension.

If the outputPath already exists:

If it is a directory, appends the default file name with the provided extension.
If it is a file, uses the provided outputPath directly.

If the outputPath does not exist:

If it ends with a '/', assumes it is a directory and appends the default file name.
Otherwise, it returns an error because the path is ambiguous.

Return Value

The full path or an error if the outputPath is ambiguous.

Parameters

Name	Description
outputPath	The specified output path, which can be a directory or file.
extension	The file extension to use for single-page output.

Synopses

Declared in <mrdocs/Metadata/Type.hpp>

Return the inner type.

Optional<Polymorphic<Type>&>
innerType(Type& TI) noexcept;

» more...

Return the inner type.

Optional<Polymorphic<Type> const&>
innerType(Type const& TI) noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/Type.hpp>

Optional<Polymorphic<Type>&>
innerType(Type& TI) noexcept;

Description

The inner type is the type that is modified by a specifier (e.g. "int" in "pointer to int").

Return Value

the inner type.

Parameters

Name	Description
TI	A possibly qualified type.

Synopsis

Declared in <mrdocs/Metadata/Type.hpp>

Optional<Polymorphic<Type> const&>
innerType(Type const& TI) noexcept;

Description

The inner type is the type that is modified by a specifier (e.g. "int" in "pointer to int").

Return Value

the inner type.

Parameters

Name	Description
TI	A possibly qualified type.

Synopses

Declared in <mrdocs/Metadata/Type.hpp>

Return the inner type.

Type*
innerTypePtr(Type& TI) noexcept;

» more...

Return the inner type.

Type const*
innerTypePtr(Type const& TI) noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/Type.hpp>

Type*
innerTypePtr(Type& TI) noexcept;

Description

The inner type is the type that is modified by a specifier (e.g. "int" in "pointer to int").

Return Value

the inner type.

Parameters

Name	Description
TI	A possibly qualified type.

Synopsis

Declared in <mrdocs/Metadata/Type.hpp>

Type const*
innerTypePtr(Type const& TI) noexcept;

Description

The inner type is the type that is modified by a specifier (e.g. "int" in "pointer to int").

Return Value

the inner type.

Parameters

Name	Description
TI	A possibly qualified type.

Synopses

Declared in <mrdocs/Metadata/Type.hpp>

Return the innermost type (mutable overload).

Polymorphic<Type>&
innermostType(Polymorphic<Type>& TI) noexcept;

» more...

Return the innermost type.

Polymorphic<Type> const&
innermostType(Polymorphic<Type> const& TI) noexcept;

» more...

Synopsis

Declared in <mrdocs/Metadata/Type.hpp>

Polymorphic<Type>&
innermostType(Polymorphic<Type>& TI) noexcept;

Return Value

the innermost type (mutable overload).

Parameters

Name	Description
TI	A polymorphic value-type.

Synopsis

Declared in <mrdocs/Metadata/Type.hpp>

Polymorphic<Type> const&
innermostType(Polymorphic<Type> const& TI) noexcept;

Description

The innermost type is the type which is not modified by any specifiers (e.g. "int" in "pointer to const int").

If the type has an inner type, we recursively call this function until we reach the innermost type. If the type has no inner type, we return the current type.

Return Value

the innermost type.

Parameters

Name	Description
TI	A polymorphic value-type.

Synopsis

Declared in <mrdocs/Generator.hpp>

Expected<void>
installGenerator(std::unique_ptr<Generator> G);

Description

This function registers a generator with the global generator registry, making it available for use.

Plugins can use this function to register custom generators.

Thread Safety

This function is thread-safe and may be called concurrently from multiple threads.

Return Value

An error if a generator with the same id already exists.

Parameters

Name	Description
G	The generator to install. Ownership is transferred to the registry.

Synopses

Declared in <mrdocs/Support/String.hpp>

Determine if a character is ASCII alphanumeric.

constexpr
bool
isAlphaNumeric(char const c) noexcept;

» more...

Determine if every character in a string is ASCII alphanumeric.

constexpr
bool
isAlphaNumeric(std::string_view const s) noexcept;

» more...

Return Value

true if c is an ASCII letter or digit.
true if all characters are ASCII letters or digits.

Parameters

Name	Description
c	Character to inspect.
s	String to inspect.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
bool
isAlphaNumeric(char const c) noexcept;

Return Value

true if c is an ASCII letter or digit.

Parameters

Name	Description
c	Character to inspect.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
bool
isAlphaNumeric(std::string_view const s) noexcept;

Return Value

true if all characters are ASCII letters or digits.

Parameters

Name	Description
s	String to inspect.

Synopses

Declared in <mrdocs/Support/String.hpp>

Determine if a character is an ASCII letter.

constexpr
bool
isAlphabetic(char const c) noexcept;

» more...

Determine if every character in a string is an ASCII letter.

constexpr
bool
isAlphabetic(std::string_view const s) noexcept;

» more...

Return Value

true if c is in the ranges 'a'-'z' or 'A'-'Z'.
true if all characters are alphabetic.

Parameters

Name	Description
c	Character to inspect.
s	String to inspect.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
bool
isAlphabetic(char const c) noexcept;

Return Value

true if c is in the ranges 'a'-'z' or 'A'-'Z'.

Parameters

Name	Description
c	Character to inspect.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
bool
isAlphabetic(std::string_view const s) noexcept;

Return Value

true if all characters are alphabetic.

Parameters

Name	Description
s	String to inspect.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/OperatorKind.hpp>

bool
isBinaryOperator(OperatorKind kind) noexcept;

Return Value

whether the operator is potentially binary.

Parameters

Name	Description
kind	Operator kinds

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool
isCopyAssignment(FunctionSymbol const& func);

Description

A copy assignment operator is a non-template operator= whose parameter is of type X, X&, const X&, volatile X&, or const volatile X& ([class.copy.assign]).

Return Value

Whether func is a copy assignment operator.

Parameters

Name	Description
func	The function to check.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool
isCopyConstructor(FunctionSymbol const& func);

Description

A copy constructor is a non-template constructor whose first parameter is an lvalue reference to the possibly cv-qualified record type, with all remaining parameters having defaults ([class.copy.ctor]).

Return Value

Whether func is a copy constructor.

Parameters

Name	Description
func	The function to check.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool
isDefaultConstructor(FunctionSymbol const& func);

Description

A default constructor is a constructor for which each parameter that is not a function parameter pack has a default argument (including the case of a constructor with no parameters) ([class.default.ctor]).

Return Value

Whether func is a default constructor.

Parameters

Name	Description
func	The function to check.

Synopses

Declared in <mrdocs/Support/String.hpp>

Determine if a character is an ASCII digit.

constexpr
bool
isDigit(char const c) noexcept;

» more...

Determine if every character in a string is an ASCII digit.

constexpr
bool
isDigit(std::string_view const s) noexcept;

» more...

Return Value

true if c is between '0' and '9'.
true if all characters are digits.

Parameters

Name	Description
c	Character to inspect.
s	String to inspect.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
bool
isDigit(char const c) noexcept;

Return Value

true if c is between '0' and '9'.

Parameters

Name	Description
c	Character to inspect.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
bool
isDigit(std::string_view const s) noexcept;

Return Value

true if all characters are digits.

Parameters

Name	Description
s	String to inspect.

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

bool
isEmpty(dom::Value const& arg);

Description

This is used by the built-in if and with helpers to control their execution flow.

The Handlebars definition of empty is any of:

Array with length 0
falsy values other than 0

This is intended to match the Mustache Behaviour.

Return Value

True if the value is empty, false otherwise

Parameters

Name	Description
arg	The value to test

Synopses

Declared in <mrdocs/Support/String.hpp>

Determine if a character is a lowercase ASCII letter.

constexpr
bool
isLowerCase(char const c) noexcept;

» more...

Determine if every character in a string is lowercase ASCII.

constexpr
bool
isLowerCase(std::string_view const s) noexcept;

» more...

Return Value

true if c is in the range 'a' to 'z'.
true if all characters are lowercase ASCII letters.

Parameters

Name	Description
c	Character to inspect.
s	String to inspect.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
bool
isLowerCase(char const c) noexcept;

Return Value

true if c is in the range 'a' to 'z'.

Parameters

Name	Description
c	Character to inspect.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
bool
isLowerCase(std::string_view const s) noexcept;

Return Value

true if all characters are lowercase ASCII letters.

Parameters

Name	Description
s	String to inspect.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool
isMoveAssignment(FunctionSymbol const& func);

Description

A move assignment operator is a non-template operator= whose parameter is an rvalue reference to the possibly cv-qualified record type ([class.copy.assign]).

Return Value

Whether func is a move assignment operator.

Parameters

Name	Description
func	The function to check.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool
isMoveConstructor(FunctionSymbol const& func);

Description

A move constructor is a non-template constructor whose first parameter is an rvalue reference to the possibly cv-qualified record type, with all remaining parameters having defaults ([class.copy.ctor]).

Return Value

Whether func is a move constructor.

Parameters

Name	Description
func	The function to check.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool
isSpecialMemberFunction(FunctionSymbol const& func);

Description

A special member function is a default constructor, copy/move constructor, copy/move assignment operator, or destructor ([special]).

Return Value

Whether func is a special member function.

Parameters

Name	Description
func	The function to check.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/OperatorKind.hpp>

bool
isUnaryOperator(OperatorKind kind) noexcept;

Return Value

whether the operator is potentially unary.

Parameters

Name	Description
kind	Operator kinds

Synopses

Declared in <mrdocs/Support/String.hpp>

Determine if a character is an uppercase ASCII letter.

constexpr
bool
isUpperCase(char const c) noexcept;

» more...

Determine if every character in a string is uppercase ASCII.

constexpr
bool
isUpperCase(std::string_view const s) noexcept;

» more...

Return Value

true if c is in the range 'A' to 'Z'.
true if all characters are uppercase ASCII letters.

Parameters

Name	Description
c	Character to inspect.
s	String to inspect.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
bool
isUpperCase(char const c) noexcept;

Return Value

true if c is in the range 'A' to 'Z'.

Parameters

Name	Description
c	Character to inspect.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
bool
isUpperCase(std::string_view const s) noexcept;

Return Value

true if all characters are uppercase ASCII letters.

Parameters

Name	Description
s	String to inspect.

Synopses

Declared in <mrdocs/Support/String.hpp>

Determine if a character is whitespace.

constexpr
bool
isWhitespace(char c) noexcept;

» more...

Determine if a string is only whitespace.

constexpr
bool
isWhitespace(std::string_view s) noexcept;

» more...

Return Value

true if c is a horizontal or vertical whitespace character.
true if the string is empty or contains only whitespace characters (space, tab, newline, vertical tab, form feed, carriage return). false otherwise.

Parameters

Name	Description
c	Character to inspect.
s	The string to check.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
bool
isWhitespace(char c) noexcept;

Return Value

true if c is a horizontal or vertical whitespace character.

Parameters

Name	Description
c	Character to inspect.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
bool
isWhitespace(std::string_view s) noexcept;

Return Value

true if the string is empty or contains only whitespace characters (space, tab, newline, vertical tab, form feed, carriage return). false otherwise.

Parameters

Name	Description
s	The string to check.

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

template<has_nullable_traits_v T>
bool
is_null(T const& v) noexcept(noexcept(nullable_traits<T>::is_null(v)));

Return Value

true if v is null, false otherwise.

Parameters

Name	Description
v	The value to test for null.

Synopses

Declared in <mrdocs/Support/Algorithm.hpp>

Determine if an element is equal to any of the elements in the specified range.

template<
    class El,
    std::ranges::range Range>
requires std::equality_comparable_with<std::ranges::range_value_t<Range>, El>
bool
is_one_of(
    El const& el,
    Range const& range);

» more...

Determine if an element is equal to any of the elements in the specified range.

template<
    class U,
    class T>
requires std::equality_comparable_with<U, T>
bool
is_one_of(
    U const& el,
    std::initializer_list<T> const& range);

» more...

Return Value

True if the element is found, false otherwise.

Parameters

Name	Description
el	The element to search for.
range	The range to search.

Synopsis

Declared in <mrdocs/Support/Algorithm.hpp>

template<
    class El,
    std::ranges::range Range>
requires std::equality_comparable_with<std::ranges::range_value_t<Range>, El>
bool
is_one_of(
    El const& el,
    Range const& range);

Return Value

True if the element is found, false otherwise.

Parameters

Name	Description
el	The element to search for.
range	The range to search.

Synopsis

Declared in <mrdocs/Support/Algorithm.hpp>

template<
    class U,
    class T>
requires std::equality_comparable_with<U, T>
bool
is_one_of(
    U const& el,
    std::initializer_list<T> const& range);

Return Value

True if the element is found, false otherwise.

Parameters

Name	Description
el	The element to search for.
range	The range to search.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

template<
    class To,
    class From>
requires ( std::derived_from<std::remove_cvref_t<To>, std::remove_cvref_t<From>> )
[[nodiscard]]
bool
isa(Polymorphic<From> const& p) noexcept;

Return Value

true if the polymorphic object holds a value of type To.

Parameters

Name	Description
p	A polymorphic value-type.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

template<
    class To,
    class From>
requires ( std::derived_from<std::remove_cvref_t<To>, std::remove_cvref_t<From>> )
[[nodiscard]]
bool
isa_or_null(Polymorphic<From> const* pp) noexcept;

Return Value

true if pointer is non-null and referent is of type To.

Parameters

Name	Description
pp	A polymorphic value-type.

Synopsis

Declared in <mrdocs/Metadata/Symbol/ExtractionMode.hpp>

constexpr
ExtractionMode
leastSpecific(
    ExtractionMode const a,
    ExtractionMode const b) noexcept;

Description

This function returns the least specific of the two ExtractionModes in terms of the number of filters passed.

If the symbol passes the filter that categorizes it as a, then it also passes the filter that categorizes it as b (or vice-versa), then this function will return the final category for the symbol.

Return Value

Determine why a symbol is extracted

Parameters

Name	Description
a	Determine why a symbol is extracted
b	Determine why a symbol is extracted

Synopses

Declared in <mrdocs/Support/String.hpp>

Return the substring without leading horizontal whitespace.

constexpr
std::string_view
ltrim(std::string_view const s) noexcept;

» more...

Return the substring without leading specified characters.

constexpr
std::string_view
ltrim(
    std::string_view const s,
    std::string_view const chars) noexcept;

» more...

Return Value

The modified string.

Parameters

Name	Description
s	The string to trim.
chars	The characters to remove.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
std::string_view
ltrim(std::string_view const s) noexcept;

Return Value

The modified string.

Parameters

Name	Description
s	The string to trim.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
std::string_view
ltrim(
    std::string_view const s,
    std::string_view const chars) noexcept;

Return Value

The modified string.

Parameters

Name	Description
s	The string to trim.
chars	The characters to remove.

Synopsis

Declared in <mrdocs/Metadata/Type/FundamentalTypeKind.hpp>

bool
makeChar(FundamentalTypeKind& kind) noexcept;

Description

If applying the "char" specifier to a type that might have been declared only with "signed/unsigned" or "short/long" specifiers, the function changes the type and returns true.

For instance, applying "char" to FundamentalTypeKind::Int ("int", which could be declared as "signed") results in FundamentalTypeKind::SignedChar ("signed char").

Return Value

Whether the operation was successful

Parameters

Name	Description
kind [in]	The type to modify

Synopsis

Declared in <mrdocs/Metadata/Type/FundamentalTypeKind.hpp>

bool
makeLong(FundamentalTypeKind& kind) noexcept;

Description

If applying "long" the specifier is a valid operation the function changes the type and returns true.

For instance, applying "long" to FundamentalTypeKind::Int ("int") results in FundamentalTypeKind::Long ("long int").

Return Value

Whether the operation was successful

Parameters

Name	Description
kind [in]	The type to modify

Synopsis

Declared in <mrdocs/ADT/Overload.hpp>

template<class... Ts>
[[nodiscard]]
constexpr
Overload<std::decay_t<Ts>...>
makeOverload(Ts&&... xs) noexcept((std::is_nothrow_constructible_v<std::decay_t<Ts>, Ts &&> && ...));

Description

Prefer this over constructing Overload directly when you need perfect forwarding and decayed storage.


auto visitor = fn::makeOverload(
     [](int) { return 1; },
     [](double) { return 2; }
);

Return Value

An Overload whose base classes are the decayed types of the provided callables.

Parameters

Name	Description
xs	The callables to combine.

Synopsis

Declared in <mrdocs/Metadata/Type/FundamentalTypeKind.hpp>

bool
makeShort(FundamentalTypeKind& kind) noexcept;

Description

If applying "short" the specifier is a valid operation the function changes the type and returns true.

For instance, applying "short" to FundamentalTypeKind::Int ("int") results in FundamentalTypeKind::Short ("short int").

Return Value

Whether the operation was successful

Parameters

Name	Description
kind [in]	The type to modify

Synopsis

Declared in <mrdocs/Metadata/Type/FundamentalTypeKind.hpp>

bool
makeSigned(FundamentalTypeKind& kind) noexcept;

Description

If applying the "signed" specifier is a valid operation the function changes the type and returns true.

For instance, applying "signed" to FundamentalTypeKind::Char ("char") results in FundamentalTypeKind::SignedChar ("signed char").

It also returns true if applying the "signed" specifier is a valid operation but doesn't affect the type.

For instance, applying "signed" to FundamentalTypeKind::Int ("int") doesn't change the type but returns true, even though FundamentalTypeKind::Int could be declared as "int" or "signed" and multiple "signed" specifiers are not allowed.

Return Value

Whether the operation was successful

Parameters

Name	Description
kind [in]	The type to modify

Synopsis

Declared in <mrdocs/Metadata/Type/FundamentalTypeKind.hpp>

bool
makeUnsigned(FundamentalTypeKind& kind) noexcept;

Description

If applying the "unsigned" specifier is a valid operation the function changes the type and returns true.

For instance, applying "unsigned" to FundamentalTypeKind::Char ("char") results in FundamentalTypeKind::UnsignedChar ("unsigned char") and applying "unsigned" to FundamentalTypeKind::Int ("int") results in FundamentalTypeKind::UnsignedInt ("unsigned int").

Return Value

Whether the operation was successful

Parameters

Name	Description
kind [in]	The type to modify

Synopsis

Declared in <mrdocs/Support/Visitor.hpp>

template<
    typename BaseTy,
    typename ObjectTy,
    typename FnTy,
    typename... ArgsTy>
auto
makeVisitor(
    ObjectTy&& obj,
    FnTy&& fn,
    ArgsTy&&... args);

Description

The returned visitor is an object with a template method visit which can be called with a derived type of the object being visited.

The visitor stores the arguments args passed to this function, and its method visit calls the function fn with the derived type as the first argument, followed by args.

Return Value

The common return type of fn when called with a derived type of obj and args

Parameters

Name	Description
obj	The object to visit
fn	The function object to call
args	The arguments to pass to the function object

Synopses

Declared in <mrdocs/ADT/ArrayView.hpp>

Create an ArrayView from a C-style array.

template<
    class T,
    std::size_t N>
constexpr
ArrayView<T>
make_array_view(T const(& arr)[N]) noexcept;

» more...

Create an ArrayView from a pointer and count.

template<class T>
constexpr
ArrayView<T>
make_array_view(
    T const* data,
    std::size_t count) noexcept;

» more...

Return Value

View over the provided array.
View over the provided range.

Parameters

Name	Description
arr	Array to view.
data	Pointer to the first element.
count	Number of elements.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

template<
    class T,
    std::size_t N>
constexpr
ArrayView<T>
make_array_view(T const(& arr)[N]) noexcept;

Return Value

View over the provided array.

Parameters

Name	Description
arr	Array to view.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

template<class T>
constexpr
ArrayView<T>
make_array_view(
    T const* data,
    std::size_t count) noexcept;

Return Value

View over the provided range.

Parameters

Name	Description
data	Pointer to the first element.
count	Number of elements.

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

template<has_nullable_traits_v T>
void
make_null(T& v) noexcept(noexcept(nullable_traits<T>::make_null(v)));

Parameters

Name	Description
v	The value to make null.

Synopses

Declared in <mrdocs/Support/MapReflectedType.hpp>

Map all described members without converting values.

template<
    bool isMostDerived,
    typename IO,
    typename T>
requires describe::has_describe_members<T>::value
void
mapReflectedType(
    IO& io,
    T const& obj);

» more...

Automatically map all described members of a type to the DOM.

template<
    bool isMostDerived,
    typename IO,
    typename T>
requires describe::has_describe_members<T>::value
void
mapReflectedType(
    IO& io,
    T const& obj,
    DomCorpus const* domCorpus);

» more...

Template Parameters

Name	Description
isMostDerived	Whether this is the most-derived type (adds $meta if true).

Parameters

Name	Description
io	The IO object to use for mapping.
obj	The object to be mapped.
domCorpus	The DomCorpus used to create the DOM values, or a null pointer.

Synopsis

Declared in <mrdocs/Support/MapReflectedType.hpp>

template<
    bool isMostDerived,
    typename IO,
    typename T>
requires describe::has_describe_members<T>::value
void
mapReflectedType(
    IO& io,
    T const& obj);

Description

This version passes raw member values to io.map(), letting the IO object handle conversion with its stored context.

Template Parameters

Name	Description
isMostDerived	Whether this is the most-derived type (adds $meta if true).

Parameters

Name	Description
io	The IO object to use for mapping.
obj	The object to be mapped.

Synopsis

Declared in <mrdocs/Support/MapReflectedType.hpp>

template<
    bool isMostDerived,
    typename IO,
    typename T>
requires describe::has_describe_members<T>::value
void
mapReflectedType(
    IO& io,
    T const& obj,
    DomCorpus const* domCorpus);

Template Parameters

Name	Description
isMostDerived	Whether this is the most-derived type. When true, adds the $meta object.

Parameters

Name	Description
io	The IO object to use for mapping.
obj	The object to be mapped.
domCorpus	The DomCorpus used to create the DOM values, or a null pointer.

Synopsis

Declared in <mrdocs/ADT/Overload.hpp>

template<
    class Variant,
    class... Ts>
constexpr
decltype(auto)
match(
    Variant&& v,
    Ts&&... xs);

Description

This is a convenience wrapper around std::visit(makeOverload(...), variant). It forwards the variant and the callables and returns whatever std::visit returns.


std::variant<int, std::string> v = 42;
auto r = fn::match(v,
    [](int i) { return i + 1; },
    [](const std::string& s) { return s.size(); }
);

Return Value

The result of std::visit.

Parameters

Name	Description
v	The variant to visit (can be lvalue or rvalue; const-qualification is preserved).
xs	The callables to be combined with makeOverload and passed to std::visit.

Synopses

Declared in <mrdocs/Metadata/Expression.hpp>

Append blocks from other into I, preserving order.

void
merge(
    DocComment& I,
    DocComment&& other);

» more...

Merge metadata from another expression.

void
merge(
    ExprInfo& I,
    ExprInfo&& Other);

» more...

Merge two ExtractionMode values.

void
merge(
    ExtractionMode& dst,
    ExtractionMode&& src) noexcept;

» more...

Merge the location sets, preferring existing def/primary.

void
merge(
    SourceInfo& I,
    SourceInfo const& Other);

» more...

Merge, transferring ownership from the right-hand side.

void
merge(
    SourceInfo& I,
    SourceInfo&& Other);

» more...

Merge partial template info, filling missing pieces.

void
merge(
    TemplateInfo& I,
    TemplateInfo&& Other);

» more...

Merge friend declarations, deduplicating by symbol ID.

void
merge(
    std::vector<FriendInfo>& dst,
    std::vector<FriendInfo>&& src);

» more...

Merge parameters element-wise, appending extras from src.

void
merge(
    std::vector<Param>& dst,
    std::vector<Param>&& src);

» more...

Merges two Symbol objects according to the behavior of the derived class.

template<polymorphic_storage_for<Symbol> SymbolTy>
void
merge(
    SymbolTy& I,
    SymbolTy&& Other);

» more...

Generic merge for any described type.

template<typename T>
requires describe::has_describe_members<T>::value
void
merge(
    T& dst,
    T&& src);

» more...

Merge metadata from another constant expression.

template<class T>
static
void
merge(
    ConstantExprInfo<T>& I,
    ConstantExprInfo<T>&& Other);

» more...

Template Parameters

Name	Description
T	The type to merge (must have MRDOCS_DESCRIBE_STRUCT).

Parameters

Name	Description
dst	The destination.
src	The source (moved from).
I	The Symbol object to merge into.
Other	The Symbol object to merge from.

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

void
merge(
    DocComment& I,
    DocComment&& other);

Parameters

Name	Description
I	A processed documentation comment attached to a declaration.
other	A processed documentation comment attached to a declaration.

Synopsis

Declared in <mrdocs/Metadata/Expression.hpp>

void
merge(
    ExprInfo& I,
    ExprInfo&& Other);

Parameters

Name	Description
I	Represents an expression
Other	Represents an expression

Synopsis

Declared in <mrdocs/Metadata/Symbol/ExtractionMode.hpp>

void
merge(
    ExtractionMode& dst,
    ExtractionMode&& src) noexcept;

Description

Takes the least specific (most conservative) of the two, so that a symbol demoted in any TU stays demoted.

Parameters

Name	Description
dst	Determine why a symbol is extracted
src	Determine why a symbol is extracted

Synopsis

Declared in <mrdocs/Metadata/Symbol/Source.hpp>

void
merge(
    SourceInfo& I,
    SourceInfo const& Other);

Parameters

Name	Description
I	Stores source information for a declaration.
Other	Stores source information for a declaration.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Source.hpp>

void
merge(
    SourceInfo& I,
    SourceInfo&& Other);

Parameters

Name	Description
I	Stores source information for a declaration.
Other	Stores source information for a declaration.

Synopsis

Declared in <mrdocs/Metadata/Template.hpp>

void
merge(
    TemplateInfo& I,
    TemplateInfo&& Other);

Parameters

Name	Description
I	Information about templates and specializations thereof.
Other	Information about templates and specializations thereof.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Friend.hpp>

void
merge(
    std::vector<FriendInfo>& dst,
    std::vector<FriendInfo>&& src);

Parameters

Name	Description
dst	The destination.
src	The source (moved from).

Synopsis

Declared in <mrdocs/Metadata/Symbol/Param.hpp>

void
merge(
    std::vector<Param>& dst,
    std::vector<Param>&& src);

Parameters

Name	Description
dst	The destination.
src	The source (moved from).

Synopsis

Declared in <mrdocs/Metadata/Symbol.hpp>

template<polymorphic_storage_for<Symbol> SymbolTy>
void
merge(
    SymbolTy& I,
    SymbolTy&& Other);

Parameters

Name	Description
I	The Symbol object to merge into.
Other	The Symbol object to merge from.

Synopsis

Declared in <mrdocs/Support/MergeReflectedType.hpp>

template<typename T>
requires describe::has_describe_members<T>::value
void
merge(
    T& dst,
    T&& src);

Description

Found via ADL for any type with MRDOCS_DESCRIBE_STRUCT. Non-template overloads (custom merge functions) are preferred by overload resolution, so types with special merge semantics are unaffected.

Iterates base classes (via describe_bases) and own members (via describe_members).

Base classes are merged first by calling `merge(base_dst, base_src)`, which must be found via ADL.

For each own member, a default merge strategy is applied based on the member type (see mergeByType for the full list of strategies).

Template Parameters

Name	Description
T	The type to merge (must have MRDOCS_DESCRIBE_STRUCT).

Parameters

Name	Description
dst	The destination object.
src	The source object. Members are moved from individually.

Synopsis

Declared in <mrdocs/Metadata/Expression.hpp>

template<class T>
static
void
merge(
    ConstantExprInfo<T>& I,
    ConstantExprInfo<T>&& Other);

Parameters

Name	Description
I	Represents an expression with a (possibly known) value
Other	Represents an expression with a (possibly known) value

Synopsis

Declared in <mrdocs/Metadata/Symbol/ExtractionMode.hpp>

constexpr
ExtractionMode
mostSpecific(
    ExtractionMode const a,
    ExtractionMode const b) noexcept;

Description

This function returns the most specific of the two ExtractionModes in terms of number of filters passed.

Return Value

Determine why a symbol is extracted

Parameters

Name	Description
a	Determine why a symbol is extracted
b	Determine why a symbol is extracted

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

template<has_nullable_traits_v T>
T
null_of() noexcept(noexcept(nullable_traits<T>::null()));

Return Value

A null T value.

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

constexpr
auto
operator|(
    R&& r,
    /* implementation-defined */ const& a);

Return Value

View over the lines in r.

Parameters

Name	Description
r	Range to split.
a	SplitLines adaptor instance.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

bool
overrides(
    FunctionSymbol const& base,
    FunctionSymbol const& derived);

Return Value

if one function would override the other

Parameters

Name	Description
base	The base function
derived	The derived function

Synopses

Declared in <mrdocs/Support/Parse.hpp>

Parse a string view

template<HasParse T>
Expected<T>
parse(std::string_view sv);

» more...

Parse a string view

template<HasParse T>
ParseResult
parse(
    std::string_view sv,
    T& value);

» more...

Parameters

Name	Description
sv	The string view to parse
value	The value to store the result

Synopsis

Declared in <mrdocs/Support/Parse.hpp>

template<HasParse T>
Expected<T>
parse(std::string_view sv);

Description

Parse a string view sv as an object of type T. If parsing fails, the function returns an error.

This overload does not return the ParseResult object containing the pointer to the first character not parsed. Instead, the position of the error is calculated and the error message is formatted with the error position.

This function parses a string view sv into a value of type T. The function calls the parse function for the type T with the sv.data() and sv.data() + sv.size() as the first and last pointers, respectively.

If the parse function returns an error, then the function returns the error.

If the parse function returns success, but there are characters left in the string view, then the function returns an error with the message "trailing characters".

Otherwise, it returns the value.

Return Value

A container holding an error or a value.

Parameters

Name	Description
sv	The string view to parse

Synopsis

Declared in <mrdocs/Support/Parse.hpp>

template<HasParse T>
ParseResult
parse(
    std::string_view sv,
    T& value);

Description

This function parses a string view sv into a value of type T. The function calls the parse function for the type T with the sv.data() and sv.data() + sv.size() as the first and last pointers, respectively.

If the parse function returns an error, then the function returns the error.

If the parse function returns success, but there are characters left in the string view, then the function returns an error with the message "trailing characters".

Otherwise, it returns the value.

Return Value

The result of a parse operation.

Parameters

Name	Description
sv	The string view to parse
value	The value to store the result

Synopsis

Declared in <mrdocs/Support/MapReflectedType.hpp>

template<typename T>
constexpr
std::string_view
readableTypeName();

Description

Extracts the name from PRETTY_FUNCTION (Clang/GCC) or FUNCSIG (MSVC).

E.g.: readableTypeName<mrdocs::FunctionSymbol>() -> "FunctionSymbol".

Return Value

the unqualified name of a type.

Synopsis

Declared in <mrdocs/Support/String.hpp>

std::string
reindentCode(
    std::string_view code,
    std::size_t indent = 0);

Return Value

The modified code block.

Parameters

Name	Description
code	The code block to unindent.
indent	The number of spaces to insert in front of each line after trimming.

Synopsis

Declared in <mrdocs/Support/String.hpp>

void
replace(
    std::string& s,
    std::string_view from,
    std::string_view to);

Return Value

The modified string.

Parameters

Name	Description
s	The string to trim.
from	The substring to remove.
to	The substring to replace with. If this is empty, the substring is removed.

Synopses

Declared in <mrdocs/Support/String.hpp>

Return the substring without trailing horizontal whitespace.

constexpr
std::string_view
rtrim(std::string_view const s) noexcept;

» more...

Return the substring without trailing specified characters.

constexpr
std::string_view
rtrim(
    std::string_view const s,
    std::string_view const chars) noexcept;

» more...

Return Value

The modified string.

Parameters

Name	Description
s	The string to trim.
chars	The characters to remove.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
std::string_view
rtrim(std::string_view const s) noexcept;

Return Value

The modified string.

Parameters

Name	Description
s	The string to trim.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
std::string_view
rtrim(
    std::string_view const s,
    std::string_view const chars) noexcept;

Return Value

The modified string.

Parameters

Name	Description
s	The string to trim.
chars	The characters to remove.

Synopses

Declared in <mrdocs/Dom/Value.hpp>

Create a wrapper for a safe string.

dom::Value
safeString(std::string_view str);

» more...

Mark an existing string-like value as safe to emit without escaping.

dom::Value
safeString(dom::Value const& str);

» more...

Return a DOM string ensuring special characters are escaped.

template<std::convertible_to<std::string_view> SV>
dom::Value
safeString(SV const& str);

» more...

Return Value

The safe string wrapper
dom::Value containing the safe string.

Parameters

Name	Description
str	The string to mark as safe

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

dom::Value
safeString(std::string_view str);

Description

This string wrapper prevents the string from being escaped when the template is rendered.

When a helper returns a safe string, it will be marked as safe and will not be escaped when rendered. The string will be rendered as if converted to a dom::Value and rendered as-is.

When constructing the string that will be marked as safe, any external content should be properly escaped using the escapeExpression function to avoid potential security concerns.

Return Value

The safe string wrapper

Parameters

Name	Description
str	The string to mark as safe

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

dom::Value
safeString(dom::Value const& str);

Description

This overload is useful when a helper already produced a dom::Value and only needs to flip the safe-string flag before it is rendered.

Return Value

A variant container for any kind of Dom value.

Parameters

Name	Description
str	A variant container for any kind of Dom value.

Synopsis

Declared in <mrdocs/Dom/Value.hpp>

template<std::convertible_to<std::string_view> SV>
dom::Value
safeString(SV const& str);

Return Value

dom::Value containing the safe string.

Parameters

Name	Description
str	Source string view convertible type.

Synopses

Declared in <mrdocs/Support/SplitLines.hpp>

Split a string view into lines.

constexpr
auto
splitLines(std::string_view sv);

» more...

Split any contiguous character range into lines.

template<std::ranges::contiguous_range R>
requires std::same_as<std::remove_cv_t<std::ranges::range_value_t<R>>, char>
constexpr
auto
splitLines(R&& r);

» more...

Return Value

View over the lines in sv.
View over the lines in the range.

Parameters

Name	Description
sv	Source string.
r	Range of characters.

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

constexpr
auto
splitLines(std::string_view sv);

NOTE

This function is defined as an Algorithm Function Object (AFO).

Return Value

View over the lines in sv.

Parameters

Name	Description
sv	Source string.

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

template<std::ranges::contiguous_range R>
requires std::same_as<std::remove_cv_t<std::ranges::range_value_t<R>>, char>
constexpr
auto
splitLines(R&& r);

NOTE

This function is defined as an Algorithm Function Object (AFO).

Return Value

View over the lines in the range.

Parameters

Name	Description
r	Range of characters.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
bool
startsWithOneOf(
    std::string_view s,
    std::string_view chars) noexcept;

Return Value

if a string starts with one of the specified characters

Parameters

Name	Description
s	The string to check.
chars	The characters to check for.

Synopses

Declared in <mrdocs/ADT/Optional.hpp>

constexpr
void
swap(
    Error& lhs,
    Error& rhs) noexcept;

» more...

constexpr
void
swap(
    Expected& a,
    Expected& b) noexcept(noexcept(a.swap(b)))
requires requires { a.swap(b); };

» more...

Swap contents with another Expected.

constexpr
void
swap(
    Expected& x,
    Expected& y) noexcept(noexcept(x.swap(y)))
requires requires {x.swap(y);};

» more...

constexpr
void
swap(
    Polymorphic& lhs,
    Polymorphic& rhs) noexcept;

» more...

constexpr
void
swap(
    Unexpected& x,
    Unexpected& y) noexcept(noexcept(x.swap(y)))
requires std::is_swappable_v<E>;

» more...

Swap two Optional references.

template<class T>
constexpr
void
swap(
    Optional<T&>& a,
    Optional<T&>& b) noexcept;

» more...

Parameters

Name	Description
a	First optional reference.
b	Second optional reference.

Synopsis

Declared in <mrdocs/Support/Error.hpp>

constexpr
void
swap(
    Error& lhs,
    Error& rhs) noexcept;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
void
swap(
    Expected& a,
    Expected& b) noexcept(noexcept(a.swap(b)))
requires requires { a.swap(b); };

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
void
swap(
    Expected& x,
    Expected& y) noexcept(noexcept(x.swap(y)))
requires requires {x.swap(y);};

Parameters

Name	Description
x	A container holding an error or a value.
y	A container holding an error or a value.

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

constexpr
void
swap(
    Polymorphic& lhs,
    Polymorphic& rhs) noexcept;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
void
swap(
    Unexpected& x,
    Unexpected& y) noexcept(noexcept(x.swap(y)))
requires std::is_swappable_v<E>;

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<class T>
constexpr
void
swap(
    Optional<T&>& a,
    Optional<T&>& b) noexcept;

Parameters

Name	Description
a	First optional reference.
b	Second optional reference.

Synopses

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

Serialize the auto kind into a DOM value.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    AutoKind kind);

» more...

Serialize a FundamentalTypeKind into a DOM value.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    FundamentalTypeKind kind);

» more...

Map an operator kind to a DOM value (its underlying integer).

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    OperatorKind kind);

» more...

Map a QualifierKind into a DOM value.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    QualifierKind kind);

» more...

Return the ReferenceKind as a dom::Value string.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    ReferenceKind kind);

» more...

Map a TypeKind into a DOM value.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    TypeKind kind);

» more...

Return the UsingClass as a dom::Value string.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    UsingClass kind);

» more...

Return the AccessKind as a dom::Value string.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    AccessKind const kind);

» more...

Return the ConstexprKind as a dom::Value string.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    ConstexprKind const kind);

» more...

Return the StorageClassKind as a dom::Value string.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    StorageClassKind const kind);

» more...

Return the ExplicitInfo as a dom::Value string.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    ExplicitInfo const& I);

» more...

Serialize source locations into a DOM value.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    SourceInfo const& I);

» more...

Convert SymbolID to dom::Value string in the DOM using toBase16

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    SymbolID const& id);

» more...

Convert a NoexceptInfo to a DOM value.

void
tag_invoke(
    dom::ValueFromTag tag,
    dom::Value& v,
    NoexceptInfo const& info);

» more...

Map the SourceInfo to a lazy DOM object.

template<class IO>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO&,
    SourceInfo const&);

» more...

Generic ValueFrom for any described enum.

template<typename Enum>
requires describe::has_describe_enumerators<Enum>::value
void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Enum e);

» more...

Generic tag_invoke for described types without context.

template<
    typename IO,
    typename T>
requires describe::has_describe_members<T>::value
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    T const& I);

» more...

Map an ExprInfo to a dom::Value object.

void
tag_invoke(
    dom::LazyObjectMapTag,
    dom::Value& v,
    ExprInfo const& expr,
    DomCorpus const*);

» more...

Serialize a base description into a DOM value.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    BaseInfo const& I,
    DomCorpus const* domCorpus);

» more...

Map an ExprInfo to a dom::Value object.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    ExprInfo const& expr,
    DomCorpus const*);

» more...

Serialize a name into a DOM value.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Name const& I,
    DomCorpus const* domCorpus);

» more...

Return the Param as a dom::Value object.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Param const& p,
    DomCorpus const* domCorpus);

» more...

Convert SymbolID to dom::Value object in the DOM using Corpus

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    SymbolID const& id,
    DomCorpus const* domCorpus);

» more...

Serialize the argument to a DOM value.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    TArg const& I,
    DomCorpus const* domCorpus);

» more...

Serialize a template parameter into a DOM value.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    TParam const& I,
    DomCorpus const* domCorpus);

» more...

Serialize template info into a DOM value.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    TemplateInfo const& I,
    DomCorpus const* domCorpus);

» more...

Serialize a Type into a DOM value.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Type const& I,
    DomCorpus const* domCorpus);

» more...

Convert an optional SymbolID to dom::Value or null.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Optional<SymbolID> const& id,
    DomCorpus const* domCorpus);

» more...

Serialize an optional template info into a DOM value.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Optional<TemplateInfo> const& I,
    DomCorpus const* domCorpus);

» more...

Serialize an optional polymorphic name into a DOM value.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Optional<Polymorphic<Name>> const& I,
    DomCorpus const* domCorpus);

» more...

Serialize an optional polymorphic type into a DOM value.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Optional<Polymorphic<Type>> const& I,
    DomCorpus const* domCorpus);

» more...

Serialize a polymorphic name into a DOM value.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Polymorphic<Name> const& I,
    DomCorpus const* domCorpus);

» more...

Serialize a polymorphic template argument into a DOM value.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Polymorphic<TArg> const& I,
    DomCorpus const* domCorpus);

» more...

Serialize a polymorphic template parameter.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Polymorphic<TParam> const& I,
    DomCorpus const* domCorpus);

» more...

Serialize a polymorphic type into a DOM value.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Polymorphic<Type> const& I,
    DomCorpus const* domCorpus);

» more...

Convert SymbolID pointers to dom::Value or null.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    std::unique_ptr<SymbolID> const& t,
    DomCorpus const* domCorpus);

» more...

Map a vector of parameters to a dom::Value object.

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    std::vector<Param> const& params,
    DomCorpus const* domCorpus);

» more...

Map an ArrayType to a dom::Object with split bounds properties.

template<typename IO>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    ArrayType const& I,
    DomCorpus const* domCorpus);

» more...

Map a BaseInfo to a dom::Object with computed access booleans.

template<class IO>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    BaseInfo const& I,
    DomCorpus const* domCorpus);

» more...

Map a FriendInfo to a dom::Object with deferred name lookup.

template<typename IO>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    FriendInfo const& I,
    DomCorpus const* domCorpus);

» more...

Map a Name to a dom::Object via visit-based polymorphic dispatch.

template<class IO>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    Name const& I,
    DomCorpus const* domCorpus);

» more...

Map a RecordSymbol to a dom::Object with computed defaultAccess.

template<typename IO>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    RecordSymbol const& I,
    DomCorpus const* domCorpus);

» more...

Map a Symbol to a dom::Object with computed extraction properties.

template<typename IO>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    Symbol const& I,
    DomCorpus const* domCorpus);

» more...

Map a TemplateInfo to a dom::Object with computed specialization kind.

template<class IO>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    TemplateInfo const& I,
    DomCorpus const* domCorpus);

» more...

Generic ValueFrom for any described compound type.

template<typename T>
requires (describe::has_describe_members<T>::value &&
              !describe::has_describe_enumerators<T>::value)
void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    T const& I,
    DomCorpus const* domCorpus);

» more...

Map the Polymorphic Symbol to a dom::Object.

template<
    class IO,
    polymorphic_storage_for<Symbol> PolymorphicSymbol>
requires std::derived_from<PolymorphicSymbol, Symbol>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    PolymorphicSymbol const& I,
    DomCorpus const* domCorpus);

» more...

Generic tag_invoke for any described type with DomCorpus context.

template<
    typename IO,
    typename T>
requires describe::has_describe_members<T>::value
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    T const& I,
    DomCorpus const* domCorpus);

» more...

Generic ValueFrom for described enums, with context.

template<
    typename Enum,
    typename Context>
requires describe::has_describe_enumerators<Enum>::value
void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Enum e,
    Context const&);

» more...

Parameters

Name	Description
v	The output value.
kind	The UsingClass to convert.
I	The ExplicitInfo to convert.
e	The enumerator to convert to a dom::Value string.
io	The lazy object builder to map fields into.
expr	The expression info to convert.
t	The SymbolID pointer to convert. If null, the dom::Value is set to null.
domCorpus	The DomCorpus to use, or nullptr. If null, the SymbolID is converted to a base16 string.
params	The list of parameters to convert.

Synopsis

Declared in <mrdocs/Metadata/Type/AutoKind.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    AutoKind kind);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
kind	The kind of `auto` keyword used in a declaration.

Synopsis

Declared in <mrdocs/Metadata/Type/FundamentalTypeKind.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    FundamentalTypeKind kind);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
kind	Categorically describes a fundamental type.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/OperatorKind.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    OperatorKind kind);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
kind	Operator kinds

Synopsis

Declared in <mrdocs/Metadata/Type/QualifierKind.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    QualifierKind kind);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
kind	Type qualifiers

Synopsis

Declared in <mrdocs/Metadata/Specifiers/ReferenceKind.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    ReferenceKind kind);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
kind	Reference type kinds

Synopsis

Declared in <mrdocs/Metadata/Type/TypeKind.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    TypeKind kind);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
kind	Variants of C++ types captured in metadata.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Using.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    UsingClass kind);

Parameters

Name	Description
v	The output value.
kind	The UsingClass to convert.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/AccessKind.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    AccessKind const kind);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
kind	Access specifier.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/ConstexprKind.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    ConstexprKind const kind);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
kind	`constexpr`/`consteval` specifier kinds

Synopsis

Declared in <mrdocs/Metadata/Specifiers/StorageClassKind.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    StorageClassKind const kind);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
kind	Storage class kinds

Synopsis

Declared in <mrdocs/Metadata/Specifiers/ExplicitInfo.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    ExplicitInfo const& I);

Parameters

Name	Description
v	The output parameter to receive the dom::Value.
I	The ExplicitInfo to convert.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Source.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    SourceInfo const& I);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
I	Stores source information for a declaration.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    SymbolID const& id);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
id	A unique identifier for a symbol.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/NoexceptInfo.hpp>

void
tag_invoke(
    dom::ValueFromTag tag,
    dom::Value& v,
    NoexceptInfo const& info);

Parameters

Name	Description
tag	Customization point tag.
v	A variant container for any kind of Dom value.
info	Captures a `noexcept` specification and its evaluated form.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Source.hpp>

template<class IO>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO&,
    SourceInfo const&);

Synopsis

Declared in <mrdocs/Support/MapReflectedType.hpp>

template<typename Enum>
requires describe::has_describe_enumerators<Enum>::value
void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Enum e);

Parameters

Name	Description
e	The enumerator to convert to a dom::Value string.
v	A variant container for any kind of Dom value.

Synopsis

Declared in <mrdocs/Support/MapReflectedType.hpp>

template<
    typename IO,
    typename T>
requires describe::has_describe_members<T>::value
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    T const& I);

Description

Same as above but for types that don't need a DomCorpus (e.g. Location).

Parameters

Name	Description
io	The lazy object builder to map fields into.
I	The described instance to serialize.

Synopsis

Declared in <mrdocs/Metadata/Expression.hpp>

void
tag_invoke(
    dom::LazyObjectMapTag,
    dom::Value& v,
    ExprInfo const& expr,
    DomCorpus const*);

Parameters

Name	Description
v	The output parameter to receive the dom::Value.
expr	The expression info to convert.

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordBase.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    BaseInfo const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
I	Metadata for a direct base.
domCorpus	Front-end factory for producing Dom nodes.

Synopsis

Declared in <mrdocs/Metadata/Expression.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    ExprInfo const& expr,
    DomCorpus const*);

Parameters

Name	Description
v	The output parameter to receive the dom::Value.
expr	The expression info to convert.

Synopsis

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Name const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
I	Represents a name for a named `Type`
domCorpus	Front-end factory for producing Dom nodes.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Param.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Param const& p,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
p	Represents a single function parameter
domCorpus	Front-end factory for producing Dom nodes.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    SymbolID const& id,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
id	A unique identifier for a symbol.
domCorpus	Front-end factory for producing Dom nodes.

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    TArg const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
I	Base class for any template argument.
domCorpus	Front-end factory for producing Dom nodes.

Synopsis

Declared in <mrdocs/Metadata/TParam/TParamBase.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    TParam const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
I	Base class for a template parameter declaration.
domCorpus	Front-end factory for producing Dom nodes.

Synopsis

Declared in <mrdocs/Metadata/Template.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    TemplateInfo const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
I	Information about templates and specializations thereof.
domCorpus	Front-end factory for producing Dom nodes.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Type const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
I	A possibly qualified type.
domCorpus	Front-end factory for producing Dom nodes.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Optional<SymbolID> const& id,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
id	A compact optional that automatically uses nullable_traits<T> when available.
domCorpus	Front-end factory for producing Dom nodes.

Synopsis

Declared in <mrdocs/Metadata/Template.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Optional<TemplateInfo> const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
I	A compact optional that automatically uses nullable_traits<T> when available.
domCorpus	Front-end factory for producing Dom nodes.

Synopsis

Declared in <mrdocs/Metadata/Name.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Optional<Polymorphic<Name>> const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
I	A compact optional that automatically uses nullable_traits<T> when available.
domCorpus	Front-end factory for producing Dom nodes.

Synopsis

Declared in <mrdocs/Metadata/Type.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Optional<Polymorphic<Type>> const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
I	A compact optional that automatically uses nullable_traits<T> when available.
domCorpus	Front-end factory for producing Dom nodes.

Synopsis

Declared in <mrdocs/Metadata/Name.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Polymorphic<Name> const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
I	A polymorphic value-type.
domCorpus	Front-end factory for producing Dom nodes.

Synopsis

Declared in <mrdocs/Metadata/TArg.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Polymorphic<TArg> const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
I	A polymorphic value-type.
domCorpus	Front-end factory for producing Dom nodes.

Synopsis

Declared in <mrdocs/Metadata/TParam.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Polymorphic<TParam> const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
I	A polymorphic value-type.
domCorpus	Front-end factory for producing Dom nodes.

Synopsis

Declared in <mrdocs/Metadata/Type.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Polymorphic<Type> const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	A variant container for any kind of Dom value.
I	A polymorphic value-type.
domCorpus	Front-end factory for producing Dom nodes.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    std::unique_ptr<SymbolID> const& t,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	The output parameter to receive the dom::Value.
t	The SymbolID pointer to convert. If null, the dom::Value is set to null.
domCorpus	The DomCorpus to use, or nullptr. If null, the SymbolID is converted to a base16 string.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Function.hpp>

void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    std::vector<Param> const& params,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	The output parameter to receive the dom::Value.
params	The list of parameters to convert.
domCorpus	The DomCorpus used to resolve references.

Synopsis

Declared in <mrdocs/Metadata/Type/ArrayType.hpp>

template<typename IO>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    ArrayType const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
io	The IO object to map into.
I	The ArrayType to map.
domCorpus	The DomCorpus context.

Synopsis

Declared in <mrdocs/Metadata/Symbol/RecordBase.hpp>

template<class IO>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    BaseInfo const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
io	The IO object to map into.
I	The BaseInfo to map.
domCorpus	The DomCorpus context.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Friend.hpp>

template<typename IO>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    FriendInfo const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
io	The IO object to map into.
I	The FriendInfo to map.
domCorpus	The DomCorpus context.

Synopsis

Declared in <mrdocs/Metadata/Name.hpp>

template<class IO>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    Name const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
io	The IO object to map into.
I	The Name to map.
domCorpus	The DomCorpus context.

Synopsis

Declared in <mrdocs/Metadata/Symbol/Record.hpp>

template<typename IO>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    RecordSymbol const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
io	The IO object to map into.
I	The RecordSymbol to map.
domCorpus	The DomCorpus context.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolBase.hpp>

template<typename IO>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    Symbol const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
io	The IO object to map into.
I	The Symbol to map.
domCorpus	The DomCorpus context.

Synopsis

Declared in <mrdocs/Metadata/Template.hpp>

template<class IO>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    TemplateInfo const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
io	The IO object to map into.
I	The TemplateInfo to map.
domCorpus	The DomCorpus context.

Synopsis

Declared in <mrdocs/Support/MapReflectedType.hpp>

template<typename T>
requires (describe::has_describe_members<T>::value &&
              !describe::has_describe_enumerators<T>::value)
void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    T const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
v	The output value.
I	The object to convert.
domCorpus	The DomCorpus context.

Synopsis

Declared in <mrdocs/Metadata/Symbol.hpp>

template<
    class IO,
    polymorphic_storage_for<Symbol> PolymorphicSymbol>
requires std::derived_from<PolymorphicSymbol, Symbol>
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    PolymorphicSymbol const& I,
    DomCorpus const* domCorpus);

Parameters

Name	Description
io	The output parameter to receive the dom::Object.
I	The polymorphic Symbol to convert.
domCorpus	The DomCorpus used to resolve references.

Synopsis

Declared in <mrdocs/Support/MapReflectedType.hpp>

template<
    typename IO,
    typename T>
requires describe::has_describe_members<T>::value
void
tag_invoke(
    dom::LazyObjectMapTag,
    IO& io,
    T const& I,
    DomCorpus const* domCorpus);

Description

Handles all types whose mapping is a straightforward mapReflectedType<true>. Custom overloads (more-specialized template or non-template) are preferred by overload resolution.

Parameters

Name	Description
io	The lazy object builder to map fields into.
I	The described instance to serialize.
domCorpus	Optional corpus used to resolve cross-references.

Synopsis

Declared in <mrdocs/Support/MapReflectedType.hpp>

template<
    typename Enum,
    typename Context>
requires describe::has_describe_enumerators<Enum>::value
void
tag_invoke(
    dom::ValueFromTag,
    dom::Value& v,
    Enum e,
    Context const&);

Description

Same as above, ignoring the context.

Parameters

Name	Description
e	The enumerator to convert to a dom::Value string.
v	A variant container for any kind of Dom value.

Synopsis

Declared in <mrdocs/Metadata/Symbol/SymbolID.hpp>

std::string
toBase16Str(SymbolID const& id);

Return Value

The base16 string representation of the SymbolID.

Parameters

Name	Description
id	The SymbolID to convert.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
std::string
toCamelCase(std::string_view const input);

Return Value

New string converted to camelCase.

Parameters

Name	Description
input	Source string.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
std::string
toKebabCase(std::string_view const input);

Return Value

New string converted to kebab-case.

Parameters

Name	Description
input	Source string.

Synopses

Declared in <mrdocs/Support/String.hpp>

Convert a character to lowercase ASCII without locale.

constexpr
char
toLowerCase(char const c) noexcept;

» more...

Return a lowercase copy of the string without locale.

constexpr
std::string
toLowerCase(std::string_view const s) noexcept;

» more...

Return Value

Lowercase version of c if it is uppercase; otherwise c.
Lowercase copy of s.

Parameters

Name	Description
c	Character to convert.
s	Input string.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
char
toLowerCase(char const c) noexcept;

Return Value

Lowercase version of c if it is uppercase; otherwise c.

Parameters

Name	Description
c	Character to convert.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
std::string
toLowerCase(std::string_view const s) noexcept;

Return Value

Lowercase copy of s.

Parameters

Name	Description
s	Input string.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
std::string
toPascalCase(std::string_view const input);

Return Value

New string converted to PascalCase.

Parameters

Name	Description
input	Source string.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
std::string
toSnakeCase(std::string_view const input);

Return Value

New string converted to snake_case.

Parameters

Name	Description
input	Source string.

Synopses

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

Convert access specifier to its string form.

dom::String
toString(AccessKind kind) noexcept;

» more...

Convert an auto-kind to its spelling.

dom::String
toString(AutoKind kind) noexcept;

» more...

Convert a constexpr/consteval specifier kind to a string.

dom::String
toString(ConstexprKind kind) noexcept;

» more...

Convert an explicit kind to its string form.

dom::String
toString(ExplicitKind kind) noexcept;

» more...

Convert a FundamentalTypeKind to a string.

std::string_view
toString(FundamentalTypeKind kind) noexcept;

» more...

Convert a noexcept kind to its string form.

dom::String
toString(NoexceptKind kind) noexcept;

» more...

Convert a cv/ref qualifier kind to its string form.

dom::String
toString(QualifierKind kind) noexcept;

» more...

Convert a reference kind to its string representation.

dom::String
toString(ReferenceKind kind) noexcept;

» more...

Convert a storage class kind to its string form.

dom::String
toString(StorageClassKind kind) noexcept;

» more...

Convert the specialization kind to a readable string.

std::string_view
toString(TemplateSpecKind kind);

» more...

Convert a TypeKind to its string representation.

dom::String
toString(TypeKind kind) noexcept;

» more...

Convert the name to a human-readable string.

std::string
toString(Name const& N);

» more...

Convert a template argument to a human-readable string.

std::string
toString(TArg const& arg) noexcept;

» more...

Convert a described enumerator to string form.

template<typename Enum>
requires describe::has_describe_enumerators<Enum>::value
std::string
toString(Enum e);

» more...

Render a type to a human-readable string.

std::string
toString(
    Type const& T,
    std::string_view Name = "");

» more...

Convert ExplicitInfo to a string.

dom::String
toString(
    ExplicitInfo const& info,
    bool resolved = false,
    bool implicit = false);

» more...

Convert NoexceptInfo to a string.

dom::String
toString(
    NoexceptInfo const& info,
    bool resolved = false,
    bool implicit = false);

» more...

Return Value

String naming the keyword.
The string representation of the kind
String view naming the specialization category.
The textual form of the name.
Descriptive text for the argument.
The string form of the enumerator.
Text representation of the type.
The string representation of the explicit-specifier.
The string representation of the noexcept-specifier.

Parameters

Name	Description
e	The enumerator to convert.
T	Type to render.
Name	Optional identifier to append.
info	The explicit-specifier information.
resolved	If true, the operand is not shown when the explicit-specifier is non-dependent.
implicit	If true, implicit explicit-specifiers are shown.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/AccessKind.hpp>

dom::String
toString(AccessKind kind) noexcept;

Return Value

UTF-8 string value used by the DOM.

Parameters

Name	Description
kind	Access specifier.

Synopsis

Declared in <mrdocs/Metadata/Type/AutoKind.hpp>

dom::String
toString(AutoKind kind) noexcept;

Return Value

String naming the keyword.

Parameters

Name	Description
kind	The kind of `auto` keyword used in a declaration.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/ConstexprKind.hpp>

dom::String
toString(ConstexprKind kind) noexcept;

Return Value

UTF-8 string value used by the DOM.

Parameters

Name	Description
kind	`constexpr`/`consteval` specifier kinds

Synopsis

Declared in <mrdocs/Metadata/Specifiers/ExplicitKind.hpp>

dom::String
toString(ExplicitKind kind) noexcept;

Return Value

UTF-8 string value used by the DOM.

Parameters

Name	Description
kind	Explicit specifier kinds

Synopsis

Declared in <mrdocs/Metadata/Type/FundamentalTypeKind.hpp>

std::string_view
toString(FundamentalTypeKind kind) noexcept;

Description

This function converts a FundamentalTypeKind to the shortest canonical string representing the type.

Return Value

The string representation of the kind

Parameters

Name	Description
kind	Categorically describes a fundamental type.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/NoexceptKind.hpp>

dom::String
toString(NoexceptKind kind) noexcept;

Return Value

UTF-8 string value used by the DOM.

Parameters

Name	Description
kind	Exception specification kinds

Synopsis

Declared in <mrdocs/Metadata/Type/QualifierKind.hpp>

dom::String
toString(QualifierKind kind) noexcept;

Return Value

UTF-8 string value used by the DOM.

Parameters

Name	Description
kind	Type qualifiers

Synopsis

Declared in <mrdocs/Metadata/Specifiers/ReferenceKind.hpp>

dom::String
toString(ReferenceKind kind) noexcept;

Return Value

UTF-8 string value used by the DOM.

Parameters

Name	Description
kind	Reference type kinds

Synopsis

Declared in <mrdocs/Metadata/Specifiers/StorageClassKind.hpp>

dom::String
toString(StorageClassKind kind) noexcept;

Return Value

UTF-8 string value used by the DOM.

Parameters

Name	Description
kind	Storage class kinds

Synopsis

Declared in <mrdocs/Metadata/Template.hpp>

std::string_view
toString(TemplateSpecKind kind);

Return Value

String view naming the specialization category.

Parameters

Name	Description
kind	The kind of template or specialization.

Synopsis

Declared in <mrdocs/Metadata/Type/TypeKind.hpp>

dom::String
toString(TypeKind kind) noexcept;

Return Value

UTF-8 string value used by the DOM.

Parameters

Name	Description
kind	Variants of C++ types captured in metadata.

Synopsis

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

std::string
toString(Name const& N);

Return Value

The textual form of the name.

Parameters

Name	Description
N	Represents a name for a named `Type`

Synopsis

Declared in <mrdocs/Metadata/TArg/TArgBase.hpp>

std::string
toString(TArg const& arg) noexcept;

Return Value

Descriptive text for the argument.

Parameters

Name	Description
arg	Base class for any template argument.

Synopsis

Declared in <mrdocs/Support/EnumToString.hpp>

template<typename Enum>
requires describe::has_describe_enumerators<Enum>::value
std::string
toString(Enum e);

Return Value

The string form of the enumerator.

Parameters

Name	Description
e	The enumerator to convert.

Synopsis

Declared in <mrdocs/Metadata/Type.hpp>

std::string
toString(
    Type const& T,
    std::string_view Name = "");

Return Value

Text representation of the type.

Parameters

Name	Description
T	Type to render.
Name	Optional identifier to append.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/ExplicitInfo.hpp>

dom::String
toString(
    ExplicitInfo const& info,
    bool resolved = false,
    bool implicit = false);

Return Value

The string representation of the explicit-specifier.

Parameters

Name	Description
info	The explicit-specifier information.
resolved	If true, the operand is not shown when the explicit-specifier is non-dependent.
implicit	If true, implicit explicit-specifiers are shown.

Synopsis

Declared in <mrdocs/Metadata/Specifiers/NoexceptInfo.hpp>

dom::String
toString(
    NoexceptInfo const& info,
    bool resolved = false,
    bool implicit = false);

Return Value

The string representation of the noexcept-specifier.

Parameters

Name	Description
info	The noexcept-specifier information.
resolved	If true, the operand is not shown when the exception specification is non-dependent.
implicit	If true, implicit exception specifications are shown.

Synopses

Declared in <mrdocs/Support/String.hpp>

Convert a character to uppercase ASCII without locale.

constexpr
char
toUpperCase(char const c) noexcept;

» more...

Return an uppercase copy of the string without locale.

constexpr
std::string
toUpperCase(std::string_view const s) noexcept;

» more...

Return Value

Uppercase version of c if it is lowercase; otherwise c.
Uppercase copy of s.

Parameters

Name	Description
c	Character to convert.
s	Input string.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
char
toUpperCase(char const c) noexcept;

Return Value

Uppercase version of c if it is lowercase; otherwise c.

Parameters

Name	Description
c	Character to convert.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
std::string
toUpperCase(std::string_view const s) noexcept;

Return Value

Uppercase copy of s.

Parameters

Name	Description
s	Input string.

Synopsis

Declared in <mrdocs/Support/TypeTraits.hpp>

template<class Enum>
requires std::is_enum_v<Enum>
constexpr
std::underlying_type_t<Enum>
to_underlying(Enum value) noexcept;

Return Value

the value as its underlying type.

Parameters

Name	Description
value	The enum value to convert

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

template<
    DocCommentNodeTraversable T,
    class F>
void
topDownTraverse(
    T& node,
    F&& func);

Parameters

Name	Description
node	Root node to traverse.
func	Visitor invoked before children are visited.

Synopses

Declared in <mrdocs/Support/String.hpp>

Return the substring without leading and trailing horizontal whitespace.

constexpr
std::string_view
trim(std::string_view const s) noexcept;

» more...

Return the substring without leading and trailing specified characters.

constexpr
std::string_view
trim(
    std::string_view const s,
    std::string_view const chars) noexcept;

» more...

Return Value

The modified string.

Parameters

Name	Description
s	The string to trim.
chars	The characters to remove.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
std::string_view
trim(std::string_view const s) noexcept;

Return Value

The modified string.

Parameters

Name	Description
s	The string to trim.

Synopsis

Declared in <mrdocs/Support/String.hpp>

constexpr
std::string_view
trim(
    std::string_view const s,
    std::string_view const chars) noexcept;

Return Value

The modified string.

Parameters

Name	Description
s	The string to trim.
chars	The characters to remove.

Synopses

Declared in <mrdocs/Metadata/TParam.hpp>

Visit a template parameter, dispatching to its concrete type.

template<
    typename TParamTy,
    typename F,
    typename... Args>
requires std::derived_from<TParamTy, TParam>
constexpr
decltype(auto)
visit(
    TParamTy& P,
    F&& f,
    Args&&... args);

» more...

Visit a Type with the provided callable.

template<
    std::derived_from<Symbol> TypeTy,
    class F,
    class... Args>
constexpr
decltype(auto)
visit(
    TypeTy& info,
    F&& fn,
    Args&&... args);

» more...

Return Value

Whatever the callable returns.
The result of calling the function object with the derived type

Parameters

Name	Description
P	Parameter to visit.
f	Callable to receive the concrete parameter.
args	Additional arguments forwarded to the callable.
info	The type instance to visit.
fn	The callable to dispatch to the concrete type.

Synopsis

Declared in <mrdocs/Metadata/TParam.hpp>

template<
    typename TParamTy,
    typename F,
    typename... Args>
requires std::derived_from<TParamTy, TParam>
constexpr
decltype(auto)
visit(
    TParamTy& P,
    F&& f,
    Args&&... args);

Return Value

Whatever the callable returns.

Parameters

Name	Description
P	Parameter to visit.
f	Callable to receive the concrete parameter.
args	Additional arguments forwarded to the callable.

Synopsis

Declared in <mrdocs/Metadata/Type.hpp>

template<
    std::derived_from<Symbol> TypeTy,
    class F,
    class... Args>
constexpr
decltype(auto)
visit(
    TypeTy& info,
    F&& fn,
    Args&&... args);

Description

Visit a template argument, dispatching on its concrete kind.

Invoke a function object with a type derived from Symbol

This function will invoke the function object fn with a type derived from Symbol as the first argument, followed by args.... The type of the first argument is determined by the SymbolKind of the Symbol object.

Return Value

Whatever the callable returns.
The result of calling the function object with the derived type

Parameters

Name	Description
info	The type instance to visit.
fn	The callable to dispatch to the concrete type.
args	Additional arguments forwarded to the callable.

Synopsis

Declared in <mrdocs/ADT/Overload.hpp>

template<
    class Variant,
    class... Ts>
constexpr
decltype(auto)
visitIndexed(
    Variant&& v,
    Ts&&... xs);

Description

Unlike match, visitIndexed passes an additional first parameter to your callable set: the runtime index of the active alternative (as a std::size_t).

This is useful when you need both the value and which alternative was selected, without relying on type-unique alternatives.

The supplied callables are combined via makeOverload and are expected to accept a signature like (std::size_t index, T value) for the relevant T.


std::variant<int, double, std::string> v = 3.14;
fn::visitIndexed(v,
    [](std::size_t i, int x) { return i + x; },
    [](std::size_t i, double d) { return d + i; },
    [](std::size_t i, const std::string& s) { return s.size() + i; });

Return Value

The result of invoking the selected callable.

Parameters

Name	Description
v	The variant to visit.
xs	The callables to be combined with makeOverload and invoked with (index, value).

Synopsis

Declared in <mrdocs/ADT/Overload.hpp>

template<class F>
[[nodiscard]]
constexpr
YCombinator<std::decay_t<F>>
yCombinator(F&& f) noexcept(std::is_nothrow_constructible_v<std::decay_t<F>, F &&>);

Description

Prefer this helper to avoid spelling template arguments explicitly.

auto fib = fn::yCombinator( []self, int n) -> int { return n <= 1 ? n : self(n - 1) + self(n - 2); });

Return Value

A YCombinator storing a decayed copy of the callable.

Parameters

Name	Description
f	The callable to wrap.

Synopses

Declared in <mrdocs/Support/Handlebars.hpp>

Write to output

OutputRef&
operator<<(
    OutputRef& os,
    T v);

» more...

Write to output

OutputRef&
operator<<(
    OutputRef& os,
    char const* c);

» more...

Write to output

OutputRef&
operator<<(
    OutputRef& os,
    char c);

» more...

Write to output

OutputRef&
operator<<(
    OutputRef& os,
    std::string_view sv);

» more...

Return Value

A reference to this object

Parameters

Name	Description
os	The output stream reference
v	The character to write
c	The string to write
sv	The string to write

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

OutputRef&
operator<<(
    OutputRef& os,
    T v);

Return Value

A reference to this object

Parameters

Name	Description
os	The output stream reference
v	The character to write

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

OutputRef&
operator<<(
    OutputRef& os,
    char const* c);

Return Value

A reference to this object

Parameters

Name	Description
os	The output stream reference
c	The string to write

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

OutputRef&
operator<<(
    OutputRef& os,
    char c);

Return Value

A reference to this object

Parameters

Name	Description
os	The output stream reference
c	The character to write

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

OutputRef&
operator<<(
    OutputRef& os,
    std::string_view sv);

Return Value

A reference to this object

Parameters

Name	Description
os	The output stream reference
sv	The string to write

Synopses

Declared in <mrdocs/ADT/Optional.hpp>

Equality operator

constexpr
bool
operator==(
    Expected const& x,
    Expected<U, E2> const& y) noexcept(noexcept(bool(x.error() == y.error())));

» more...

Equality operator

constexpr
bool
operator==(
    Iterator const& it,
    std::default_sentinel_t rhs) noexcept;

» more...

Equality operator

constexpr
bool
operator==(
    ParseResult const& lhs,
    ParseResult const& rhs) = default;

» more...

Equality helper for polymorphic template parameters.

bool
operator==(
    Polymorphic<TParam> const& lhs,
    Polymorphic<TParam> const& rhs);

» more...

Equality for polymorphic template arguments.

bool
operator==(
    Polymorphic<TArg> const& a,
    Polymorphic<TArg> const& b);

» more...

Equality for two polymorphic types.

bool
operator==(
    Polymorphic<Type> const& a,
    Polymorphic<Type> const& b);

» more...

Equality for two polymorphic names.

bool
operator==(
    Polymorphic<Name> const& a,
    Polymorphic<Name> const& b);

» more...

Equality for any described type.

template<typename T>
requires DescribedComparable<T>
bool
operator==(
    T const& a,
    T const& b);

» more...

Equality operator

constexpr
bool
operator==(
    Expected const& x,
    Expected<U, E2> const& y) noexcept(noexcept(bool(*x == *y)) && noexcept(bool(x.error() == y.error())))
requires (!std::is_void_v<U>);

» more...

Equality operator

constexpr
bool
operator==(
    Expected const& x,
    U const& v) noexcept(noexcept(bool(*x == v)));

» more...

Equality operator

constexpr
bool
operator==(
    Expected const& x,
    Unexpected<E2> const& e) noexcept(noexcept(bool(x.error() == e.error())));

» more...

Equality operator

constexpr
bool
operator==(
    ArrayView a,
    ArrayView b) noexcept
requires requires (const T& x, const T& y) { { x == y } -> std::convertible_to<bool>; };

» more...

Equality operator

constexpr
bool
operator==(
    Expected const& x,
    Expected<U, E2> const& y) noexcept(noexcept(bool(*x == *y)) && noexcept(bool(x.error() == y.error())));

» more...

Equality operator

constexpr
bool
operator==(
    Expected const& x,
    U const& v) noexcept(noexcept(bool(*x == v)));

» more...

Equality operator

constexpr
bool
operator==(
    Expected const& x,
    Unexpected<E2> const& e) noexcept(noexcept(bool(x.error() == e.error())));

» more...

Equality operator

[[nodiscard]]
constexpr
bool
operator==(
    Unexpected const& x,
    Unexpected<Er> const& y);

» more...

Equality comparison of two polymorphic objects.

template<class Base>
requires detail::CanVisitCompare<Base>
bool
operator==(
    Polymorphic<Base> const& lhs,
    Polymorphic<Base> const& rhs);

» more...

Compares a value to an engaged Optional for equality. Returns true if the Optional is engaged and its value equals lhs.

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<T>)
constexpr
/* implementation-defined */
operator==(
    T const& lhs,
    Optional<U> const& rhs);

» more...

Compares an engaged Optional to a value for equality. Returns true if the Optional is engaged and its value equals rhs.

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<U>)
constexpr
/* implementation-defined */
operator==(
    Optional<T> const& lhs,
    U const& rhs);

» more...

Checks if the Optional is disengaged (equal to std::nullopt). Returns true if the Optional does not contain a value.

template<typename T>
[[nodiscard]]
constexpr
bool
operator==(
    Optional<T> const& lhs,
    std::nullopt_t rhs) noexcept;

» more...

Compares two Optional values for equality. Returns true if both are engaged and their contained values are equal, or both are disengaged.

template<
    typename T,
    typename U>
constexpr
/* implementation-defined */
operator==(
    Optional<T> const& lhs,
    Optional<U> const& rhs);

» more...

Return Value

true when objects compare equal.
true if the optional is engaged and equal to lhs; otherwise, false.
true if the optional is engaged and equal to rhs; otherwise, false.
true if the optional is disengaged; otherwise, false.
true if both optionals are engaged and equal, or both are disengaged; otherwise, false.

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
bool
operator==(
    Expected const& x,
    Expected<U, E2> const& y) noexcept(noexcept(bool(x.error() == y.error())));

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
x	The left operand
y	The right operand

Synopsis

Declared in <mrdocs/Support/SplitLines.hpp>

constexpr
bool
operator==(
    Iterator const& it,
    std::default_sentinel_t rhs) noexcept;

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
it	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Support/Parse.hpp>

constexpr
bool
operator==(
    ParseResult const& lhs,
    ParseResult const& rhs) = default;

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Metadata/TParam.hpp>

bool
operator==(
    Polymorphic<TParam> const& lhs,
    Polymorphic<TParam> const& rhs);

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Metadata/TArg.hpp>

bool
operator==(
    Polymorphic<TArg> const& a,
    Polymorphic<TArg> const& b);

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
a	The left operand
b	The right operand

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

bool
operator==(
    Polymorphic<Type> const& a,
    Polymorphic<Type> const& b);

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
a	The left operand
b	The right operand

Synopsis

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

bool
operator==(
    Polymorphic<Name> const& a,
    Polymorphic<Name> const& b);

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
a	The left operand
b	The right operand

Synopsis

Declared in <mrdocs/Support/CompareReflectedType.hpp>

template<typename T>
requires DescribedComparable<T>
bool
operator==(
    T const& a,
    T const& b);

Description

Needed because removing a defaulted member operator<=>() also removes the implicitly-generated operator==().

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
a	The left operand
b	The right operand

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
bool
operator==(
    Expected const& x,
    Expected<U, E2> const& y) noexcept(noexcept(bool(*x == *y)) && noexcept(bool(x.error() == y.error())))
requires (!std::is_void_v<U>);

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
x	The left operand
y	The right operand

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
bool
operator==(
    Expected const& x,
    U const& v) noexcept(noexcept(bool(*x == v)));

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
x	The left operand
v	The right operand

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
bool
operator==(
    Expected const& x,
    Unexpected<E2> const& e) noexcept(noexcept(bool(x.error() == e.error())));

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
x	The left operand
e	The right operand

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
bool
operator==(
    ArrayView a,
    ArrayView b) noexcept
requires requires (const T& x, const T& y) { { x == y } -> std::convertible_to<bool>; };

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
a	The left operand
b	The right operand

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
bool
operator==(
    Expected const& x,
    Expected<U, E2> const& y) noexcept(noexcept(bool(*x == *y)) && noexcept(bool(x.error() == y.error())));

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
x	The left operand
y	The right operand

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
bool
operator==(
    Expected const& x,
    U const& v) noexcept(noexcept(bool(*x == v)));

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
x	The left operand
v	The right operand

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

constexpr
bool
operator==(
    Expected const& x,
    Unexpected<E2> const& e) noexcept(noexcept(bool(x.error() == e.error())));

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
x	The left operand
e	The right operand

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

[[nodiscard]]
constexpr
bool
operator==(
    Unexpected const& x,
    Unexpected<Er> const& y);

Return Value

true if the objects are equal, false otherwise

Parameters

Name	Description
x	The left operand
y	The right operand

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

template<class Base>
requires detail::CanVisitCompare<Base>
bool
operator==(
    Polymorphic<Base> const& lhs,
    Polymorphic<Base> const& rhs);

Return Value

true when objects compare equal.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<T>)
constexpr
/* implementation-defined */
operator==(
    T const& lhs,
    Optional<U> const& rhs);

Return Value

true if the optional is engaged and equal to lhs; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<U>)
constexpr
/* implementation-defined */
operator==(
    Optional<T> const& lhs,
    U const& rhs);

Return Value

true if the optional is engaged and equal to rhs; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<typename T>
[[nodiscard]]
constexpr
bool
operator==(
    Optional<T> const& lhs,
    std::nullopt_t rhs) noexcept;

Return Value

true if the optional is disengaged; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
constexpr
/* implementation-defined */
operator==(
    Optional<T> const& lhs,
    Optional<U> const& rhs);

Return Value

true if both optionals are engaged and equal, or both are disengaged; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopses

Declared in <mrdocs/ADT/Optional.hpp>

Compares two Optional values for inequality. Returns true if their engagement states differ or their contained values are not equal.

template<
    typename T,
    typename U>
constexpr
/* implementation-defined */
operator!=(
    Optional<T> const& lhs,
    Optional<U> const& rhs);

» more...

Compares an Optional to a value for inequality. Returns true if the Optional is disengaged or its value does not equal rhs.

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<U>)
constexpr
/* implementation-defined */
operator!=(
    Optional<T> const& lhs,
    U const& rhs);

» more...

Compares a value to an Optional for inequality. Returns true if the Optional is disengaged or its value does not equal lhs.

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<T>)
constexpr
/* implementation-defined */
operator!=(
    T const& lhs,
    Optional<U> const& rhs);

» more...

Return Value

true if the optionals differ in engagement or value; otherwise, false.
true if the optional is disengaged or not equal to rhs; otherwise, false.
true if the optional is disengaged or not equal to lhs; otherwise, false.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
constexpr
/* implementation-defined */
operator!=(
    Optional<T> const& lhs,
    Optional<U> const& rhs);

Return Value

true if the optionals differ in engagement or value; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<U>)
constexpr
/* implementation-defined */
operator!=(
    Optional<T> const& lhs,
    U const& rhs);

Return Value

true if the optional is disengaged or not equal to rhs; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<T>)
constexpr
/* implementation-defined */
operator!=(
    T const& lhs,
    Optional<U> const& rhs);

Return Value

true if the optional is disengaged or not equal to lhs; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopses

Declared in <mrdocs/ADT/Optional.hpp>

Checks if the left Optional is less than the right Optional. Returns true if the right is engaged and either the left is disengaged or its value is less.

template<
    typename T,
    typename U>
constexpr
/* implementation-defined */
operator<(
    Optional<T> const& lhs,
    Optional<U> const& rhs);

» more...

Checks if the Optional is less than a value. Returns true if the Optional is disengaged or its value is less than rhs.

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<U>)
[[nodiscard]]
constexpr
/* implementation-defined */
operator<(
    Optional<T> const& lhs,
    U const& rhs);

» more...

Checks if a value is less than an engaged Optional. Returns true if the Optional is engaged and lhs is less than its value.

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<T>)
[[nodiscard]]
constexpr
/* implementation-defined */
operator<(
    T const& lhs,
    Optional<U> const& rhs);

» more...

Return Value

true if lhs is less than rhs according to the described rules; otherwise, false.
true if the optional is disengaged or less than rhs; otherwise, false.
true if the optional is engaged and lhs is less than its value; otherwise, false.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
constexpr
/* implementation-defined */
operator<(
    Optional<T> const& lhs,
    Optional<U> const& rhs);

Return Value

true if lhs is less than rhs according to the described rules; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<U>)
[[nodiscard]]
constexpr
/* implementation-defined */
operator<(
    Optional<T> const& lhs,
    U const& rhs);

Return Value

true if the optional is disengaged or less than rhs; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<T>)
[[nodiscard]]
constexpr
/* implementation-defined */
operator<(
    T const& lhs,
    Optional<U> const& rhs);

Return Value

true if the optional is engaged and lhs is less than its value; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopses

Declared in <mrdocs/ADT/Optional.hpp>

Checks if the left Optional is less than or equal to the right Optional. Returns true if the left is disengaged or the right is engaged and the left's value is less or equal.

template<
    typename T,
    typename U>
constexpr
/* implementation-defined */
operator<=(
    Optional<T> const& lhs,
    Optional<U> const& rhs);

» more...

Checks if the Optional is less than or equal to a value. Returns true if the Optional is disengaged or its value is less than or equal to rhs.

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<U>)
constexpr
/* implementation-defined */
operator<=(
    Optional<T> const& lhs,
    U const& rhs);

» more...

Checks if a value is less than or equal to an engaged Optional. Returns true if the Optional is engaged and lhs is less than or equal to its value.

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<T>)
constexpr
/* implementation-defined */
operator<=(
    T const& lhs,
    Optional<U> const& rhs);

» more...

Return Value

true if lhs is less than or equal to rhs according to the described rules; otherwise, false.
true if the optional is disengaged or less than or equal to rhs; otherwise, false.
true if the optional is engaged and lhs is less than or equal to its value; otherwise, false.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
constexpr
/* implementation-defined */
operator<=(
    Optional<T> const& lhs,
    Optional<U> const& rhs);

Return Value

true if lhs is less than or equal to rhs according to the described rules; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<U>)
constexpr
/* implementation-defined */
operator<=(
    Optional<T> const& lhs,
    U const& rhs);

Return Value

true if the optional is disengaged or less than or equal to rhs; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<T>)
constexpr
/* implementation-defined */
operator<=(
    T const& lhs,
    Optional<U> const& rhs);

Return Value

true if the optional is engaged and lhs is less than or equal to its value; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopses

Declared in <mrdocs/ADT/Optional.hpp>

Checks if the left Optional is greater than the right Optional. Returns true if the left is engaged and either the right is disengaged or its value is greater.

template<
    typename T,
    typename U>
constexpr
/* implementation-defined */
operator>(
    Optional<T> const& lhs,
    Optional<U> const& rhs);

» more...

Checks if the Optional is greater than a value. Returns true if the Optional is engaged and its value is greater than rhs.

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<U>)
constexpr
/* implementation-defined */
operator>(
    Optional<T> const& lhs,
    U const& rhs);

» more...

Checks if a value is greater than an Optional. Returns true if the Optional is disengaged or lhs is greater than its value.

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<T>)
constexpr
/* implementation-defined */
operator>(
    T const& lhs,
    Optional<U> const& rhs);

» more...

Return Value

true if lhs is greater than rhs according to the described rules; otherwise, false.
true if the optional is engaged and greater than rhs; otherwise, false.
true if the optional is disengaged or lhs is greater than its value; otherwise, false.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
constexpr
/* implementation-defined */
operator>(
    Optional<T> const& lhs,
    Optional<U> const& rhs);

Return Value

true if lhs is greater than rhs according to the described rules; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<U>)
constexpr
/* implementation-defined */
operator>(
    Optional<T> const& lhs,
    U const& rhs);

Return Value

true if the optional is engaged and greater than rhs; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<T>)
constexpr
/* implementation-defined */
operator>(
    T const& lhs,
    Optional<U> const& rhs);

Return Value

true if the optional is disengaged or lhs is greater than its value; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopses

Declared in <mrdocs/ADT/Optional.hpp>

Checks if the left Optional is greater than or equal to the right Optional. Returns true if the right is disengaged or the left is engaged and its value is greater or equal.

template<
    typename T,
    typename U>
constexpr
/* implementation-defined */
operator>=(
    Optional<T> const& lhs,
    Optional<U> const& rhs);

» more...

Checks if the Optional is greater than or equal to a value. Returns true if the Optional is engaged and its value is greater than or equal to rhs.

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<U>)
constexpr
/* implementation-defined */
operator>=(
    Optional<T> const& lhs,
    U const& rhs);

» more...

Checks if a value is greater than or equal to an Optional. Returns true if the Optional is disengaged or lhs is greater than or equal to its value.

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<T>)
constexpr
/* implementation-defined */
operator>=(
    T const& lhs,
    Optional<U> const& rhs);

» more...

Return Value

true if lhs is greater than or equal to rhs according to the described rules; otherwise, false.
true if the optional is engaged and greater than or equal to rhs; otherwise, false.
true if the optional is disengaged or lhs is greater than or equal to its value; otherwise, false.

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
constexpr
/* implementation-defined */
operator>=(
    Optional<T> const& lhs,
    Optional<U> const& rhs);

Return Value

true if lhs is greater than or equal to rhs according to the described rules; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<U>)
constexpr
/* implementation-defined */
operator>=(
    Optional<T> const& lhs,
    U const& rhs);

Return Value

true if the optional is engaged and greater than or equal to rhs; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
requires (!detail::isOptionalV<T>)
constexpr
/* implementation-defined */
operator>=(
    T const& lhs,
    Optional<U> const& rhs);

Return Value

true if the optional is disengaged or lhs is greater than or equal to its value; otherwise, false.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopses

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

Three-way comparison operator

constexpr
auto
operator<=>(
    ArrayView a,
    ArrayView b) noexcept
requires requires (const T& x, const T& y) { x <=> y; };

» more...

Performs a three-way comparison between two Optional values. If both are engaged, compares their contained values; otherwise, compares engagement state.

template<
    typename T,
    std::three_way_comparable_with<T> U>
[[nodiscard]]
constexpr
std::compare_three_way_result_t<T, U>
operator<=>(
    Optional<T> const& x,
    Optional<U> const& y);

» more...

Performs a three-way comparison between an Optional and std::nullopt. Returns std::strong_ordering::greater if engaged, std::strong_ordering::equal if disengaged.

template<typename T>
[[nodiscard]]
constexpr
std::strong_ordering
operator<=>(
    Optional<T> const& x,
    std::nullopt_t rhs) noexcept;

» more...

Performs a three-way comparison between an Optional and a value. If the Optional is engaged, compares its value to v; otherwise, returns less.

template<
    typename T,
    typename U>
requires (!detail::isDerivedFromOptional<U>)
        && requires { typename std::compare_three_way_result_t<T, U>; }
        && std::three_way_comparable_with<T, U>
constexpr
std::compare_three_way_result_t<T, U>
operator<=>(
    Optional<T> const& x,
    U const& v);

» more...

Three-way comparison of two polymorphic objects.

template<class Base>
requires detail::CanVisitCompare<Base>
auto
operator<=>(
    Polymorphic<Base> const& lhs,
    Polymorphic<Base> const& rhs);

» more...

Three-way comparison for any described type.

template<typename T>
requires DescribedComparable<T>
std::strong_ordering
operator<=>(
    T const& a,
    T const& b);

» more...

Compare two polymorphic names by visitor dispatch.

std::strong_ordering
operator<=>(
    Polymorphic<Name> const& lhs,
    Polymorphic<Name> const& rhs);

» more...

Compare two polymorphic types by visitor dispatch.

std::strong_ordering
operator<=>(
    Polymorphic<Type> const& lhs,
    Polymorphic<Type> const& rhs);

» more...

Compare polymorphic template arguments.

std::strong_ordering
operator<=>(
    Polymorphic<TArg> const& lhs,
    Polymorphic<TArg> const& rhs);

» more...

Compare polymorphic template parameters.

std::strong_ordering
operator<=>(
    Polymorphic<TParam> const& lhs,
    Polymorphic<TParam> const& rhs);

» more...

Return Value

The result of the three-way comparison between the optionals or their values.
The result of the three-way comparison with std::nullopt.
The result of the three-way comparison with the value.
strong_ordering comparing held objects.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

constexpr
auto
operator<=>(
    ArrayView a,
    ArrayView b) noexcept
requires requires (const T& x, const T& y) { x <=> y; };

Return Value

The relative order of the objects

Parameters

Name	Description
a	The left operand
b	The right operand

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    std::three_way_comparable_with<T> U>
[[nodiscard]]
constexpr
std::compare_three_way_result_t<T, U>
operator<=>(
    Optional<T> const& x,
    Optional<U> const& y);

Return Value

The result of the three-way comparison between the optionals or their values.

Parameters

Name	Description
x	The left operand
y	The right operand

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<typename T>
[[nodiscard]]
constexpr
std::strong_ordering
operator<=>(
    Optional<T> const& x,
    std::nullopt_t rhs) noexcept;

Return Value

The result of the three-way comparison with std::nullopt.

Parameters

Name	Description
x	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/ADT/Optional.hpp>

template<
    typename T,
    typename U>
requires (!detail::isDerivedFromOptional<U>)
        && requires { typename std::compare_three_way_result_t<T, U>; }
        && std::three_way_comparable_with<T, U>
constexpr
std::compare_three_way_result_t<T, U>
operator<=>(
    Optional<T> const& x,
    U const& v);

Return Value

The result of the three-way comparison with the value.

Parameters

Name	Description
x	The left operand
v	The right operand

Synopsis

Declared in <mrdocs/ADT/Polymorphic.hpp>

template<class Base>
requires detail::CanVisitCompare<Base>
auto
operator<=>(
    Polymorphic<Base> const& lhs,
    Polymorphic<Base> const& rhs);

Return Value

strong_ordering comparing held objects.

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Support/CompareReflectedType.hpp>

template<typename T>
requires DescribedComparable<T>
std::strong_ordering
operator<=>(
    T const& a,
    T const& b);

Description

Compares base classes first (in description order), then own members.

Return Value

The relative order of the objects

Parameters

Name	Description
a	The left operand
b	The right operand

Synopsis

Declared in <mrdocs/Metadata/Name/NameBase.hpp>

std::strong_ordering
operator<=>(
    Polymorphic<Name> const& lhs,
    Polymorphic<Name> const& rhs);

Return Value

The relative order of the objects

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Metadata/Type/TypeBase.hpp>

std::strong_ordering
operator<=>(
    Polymorphic<Type> const& lhs,
    Polymorphic<Type> const& rhs);

Return Value

The relative order of the objects

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Metadata/TArg.hpp>

std::strong_ordering
operator<=>(
    Polymorphic<TArg> const& lhs,
    Polymorphic<TArg> const& rhs);

Return Value

The relative order of the objects

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Metadata/TParam.hpp>

std::strong_ordering
operator<=>(
    Polymorphic<TParam> const& lhs,
    Polymorphic<TParam> const& rhs);

Return Value

The relative order of the objects

Parameters

Name	Description
lhs	The left operand
rhs	The right operand

Synopsis

Declared in <mrdocs/Support/Handlebars.hpp>

inline constexpr std::pair<char, std::string_view> const htmlEscapeEntities[7] = {
    {'&',  "&amp;"},
    {'<',  "&lt;"},
    {'>',  "&gt;"},
    {'"',  "&quot;"},
    {'\'', "&#x27;"},
    {'`',  "&#x60;"},
    {'=',  "&#x3D;"}
};

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

inline constexpr unexpect_t unexpect = unexpect{};

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

template<class T>
concept ClearableContainerLike = requires {
        typename T::value_type;
        typename T::size_type;
        typename T::difference_type;
        typename T::reference;
        typename T::const_reference;
        typename T::iterator;
        typename T::const_iterator;
    } &&
    // size_type should be integral for normal containers
    std::is_integral_v<typename T::size_type> &&

    // ---- member begin/end with expected iterator types ----
    requires(T& t, const T& ct) {
        { t.begin() }  -> std::convertible_to<typename T::iterator>;
        { t.end() }    -> std::convertible_to<typename T::iterator>;
        { ct.begin() } -> std::convertible_to<typename T::const_iterator>;
        { ct.end() }   -> std::convertible_to<typename T::const_iterator>;
    } &&

    // ---- iterator “shape”: deref and increment ----
    requires(T& t, const T& ct) {
        { *t.begin() }  -> std::convertible_to<typename T::reference>;
        { *ct.begin() } -> std::convertible_to<typename T::const_reference>;
        { ++std::declval<typename T::iterator&>() } -> std::same_as<typename T::iterator&>;
    } &&

    // ---- size/empty/clear trio ----
    requires(T& t, const T& ct) {
        { ct.size() }  -> std::same_as<typename T::size_type>;
        { ct.empty() } -> std::convertible_to<bool>;
        { t.clear() }  -> std::same_as<void>;
    } &&

    // ---- default constructible (most std containers satisfy this) ----
    std::default_initializable<T>;

Description

This captures the common case of containers and data structures that can be default-constructed to empty, tested with .empty(), and reset with .clear().

Common cases of such containers include std::string, std::vector, std::optional, std::unique_ptr, std::shared_ptr, and many more.

Synopsis

Declared in <mrdocs/Support/CompareReflectedType.hpp>

template<typename T>
concept DescribedComparable = requires {
    typename describe::describe_members<T>;
};

Description

Semantically equivalent to has_describe_members<T>::value, but checked via a requires-expression so that MSVC treats it as a wholly distinct atomic constraint. This avoids an MSVC bug where a constrained operator<=>() in the same namespace breaks constraint evaluation for the unrelated merge() template.

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

template<class T>
concept DocCommentNode = std::derived_from<T, doc::Block> || std::derived_from<T, doc::Inline>;

Synopsis

Declared in <mrdocs/Metadata/DocComment.hpp>

template<class T>
concept DocCommentNodeTraversable = DocCommentNode<T> ||
    std::same_as<DocComment, T> ||
    (detail::IsPolymorphic<T> && DocCommentNode<typename T::value_type>);

Synopsis

Declared in <mrdocs/Support/Parse.hpp>

template<class T>
concept HasParse = requires(
    char const* first,
    char const* last,
    T& value)
{
    { parse(first, last, value) } -> std::same_as<ParseResult>;
};

Description

This concept checks if a type T has a parse function with the signature:


ParseResult
parse(
    char const* first,
    char const* last,
    T& value);

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

template<class T>
concept HasSentinel = requires
    {
        { sentinel_traits<T>::sentinel() } -> std::same_as<T>;
        { sentinel_traits<T>::is_sentinel(std::declval<const T&>()) } -> std::convertible_to<bool>;
    };

Synopsis

Declared in <mrdocs/Metadata/Symbol.hpp>

template<class SymbolTy>
concept SymbolParent = requires(SymbolTy const& I)
{
    { allMembers(I) } -> range_of<SymbolID>;
};

Description

In most cases T is another Symbol type that has a Members member which is a range of SymbolID values.

Synopsis

Declared in <mrdocs/Support/Concepts.hpp>

template<class T>
concept dereferenceable = requires(T const& t)
{
    { static_cast<bool>(t) };
    { *t };
};

Description

This concept checks if a type can be dereferenced to a value it represents and converted to a boolean value that represents if the object is in a valid state.

Examples of such types are std::optional, std::unique_ptr, std::shared_ptr, Polymorphic, pointers, etc.

Synopsis

Declared in <mrdocs/ADT/Nullable.hpp>

template<class T>
concept has_nullable_traits_v = requires
    {
        { nullable_traits<T>::is_null(std::declval<const T&>()) } -> std::convertible_to<bool>;
        { nullable_traits<T>::null() } -> std::same_as<T>;
        { nullable_traits<T>::make_null(std::declval<T&>()) } -> std::same_as<void>;
    };

Synopsis

Declared in <mrdocs/Support/Concepts.hpp>

template<class T>
concept pair_like = tuple_like<T> &&
    (std::tuple_size<std::remove_cvref_t<T>>::value == 2);

Description

This concept checks if a type is tuple-like and has exactly two elements.

Examples of such types are std::pair, std::array with two elements, and user-defined types that provide specializations for std::tuple_size and std::tuple_element with exactly two elements.

Synopsis

Declared in <mrdocs/Support/Concepts.hpp>

template<
    class T,
    class Base>
concept polymorphic_storage_for = requires(T const& t)
{
    { *t } -> std::convertible_to<Base const&>;
    { t.operator->() } -> std::convertible_to<Base const*>;
};

Description

This concept checks if a type is used to store derived objects of a base class.

Examples of such types are std::unique_ptr, std::shared_ptr, Polymorphic, etc.

The get() function might not always be available, but operator* and operator-> should be available and return a reference to the Base class.

Synopsis

Declared in <mrdocs/Support/Concepts.hpp>

template<
    class Range,
    class T>
concept range_of = std::ranges::range<Range> && std::same_as<std::ranges::range_value_t<Range>, T>;

Synopsis

Declared in <mrdocs/Support/Concepts.hpp>

template<class Range>
concept range_of_tuple_like = std::ranges::range<Range> && tuple_like<std::ranges::range_value_t<Range>>;

Description

This concept checks if a type is a range and all its elements are tuple-like.

Examples of such types are std::vector<std::tuple<...>>, std::list<std::pair<...>>, and user-defined types that provide specializations for std::tuple_size and std::tuple_element for their element type.

Synopsis

Declared in <mrdocs/Support/Concepts.hpp>

template<class T>
concept tuple_like = detail::has_tuple_size<T>::value &&
    detail::all_tuple_elements<T>::value;

Description

This concept checks if a type has a specialization of std::tuple_size and std::tuple_element for all elements in the range [0, N), where N is the value] of std::tuple_size.

Examples of such types are std::tuple, std::pair, std::array, and user-defined types that provide specializations for std::tuple_size and std::tuple_element.

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

template<
    class T,
    std::size_t N>
ArrayView<T>(T const(&)[N]) -> ArrayView<T>;

Synopsis

Declared in <mrdocs/ADT/ArrayView.hpp>

template<class T>
ArrayView<T>(
    T const*,
    std::size_t) -> ArrayView<T>;

Synopsis

Declared in <mrdocs/ADT/Overload.hpp>

template<class... Ts>
Overload<Ts...>(Ts...) -> Overload<Ts...>;

Description

Allows writing Overload{lambda1, lambda2, ...} without specifying template parameters.

Synopsis

Declared in <mrdocs/Support/RangeFor.hpp>

template<class Container>
RangeFor<Container>(Container const&) -> RangeFor<Container>;

Description

Deduction guide for RangeFor.

Synopsis

Declared in <mrdocs/Support/ScopeExit.hpp>

template<class F>
ScopeExit<F>(F) -> ScopeExit<F>;

Synopsis

Declared in <mrdocs/Support/ScopeExit.hpp>

template<class T>
ScopeExitRestore<T>(T&) -> ScopeExitRestore<T>;

Synopsis

Declared in <mrdocs/Support/ScopeExit.hpp>

template<
    class T,
    std::convertible_to<T> T2>
ScopeExitRestore<T>(
    T&,
    T2) -> ScopeExitRestore<T>;

Synopsis

Declared in <mrdocs/Support/Expected.hpp>

template<class E>
Unexpected<E>(E) -> Unexpected<E>;

Synopsis

Declared in <mrdocs/Support/Concepts.hpp>

using std::reference_constructs_from_temporary_v;

Synopsis

Declared in <mrdocs/Support/Concepts.hpp>

using std::reference_converts_from_temporary_v;

Synopsis

Declared in <mrdocs/Support/source_location.hpp>

using std::source_location;

Global namespace

Namespaces

mrdocs namespace

Namespaces

Types

Type Aliases

Enums

Functions

Variables

Concepts

Deduction Guides

Using Declarations

mrdocs::doc namespace

Types

Enums

Functions

Using Declarations

mrdocs::dom namespace

Namespaces

Types

Enums

Functions

Concepts

mrdocs::dom::JSON namespace

Functions

mrdocs::files namespace

Enums

Functions

mrdocs::helpers namespace

Functions

mrdocs::js namespace

Types

Enums

Functions

mrdocs::lua namespace

Types

Type Aliases

Enums

Functions

mrdocs::report namespace

Types

Enums

Functions

Variables

Description

Namespaces

Types

Type Aliases

Enums

Functions

Variables

Concepts

Deduction Guides

Using Declarations

Types

Enums

Functions

Using Declarations

Synopsis

Description

Base Classes

Member Functions

Static Member Functions

Data Members

Static Data Members

Non-Member Functions

Synopsis

Parameters

Synopsis

Synopsis

Synopsis

Synopsis

Synopsis

Synopsis

Synopsis

Synopsis

Synopsis

Synopsis

Synopsis

Synopsis