Generic information about the physical location of data.

Values depend on the concrete storage type. E.g., for a local file fPosition might be a 64bit file offset. Referenced objects on storage can be compressed and therefore we need to store their actual size. TODO(jblomer): consider moving this to RNTupleDescriptor

Definition at line 218 of file RNTupleUtil.hxx.

Public Types
enum	ELocatorType : std::uint8_t { kTypeFile = 0x00 , kTypeDAOS = 0x02 , kLastSerializableType = 0x7f , kTypePageZero = kLastSerializableType + 1 , kTypeUnknown }
	Values for the Type field in non-disk locators. More...

Public Member Functions
template<typename T >
const T &	GetPosition () const

bool	operator== (const RNTupleLocator &other) const

Public Attributes
std::uint64_t	fBytesOnStorage = 0

std::variant< std::uint64_t, RNTupleLocatorObject64 >	fPosition {}
	Simple on-disk locators consisting of a 64-bit offset use variant type `uint64_t`; extended locators have `fPosition.index()` > 0.

std::uint8_t	fReserved = 0
	Reserved for use by concrete storage backends.

ELocatorType	fType = kTypeFile
	For non-disk locators, the value for the Type field.

#include <ROOT/RNTupleUtil.hxx>

Member Enumeration Documentation

◆ ELocatorType

enum ROOT::Experimental::RNTupleLocator::ELocatorType : std::uint8_t

Values for the Type field in non-disk locators.

Serializable types must have the MSb == 0; see doc/BinaryFormatSpecification.md for details

Enumerator
kTypeFile
kTypeDAOS
kLastSerializableType
kTypePageZero
kTypeUnknown

Definition at line 221 of file RNTupleUtil.hxx.

Member Function Documentation

◆ GetPosition()

template<typename T >

const T & ROOT::Experimental::RNTupleLocator::GetPosition ( ) const

inline

Definition at line 247 of file RNTupleUtil.hxx.

◆ operator==()

bool ROOT::Experimental::RNTupleLocator::operator== ( const RNTupleLocator & other ) const

inline

Definition at line 242 of file RNTupleUtil.hxx.

Member Data Documentation

◆ fBytesOnStorage

std::uint64_t ROOT::Experimental::RNTupleLocator::fBytesOnStorage = 0

Definition at line 232 of file RNTupleUtil.hxx.

◆ fPosition

std::variant<std::uint64_t, RNTupleLocatorObject64> ROOT::Experimental::RNTupleLocator::fPosition {}

Simple on-disk locators consisting of a 64-bit offset use variant type uint64_t; extended locators have fPosition.index() > 0.

Definition at line 235 of file RNTupleUtil.hxx.

◆ fReserved

std::uint8_t ROOT::Experimental::RNTupleLocator::fReserved = 0

Reserved for use by concrete storage backends.

Definition at line 240 of file RNTupleUtil.hxx.

◆ fType

ELocatorType ROOT::Experimental::RNTupleLocator::fType = kTypeFile

For non-disk locators, the value for the Type field.

This makes it possible to have different type values even if the payload structure is identical.

Definition at line 238 of file RNTupleUtil.hxx.

Collaboration diagram for ROOT::Experimental::RNTupleLocator:

[legend]

The documentation for this struct was generated from the following file:

tree/ntuple/v7/inc/ROOT/RNTupleUtil.hxx

Public Types

Public Member Functions

Public Attributes