doc/master/RField_8cxx_source.html

/// \file RField.cxx

/// \ingroup NTuple

/// \author Jakob Blomer <jblomer@cern.ch>

/// \date 2018-10-15


/*************************************************************************

 * Copyright (C) 1995-2019, Rene Brun and Fons Rademakers.               *

 * All rights reserved.                                                  *

 *                                                                       *

 * For the licensing terms see $ROOTSYS/LICENSE.                         *

 * For the list of contributors see $ROOTSYS/README/CREDITS.             *

 *************************************************************************/


#include <ROOT/RColumn.hxx>

#include <ROOT/REntry.hxx>

#include <ROOT/RError.hxx>

#include <ROOT/RField.hxx>

#include <ROOT/RFieldVisitor.hxx>

#include <ROOT/RLogger.hxx>

#include <ROOT/RNTupleModel.hxx>

#include <ROOT/RNTupleSerialize.hxx>

#include <ROOT/RNTupleTypes.hxx>


#include <algorithm>

#include <cstdint>

#include <exception>

#include <functional>

#include <iostream>

#include <memory>

#include <string_view>

#include <type_traits>

#include <unordered_set>


void ROOT::Internal::SetAllowFieldSubstitutions(RFieldZero &fieldZero, bool val)

{

   fieldZero.fAllowFieldSubstitutions = val;

}


std::unique_ptr<ROOT::RFieldBase> ROOT::RFieldZero::CloneImpl(std::string_view /*newName*/) const

{

   auto result = std::make_unique<RFieldZero>();

   for (auto &f : fSubfields)

      result->Attach(f->Clone(f->GetFieldName()));

   return result;

}


std::vector<std::unique_ptr<ROOT::RFieldBase>> ROOT::RFieldZero::ReleaseSubfields()

{

   std::vector<std::unique_ptr<ROOT::RFieldBase>> result;

   std::swap(fSubfields, result);

   for (auto &f : result)

      f->fParent = nullptr;

   return result;

}


void ROOT::RFieldZero::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitFieldZero(*this);

}


//------------------------------------------------------------------------------


const ROOT::RFieldBase::RColumnRepresentations &ROOT::RCardinalityField::GetColumnRepresentations() const

{

   static RColumnRepresentations representations({{ENTupleColumnType::kSplitIndex64},

                                                  {ENTupleColumnType::kIndex64},

                                                  {ENTupleColumnType::kSplitIndex32},

                                                  {ENTupleColumnType::kIndex32}},

                                                 {});

   return representations;

}


void ROOT::RCardinalityField::GenerateColumns(const ROOT::RNTupleDescriptor &desc)

{

   GenerateColumnsImpl<ROOT::Internal::RColumnIndex>(desc);

}


void ROOT::RCardinalityField::ReconcileOnDiskField(const RNTupleDescriptor &desc)

{

   const auto &fieldDesc = desc.GetFieldDescriptor(GetOnDiskId());

   EnsureMatchingOnDiskField(fieldDesc, kDiffTypeVersion | kDiffStructure | kDiffTypeName).ThrowOnError();

   if (fieldDesc.GetStructure() == ENTupleStructure::kPlain) {

      if (fieldDesc.GetTypeName().rfind("ROOT::RNTupleCardinality<", 0) != 0) {

         throw RException(R__FAIL("RCardinalityField " + GetQualifiedFieldName() +

                                  " expects an on-disk leaf field of the same type"));

      }

   } else if (fieldDesc.GetStructure() != ENTupleStructure::kCollection) {

      throw RException(R__FAIL("invalid on-disk structural role for RCardinalityField " + GetQualifiedFieldName()));

   }

}


void ROOT::RCardinalityField::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitCardinalityField(*this);

}


const ROOT::RField<ROOT::RNTupleCardinality<std::uint32_t>> *ROOT::RCardinalityField::As32Bit() const

{

   return dynamic_cast<const RField<RNTupleCardinality<std::uint32_t>> *>(this);

}


const ROOT::RField<ROOT::RNTupleCardinality<std::uint64_t>> *ROOT::RCardinalityField::As64Bit() const

{

   return dynamic_cast<const RField<RNTupleCardinality<std::uint64_t>> *>(this);

}


//------------------------------------------------------------------------------


template <typename T>


void ROOT::RSimpleField<T>::ReconcileIntegralField(const RNTupleDescriptor &desc)

{

   const RFieldDescriptor &fieldDesc = desc.GetFieldDescriptor(GetOnDiskId());

   EnsureMatchingOnDiskField(fieldDesc, kDiffTypeName);


   if (fieldDesc.IsCustomEnum(desc)) {

      SetOnDiskId(desc.FindFieldId("_0", GetOnDiskId()));

      return;

   }


   static const std::string gIntegralTypeNames[] = {"bool",         "char",          "std::int8_t",  "std::uint8_t",

                                                    "std::int16_t", "std::uint16_t", "std::int32_t", "std::uint32_t",

                                                    "std::int64_t", "std::uint64_t"};

   if (std::find(std::begin(gIntegralTypeNames), std::end(gIntegralTypeNames), fieldDesc.GetTypeName()) ==

       std::end(gIntegralTypeNames)) {

      throw RException(R__FAIL("unexpected on-disk type name '" + fieldDesc.GetTypeName() + "' for field of type '" +

                               GetTypeName() + "'"));

   }

}


template <typename T>


void ROOT::RSimpleField<T>::ReconcileFloatingPointField(const RNTupleDescriptor &desc)

{

   const RFieldDescriptor &fieldDesc = desc.GetFieldDescriptor(GetOnDiskId());

   EnsureMatchingOnDiskField(fieldDesc, kDiffTypeName);


   if (!(fieldDesc.GetTypeName() == "float" || fieldDesc.GetTypeName() == "double")) {

      throw RException(R__FAIL("unexpected on-disk type name '" + fieldDesc.GetTypeName() + "' for field of type '" +

                               GetTypeName() + "'"));

   }

}


//------------------------------------------------------------------------------


template class ROOT::RSimpleField<char>;


const ROOT::RFieldBase::RColumnRepresentations &ROOT::RField<char>::GetColumnRepresentations() const

{

   static RColumnRepresentations representations({{ENTupleColumnType::kChar}}, {{ENTupleColumnType::kInt8},

                                                                                {ENTupleColumnType::kUInt8},

                                                                                {ENTupleColumnType::kInt16},

                                                                                {ENTupleColumnType::kUInt16},

                                                                                {ENTupleColumnType::kInt32},

                                                                                {ENTupleColumnType::kUInt32},

                                                                                {ENTupleColumnType::kInt64},

                                                                                {ENTupleColumnType::kUInt64},

                                                                                {ENTupleColumnType::kSplitInt16},

                                                                                {ENTupleColumnType::kSplitUInt16},

                                                                                {ENTupleColumnType::kSplitInt32},

                                                                                {ENTupleColumnType::kSplitUInt32},

                                                                                {ENTupleColumnType::kSplitInt64},

                                                                                {ENTupleColumnType::kSplitUInt64},

                                                                                {ENTupleColumnType::kBit}});

   return representations;

}


void ROOT::RField<char>::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitCharField(*this);

}


//------------------------------------------------------------------------------


template class ROOT::RSimpleField<std::byte>;


const ROOT::RFieldBase::RColumnRepresentations &ROOT::RField<std::byte>::GetColumnRepresentations() const

{

   static RColumnRepresentations representations({{ENTupleColumnType::kByte}}, {});

   return representations;

}


void ROOT::RField<std::byte>::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitByteField(*this);

}


//------------------------------------------------------------------------------


template class ROOT::RSimpleField<int8_t>;


const ROOT::RFieldBase::RColumnRepresentations &ROOT::RIntegralField<std::int8_t>::GetColumnRepresentations() const

{

   static RColumnRepresentations representations({{ENTupleColumnType::kInt8}}, {{ENTupleColumnType::kChar},

                                                                                {ENTupleColumnType::kUInt8},

                                                                                {ENTupleColumnType::kInt16},

                                                                                {ENTupleColumnType::kUInt16},

                                                                                {ENTupleColumnType::kInt32},

                                                                                {ENTupleColumnType::kUInt32},

                                                                                {ENTupleColumnType::kInt64},

                                                                                {ENTupleColumnType::kUInt64},

                                                                                {ENTupleColumnType::kSplitInt16},

                                                                                {ENTupleColumnType::kSplitUInt16},

                                                                                {ENTupleColumnType::kSplitInt32},

                                                                                {ENTupleColumnType::kSplitUInt32},

                                                                                {ENTupleColumnType::kSplitInt64},

                                                                                {ENTupleColumnType::kSplitUInt64},

                                                                                {ENTupleColumnType::kBit}});

   return representations;

}


