A helper class for piece-wise construction of an RNTupleDescriptor.

Used by RPageStorage implementations in order to construct the RNTupleDescriptor from the various header parts.

Definition at line 1725 of file RNTupleDescriptor.hxx.

Public Member Functions
RResult< void >	AddAttributeSet (Experimental::RNTupleAttrSetDescriptor &&attrSetDesc)
RResult< void >	AddCluster (RClusterDescriptor &&clusterDesc)
RResult< void >	AddClusterGroup (RClusterGroupDescriptor &&clusterGroup)
RResult< void >	AddColumn (RColumnDescriptor &&columnDesc)
RResult< void >	AddExtraTypeInfo (RExtraTypeInfoDescriptor &&extraTypeInfoDesc)
void	AddField (const RFieldDescriptor &fieldDesc)
RResult< void >	AddFieldLink (ROOT::DescriptorId_t fieldId, ROOT::DescriptorId_t linkId)
RResult< void >	AddFieldProjection (ROOT::DescriptorId_t sourceId, ROOT::DescriptorId_t targetId)
void	AddToOnDiskFooterSize (std::uint64_t size)
	The real footer size also include the page list envelopes.
void	BeginHeaderExtension ()
	Mark the beginning of the header extension; any fields and columns added after a call to this function are annotated as begin part of the header extension.
RResult< void >	EnsureValidDescriptor () const
	Checks whether invariants hold:
const RNTupleDescriptor &	GetDescriptor () const
RNTupleDescriptor	MoveDescriptor ()
void	ReplaceExtraTypeInfo (RExtraTypeInfoDescriptor &&extraTypeInfoDesc)
void	SetFeature (unsigned int flag)
	Sets the flag-th bit of the feature flag to 1.
void	SetNTuple (const std::string_view name, const std::string_view description)
void	SetOnDiskHeaderSize (std::uint64_t size)
void	SetOnDiskHeaderXxHash3 (std::uint64_t xxhash3)
void	SetSchemaFromExisting (const RNTupleDescriptor &descriptor)
	Copies the "schema" part of descriptor into the builder's descriptor.
void	SetVersion (std::uint16_t versionEpoch, std::uint16_t versionMajor, std::uint16_t versionMinor, std::uint16_t versionPatch)
void	SetVersionForWriting ()
void	ShiftAliasColumns (std::uint32_t offset)
	Shift column IDs of alias columns by offset.

Private Member Functions
RResult< void >	EnsureFieldExists (ROOT::DescriptorId_t fieldId) const

Private Attributes
RNTupleDescriptor	fDescriptor

#include <ROOT/RNTupleDescriptor.hxx>

Member Function Documentation

◆ AddAttributeSet()

ROOT::RResult< void > ROOT::Internal::RNTupleDescriptorBuilder::AddAttributeSet ( Experimental::RNTupleAttrSetDescriptor && attrSetDesc )

Definition at line 1387 of file RNTupleDescriptor.cxx.

◆ AddCluster()

ROOT::RResult< void > ROOT::Internal::RNTupleDescriptorBuilder::AddCluster ( RClusterDescriptor && clusterDesc )

Definition at line 1355 of file RNTupleDescriptor.cxx.

◆ AddClusterGroup()

ROOT::RResult< void > ROOT::Internal::RNTupleDescriptorBuilder::AddClusterGroup ( RClusterGroupDescriptor && clusterGroup )

Definition at line 1310 of file RNTupleDescriptor.cxx.

◆ AddColumn()

ROOT::RResult< void > ROOT::Internal::RNTupleDescriptorBuilder::AddColumn ( RColumnDescriptor && columnDesc )

Definition at line 1256 of file RNTupleDescriptor.cxx.

◆ AddExtraTypeInfo()

ROOT::RResult< void > ROOT::Internal::RNTupleDescriptorBuilder::AddExtraTypeInfo ( RExtraTypeInfoDescriptor && extraTypeInfoDesc )

Definition at line 1365 of file RNTupleDescriptor.cxx.

◆ AddField()

void ROOT::Internal::RNTupleDescriptorBuilder::AddField ( const RFieldDescriptor & fieldDesc )

Definition at line 1193 of file RNTupleDescriptor.cxx.

◆ AddFieldLink()

ROOT::RResult< void > ROOT::Internal::RNTupleDescriptorBuilder::AddFieldLink	(	ROOT::DescriptorId_t	fieldId,
		ROOT::DescriptorId_t	linkId )

Definition at line 1204 of file RNTupleDescriptor.cxx.

◆ AddFieldProjection()

ROOT::RResult< void > ROOT::Internal::RNTupleDescriptorBuilder::AddFieldProjection	(	ROOT::DescriptorId_t	sourceId,
		ROOT::DescriptorId_t	targetId )

Definition at line 1228 of file RNTupleDescriptor.cxx.

◆ AddToOnDiskFooterSize()

void ROOT::Internal::RNTupleDescriptorBuilder::AddToOnDiskFooterSize ( std::uint64_t size )

inline

The real footer size also include the page list envelopes.

Definition at line 1756 of file RNTupleDescriptor.hxx.

◆ BeginHeaderExtension()

void ROOT::Internal::RNTupleDescriptorBuilder::BeginHeaderExtension ( )

Mark the beginning of the header extension; any fields and columns added after a call to this function are annotated as begin part of the header extension.

Definition at line 1326 of file RNTupleDescriptor.cxx.

◆ EnsureFieldExists()

