Logo ROOT   6.16/01
Reference Guide
TOrdCollection.h
Go to the documentation of this file.
1// @(#)root/cont:$Id$
2// Author: Fons Rademakers 13/09/95
3
4/*************************************************************************
5 * Copyright (C) 1995-2000, Rene Brun and Fons Rademakers. *
6 * All rights reserved. *
7 * *
8 * For the licensing terms see $ROOTSYS/LICENSE. *
9 * For the list of contributors see $ROOTSYS/README/CREDITS. *
10 *************************************************************************/
11
12#ifndef ROOT_TOrdCollection
13#define ROOT_TOrdCollection
14
15
16//////////////////////////////////////////////////////////////////////////
17// //
18// TOrdCollection //
19// //
20// Ordered collection. //
21// //
22//////////////////////////////////////////////////////////////////////////
23
24#include "TSeqCollection.h"
25
26#include <iterator>
27
28
30
31
33
34friend class TOrdCollectionIter;
35
36private:
41
42 Int_t PhysIndex(Int_t idx) const;
43 Int_t LogIndex(Int_t idx) const;
44 void MoveGapTo(Int_t newGapStart);
45 Bool_t IllegalIndex(const char *method, Int_t idx) const;
46 void Init(Int_t capacity);
47 Bool_t LowWaterMark() const;
48 void SetCapacity(Int_t newCapacity);
49
50 TOrdCollection(const TOrdCollection&); // Not implemented
51 TOrdCollection& operator=(const TOrdCollection&); // Not implemented
52
53public:
55
57
60 void Clear(Option_t *option="");
61 void Delete(Option_t *option="");
62 TObject **GetObjectRef(const TObject *obj) const;
63 Int_t IndexOf(const TObject *obj) const;
65
66 void AddFirst(TObject *obj);
67 void AddLast(TObject *obj);
68 void AddAt(TObject *obj, Int_t idx);
69 void AddAfter(const TObject *after, TObject *obj);
70 void AddBefore(const TObject *before, TObject *obj);
71 void PutAt(TObject *obj, Int_t idx);
73 TObject *Remove(TObject *obj);
74
75 TObject *At(Int_t idx) const;
76 TObject *Before(const TObject *obj) const;
77 TObject *After(const TObject *obj) const;
78 TObject *First() const;
79 TObject *Last() const;
80
81 void Sort();
83
84 ClassDef(TOrdCollection,0) //An ordered collection
85};
86
87
88//////////////////////////////////////////////////////////////////////////
89// //
90// TOrdCollectionIter //
91// //
92// Iterator of ordered collection. //
93// //
94//////////////////////////////////////////////////////////////////////////
95
97 public std::iterator<std::bidirectional_iterator_tag,
98 TObject*, std::ptrdiff_t,
99 const TObject**, const TObject*&> {
100
101private:
102 const TOrdCollection *fCol; //collection being iterated
103 Int_t fCurCursor; //current position in collection
104 Int_t fCursor; //next position in collection
105 Bool_t fDirection; //iteration direction
106
108
109public:
113 TIterator &operator=(const TIterator &rhs);
115
116 const TCollection *GetCollection() const { return fCol; }
117 TObject *Next();
118 void Reset();
119 Bool_t operator!=(const TIterator &aIter) const;
120 Bool_t operator!=(const TOrdCollectionIter &aIter) const;
121 TObject *operator*() const;
122
123 ClassDef(TOrdCollectionIter,0) //Ordered collection iterator
124};
125
126
127//---- inlines -----------------------------------------------------------------
128
130{
131 return (fSize < (fCapacity / 4) && fSize > TCollection::kInitCapacity);
132}
133
135 { return (idx < fGapStart) ? idx : idx + fGapSize; }
136
138 { return (idx < fGapStart) ? idx : idx - fGapSize; }
139
140#endif
int Int_t
Definition: RtypesCore.h:41
bool Bool_t
Definition: RtypesCore.h:59
const char Option_t
Definition: RtypesCore.h:62
#define ClassDef(name, id)
Definition: Rtypes.h:324
const Bool_t kIterForward
Definition: TCollection.h:40
Collection abstract base class.
Definition: TCollection.h:63
Iterator abstract base class.
Definition: TIterator.h:30
Mother of all ROOT objects.
Definition: TObject.h:37
Iterator of ordered collection.
void Reset()
Reset collection iterator.
const TCollection * GetCollection() const
Bool_t operator!=(const TIterator &aIter) const
This operator compares two TIterator objects.
const TOrdCollection * fCol
TObject * Next()
Return next object in collection.
TIterator & operator=(const TIterator &rhs)
Overridden assignment operator.
TObject * operator*() const
Return current object or nullptr.
Ordered collection.
TObject * Remove(TObject *obj)
Remove object from collection.
Bool_t LowWaterMark() const
Int_t IndexOf(const TObject *obj) const
Return index of object in collection.
void Clear(Option_t *option="")
Remove all objects from the collection.
TObject * After(const TObject *obj) const
Return the object after object obj.
void AddBefore(const TObject *before, TObject *obj)
Insert object before object before in the collection.
void PutAt(TObject *obj, Int_t idx)
Put object at index idx. Overwrites what was at idx before.
TObject ** fCont
TOrdCollection(const TOrdCollection &)
void AddLast(TObject *obj)
Add object at the end of the collection.
~TOrdCollection()
Delete the collection.
Int_t PhysIndex(Int_t idx) const
void Sort()
If objects in collection are sortable (i.e.
TObject ** GetObjectRef(const TObject *obj) const
return address of pointer obj
void AddAt(TObject *obj, Int_t idx)
Insert object at position idx in the collection.
TObject * At(Int_t idx) const
Returns the object at position idx. Returns 0 if idx is out of range.
Int_t LogIndex(Int_t idx) const
TOrdCollectionIter Iterator_t
void AddFirst(TObject *obj)
Insert object at beginning of collection.
void AddAfter(const TObject *after, TObject *obj)
Insert object after object after in the collection.
void Init(Int_t capacity)
Initialize ordered collection.
Bool_t IllegalIndex(const char *method, Int_t idx) const
Return true when index out of bounds and print error.
TObject * RemoveAt(Int_t idx)
Remove object at index idx.
TObject * First() const
Return the first object in the collection.
TIterator * MakeIterator(Bool_t dir=kIterForward) const
Return an ordered collection iterator.
TObject * Before(const TObject *obj) const
Returns the object before object obj.
void MoveGapTo(Int_t newGapStart)
Move gap to new position.
Int_t BinarySearch(TObject *obj)
Find object using a binary search.
void Delete(Option_t *option="")
Remove all objects from the collection AND delete all heap based objects.
TObject * Last() const
Return the last object in the collection.
TOrdCollection & operator=(const TOrdCollection &)
void SetCapacity(Int_t newCapacity)
Set/change ordered collection capacity.
Sequenceable collection abstract base class.