void ROOT::RIntegralField<std::int8_t>::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitInt8Field(*this);

}


//------------------------------------------------------------------------------


template class ROOT::RSimpleField<uint8_t>;


const ROOT::RFieldBase::RColumnRepresentations &ROOT::RIntegralField<std::uint8_t>::GetColumnRepresentations() const

{

   static RColumnRepresentations representations({{ENTupleColumnType::kUInt8}}, {{ENTupleColumnType::kChar},

                                                                                 {ENTupleColumnType::kInt8},

                                                                                 {ENTupleColumnType::kInt16},

                                                                                 {ENTupleColumnType::kUInt16},

                                                                                 {ENTupleColumnType::kInt32},

                                                                                 {ENTupleColumnType::kUInt32},

                                                                                 {ENTupleColumnType::kInt64},

                                                                                 {ENTupleColumnType::kUInt64},

                                                                                 {ENTupleColumnType::kSplitInt16},

                                                                                 {ENTupleColumnType::kSplitUInt16},

                                                                                 {ENTupleColumnType::kSplitInt32},

                                                                                 {ENTupleColumnType::kSplitUInt32},

                                                                                 {ENTupleColumnType::kSplitInt64},

                                                                                 {ENTupleColumnType::kSplitUInt64},

                                                                                 {ENTupleColumnType::kBit}});

   return representations;

}


void ROOT::RIntegralField<std::uint8_t>::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitUInt8Field(*this);

}


//------------------------------------------------------------------------------


template class ROOT::RSimpleField<bool>;


const ROOT::RFieldBase::RColumnRepresentations &ROOT::RField<bool>::GetColumnRepresentations() const

{

   static RColumnRepresentations representations({{ENTupleColumnType::kBit}}, {{ENTupleColumnType::kChar},

                                                                               {ENTupleColumnType::kInt8},

                                                                               {ENTupleColumnType::kUInt8},

                                                                               {ENTupleColumnType::kInt16},

                                                                               {ENTupleColumnType::kUInt16},

                                                                               {ENTupleColumnType::kInt32},

                                                                               {ENTupleColumnType::kUInt32},

                                                                               {ENTupleColumnType::kInt64},

                                                                               {ENTupleColumnType::kUInt64},

                                                                               {ENTupleColumnType::kSplitInt16},

                                                                               {ENTupleColumnType::kSplitUInt16},

                                                                               {ENTupleColumnType::kSplitInt32},

                                                                               {ENTupleColumnType::kSplitUInt32},

                                                                               {ENTupleColumnType::kSplitInt64},

                                                                               {ENTupleColumnType::kSplitUInt64}});

   return representations;

}


void ROOT::RField<bool>::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitBoolField(*this);

}


//------------------------------------------------------------------------------


template class ROOT::RSimpleField<float>;


const ROOT::RFieldBase::RColumnRepresentations &ROOT::RField<float>::GetColumnRepresentations() const

{

   static RColumnRepresentations representations({{ENTupleColumnType::kSplitReal32},

                                                  {ENTupleColumnType::kReal32},

                                                  {ENTupleColumnType::kReal16},

                                                  {ENTupleColumnType::kReal32Trunc},

                                                  {ENTupleColumnType::kReal32Quant}},

                                                 {{ENTupleColumnType::kSplitReal64}, {ENTupleColumnType::kReal64}});

   return representations;

}


void ROOT::RField<float>::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitFloatField(*this);

}


//------------------------------------------------------------------------------


template class ROOT::RSimpleField<double>;


const ROOT::RFieldBase::RColumnRepresentations &ROOT::RField<double>::GetColumnRepresentations() const

{

   static RColumnRepresentations representations({{ENTupleColumnType::kSplitReal64},

                                                  {ENTupleColumnType::kReal64},

                                                  {ENTupleColumnType::kSplitReal32},

                                                  {ENTupleColumnType::kReal32},

                                                  {ENTupleColumnType::kReal16},

                                                  {ENTupleColumnType::kReal32Trunc},

                                                  {ENTupleColumnType::kReal32Quant}},

                                                 {});

   return representations;

}


void ROOT::RField<double>::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitDoubleField(*this);

}


void ROOT::RField<double>::SetDouble32()

{

   fTypeAlias = "Double32_t";

}


//------------------------------------------------------------------------------


template class ROOT::RSimpleField<int16_t>;


const ROOT::RFieldBase::RColumnRepresentations &ROOT::RIntegralField<std::int16_t>::GetColumnRepresentations() const

{

   static RColumnRepresentations representations({{ENTupleColumnType::kSplitInt16}, {ENTupleColumnType::kInt16}},

                                                 {{ENTupleColumnType::kChar},

                                                  {ENTupleColumnType::kInt8},

                                                  {ENTupleColumnType::kUInt8},

                                                  {ENTupleColumnType::kUInt16},

                                                  {ENTupleColumnType::kInt32},

                                                  {ENTupleColumnType::kUInt32},

                                                  {ENTupleColumnType::kInt64},

                                                  {ENTupleColumnType::kUInt64},

                                                  {ENTupleColumnType::kSplitUInt16},

                                                  {ENTupleColumnType::kSplitInt32},

                                                  {ENTupleColumnType::kSplitUInt32},

                                                  {ENTupleColumnType::kSplitInt64},

                                                  {ENTupleColumnType::kSplitUInt64},

                                                  {ENTupleColumnType::kBit}});

   return representations;

}


void ROOT::RIntegralField<std::int16_t>::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitInt16Field(*this);

}


//------------------------------------------------------------------------------


template class ROOT::RSimpleField<uint16_t>;


const ROOT::RFieldBase::RColumnRepresentations &ROOT::RIntegralField<std::uint16_t>::GetColumnRepresentations() const

{

   static RColumnRepresentations representations({{ENTupleColumnType::kSplitUInt16}, {ENTupleColumnType::kUInt16}},

                                                 {{ENTupleColumnType::kChar},

                                                  {ENTupleColumnType::kInt8},

                                                  {ENTupleColumnType::kUInt8},

                                                  {ENTupleColumnType::kInt16},

                                                  {ENTupleColumnType::kInt32},

                                                  {ENTupleColumnType::kUInt32},

                                                  {ENTupleColumnType::kInt64},

                                                  {ENTupleColumnType::kUInt64},

                                                  {ENTupleColumnType::kSplitInt16},

                                                  {ENTupleColumnType::kSplitInt32},

                                                  {ENTupleColumnType::kSplitUInt32},

                                                  {ENTupleColumnType::kSplitInt64},

                                                  {ENTupleColumnType::kSplitUInt64},

                                                  {ENTupleColumnType::kBit}});

   return representations;

}


void ROOT::RIntegralField<std::uint16_t>::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitUInt16Field(*this);

}


//------------------------------------------------------------------------------


template class ROOT::RSimpleField<int32_t>;


const ROOT::RFieldBase::RColumnRepresentations &ROOT::RIntegralField<std::int32_t>::GetColumnRepresentations() const

{

   static RColumnRepresentations representations({{ENTupleColumnType::kSplitInt32}, {ENTupleColumnType::kInt32}},

                                                 {{ENTupleColumnType::kChar},

                                                  {ENTupleColumnType::kInt8},

                                                  {ENTupleColumnType::kUInt8},

                                                  {ENTupleColumnType::kInt16},

                                                  {ENTupleColumnType::kUInt16},

                                                  {ENTupleColumnType::kUInt32},

                                                  {ENTupleColumnType::kInt64},

                                                  {ENTupleColumnType::kUInt64},

                                                  {ENTupleColumnType::kSplitInt16},

                                                  {ENTupleColumnType::kSplitUInt16},

                                                  {ENTupleColumnType::kSplitUInt32},

                                                  {ENTupleColumnType::kSplitInt64},

                                                  {ENTupleColumnType::kSplitUInt64},

                                                  {ENTupleColumnType::kBit}});

   return representations;

}


void ROOT::RIntegralField<std::int32_t>::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitInt32Field(*this);

}


//------------------------------------------------------------------------------


template class ROOT::RSimpleField<uint32_t>;


const ROOT::RFieldBase::RColumnRepresentations &ROOT::RIntegralField<std::uint32_t>::GetColumnRepresentations() const

{

   static RColumnRepresentations representations({{ENTupleColumnType::kSplitUInt32}, {ENTupleColumnType::kUInt32}},

                                                 {{ENTupleColumnType::kChar},

                                                  {ENTupleColumnType::kInt8},

                                                  {ENTupleColumnType::kUInt8},

                                                  {ENTupleColumnType::kInt16},

                                                  {ENTupleColumnType::kUInt16},

                                                  {ENTupleColumnType::kInt32},

                                                  {ENTupleColumnType::kInt64},

                                                  {ENTupleColumnType::kUInt64},

                                                  {ENTupleColumnType::kSplitInt16},

                                                  {ENTupleColumnType::kSplitUInt16},

                                                  {ENTupleColumnType::kSplitInt32},

                                                  {ENTupleColumnType::kSplitInt64},

                                                  {ENTupleColumnType::kSplitUInt64},

                                                  {ENTupleColumnType::kBit}});

   return representations;

}


