![]() |
ROOT 6.10/09 Reference Guide |
Proxy around an arbitrary container, which implements basic functionality and iteration.
The purpose of this implementation is to shield any generated dictionary implementation from the underlying streamer/proxy implementation and only expose the creation functions.
In particular this is used to implement splitting and abstract element access of any container. Access to compiled code is necessary to implement the abstract iteration sequence and functionality like size(), clear(), resize(). resize() may be a void operation.
Definition at line 28 of file TGenCollectionProxy.h.
Classes | |
class | Method |
Small helper to execute (compiler) generated function for the access to STL or other containers. More... | |
class | Method0 |
class | StreamHelper |
Helper class to facilitate I/O. More... | |
class | TStaging |
Small helper to stage the content of an associative container when reading and before inserting it in the actual collection. More... | |
class | Value |
Small helper to describe the Value_type or the key_type of an STL container. More... | |
Public Types | |
enum | { kBIT_ISSTRING = 0x20000000, kBIT_ISTSTRING = 0x40000000 } |
typedef const std::type_info & | Info_t |
![]() | |
typedef void *(* | CopyIterator_t) (void *dest, const void *source) |
typedef void(* | CreateIterators_t) (void *collection, void **begin_arena, void **end_arena, TVirtualCollectionProxy *proxy) |
typedef void(* | DeleteIterator_t) (void *iter) |
typedef void(* | DeleteTwoIterators_t) (void *begin, void *end) |
enum | EProperty { kIsAssociative = BIT(2), kIsEmulated = BIT(3), kNeedDelete = BIT(4) } |
typedef void *(* | Next_t) (void *iter, const void *end) |
Public Member Functions | |
TGenCollectionProxy (const TGenCollectionProxy ©) | |
Build a proxy for an emulated container. More... | |
TGenCollectionProxy (Info_t typ, size_t iter_size) | |
Build a proxy for a collection whose type is described by 'collectionClass'. More... | |
TGenCollectionProxy (const ROOT::Detail::TCollectionProxyInfo &info, TClass *cl) | |
Build a proxy for a collection whose type is described by 'collectionClass'. More... | |
virtual | ~TGenCollectionProxy () |
Standard destructor. More... | |
virtual void * | Allocate (UInt_t n, Bool_t forceDelete) |
Allocate the needed space. More... | |
virtual void * | At (UInt_t idx) |
Return the address of the value at index 'idx'. More... | |
virtual void | Clear (const char *opt="") |
Clear the emulated collection. More... | |
virtual void | Commit (void *env) |
Commit the change. More... | |
virtual TVirtualCollectionProxy * | Generate () const |
Virtual copy constructor. More... | |
virtual TClass * | GetCollectionClass () const |
Return a pointer to the TClass representing the container. More... | |
virtual Int_t | GetCollectionType () const |
Return the type of collection see TClassEdit::ESTLType. More... | |
virtual TStreamerInfoActions::TActionSequence * | GetConversionReadMemberWiseActions (TClass *oldClass, Int_t version) |
Return the set of action necessary to stream in this collection member-wise coming from the old value class layout refered to by 'version'. More... | |
virtual CopyIterator_t | GetFunctionCopyIterator (Bool_t read=kTRUE) |
See typedef void (*CopyIterator_t)(void *&dest, const void *source); Copy the iterator source, into dest. More... | |
virtual CreateIterators_t | GetFunctionCreateIterators (Bool_t read=kTRUE) |
See typedef void (*CreateIterators_t)(void *collection, void *&begin_arena, void *&end_arena); begin_arena and end_arena should contain the location of memory arena of size fgIteratorSize. More... | |
virtual DeleteIterator_t | GetFunctionDeleteIterator (Bool_t read=kTRUE) |
See typedef void (*DeleteIterator_t)(void *iter); If the sizeof iterator is greater than fgIteratorArenaSize, call delete on the addresses, Otherwise just call the iterator's destructor. More... | |
virtual DeleteTwoIterators_t | GetFunctionDeleteTwoIterators (Bool_t read=kTRUE) |
See typedef void (*DeleteTwoIterators_t)(void *begin, void *end); If the sizeof iterator is greater than fgIteratorArenaSize, call delete on the addresses, Otherwise just call the iterator's destructor. More... | |
virtual Next_t | GetFunctionNext (Bool_t read=kTRUE) |
See typedef void* (*Next_t)(void *iter, void *end); iter and end should be pointer to respectively an iterator to be incremented and the result of colleciton.end() 'Next' will increment the iterator 'iter' and return 0 if the iterator reached the end. More... | |
virtual ULong_t | GetIncrement () const |
Return the offset between two consecutive value_types (memory layout). More... | |
virtual TClass * | GetOnFileClass () const |
virtual TStreamerInfoActions::TActionSequence * | GetReadMemberWiseActions (Int_t version) |
Return the set of action necessary to stream in this collection member-wise coming from the old value class layout refered to by 'version'. More... | |
virtual EDataType | GetType () const |
If the content is a simple numerical value, return its type (see TDataType) More... | |
virtual TClass * | GetValueClass () const |
Return a pointer to the TClass representing the content. More... | |
virtual TStreamerInfoActions::TActionSequence * | GetWriteMemberWiseActions () |
Return the set of action necessary to stream out this collection member-wise. More... | |
virtual Bool_t | HasPointers () const |
Return true if the content is of type 'pointer to'. More... | |
virtual void | Insert (const void *data, void *container, size_t size) |
Insert data into the container where data is a C-style array of the actual type contained in the collection of the given size. More... | |
virtual void | operator() (TBuffer &refBuffer, void *pObject) |
TClassStreamer IO overload. More... | |
virtual void | PopProxy () |
Remove the last object. More... | |
virtual void | PushProxy (void *objstart) |
Add an object. More... | |
virtual void | ReadBuffer (TBuffer &b, void *obj) |
virtual void | ReadBuffer (TBuffer &b, void *obj, const TClass *onfileClass) |
virtual void | Resize (UInt_t n, Bool_t force_delete) |
Resize the container. More... | |
virtual void | SetOnFileClass (TClass *cl) |
virtual UInt_t | Size () const |
Return the current size of the container. More... | |
virtual UInt_t | Sizeof () const |
Return the sizeof the collection object. More... | |
virtual void | Streamer (TBuffer &refBuffer) |
Streamer Function. More... | |
virtual void | Streamer (TBuffer &refBuffer, void *pObject, int siz) |
Streamer I/O overload. More... | |
![]() | |
TVirtualCollectionProxy () | |
TVirtualCollectionProxy (TClass *cl) | |
virtual | ~TVirtualCollectionProxy () |
virtual void | DeleteArray (void *p, Bool_t dtorOnly=kFALSE) const |
virtual void | Destructor (void *p, Bool_t dtorOnly=kFALSE) const |
virtual Int_t | GetProperties () const |
virtual void * | New () const |
virtual void * | New (void *arena) const |
virtual void * | NewArray (Int_t nElements) const |
virtual void * | NewArray (Int_t nElements, void *arena) const |
char * | operator[] (UInt_t idx) const |
Protected Types | |
typedef void *(* | ArrIterfunc_t) (void *from, size_t size) |
typedef void *(* | Collectfunc_t) (void *from, void *to) |
typedef ROOT::Detail::TCollectionProxyInfo::Environ< char[64]> | Env_t |
typedef ROOT::Detail::TCollectionProxyInfo::EnvironBase | EnvironBase_t |
typedef void *(* | Feedfunc_t) (void *from, void *to, size_t size) |
typedef std::vector< EnvironBase_t * > | Proxies_t |
typedef void(* | Sizing_t) (void *obj, size_t size) |
typedef std::vector< TStaging * > | Staged_t |
Collection of pre-allocated staged array for associative containers. More... | |
Protected Member Functions | |
void | CheckFunctions () const |
Check existence of function pointers. More... | |
virtual void | DeleteItem (Bool_t force, void *ptr) const |
Call to delete/destruct individual item. More... | |
TGenCollectionProxy * | Initialize (Bool_t silent) const |
Proxy initializer. More... | |
virtual TGenCollectionProxy * | InitializeEx (Bool_t silent) |
Proxy initializer. More... | |
virtual void | UpdateValueClass (const TClass *oldcl, TClass *newcl) |
Update the internal ValueClass when a TClass constructor need to replace an emulated TClass by the real TClass. More... | |
Protected Attributes | |
Method | fClear |
Method cache for container accessors: clear container. More... | |
Collectfunc_t | fCollect |
Method to collect objects from container. More... | |
ArrIterfunc_t | fConstruct |
Container accessors: block construct. More... | |
std::map< std::string, TObjArray * > * | fConversionReadMemberWise |
Array of bundle of TStreamerInfoActions to stream out (read) derived from another class. More... | |
Method0 | fCreateEnv |
Method to allocate an Environment holder. More... | |
Sizing_t | fDestruct |
Container accessors: block destruct. More... | |
EnvironBase_t * | fEnv |
Address of the currently proxied object. More... | |
Feedfunc_t | fFeed |
Container accessors: block feed. More... | |
Method | fFirst |
Container accessors: generic iteration: first. More... | |
CopyIterator_t | fFunctionCopyIterator |
CreateIterators_t | fFunctionCreateIterators |
DeleteIterator_t | fFunctionDeleteIterator |
DeleteTwoIterators_t | fFunctionDeleteTwoIterators |
Next_t | fFunctionNextIterator |
Value * | fKey |
Descriptor of the key_type. More... | |
std::string | fName |
Name of the class being proxied. More... | |
Method | fNext |
Container accessors: generic iteration: next. More... | |
TClass * | fOnFileClass |
On file class. More... | |
Bool_t | fPointers |
Flag to indicate if containee has pointers (key or value) More... | |
Proxies_t | fProxyKept |
Optimization: Keep proxies once they were created. More... | |
Proxies_t | fProxyList |
Stack of recursive proxies. More... | |
TObjArray * | fReadMemberWise |
Array of bundle of TStreamerInfoActions to stream out (read) More... | |
Sizing_t | fResize |
Container accessors: resize container. More... | |
Method | fSize |
Container accessors: size of container. More... | |
Staged_t | fStaged |
Optimization: Keep staged array once they were created. More... | |
int | fSTL_type |
STL container type. More... | |
Info_t | fTypeinfo |
Type information. More... | |
Value * | fVal |
Descriptor of the Value_type. More... | |
int | fValDiff |
Offset between two consecutive value_types (memory layout). More... | |
int | fValOffset |
Offset from key to value (in maps) More... | |
std::atomic< Value * > | fValue |
Descriptor of the container value type. More... | |
TStreamerInfoActions::TActionSequence * | fWriteMemberWise |
![]() | |
TClassRef | fClass |
UInt_t | fProperties |
Private Member Functions | |
TGenCollectionProxy () | |
TGenCollectionProxy & | operator= (const TGenCollectionProxy &) |
Friends | |
class | TCollectionProxyFactory |
Additional Inherited Members | |
![]() | |
static const Int_t | fgIteratorArenaSize = 16 |
#include <TGenCollectionProxy.h>
Definition at line 296 of file TGenCollectionProxy.h.
Definition at line 295 of file TGenCollectionProxy.h.
|
protected |
Definition at line 286 of file TGenCollectionProxy.h.
|
protected |
Definition at line 287 of file TGenCollectionProxy.h.
Definition at line 294 of file TGenCollectionProxy.h.
typedef const std::type_info& TGenCollectionProxy::Info_t |
Definition at line 40 of file TGenCollectionProxy.h.
|
protected |
Definition at line 289 of file TGenCollectionProxy.h.
Definition at line 293 of file TGenCollectionProxy.h.
|
protected |
Collection of pre-allocated staged array for associative containers.
Definition at line 288 of file TGenCollectionProxy.h.
anonymous enum |
Enumerator | |
---|---|
kBIT_ISSTRING | |
kBIT_ISTSTRING |
Definition at line 43 of file TGenCollectionProxy.h.
|
private |
TGenCollectionProxy::TGenCollectionProxy | ( | const TGenCollectionProxy & | copy | ) |
Build a proxy for an emulated container.
Definition at line 544 of file TGenCollectionProxy.cxx.
TGenCollectionProxy::TGenCollectionProxy | ( | Info_t | typ, |
size_t | iter_size | ||
) |
Build a proxy for a collection whose type is described by 'collectionClass'.
Definition at line 582 of file TGenCollectionProxy.cxx.
TGenCollectionProxy::TGenCollectionProxy | ( | const ROOT::Detail::TCollectionProxyInfo & | info, |
TClass * | cl | ||
) |
Build a proxy for a collection whose type is described by 'collectionClass'.
Definition at line 627 of file TGenCollectionProxy.cxx.
|
virtual |
Standard destructor.
Definition at line 693 of file TGenCollectionProxy.cxx.
Allocate the needed space.
For associative collection, this returns a TStaging object that need to be deleted manually or returned by calling Commit(TStaging*)
Implements TVirtualCollectionProxy.
Reimplemented in TEmulatedCollectionProxy.
Definition at line 1122 of file TGenCollectionProxy.cxx.
Return the address of the value at index 'idx'.
Implements TVirtualCollectionProxy.
Reimplemented in TEmulatedCollectionProxy, and TEmulatedMapProxy.
Definition at line 996 of file TGenCollectionProxy.cxx.
|
protected |
Check existence of function pointers.
Definition at line 768 of file TGenCollectionProxy.cxx.
|
virtual |
Clear the emulated collection.
Implements TVirtualCollectionProxy.
Reimplemented in TEmulatedCollectionProxy.
Definition at line 1066 of file TGenCollectionProxy.cxx.
Commit the change.
Implements TVirtualCollectionProxy.
Reimplemented in TEmulatedCollectionProxy.
Definition at line 1206 of file TGenCollectionProxy.cxx.
Call to delete/destruct individual item.
Definition at line 1279 of file TGenCollectionProxy.cxx.
|
virtual |
Virtual copy constructor.
Implements TVirtualCollectionProxy.
Reimplemented in TGenCollectionStreamer, TEmulatedCollectionProxy, and TEmulatedMapProxy.
Definition at line 719 of file TGenCollectionProxy.cxx.
|
virtual |
Return a pointer to the TClass representing the container.
Reimplemented from TVirtualCollectionProxy.
Definition at line 910 of file TGenCollectionProxy.cxx.
|
virtual |
Return the type of collection see TClassEdit::ESTLType.
Implements TVirtualCollectionProxy.
Definition at line 918 of file TGenCollectionProxy.cxx.
|
virtual |
Return the set of action necessary to stream in this collection member-wise coming from the old value class layout refered to by 'version'.
Implements TVirtualCollectionProxy.
Definition at line 1671 of file TGenCollectionProxy.cxx.
|
virtual |
See typedef void (*CopyIterator_t)(void *&dest, const void *source); Copy the iterator source, into dest.
dest should contain should contain the location of memory arena of size fgIteratorSize. If the collection iterator are of that size or less, the iterator will be constructed in place in this location (new with placement) Otherwise the iterator will be allocated via a regular new and its address returned by modifying the value of dest.
Implements TVirtualCollectionProxy.
Definition at line 1570 of file TGenCollectionProxy.cxx.
|
virtual |
See typedef void (*CreateIterators_t)(void *collection, void *&begin_arena, void *&end_arena); begin_arena and end_arena should contain the location of memory arena of size fgIteratorSize.
If the collection iterator are of that size or less, the iterators will be constructed in place in those location (new with placement) Otherwise the iterators will be allocated via a regular new and their address returned by modifying the value of begin_arena and end_arena.
Implements TVirtualCollectionProxy.
Definition at line 1536 of file TGenCollectionProxy.cxx.
|
virtual |
See typedef void (*DeleteIterator_t)(void *iter); If the sizeof iterator is greater than fgIteratorArenaSize, call delete on the addresses, Otherwise just call the iterator's destructor.
Implements TVirtualCollectionProxy.
Definition at line 1622 of file TGenCollectionProxy.cxx.
|
virtual |
See typedef void (*DeleteTwoIterators_t)(void *begin, void *end); If the sizeof iterator is greater than fgIteratorArenaSize, call delete on the addresses, Otherwise just call the iterator's destructor.
Implements TVirtualCollectionProxy.
Definition at line 1647 of file TGenCollectionProxy.cxx.
|
virtual |
See typedef void* (*Next_t)(void *iter, void *end); iter and end should be pointer to respectively an iterator to be incremented and the result of colleciton.end() 'Next' will increment the iterator 'iter' and return 0 if the iterator reached the end.
If the end is not reached, 'Next' will return the address of the content unless the collection contains pointers in which case 'Next' will return the value of the pointer.
Implements TVirtualCollectionProxy.
Definition at line 1597 of file TGenCollectionProxy.cxx.
|
virtual |
Return the offset between two consecutive value_types (memory layout).
Implements TVirtualCollectionProxy.
Definition at line 929 of file TGenCollectionProxy.cxx.
|
inlinevirtual |
Definition at line 427 of file TGenCollectionProxy.h.
|
virtual |
Return the set of action necessary to stream in this collection member-wise coming from the old value class layout refered to by 'version'.
Implements TVirtualCollectionProxy.
Definition at line 1722 of file TGenCollectionProxy.cxx.
|
virtual |
If the content is a simple numerical value, return its type (see TDataType)
Implements TVirtualCollectionProxy.
Definition at line 987 of file TGenCollectionProxy.cxx.
|
virtual |
Return a pointer to the TClass representing the content.
Implements TVirtualCollectionProxy.
Definition at line 963 of file TGenCollectionProxy.cxx.
|
virtual |
Return the set of action necessary to stream out this collection member-wise.
Implements TVirtualCollectionProxy.
Definition at line 1744 of file TGenCollectionProxy.cxx.
|
virtual |
Return true if the content is of type 'pointer to'.
Implements TVirtualCollectionProxy.
Definition at line 947 of file TGenCollectionProxy.cxx.
|
protected |
Proxy initializer.
Definition at line 758 of file TGenCollectionProxy.cxx.
|
protectedvirtual |
Proxy initializer.
Reimplemented in TEmulatedCollectionProxy.
Definition at line 817 of file TGenCollectionProxy.cxx.
Insert data into the container where data is a C-style array of the actual type contained in the collection of the given size.
For associative container (map, etc.), the data type is the pair<key,value>.
Implements TVirtualCollectionProxy.
Reimplemented in TEmulatedCollectionProxy.
Definition at line 1198 of file TGenCollectionProxy.cxx.
TClassStreamer IO overload.
Definition at line 1377 of file TGenCollectionProxy.cxx.
|
private |
|
virtual |
Remove the last object.
Implements TVirtualCollectionProxy.
Definition at line 1263 of file TGenCollectionProxy.cxx.
Add an object.
Implements TVirtualCollectionProxy.
Definition at line 1228 of file TGenCollectionProxy.cxx.
Reimplemented in TEmulatedCollectionProxy, TGenCollectionStreamer, and TEmulatedMapProxy.
Definition at line 1348 of file TGenCollectionProxy.cxx.
|
virtual |
Reimplemented in TEmulatedCollectionProxy, TGenCollectionStreamer, and TEmulatedMapProxy.
Definition at line 1341 of file TGenCollectionProxy.cxx.
Resize the container.
Reimplemented in TEmulatedCollectionProxy.
Definition at line 1099 of file TGenCollectionProxy.cxx.
Definition at line 426 of file TGenCollectionProxy.h.
|
virtual |
Return the current size of the container.
Implements TVirtualCollectionProxy.
Reimplemented in TEmulatedCollectionProxy, and TEmulatedMapProxy.
Definition at line 1083 of file TGenCollectionProxy.cxx.
|
virtual |
Return the sizeof the collection object.
Implements TVirtualCollectionProxy.
Reimplemented in TEmulatedCollectionProxy.
Definition at line 939 of file TGenCollectionProxy.cxx.
Streamer Function.
Reimplemented in TEmulatedCollectionProxy, TGenCollectionStreamer, and TEmulatedMapProxy.
Definition at line 1356 of file TGenCollectionProxy.cxx.
Streamer I/O overload.
Reimplemented in TEmulatedCollectionProxy, TGenCollectionStreamer, and TEmulatedMapProxy.
Definition at line 1368 of file TGenCollectionProxy.cxx.
|
protectedvirtual |
Update the internal ValueClass when a TClass constructor need to replace an emulated TClass by the real TClass.
Implements TVirtualCollectionProxy.
Definition at line 973 of file TGenCollectionProxy.cxx.
|
friend |
Definition at line 33 of file TGenCollectionProxy.h.
|
protected |
Method cache for container accessors: clear container.
Definition at line 300 of file TGenCollectionProxy.h.
|
protected |
Method to collect objects from container.
Definition at line 308 of file TGenCollectionProxy.h.
|
protected |
Container accessors: block construct.
Definition at line 305 of file TGenCollectionProxy.h.
|
mutableprotected |
Array of bundle of TStreamerInfoActions to stream out (read) derived from another class.
Definition at line 291 of file TGenCollectionProxy.h.
|
protected |
Method to allocate an Environment holder.
Definition at line 309 of file TGenCollectionProxy.h.
|
protected |
Container accessors: block destruct.
Definition at line 306 of file TGenCollectionProxy.h.
|
protected |
Address of the currently proxied object.
Definition at line 313 of file TGenCollectionProxy.h.
|
protected |
Container accessors: block feed.
Definition at line 307 of file TGenCollectionProxy.h.
|
protected |
Container accessors: generic iteration: first.
Definition at line 303 of file TGenCollectionProxy.h.
|
protected |
Definition at line 324 of file TGenCollectionProxy.h.
|
protected |
Definition at line 323 of file TGenCollectionProxy.h.
|
protected |
Definition at line 326 of file TGenCollectionProxy.h.
|
protected |
Definition at line 327 of file TGenCollectionProxy.h.
|
protected |
Definition at line 325 of file TGenCollectionProxy.h.
|
protected |
Descriptor of the key_type.
Definition at line 312 of file TGenCollectionProxy.h.
|
protected |
Name of the class being proxied.
Definition at line 298 of file TGenCollectionProxy.h.
|
protected |
Container accessors: generic iteration: next.
Definition at line 304 of file TGenCollectionProxy.h.
|
protected |
On file class.
Definition at line 321 of file TGenCollectionProxy.h.
|
protected |
Flag to indicate if containee has pointers (key or value)
Definition at line 299 of file TGenCollectionProxy.h.
|
protected |
Optimization: Keep proxies once they were created.
Definition at line 317 of file TGenCollectionProxy.h.
|
protected |
Stack of recursive proxies.
Definition at line 316 of file TGenCollectionProxy.h.
|
mutableprotected |
Array of bundle of TStreamerInfoActions to stream out (read)
Definition at line 290 of file TGenCollectionProxy.h.
|
protected |
Container accessors: resize container.
Definition at line 302 of file TGenCollectionProxy.h.
|
protected |
Container accessors: size of container.
Definition at line 301 of file TGenCollectionProxy.h.
|
protected |
Optimization: Keep staged array once they were created.
Definition at line 318 of file TGenCollectionProxy.h.
|
protected |
STL container type.
Definition at line 319 of file TGenCollectionProxy.h.
|
protected |
Type information.
Definition at line 320 of file TGenCollectionProxy.h.
|
protected |
Descriptor of the Value_type.
Definition at line 311 of file TGenCollectionProxy.h.
|
protected |
Offset between two consecutive value_types (memory layout).
Definition at line 315 of file TGenCollectionProxy.h.
|
protected |
Offset from key to value (in maps)
Definition at line 314 of file TGenCollectionProxy.h.
|
protected |
Descriptor of the container value type.
Definition at line 310 of file TGenCollectionProxy.h.
|
mutableprotected |
Definition at line 292 of file TGenCollectionProxy.h.