ROOT::RResult< void > ROOT::Internal::RNTupleDescriptorBuilder::EnsureFieldExists ( ROOT::DescriptorId_t fieldId ) const

private

Definition at line 1016 of file RNTupleDescriptor.cxx.

◆ EnsureValidDescriptor()

ROOT::RResult< void > ROOT::Internal::RNTupleDescriptorBuilder::EnsureValidDescriptor ( ) const

Checks whether invariants hold:

RNTuple epoch is valid
RNTuple name is valid
Fields have valid parents
Number of columns is constant across column representations

Definition at line 1023 of file RNTupleDescriptor.cxx.

◆ GetDescriptor()

const RNTupleDescriptor & ROOT::Internal::RNTupleDescriptorBuilder::GetDescriptor ( ) const

inline

Definition at line 1737 of file RNTupleDescriptor.hxx.

◆ MoveDescriptor()

ROOT::RNTupleDescriptor ROOT::Internal::RNTupleDescriptorBuilder::MoveDescriptor ( )

Definition at line 1062 of file RNTupleDescriptor.cxx.

◆ ReplaceExtraTypeInfo()

void ROOT::Internal::RNTupleDescriptorBuilder::ReplaceExtraTypeInfo ( RExtraTypeInfoDescriptor && extraTypeInfoDesc )

Definition at line 1376 of file RNTupleDescriptor.cxx.

◆ SetFeature()

void ROOT::Internal::RNTupleDescriptorBuilder::SetFeature ( unsigned int flag )

Sets the flag-th bit of the feature flag to 1.

Note that flag itself is not a bitmask, just the bit index of the flag to enable.

Definition at line 1105 of file RNTupleDescriptor.cxx.

◆ SetNTuple()

void ROOT::Internal::RNTupleDescriptorBuilder::SetNTuple	(	const std::string_view	name,
		const std::string_view	description )

Definition at line 1098 of file RNTupleDescriptor.cxx.

◆ SetOnDiskHeaderSize()

void ROOT::Internal::RNTupleDescriptorBuilder::SetOnDiskHeaderSize ( std::uint64_t size )

inline

Definition at line 1754 of file RNTupleDescriptor.hxx.

◆ SetOnDiskHeaderXxHash3()

void ROOT::Internal::RNTupleDescriptorBuilder::SetOnDiskHeaderXxHash3 ( std::uint64_t xxhash3 )

inline

Definition at line 1753 of file RNTupleDescriptor.hxx.

◆ SetSchemaFromExisting()

void ROOT::Internal::RNTupleDescriptorBuilder::SetSchemaFromExisting ( const RNTupleDescriptor & descriptor )

Copies the "schema" part of descriptor into the builder's descriptor.

This resets the builder's descriptor.

Definition at line 1321 of file RNTupleDescriptor.cxx.

◆ SetVersion()

void ROOT::Internal::RNTupleDescriptorBuilder::SetVersion	(	std::uint16_t	versionEpoch,
		std::uint16_t	versionMajor,
		std::uint16_t	versionMinor,
		std::uint16_t	versionPatch )

Definition at line 1078 of file RNTupleDescriptor.cxx.

◆ SetVersionForWriting()

void ROOT::Internal::RNTupleDescriptorBuilder::SetVersionForWriting ( )

Definition at line 1090 of file RNTupleDescriptor.cxx.

◆ ShiftAliasColumns()

void ROOT::Internal::RNTupleDescriptorBuilder::ShiftAliasColumns ( std::uint32_t offset )

Shift column IDs of alias columns by offset.

If the descriptor is constructed in pieces consisting of physical and alias columns (regular and projected fields), the natural column order would be

Physical and alias columns of piece one
Physical and alias columns of piece two
etc. What we want, however, are first all physical column IDs and then all alias column IDs. This method adds offset to the logical column IDs of all alias columns and fixes up the corresponding column IDs in the projected field descriptors. In this way, a new piece of physical and alias columns can first shift the existing alias columns by the number of new physical columns, resulting in the following order
Physical columns of piece one
Physical columns of piece two
...

Logical columns of piece two

...

Definition at line 1332 of file RNTupleDescriptor.cxx.

Member Data Documentation

◆ fDescriptor

RNTupleDescriptor ROOT::Internal::RNTupleDescriptorBuilder::fDescriptor

private

Definition at line 1727 of file RNTupleDescriptor.hxx.

The documentation for this class was generated from the following files:

tree/ntuple/inc/ROOT/RNTupleDescriptor.hxx
tree/ntuple/src/RNTupleDescriptor.cxx

Public Member Functions

Private Member Functions

Private Attributes

Member Function Documentation

◆ AddAttributeSet()

◆ AddCluster()

◆ AddClusterGroup()

◆ AddColumn()

◆ AddExtraTypeInfo()

◆ AddField()

◆ AddFieldLink()

◆ AddFieldProjection()

◆ AddToOnDiskFooterSize()

◆ BeginHeaderExtension()

◆ EnsureFieldExists()

◆ EnsureValidDescriptor()

◆ GetDescriptor()

◆ MoveDescriptor()

◆ ReplaceExtraTypeInfo()

◆ SetFeature()

◆ SetNTuple()

◆ SetOnDiskHeaderSize()

◆ SetOnDiskHeaderXxHash3()

◆ SetSchemaFromExisting()

◆ SetVersion()

◆ SetVersionForWriting()

◆ ShiftAliasColumns()

Member Data Documentation

◆ fDescriptor