void ROOT::RIntegralField<std::uint32_t>::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitUInt32Field(*this);

}


//------------------------------------------------------------------------------


template class ROOT::RSimpleField<uint64_t>;


const ROOT::RFieldBase::RColumnRepresentations &ROOT::RIntegralField<std::uint64_t>::GetColumnRepresentations() const

{

   static RColumnRepresentations representations({{ENTupleColumnType::kSplitUInt64}, {ENTupleColumnType::kUInt64}},

                                                 {{ENTupleColumnType::kChar},

                                                  {ENTupleColumnType::kInt8},

                                                  {ENTupleColumnType::kUInt8},

                                                  {ENTupleColumnType::kInt16},

                                                  {ENTupleColumnType::kUInt16},

                                                  {ENTupleColumnType::kInt32},

                                                  {ENTupleColumnType::kUInt32},

                                                  {ENTupleColumnType::kInt64},

                                                  {ENTupleColumnType::kSplitInt16},

                                                  {ENTupleColumnType::kSplitUInt16},

                                                  {ENTupleColumnType::kSplitInt32},

                                                  {ENTupleColumnType::kSplitUInt32},

                                                  {ENTupleColumnType::kSplitInt64},

                                                  {ENTupleColumnType::kBit}});

   return representations;

}


void ROOT::RIntegralField<std::uint64_t>::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitUInt64Field(*this);

}


//------------------------------------------------------------------------------


template class ROOT::RSimpleField<int64_t>;


const ROOT::RFieldBase::RColumnRepresentations &ROOT::RIntegralField<std::int64_t>::GetColumnRepresentations() const

{

   static RColumnRepresentations representations({{ENTupleColumnType::kSplitInt64}, {ENTupleColumnType::kInt64}},

                                                 {{ENTupleColumnType::kChar},

                                                  {ENTupleColumnType::kInt8},

                                                  {ENTupleColumnType::kUInt8},

                                                  {ENTupleColumnType::kInt16},

                                                  {ENTupleColumnType::kUInt16},

                                                  {ENTupleColumnType::kInt32},

                                                  {ENTupleColumnType::kUInt32},

                                                  {ENTupleColumnType::kUInt64},

                                                  {ENTupleColumnType::kSplitInt16},

                                                  {ENTupleColumnType::kSplitUInt16},

                                                  {ENTupleColumnType::kSplitInt32},

                                                  {ENTupleColumnType::kSplitUInt32},

                                                  {ENTupleColumnType::kSplitUInt64},

                                                  {ENTupleColumnType::kBit}});

   return representations;

}


void ROOT::RIntegralField<std::int64_t>::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitInt64Field(*this);

}


//------------------------------------------------------------------------------


const ROOT::RFieldBase::RColumnRepresentations &ROOT::RField<std::string>::GetColumnRepresentations() const

{

   static RColumnRepresentations representations({{ENTupleColumnType::kSplitIndex64, ENTupleColumnType::kChar},

                                                  {ENTupleColumnType::kIndex64, ENTupleColumnType::kChar},

                                                  {ENTupleColumnType::kSplitIndex32, ENTupleColumnType::kChar},

                                                  {ENTupleColumnType::kIndex32, ENTupleColumnType::kChar}},

                                                 {});

   return representations;

}


void ROOT::RField<std::string>::GenerateColumns()

{

   GenerateColumnsImpl<ROOT::Internal::RColumnIndex, char>();

}


void ROOT::RField<std::string>::GenerateColumns(const ROOT::RNTupleDescriptor &desc)

{

   GenerateColumnsImpl<ROOT::Internal::RColumnIndex, char>(desc);

}


std::size_t ROOT::RField<std::string>::AppendImpl(const void *from)

{

   auto typedValue = static_cast<const std::string *>(from);

   auto length = typedValue->length();

   fAuxiliaryColumn->AppendV(typedValue->data(), length);

   fIndex += length;

   fPrincipalColumn->Append(&fIndex);

   return length + fPrincipalColumn->GetElement()->GetPackedSize();

}


void ROOT::RField<std::string>::ReadGlobalImpl(ROOT::NTupleSize_t globalIndex, void *to)

{

   auto typedValue = static_cast<std::string *>(to);

   RNTupleLocalIndex collectionStart;

   ROOT::NTupleSize_t nChars;

   fPrincipalColumn->GetCollectionInfo(globalIndex, &collectionStart, &nChars);

   if (nChars == 0) {

      typedValue->clear();

   } else {

      typedValue->resize(nChars);

      fAuxiliaryColumn->ReadV(collectionStart, nChars, const_cast<char *>(typedValue->data()));

   }

}


void ROOT::RField<std::string>::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitStringField(*this);

}


//------------------------------------------------------------------------------


ROOT::RRecordField::RRecordField(std::string_view name, const RRecordField &source)

   : ROOT::RFieldBase(name, source.GetTypeName(), ROOT::ENTupleStructure::kRecord, false /* isSimple */),

     fMaxAlignment(source.fMaxAlignment),

     fSize(source.fSize),

     fOffsets(source.fOffsets)

{

   for (const auto &f : source.GetConstSubfields())

      Attach(f->Clone(f->GetFieldName()));

   fTraits = source.fTraits;

}


ROOT::RRecordField::RRecordField(std::string_view fieldName, std::string_view typeName)

   : ROOT::RFieldBase(fieldName, typeName, ROOT::ENTupleStructure::kRecord, false /* isSimple */)

{

}


void ROOT::RRecordField::AttachItemFields(std::vector<std::unique_ptr<RFieldBase>> itemFields)

{

   fTraits |= kTraitTrivialType;

   for (auto &item : itemFields) {

      fMaxAlignment = std::max(fMaxAlignment, item->GetAlignment());

      fSize += GetItemPadding(fSize, item->GetAlignment()) + item->GetValueSize();

      fTraits &= item->GetTraits();

      Attach(std::move(item));

   }

   // Trailing padding: although this is implementation-dependent, most add enough padding to comply with the

   // requirements of the type with strictest alignment

   fSize += GetItemPadding(fSize, fMaxAlignment);

}


std::unique_ptr<ROOT::RFieldBase>


ROOT::Internal::CreateEmulatedRecordField(std::string_view fieldName,

                                          std::vector<std::unique_ptr<RFieldBase>> itemFields,

                                          std::string_view emulatedFromType)

{

   R__ASSERT(!emulatedFromType.empty());

   return std::unique_ptr<RFieldBase>(new RRecordField(fieldName, std::move(itemFields), emulatedFromType));

}


std::unique_ptr<ROOT::RFieldBase> ROOT::Internal::CreateEmulatedVectorField(std::string_view fieldName,

                                                                            std::unique_ptr<RFieldBase> itemField,

                                                                            std::string_view emulatedFromType)

{

   R__ASSERT(!emulatedFromType.empty());

   return std::unique_ptr<RFieldBase>(new RVectorField(fieldName, std::move(itemField), emulatedFromType));

}


ROOT::RRecordField::RRecordField(std::string_view fieldName, std::vector<std::unique_ptr<RFieldBase>> itemFields,

                                 std::string_view emulatedFromType)

   : ROOT::RFieldBase(fieldName, emulatedFromType, ROOT::ENTupleStructure::kRecord, false /* isSimple */)

{

   fTraits |= kTraitTrivialType;

   fOffsets.reserve(itemFields.size());

   for (auto &item : itemFields) {

      fSize += GetItemPadding(fSize, item->GetAlignment());

      fOffsets.push_back(fSize);

      fMaxAlignment = std::max(fMaxAlignment, item->GetAlignment());

      fSize += item->GetValueSize();

      fTraits &= item->GetTraits();

      Attach(std::move(item));

   }

   fTraits |= !emulatedFromType.empty() * kTraitEmulatedField;

   // Trailing padding: although this is implementation-dependent, most add enough padding to comply with the

   // requirements of the type with strictest alignment

   fSize += GetItemPadding(fSize, fMaxAlignment);

}


ROOT::RRecordField::RRecordField(std::string_view fieldName, std::vector<std::unique_ptr<RFieldBase>> itemFields)

   : ROOT::RRecordField(fieldName, std::move(itemFields), "")

{

}


std::size_t ROOT::RRecordField::GetItemPadding(std::size_t baseOffset, std::size_t itemAlignment) const

