Logo ROOT  
Reference Guide
No Matches
ROOT::Experimental::RNTupleModel::RUpdater Class Reference

A model is usually immutable after passing it to an RNTupleWriter.

However, for the rare cases that require changing the model after the fact, RUpdater provides limited support for incremental updates, e.g. addition of new fields.

See RNTupleWriter::CreateModelUpdater() for an example.

Definition at line 157 of file RNTupleModel.hxx.

Public Member Functions

 RUpdater (RNTupleWriter &writer)
 ~RUpdater ()
void AddField (std::unique_ptr< RFieldBase > field)
RResult< void > AddProjectedField (std::unique_ptr< RFieldBase > field, std::function< std::string(const std::string &)> mapping)
void BeginUpdate ()
 Begin a new set of alterations to the underlying model.
void CommitUpdate ()
 Commit changes since the last call to BeginUpdate().
template<typename T , typename... ArgsT>
std::shared_ptr< T > MakeField (const NameWithDescription_t &fieldNameDesc, ArgsT &&...args)

Private Attributes

std::uint64_t fNewModelId = 0
 The model ID after committing.
Internal::RNTupleModelChangeset fOpenChangeset

#include <ROOT/RNTupleModel.hxx>

Constructor & Destructor Documentation

◆ RUpdater()

ROOT::Experimental::RNTupleModel::RUpdater::RUpdater ( RNTupleWriter writer)

Definition at line 163 of file RNTupleModel.cxx.

◆ ~RUpdater()

ROOT::Experimental::RNTupleModel::RUpdater::~RUpdater ( )

Definition at line 165 of file RNTupleModel.hxx.

Member Function Documentation

◆ AddField()

void ROOT::Experimental::RNTupleModel::RUpdater::AddField ( std::unique_ptr< RFieldBase field)

Definition at line 188 of file RNTupleModel.cxx.

◆ AddProjectedField()

ROOT::Experimental::RResult< void > ROOT::Experimental::RNTupleModel::RUpdater::AddProjectedField ( std::unique_ptr< RFieldBase field,
std::function< std::string(const std::string &)>  mapping 

Definition at line 196 of file RNTupleModel.cxx.

◆ BeginUpdate()

void ROOT::Experimental::RNTupleModel::RUpdater::BeginUpdate ( )

Begin a new set of alterations to the underlying model.

As a side effect, all REntry instances related to the model are invalidated.

Definition at line 168 of file RNTupleModel.cxx.

◆ CommitUpdate()

void ROOT::Experimental::RNTupleModel::RUpdater::CommitUpdate ( )

Commit changes since the last call to BeginUpdate().

All the invalidated REntrys remain invalid. CreateEntry() or CreateBareEntry() can be used to create an REntry that matching the new model. Upon completion, BeginUpdate() can be called again to begin a new set of changes.

Definition at line 176 of file RNTupleModel.cxx.

◆ MakeField()

template<typename T , typename... ArgsT>
std::shared_ptr< T > ROOT::Experimental::RNTupleModel::RUpdater::MakeField ( const NameWithDescription_t fieldNameDesc,
ArgsT &&...  args 

Definition at line 175 of file RNTupleModel.hxx.

Member Data Documentation

◆ fNewModelId

std::uint64_t ROOT::Experimental::RNTupleModel::RUpdater::fNewModelId = 0

The model ID after committing.

Definition at line 161 of file RNTupleModel.hxx.

◆ fOpenChangeset

Internal::RNTupleModelChangeset ROOT::Experimental::RNTupleModel::RUpdater::fOpenChangeset

Definition at line 160 of file RNTupleModel.hxx.

◆ fWriter

RNTupleWriter& ROOT::Experimental::RNTupleModel::RUpdater::fWriter

Definition at line 159 of file RNTupleModel.hxx.

Libraries for ROOT::Experimental::RNTupleModel::RUpdater:

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