{

   if (itemAlignment > 1) {

      auto remainder = baseOffset % itemAlignment;

      if (remainder != 0)

         return itemAlignment - remainder;

   }

   return 0;

}


std::unique_ptr<ROOT::RFieldBase> ROOT::RRecordField::CloneImpl(std::string_view newName) const

{

   return std::unique_ptr<RRecordField>(new RRecordField(newName, *this));

}


std::size_t ROOT::RRecordField::AppendImpl(const void *from)

{

   std::size_t nbytes = 0;

   for (unsigned i = 0; i < fSubfields.size(); ++i) {

      nbytes += CallAppendOn(*fSubfields[i], static_cast<const unsigned char *>(from) + fOffsets[i]);

   }

   return nbytes;

}


void ROOT::RRecordField::ReadGlobalImpl(ROOT::NTupleSize_t globalIndex, void *to)

{

   for (unsigned i = 0; i < fSubfields.size(); ++i) {

      CallReadOn(*fSubfields[i], globalIndex, static_cast<unsigned char *>(to) + fOffsets[i]);

   }

}


void ROOT::RRecordField::ReadInClusterImpl(RNTupleLocalIndex localIndex, void *to)

{

   for (unsigned i = 0; i < fSubfields.size(); ++i) {

      CallReadOn(*fSubfields[i], localIndex, static_cast<unsigned char *>(to) + fOffsets[i]);

   }

}


void ROOT::RRecordField::ReconcileOnDiskField(const RNTupleDescriptor &desc)

{

   if (fTraits & kTraitEmulatedField) {

      // The field has been explicitly constructed following the on-disk information. No further reconcilation needed.

      return;

   }

   // Note that the RPairField and RTupleField descendants have their own reconcilation logic

   R__ASSERT(GetTypeName().empty());


   const auto &fieldDesc = desc.GetFieldDescriptor(GetOnDiskId());

   EnsureMatchingOnDiskField(fieldDesc, kDiffTypeName | kDiffTypeVersion).ThrowOnError();


   // The on-disk ID of subfields is matched by field name. So we inherently support reordering of fields

   // and we will ignore extra on-disk fields.

   // It remains to mark the extra in-memory fields as artificial.

   std::unordered_set<std::string_view> onDiskSubfields;

   for (const auto &subField : desc.GetFieldIterable(fieldDesc)) {

      onDiskSubfields.insert(subField.GetFieldName());

   }

   for (auto &f : fSubfields) {

      if (onDiskSubfields.count(f->GetFieldName()) == 0)

         CallSetArtificialOn(*f);

   }

}


void ROOT::RRecordField::ConstructValue(void *where) const

{

   for (unsigned i = 0; i < fSubfields.size(); ++i) {

      CallConstructValueOn(*fSubfields[i], static_cast<unsigned char *>(where) + fOffsets[i]);

   }

}


void ROOT::RRecordField::RRecordDeleter::operator()(void *objPtr, bool dtorOnly)

{

   for (unsigned i = 0; i < fItemDeleters.size(); ++i) {

      fItemDeleters[i]->operator()(reinterpret_cast<unsigned char *>(objPtr) + fOffsets[i], true /* dtorOnly */);

   }

   RDeleter::operator()(objPtr, dtorOnly);

}


std::unique_ptr<ROOT::RFieldBase::RDeleter> ROOT::RRecordField::GetDeleter() const

{

   std::vector<std::unique_ptr<RDeleter>> itemDeleters;

   itemDeleters.reserve(fOffsets.size());

   for (const auto &f : fSubfields) {

      itemDeleters.emplace_back(GetDeleterOf(*f));

   }

   return std::make_unique<RRecordDeleter>(std::move(itemDeleters), fOffsets);

}


std::vector<ROOT::RFieldBase::RValue> ROOT::RRecordField::SplitValue(const RValue &value) const

{

   auto valuePtr = value.GetPtr<void>();

   auto charPtr = static_cast<unsigned char *>(valuePtr.get());

   std::vector<RValue> result;

   result.reserve(fSubfields.size());

   for (unsigned i = 0; i < fSubfields.size(); ++i) {

      result.emplace_back(fSubfields[i]->BindValue(std::shared_ptr<void>(valuePtr, charPtr + fOffsets[i])));

   }

   return result;

}


void ROOT::RRecordField::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitRecordField(*this);

}


//------------------------------------------------------------------------------


ROOT::RBitsetField::RBitsetField(std::string_view fieldName, std::size_t N)

   : ROOT::RFieldBase(fieldName, "std::bitset<" + std::to_string(N) + ">", ROOT::ENTupleStructure::kPlain,

                      false /* isSimple */, N),

     fN(N)

{

   fTraits |= kTraitTriviallyDestructible;

}


const ROOT::RFieldBase::RColumnRepresentations &ROOT::RBitsetField::GetColumnRepresentations() const

{

   static RColumnRepresentations representations({{ENTupleColumnType::kBit}}, {});

   return representations;

}


void ROOT::RBitsetField::GenerateColumns()

{

   GenerateColumnsImpl<bool>();

}


void ROOT::RBitsetField::GenerateColumns(const ROOT::RNTupleDescriptor &desc)

{

   GenerateColumnsImpl<bool>(desc);

}


template <typename FUlong, typename FUlonglong, typename... Args>


void ROOT::RBitsetField::SelectWordSize(FUlong &&fUlong, FUlonglong &&fUlonglong, Args &&...args)

{

   if (WordSize() == sizeof(unsigned long)) {

      fUlong(std::forward<Args>(args)..., fN, *fPrincipalColumn);

   } else if (WordSize() == sizeof(unsigned long long)) {

      // NOTE: this can only happen on Windows; see the comment on the RBitsetField class.

      fUlonglong(std::forward<Args>(args)..., fN, *fPrincipalColumn);

   } else {

      R__ASSERT(false);

   }

}


template <typename Word_t>


static void BitsetAppendImpl(const void *from, size_t nBits, ROOT::Internal::RColumn &column)

{

   constexpr auto kBitsPerWord = sizeof(Word_t) * 8;


   const auto *asWordArray = static_cast<const Word_t *>(from);

   bool elementValue;

   std::size_t i = 0;

   for (std::size_t word = 0; word < (nBits + kBitsPerWord - 1) / kBitsPerWord; ++word) {

      for (std::size_t mask = 0; (mask < kBitsPerWord) && (i < nBits); ++mask, ++i) {

         elementValue = (asWordArray[word] & (static_cast<Word_t>(1) << mask)) != 0;

         column.Append(&elementValue);

      }

   }

}


std::size_t ROOT::RBitsetField::AppendImpl(const void *from)

{

   SelectWordSize(BitsetAppendImpl<unsigned long>, BitsetAppendImpl<unsigned long long>, from);

   return fN;

}


template <typename Word_t>

static void


BitsetReadGlobalImpl(ROOT::NTupleSize_t globalIndex, void *to, size_t nBits, ROOT::Internal::RColumn &column)

{

   constexpr auto kBitsPerWord = sizeof(Word_t) * 8;


   auto *asWordArray = static_cast<Word_t *>(to);

   bool elementValue;

   for (std::size_t i = 0; i < nBits; ++i) {

      column.Read(globalIndex * nBits + i, &elementValue);

      Word_t mask = static_cast<Word_t>(1) << (i % kBitsPerWord);

      Word_t bit = static_cast<Word_t>(elementValue) << (i % kBitsPerWord);

      asWordArray[i / kBitsPerWord] = (asWordArray[i / kBitsPerWord] & ~mask) | bit;

   }

}


void ROOT::RBitsetField::ReadGlobalImpl(ROOT::NTupleSize_t globalIndex, void *to)

{

   SelectWordSize(BitsetReadGlobalImpl<unsigned long>, BitsetReadGlobalImpl<unsigned long long>, globalIndex, to);

}


template <typename Word_t>

static void


BitsetReadInClusterImpl(ROOT::RNTupleLocalIndex localIndex, void *to, size_t nBits, ROOT::Internal::RColumn &column)

{

   constexpr auto kBitsPerWord = sizeof(Word_t) * 8;


   auto *asWordArray = static_cast<Word_t *>(to);

   bool elementValue;

   for (std::size_t i = 0; i < nBits; ++i) {

      column.Read(ROOT::RNTupleLocalIndex(localIndex.GetClusterId(), localIndex.GetIndexInCluster() * nBits) + i,

                  &elementValue);

      Word_t mask = static_cast<Word_t>(1) << (i % kBitsPerWord);

      Word_t bit = static_cast<Word_t>(elementValue) << (i % kBitsPerWord);

      asWordArray[i / kBitsPerWord] = (asWordArray[i / kBitsPerWord] & ~mask) | bit;

   }

}


void ROOT::RBitsetField::ReadInClusterImpl(RNTupleLocalIndex localIndex, void *to)

{

   SelectWordSize(BitsetReadInClusterImpl<unsigned long>, BitsetReadInClusterImpl<unsigned long long>, localIndex, to);

}


void ROOT::RBitsetField::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitBitsetField(*this);

}


//------------------------------------------------------------------------------


ROOT::RNullableField::RNullableField(std::string_view fieldName, const std::string &typePrefix,

                                     std::unique_ptr<RFieldBase> itemField)

   : ROOT::RFieldBase(fieldName, typePrefix + "<" + itemField->GetTypeName() + ">", ROOT::ENTupleStructure::kCollection,

                      false /* isSimple */)

{

   Attach(std::move(itemField));

}


const ROOT::RFieldBase::RColumnRepresentations &ROOT::RNullableField::GetColumnRepresentations() const

{

   static RColumnRepresentations representations({{ENTupleColumnType::kSplitIndex64},

                                                  {ENTupleColumnType::kIndex64},

                                                  {ENTupleColumnType::kSplitIndex32},

                                                  {ENTupleColumnType::kIndex32}},

                                                 {});

   return representations;

}


void ROOT::RNullableField::GenerateColumns()

{

   GenerateColumnsImpl<ROOT::Internal::RColumnIndex>();

}


void ROOT::RNullableField::GenerateColumns(const ROOT::RNTupleDescriptor &desc)

{

   GenerateColumnsImpl<ROOT::Internal::RColumnIndex>(desc);

}


std::size_t ROOT::RNullableField::AppendNull()

{

   fPrincipalColumn->Append(&fNWritten);

   return sizeof(ROOT::Internal::RColumnIndex);

}


std::size_t ROOT::RNullableField::AppendValue(const void *from)

{

   auto nbytesItem = CallAppendOn(*fSubfields[0], from);

   fNWritten++;

   fPrincipalColumn->Append(&fNWritten);

   return sizeof(ROOT::Internal::RColumnIndex) + nbytesItem;

}


void ROOT::RNullableField::ReconcileOnDiskField(const RNTupleDescriptor &desc)

{

   static const std::vector<std::string> prefixes = {"std::optional<", "std::unique_ptr<"};


   const auto &fieldDesc = desc.GetFieldDescriptor(GetOnDiskId());

   EnsureMatchingOnDiskField(fieldDesc, kDiffTypeName).ThrowOnError();

   EnsureMatchingTypePrefix(fieldDesc, prefixes).ThrowOnError();

}


ROOT::RNTupleLocalIndex ROOT::RNullableField::GetItemIndex(ROOT::NTupleSize_t globalIndex)

{

   RNTupleLocalIndex collectionStart;

   ROOT::NTupleSize_t collectionSize;

   fPrincipalColumn->GetCollectionInfo(globalIndex, &collectionStart, &collectionSize);

   return (collectionSize == 0) ? RNTupleLocalIndex() : collectionStart;

}


void ROOT::RNullableField::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitNullableField(*this);

}


//------------------------------------------------------------------------------


ROOT::RUniquePtrField::RUniquePtrField(std::string_view fieldName, std::unique_ptr<RFieldBase> itemField)

   : RNullableField(fieldName, "std::unique_ptr", std::move(itemField)), fItemDeleter(GetDeleterOf(*fSubfields[0]))

{

}


std::unique_ptr<ROOT::RFieldBase> ROOT::RUniquePtrField::CloneImpl(std::string_view newName) const

{

   auto newItemField = fSubfields[0]->Clone(fSubfields[0]->GetFieldName());

   return std::make_unique<RUniquePtrField>(newName, std::move(newItemField));

}


std::size_t ROOT::RUniquePtrField::AppendImpl(const void *from)

{

   auto typedValue = static_cast<const std::unique_ptr<char> *>(from);

   if (*typedValue) {

      return AppendValue(typedValue->get());

   } else {

      return AppendNull();

   }

}


void ROOT::RUniquePtrField::ReadGlobalImpl(ROOT::NTupleSize_t globalIndex, void *to)

{

   auto ptr = static_cast<std::unique_ptr<char> *>(to);

   bool isValidValue = static_cast<bool>(*ptr);


   auto itemIndex = GetItemIndex(globalIndex);

   bool isValidItem = itemIndex.GetIndexInCluster() != ROOT::kInvalidNTupleIndex;


   void *valuePtr = nullptr;

   if (isValidValue)

      valuePtr = ptr->get();


   if (isValidValue && !isValidItem) {

      ptr->release();

      fItemDeleter->operator()(valuePtr, false /* dtorOnly */);

      return;

   }


   if (!isValidItem) // On-disk value missing; nothing else to do

      return;


   if (!isValidValue) {

      valuePtr = CallCreateObjectRawPtrOn(*fSubfields[0]);

      ptr->reset(reinterpret_cast<char *>(valuePtr));

   }


   CallReadOn(*fSubfields[0], itemIndex, valuePtr);

}


void ROOT::RUniquePtrField::RUniquePtrDeleter::operator()(void *objPtr, bool dtorOnly)

{

   auto typedPtr = static_cast<std::unique_ptr<char> *>(objPtr);

   if (*typedPtr) {

      fItemDeleter->operator()(typedPtr->get(), false /* dtorOnly */);

      typedPtr->release();

   }

   RDeleter::operator()(objPtr, dtorOnly);

}


std::unique_ptr<ROOT::RFieldBase::RDeleter> ROOT::RUniquePtrField::GetDeleter() const

{

   return std::make_unique<RUniquePtrDeleter>(GetDeleterOf(*fSubfields[0]));

}


std::vector<ROOT::RFieldBase::RValue> ROOT::RUniquePtrField::SplitValue(const RValue &value) const

{

   std::vector<RValue> result;

   auto valuePtr = value.GetPtr<void>();

   const auto &uniquePtr = *static_cast<std::unique_ptr<char> *>(valuePtr.get());

   if (uniquePtr) {

      result.emplace_back(fSubfields[0]->BindValue(std::shared_ptr<void>(valuePtr, uniquePtr.get())));

   }

   return result;

}


//------------------------------------------------------------------------------


ROOT::ROptionalField::ROptionalField(std::string_view fieldName, std::unique_ptr<RFieldBase> itemField)

   : RNullableField(fieldName, "std::optional", std::move(itemField)), fItemDeleter(GetDeleterOf(*fSubfields[0]))

{

   if (fSubfields[0]->GetTraits() & kTraitTriviallyDestructible)

      fTraits |= kTraitTriviallyDestructible;

}


bool *ROOT::ROptionalField::GetEngagementPtr(void *optionalPtr) const

{

   return reinterpret_cast<bool *>(reinterpret_cast<unsigned char *>(optionalPtr) + fSubfields[0]->GetValueSize());

}


const bool *ROOT::ROptionalField::GetEngagementPtr(const void *optionalPtr) const

{

   return GetEngagementPtr(const_cast<void *>(optionalPtr));

}


std::unique_ptr<ROOT::RFieldBase> ROOT::ROptionalField::CloneImpl(std::string_view newName) const

{

   auto newItemField = fSubfields[0]->Clone(fSubfields[0]->GetFieldName());

   return std::make_unique<ROptionalField>(newName, std::move(newItemField));

}


std::size_t ROOT::ROptionalField::AppendImpl(const void *from)

{

   if (*GetEngagementPtr(from)) {

      return AppendValue(from);

   } else {

      return AppendNull();

   }

}


void ROOT::ROptionalField::ReadGlobalImpl(ROOT::NTupleSize_t globalIndex, void *to)

{

   auto engagementPtr = GetEngagementPtr(to);

   auto itemIndex = GetItemIndex(globalIndex);

   if (itemIndex.GetIndexInCluster() == ROOT::kInvalidNTupleIndex) {

      if (*engagementPtr && !(fSubfields[0]->GetTraits() & kTraitTriviallyDestructible))

         fItemDeleter->operator()(to, true /* dtorOnly */);

      *engagementPtr = false;

   } else {

      if (!(*engagementPtr) && !(fSubfields[0]->GetTraits() & kTraitTriviallyConstructible))

         CallConstructValueOn(*fSubfields[0], to);

      CallReadOn(*fSubfields[0], itemIndex, to);

      *engagementPtr = true;

   }

}


void ROOT::ROptionalField::ConstructValue(void *where) const

{

   *GetEngagementPtr(where) = false;

}


void ROOT::ROptionalField::ROptionalDeleter::operator()(void *objPtr, bool dtorOnly)

{

   if (fItemDeleter) {

      auto engagementPtr = reinterpret_cast<bool *>(reinterpret_cast<unsigned char *>(objPtr) + fEngagementPtrOffset);

      if (*engagementPtr)

         fItemDeleter->operator()(objPtr, true /* dtorOnly */);

   }

   RDeleter::operator()(objPtr, dtorOnly);

}


std::unique_ptr<ROOT::RFieldBase::RDeleter> ROOT::ROptionalField::GetDeleter() const

{

   return std::make_unique<ROptionalDeleter>(

      (fSubfields[0]->GetTraits() & kTraitTriviallyDestructible) ? nullptr : GetDeleterOf(*fSubfields[0]),

      fSubfields[0]->GetValueSize());

}


std::vector<ROOT::RFieldBase::RValue> ROOT::ROptionalField::SplitValue(const RValue &value) const

{

   std::vector<RValue> result;

   const auto valuePtr = value.GetPtr<void>().get();

   if (*GetEngagementPtr(valuePtr)) {

      result.emplace_back(fSubfields[0]->BindValue(std::shared_ptr<void>(value.GetPtr<void>(), valuePtr)));

   }

   return result;

}


size_t ROOT::ROptionalField::GetValueSize() const

{

   const auto alignment = GetAlignment();

   // real size is the sum of the value size and the engagement boolean

   const auto actualSize = fSubfields[0]->GetValueSize() + sizeof(bool);

   auto padding = 0;

   if (alignment > 1) {

      auto remainder = actualSize % alignment;

      if (remainder != 0)

         padding = alignment - remainder;

   }

   return actualSize + padding;

}


size_t ROOT::ROptionalField::GetAlignment() const

{

   return fSubfields[0]->GetAlignment();

}


//------------------------------------------------------------------------------


ROOT::RAtomicField::RAtomicField(std::string_view fieldName, std::unique_ptr<RFieldBase> itemField)

   : RFieldBase(fieldName, "std::atomic<" + itemField->GetTypeName() + ">", ROOT::ENTupleStructure::kPlain,

                false /* isSimple */)

{

   if (itemField->GetTraits() & kTraitTriviallyConstructible)

      fTraits |= kTraitTriviallyConstructible;

   if (itemField->GetTraits() & kTraitTriviallyDestructible)

      fTraits |= kTraitTriviallyDestructible;

   Attach(std::move(itemField));

}


std::unique_ptr<ROOT::RFieldBase> ROOT::RAtomicField::CloneImpl(std::string_view newName) const

{

   auto newItemField = fSubfields[0]->Clone(fSubfields[0]->GetFieldName());

   return std::make_unique<RAtomicField>(newName, std::move(newItemField));

}


void ROOT::RAtomicField::ReconcileOnDiskField(const RNTupleDescriptor &desc)

{

   static const std::vector<std::string> prefixes = {"std::atomic<"};


   const auto &fieldDesc = desc.GetFieldDescriptor(GetOnDiskId());

   EnsureMatchingOnDiskField(fieldDesc, kDiffTypeName).ThrowOnError();

   EnsureMatchingTypePrefix(fieldDesc, prefixes).ThrowOnError();

}


std::vector<ROOT::RFieldBase::RValue> ROOT::RAtomicField::SplitValue(const RValue &value) const

{

   std::vector<RValue> result;

   result.emplace_back(fSubfields[0]->BindValue(value.GetPtr<void>()));

   return result;

}


void ROOT::RAtomicField::AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const

{

   visitor.VisitAtomicField(*this);

}


fSize
dim_t fSize
Definition DeclareExecutors.h:179

RColumn.hxx

REntry.hxx

RError.hxx

R__FAIL
#define R__FAIL(msg)
Short-hand to return an RResult<T> in an error state; the RError is implicitly converted into RResult...
Definition RError.hxx:300

RFieldVisitor.hxx

BitsetReadGlobalImpl
static void BitsetReadGlobalImpl(ROOT::NTupleSize_t globalIndex, void *to, size_t nBits, ROOT::Internal::RColumn &column)
Definition RField.cxx:787

BitsetReadInClusterImpl
static void BitsetReadInClusterImpl(ROOT::RNTupleLocalIndex localIndex, void *to, size_t nBits, ROOT::Internal::RColumn &column)
Definition RField.cxx:808

BitsetAppendImpl
static void BitsetAppendImpl(const void *from, size_t nBits, ROOT::Internal::RColumn &column)
Definition RField.cxx:764

RField.hxx

RLogger.hxx

RNTupleModel.hxx

RNTupleSerialize.hxx

RNTupleTypes.hxx

f
#define f(i)
Definition RSha256.hxx:104

TRangeDynCast
ROOT::Detail::TRangeCast< T, true > TRangeDynCast
TRangeDynCast is an adapter class that allows the typed iteration through a TCollection.
Definition TCollection.h:358

R__ASSERT
#define R__ASSERT(e)
Checks condition e and reports a fatal error if it's false.
Definition TError.h:125

N
#define N

mask
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void char Point_t Rectangle_t WindowAttributes_t Float_t Float_t Float_t Int_t Int_t UInt_t UInt_t Rectangle_t mask
Definition TGWin32VirtualXProxy.cxx:178

result
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void char Point_t Rectangle_t WindowAttributes_t Float_t Float_t Float_t Int_t Int_t UInt_t UInt_t Rectangle_t result
Definition TGWin32VirtualXProxy.cxx:174

length
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void char Point_t Rectangle_t WindowAttributes_t Float_t Float_t Float_t Int_t Int_t UInt_t UInt_t Rectangle_t Int_t Int_t Window_t TString Int_t GCValues_t GetPrimarySelectionOwner GetDisplay GetScreen GetColormap GetNativeEvent const char const char dpyName wid window const char font_name cursor keysym reg const char only_if_exist regb h Point_t winding char text const char depth char const char Int_t count const char ColorStruct_t color const char Pixmap_t Pixmap_t PictureAttributes_t attr const char char ret_data h unsigned char height h length
Definition TGWin32VirtualXProxy.cxx:245

value
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void value
Definition TGWin32VirtualXProxy.cxx:142

name
char name[80]
Definition TGX11.cxx:110

alignment
TCanvas * alignment()
Definition alignment.C:1

ROOT::Detail::RFieldVisitor
Abstract base class for classes implementing the visitor design pattern.
Definition RFieldVisitor.hxx:58

ROOT::Detail::TRangeCast
Definition TCollection.h:311

ROOT::Internal::RColumnIndex
The in-memory representation of a 32bit or 64bit on-disk index column.
Definition RNTupleTypes.hxx:271

ROOT::Internal::RColumn
A column is a storage-backed array of a simple, fixed-size type, from which pages can be mapped into ...
Definition RColumn.hxx:38

ROOT::Internal::RColumn::Read
void Read(const ROOT::NTupleSize_t globalIndex, void *to)
Definition RColumn.hxx:160

ROOT::Internal::RColumn::Append
void Append(const void *from)
Definition RColumn.hxx:126

ROOT::RAtomicField::AcceptVisitor
void AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const final
Definition RField.cxx:1113

ROOT::RAtomicField::RAtomicField
RAtomicField(std::string_view fieldName, std::unique_ptr< RFieldBase > itemField)
Definition RField.cxx:1080

ROOT::RAtomicField::CloneImpl
std::unique_ptr< RFieldBase > CloneImpl(std::string_view newName) const final
Called by Clone(), which additionally copies the on-disk ID.
Definition RField.cxx:1091

ROOT::RAtomicField::ReconcileOnDiskField
void ReconcileOnDiskField(const RNTupleDescriptor &desc) final
For non-artificial fields, check compatibility of the in-memory field and the on-disk field.
Definition RField.cxx:1097

ROOT::RAtomicField::SplitValue
std::vector< RValue > SplitValue(const RValue &value) const final
Creates the list of direct child values given an existing value for this field.
Definition RField.cxx:1106

ROOT::RBitsetField::RBitsetField
RBitsetField(std::string_view fieldName, std::size_t N)
Definition RField.cxx:726

ROOT::RBitsetField::ReadInClusterImpl
void ReadInClusterImpl(RNTupleLocalIndex localIndex, void *to) final
Definition RField.cxx:823

ROOT::RBitsetField::GenerateColumns
void GenerateColumns() final
Implementations in derived classes should create the backing columns corresponding to the field type ...
Definition RField.cxx:740

ROOT::RBitsetField::ReadGlobalImpl
void ReadGlobalImpl(ROOT::NTupleSize_t globalIndex, void *to) final
Definition RField.cxx:801

ROOT::RBitsetField::AppendImpl
std::size_t AppendImpl(const void *from) final
Operations on values of complex types, e.g.
Definition RField.cxx:779

ROOT::RBitsetField::GetColumnRepresentations
const RColumnRepresentations & GetColumnRepresentations() const final
Implementations in derived classes should return a static RColumnRepresentations object.
Definition RField.cxx:734

ROOT::RBitsetField::AcceptVisitor
void AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const final
Definition RField.cxx:828

ROOT::RBitsetField::SelectWordSize
void SelectWordSize(FUlong &&fUlong, FUlonglong &&fUlonglong, Args &&...args)
Definition RField.cxx:751

ROOT::RCardinalityField::AcceptVisitor
void AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const final
Definition RField.cxx:92

ROOT::RCardinalityField::GetColumnRepresentations
const RColumnRepresentations & GetColumnRepresentations() const final
Implementations in derived classes should return a static RColumnRepresentations object.
Definition RField.cxx:63

ROOT::RCardinalityField::As32Bit
const RField< RNTupleCardinality< std::uint32_t > > * As32Bit() const
Definition RField.cxx:97

ROOT::RCardinalityField::ReconcileOnDiskField
void ReconcileOnDiskField(const RNTupleDescriptor &desc) final
For non-artificial fields, check compatibility of the in-memory field and the on-disk field.
Definition RField.cxx:78

ROOT::RCardinalityField::As64Bit
const RField< RNTupleCardinality< std::uint64_t > > * As64Bit() const
Definition RField.cxx:102

ROOT::RCardinalityField::GenerateColumns
void GenerateColumns() final
Implementations in derived classes should create the backing columns corresponding to the field type ...
Definition RField.hxx:361

ROOT::RClassField::AppendImpl
std::size_t AppendImpl(const void *from) final
Operations on values of complex types, e.g.
Definition RFieldMeta.cxx:313

ROOT::RClassField::ReadGlobalImpl
void ReadGlobalImpl(ROOT::NTupleSize_t globalIndex, void *to) final
Definition RFieldMeta.cxx:322

ROOT::RClassField::AcceptVisitor
void AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const final
Definition RFieldMeta.cxx:566

ROOT::RException
Base class for all ROOT issued exceptions.
Definition RError.hxx:79

ROOT::RFieldBase::RColumnRepresentations
The list of column representations a field can have.
Definition RFieldBase.hxx:189

ROOT::RFieldBase::RValue
Points to an object with RNTuple I/O support and keeps a pointer to the corresponding field.
Definition RFieldBase.hxx:746

ROOT::RFieldBase
A field translates read and write calls from/to underlying columns to/from tree values.
Definition RFieldBase.hxx:87

ROOT::RFieldBase::Attach
void Attach(std::unique_ptr< RFieldBase > child)
Add a new subfield to the list of nested fields.
Definition RFieldBase.cxx:651

ROOT::RFieldBase::fSubfields
std::vector< std::unique_ptr< RFieldBase > > fSubfields
Collections and classes own subfields.
Definition RFieldBase.hxx:295

ROOT::RFieldBase::GetColumnRepresentations
virtual const RColumnRepresentations & GetColumnRepresentations() const
Implementations in derived classes should return a static RColumnRepresentations object.
Definition RFieldBase.cxx:579

ROOT::RFieldBase::GenerateColumns
virtual void GenerateColumns()
Implementations in derived classes should create the backing columns corresponding to the field type ...
Definition RFieldBase.hxx:396

ROOT::RFieldBase::fTraits
std::uint32_t fTraits
Properties of the type that allow for optimizations of collections of that type.
Definition RFieldBase.hxx:312

ROOT::RFieldBase::GetTraits
std::uint32_t GetTraits() const
Definition RFieldBase.hxx:622

ROOT::RFieldBase::kTraitEmulatedField
@ kTraitEmulatedField
This field is a user defined type that was missing dictionaries and was reconstructed from the on-dis...
Definition RFieldBase.hxx:154

ROOT::RFieldBase::kTraitTrivialType
@ kTraitTrivialType
Shorthand for types that are both trivially constructible and destructible.
Definition RFieldBase.hxx:157

ROOT::RFieldBase::kTraitTriviallyDestructible
@ kTraitTriviallyDestructible
The type is cleaned up just by freeing its memory. I.e. the destructor performs a no-op.
Definition RFieldBase.hxx:144

ROOT::RFieldBase::kTraitTriviallyConstructible
@ kTraitTriviallyConstructible
No constructor needs to be called, i.e.
Definition RFieldBase.hxx:142

ROOT::RFieldDescriptor
Metadata stored for every field of an RNTuple.
Definition RNTupleDescriptor.hxx:77

ROOT::RFieldZero
The container field for an ntuple model, which itself has no physical representation.
Definition RField.hxx:59

ROOT::RFieldZero::AcceptVisitor
void AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const final
Definition RField.cxx:56

ROOT::RFieldZero::CloneImpl
std::unique_ptr< RFieldBase > CloneImpl(std::string_view newName) const final
Called by Clone(), which additionally copies the on-disk ID.
Definition RField.cxx:39

ROOT::RFieldZero::ReleaseSubfields
std::vector< std::unique_ptr< RFieldBase > > ReleaseSubfields()
Moves all subfields into the returned vector.
Definition RField.cxx:47

ROOT::RField
Classes with dictionaries that can be inspected by TClass.
Definition RField.hxx:313

ROOT::RIntegralField
Definition RFieldFundamental.hxx:109

ROOT::RNTupleDescriptor
The on-storage metadata of an RNTuple.
Definition RNTupleDescriptor.hxx:649

ROOT::RNTupleDescriptor::GetFieldIterable
RFieldDescriptorIterable GetFieldIterable(const RFieldDescriptor &fieldDesc) const
Definition RNTupleDescriptor.cxx:1428

ROOT::RNTupleDescriptor::GetFieldDescriptor
const RFieldDescriptor & GetFieldDescriptor(ROOT::DescriptorId_t fieldId) const
Definition RNTupleDescriptor.hxx:769

ROOT::RNTupleDescriptor::FindFieldId
ROOT::DescriptorId_t FindFieldId(std::string_view fieldName, ROOT::DescriptorId_t parentId) const
Definition RNTupleDescriptor.cxx:380

ROOT::RNTupleLocalIndex
Addresses a column element or field item relative to a particular cluster, instead of a global NTuple...
Definition RNTupleTypes.hxx:142

ROOT::RNullableField
Template specializations for C++ std::optional and std::unique_ptr.
Definition RFieldSTLMisc.hxx:193

ROOT::RNullableField::ReconcileOnDiskField
void ReconcileOnDiskField(const RNTupleDescriptor &desc) final
For non-artificial fields, check compatibility of the in-memory field and the on-disk field.
Definition RField.cxx:877

ROOT::RNullableField::RNullableField
RNullableField(std::string_view fieldName, const std::string &typePrefix, std::unique_ptr< RFieldBase > itemField)
Definition RField.cxx:835

ROOT::RNullableField::AppendNull
std::size_t AppendNull()
Definition RField.cxx:863

ROOT::RNullableField::GetItemIndex
RNTupleLocalIndex GetItemIndex(ROOT::NTupleSize_t globalIndex)
Given the index of the nullable field, returns the corresponding global index of the subfield or,...
Definition RField.cxx:886

ROOT::RNullableField::AppendValue
std::size_t AppendValue(const void *from)
Definition RField.cxx:869

ROOT::RNullableField::GenerateColumns
void GenerateColumns() final
Implementations in derived classes should create the backing columns corresponding to the field type ...
Definition RField.cxx:853

ROOT::RNullableField::AcceptVisitor
void AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const final
Definition RField.cxx:894

ROOT::RNullableField::GetColumnRepresentations
const RFieldBase::RColumnRepresentations & GetColumnRepresentations() const final
Implementations in derived classes should return a static RColumnRepresentations object.
Definition RField.cxx:843

ROOT::ROptionalField::ROptionalDeleter::operator()
void operator()(void *objPtr, bool dtorOnly) final
Definition RField.cxx:1032

ROOT::ROptionalField::ConstructValue
void ConstructValue(void *where) const final
Constructs value in a given location of size at least GetValueSize(). Called by the base class' Creat...
Definition RField.cxx:1027

ROOT::ROptionalField::GetAlignment
size_t GetAlignment() const final
As a rule of thumb, the alignment is equal to the size of the type.
Definition RField.cxx:1073

ROOT::ROptionalField::GetDeleter
std::unique_ptr< RDeleter > GetDeleter() const final
Definition RField.cxx:1042

ROOT::ROptionalField::CloneImpl
std::unique_ptr< RFieldBase > CloneImpl(std::string_view newName) const final
Called by Clone(), which additionally copies the on-disk ID.
Definition RField.cxx:996

ROOT::ROptionalField::GetEngagementPtr
const bool * GetEngagementPtr(const void *optionalPtr) const
Given a pointer to an std::optional<T> in optionalPtr, extract a pointer to the engagement boolean.
Definition RField.cxx:991

ROOT::ROptionalField::ReadGlobalImpl
void ReadGlobalImpl(ROOT::NTupleSize_t globalIndex, void *to) final
Definition RField.cxx:1011

ROOT::ROptionalField::AppendImpl
std::size_t AppendImpl(const void *from) final
Operations on values of complex types, e.g.
Definition RField.cxx:1002

ROOT::ROptionalField::SplitValue
std::vector< RValue > SplitValue(const RValue &value) const final
Creates the list of direct child values given an existing value for this field.
Definition RField.cxx:1049

ROOT::ROptionalField::GetValueSize
size_t GetValueSize() const final
The number of bytes taken by a value of the appropriate type.
Definition RField.cxx:1059

ROOT::ROptionalField::ROptionalField
ROptionalField(std::string_view fieldName, std::unique_ptr< RFieldBase > itemField)
Definition RField.cxx:979

ROOT::RRecordField::RRecordDeleter::operator()
void operator()(void *objPtr, bool dtorOnly) final
Definition RField.cxx:689

ROOT::RRecordField
The field for an untyped record.
Definition RFieldRecord.hxx:44

ROOT::RRecordField::SplitValue
std::vector< RValue > SplitValue(const RValue &value) const final
Creates the list of direct child values given an existing value for this field.
Definition RField.cxx:707

ROOT::RRecordField::fMaxAlignment
std::size_t fMaxAlignment
Definition RFieldRecord.hxx:71

ROOT::RRecordField::CloneImpl
std::unique_ptr< RFieldBase > CloneImpl(std::string_view newName) const override
Called by Clone(), which additionally copies the on-disk ID.
Definition RField.cxx:629

ROOT::RRecordField::fSize
std::size_t fSize
Definition RFieldRecord.hxx:72

ROOT::RRecordField::ReadInClusterImpl
void ReadInClusterImpl(RNTupleLocalIndex localIndex, void *to) final
Definition RField.cxx:650

ROOT::RRecordField::RRecordField
RRecordField(std::string_view name, const RRecordField &source)
Definition RField.cxx:547

ROOT::RRecordField::AcceptVisitor
void AcceptVisitor(ROOT::Detail::RFieldVisitor &visitor) const final
Definition RField.cxx:719

ROOT::RRecordField::GetDeleter
std::unique_ptr< RDeleter > GetDeleter() const final
Definition RField.cxx:697

ROOT::RRecordField::AttachItemFields
void AttachItemFields(std::vector< std::unique_ptr< RFieldBase > > itemFields)
Definition RField.cxx:563

ROOT::RRecordField::GetItemPadding
std::size_t GetItemPadding(std::size_t baseOffset, std::size_t itemAlignment) const
Definition RField.cxx:619

ROOT::RRecordField::ReadGlobalImpl
void ReadGlobalImpl(ROOT::NTupleSize_t globalIndex, void *to) final
Definition RField.cxx:643

ROOT::RRecordField::ConstructValue
void ConstructValue(void *where) const final
Constructs value in a given location of size at least GetValueSize(). Called by the base class' Creat...
Definition RField.cxx:682

ROOT::RRecordField::fOffsets
std::vector< std::size_t > fOffsets
Definition RFieldRecord.hxx:73

ROOT::RRecordField::AppendImpl
std::size_t AppendImpl(const void *from) final
Operations on values of complex types, e.g.
Definition RField.cxx:634

ROOT::RRecordField::ReconcileOnDiskField
void ReconcileOnDiskField(const RNTupleDescriptor &desc) override
For non-artificial fields, check compatibility of the in-memory field and the on-disk field.
Definition RField.cxx:657

ROOT::RSimpleField
Definition RField.hxx:378

ROOT::RSimpleField::ReconcileIntegralField
void ReconcileIntegralField(const RNTupleDescriptor &desc)
Definition RField.cxx:110

ROOT::RSimpleField::ReconcileFloatingPointField
void ReconcileFloatingPointField(const RNTupleDescriptor &desc)
Definition RField.cxx:131

ROOT::RUniquePtrField::RUniquePtrDeleter::operator()
void operator()(void *objPtr, bool dtorOnly) final
Definition RField.cxx:951

ROOT::RUniquePtrField::SplitValue
std::vector< RValue > SplitValue(const RValue &value) const final
Creates the list of direct child values given an existing value for this field.
Definition RField.cxx:966

ROOT::RUniquePtrField::GetDeleter
std::unique_ptr< RDeleter > GetDeleter() const final
Definition RField.cxx:961

ROOT::RUniquePtrField::ReadGlobalImpl
void ReadGlobalImpl(ROOT::NTupleSize_t globalIndex, void *to) final
Definition RField.cxx:922

ROOT::RUniquePtrField::CloneImpl
std::unique_ptr< RFieldBase > CloneImpl(std::string_view newName) const final
Called by Clone(), which additionally copies the on-disk ID.
Definition RField.cxx:906

ROOT::RUniquePtrField::RUniquePtrField
RUniquePtrField(std::string_view fieldName, std::unique_ptr< RFieldBase > itemField)
Definition RField.cxx:901

ROOT::RUniquePtrField::AppendImpl
std::size_t AppendImpl(const void *from) final
Operations on values of complex types, e.g.
Definition RField.cxx:912

ROOT::RVectorField
Template specializations for C++ std::vector.
Definition RFieldSequenceContainer.hxx:202

bool

ROOT::Internal::SetAllowFieldSubstitutions
void SetAllowFieldSubstitutions(RFieldZero &fieldZero, bool val)
Definition RField.cxx:34

ROOT::Internal::CreateEmulatedVectorField
std::unique_ptr< RFieldBase > CreateEmulatedVectorField(std::string_view fieldName, std::unique_ptr< RFieldBase > itemField, std::string_view emulatedFromType)
Definition RField.cxx:586

ROOT::Internal::CreateEmulatedRecordField
std::unique_ptr< RFieldBase > CreateEmulatedRecordField(std::string_view fieldName, std::vector< std::unique_ptr< RFieldBase > > itemFields, std::string_view emulatedFromType)
Definition RField.cxx:578

ROOT
Definition EExecutionPolicy.hxx:4

ROOT::kInvalidNTupleIndex
constexpr NTupleSize_t kInvalidNTupleIndex
Definition RNTupleTypes.hxx:135

ROOT::NTupleSize_t
std::uint64_t NTupleSize_t
Integer type long enough to hold the maximum number of entries in a column.
Definition RNTupleTypes.hxx:134

ROOT::ENTupleStructure
ENTupleStructure
The fields in the RNTuple data model tree can carry different structural information about the type s...
Definition RNTupleTypes.hxx:108

ROOT::ENTupleStructure::kRecord
@ kRecord

ROOT::ENTupleStructure::kCollection
@ kCollection

ROOT::ENTupleStructure::kPlain
@ kPlain

ROOT::ENTupleColumnType::kUInt8
@ kUInt8

ROOT::ENTupleColumnType::kByte
@ kByte

ROOT::ENTupleColumnType::kInt32
@ kInt32

ROOT::ENTupleColumnType::kSplitReal64
@ kSplitReal64

ROOT::ENTupleColumnType::kInt64
@ kInt64

ROOT::ENTupleColumnType::kBit
@ kBit

ROOT::ENTupleColumnType::kReal64
@ kReal64

ROOT::ENTupleColumnType::kSplitInt64
@ kSplitInt64

ROOT::ENTupleColumnType::kReal32Quant
@ kReal32Quant

ROOT::ENTupleColumnType::kReal16
@ kReal16

ROOT::ENTupleColumnType::kUInt32
@ kUInt32

ROOT::ENTupleColumnType::kInt16
@ kInt16

ROOT::ENTupleColumnType::kSplitIndex64
@ kSplitIndex64

ROOT::ENTupleColumnType::kSplitIndex32
@ kSplitIndex32

ROOT::ENTupleColumnType::kIndex32
@ kIndex32

ROOT::ENTupleColumnType::kIndex64
@ kIndex64

ROOT::ENTupleColumnType::kSplitInt32
@ kSplitInt32

ROOT::ENTupleColumnType::kUInt16
@ kUInt16

ROOT::ENTupleColumnType::kSplitUInt16
@ kSplitUInt16

ROOT::ENTupleColumnType::kUInt64
@ kUInt64

ROOT::ENTupleColumnType::kSplitInt16
@ kSplitInt16

ROOT::ENTupleColumnType::kSplitUInt64
@ kSplitUInt64

ROOT::ENTupleColumnType::kReal32
@ kReal32

ROOT::ENTupleColumnType::kReal32Trunc
@ kReal32Trunc

ROOT::ENTupleColumnType::kSplitReal32
@ kSplitReal32

ROOT::ENTupleColumnType::kInt8
@ kInt8

ROOT::ENTupleColumnType::kSplitUInt32
@ kSplitUInt32

ROOT::ENTupleColumnType::kChar
@ kChar