Detailed Description

Handles lists of named parameters with different types, a list of KVNamedParameter objects.

Create a list from a string

You can create and initialise a list of parameters with the constructor:

KVNameValueList k("A=10,B=stripes,C=6.751");
k.Print();
 
KVNameValueList:: :  (0x5602712ae5b0)
<A=10>
<B=stripes>
<C=6.751>

Adding and modifying parameters

Parameters are dynamically added or modified by calling SetValue():

KVNameValueList l("MyList", "A list of things");
l.SetValue("a", 6);
l.SetValue("b", 3.14);
l.SetValue("c", "sqrt");
 
l.SetValue("a", false);  <= change value & type of existing parameter
 
l.Print();
 
KVNameValueList::MyList : A list of things (0x7f405e51e010)
<a=false>
<b=3.14>
<c=sqrt>

Retrieving parameters

Before trying to retrieve a parameter from the list, it is advisable to test if a parameter with the correct name and type exists in the list:

l.HasDoubleParameter("a"); => false
l.HasParameter<double>("b"); => true
l.HasBoolParameter("a"); => true

Values can then be retrieved with the following methods:

l.GetValue<bool>("a"); => false
l.GetDoubleValue("b"); => 3.1400
l.GetValue<std::string>("c"); => (std::string) "sqrt"

Some conversions between different types will work implicitly, however be aware that any attempt to convert a non-numeric string parameter into a numerical value will result in zero:

l.GetTStringValue("a"); => (TString) "false"
l.GetValue<int>("b"); => 3
l.GetValue<double>("c"); => 0.0000

Another method allows to test whether a parameter with a given name exists and has a specific value (including of the right type):

l.IsValue("a",false); => (bool) true
l.IsValue("b",3); => (bool) false
l.IsValue("b",3.14); => (bool) true

64-bit parameters

In addition to the four types handled by KVNamedParameter, KVNameValueList adds the possibility to store (unsigned) 64-bit integers using SetValue64bit():

l.SetValue64bit("A64", 1234567890987654321);
 
l.Print();
 
KVNameValueList::MyList : A list of things (0x7f405e51e010)
<a=false>
<b=3.14>
<c=sqrt>
<A64_hi=287445236>
<A64_lo=-1318314831>

The 64-bit value is stored as 2 32-bit integers with suffixes "hi" and "lo". Dedicated methods must be used to test for the presence or retrieve the value of a 64-bit parameter:

l.HasValue64bit("A64"); => (bool) true
 
l.GetValue64bit("A64"); => (unsigned long long) 1234567890987654321

Examples: KVClassFactory_examples.C.

Definition at line 116 of file KVNameValueList.h.

#include <KVNameValueList.h>

Inheritance diagram for KVNameValueList:

[legend]

Classes
class	Iterator

Public Member Functions
	KVNameValueList ()
	Default constructor. More...

	KVNameValueList (const Char_t name, const Char_t title="")

	KVNameValueList (const KVNameValueList &)
	Copy constructor. More...

	KVNameValueList (std::initializer_list< KVNamedParameter >)

virtual	~KVNameValueList ()
	Destructor. More...

void	AddValue (const KVNamedParameter &p)

Iterator	begin () const

void	Clear (Option_t *opt="") override

virtual void	ClearSelection (TRegexp &)

Int_t	Compare (const TObject *nvl) const override

void	Concatenate (const KVNameValueList &nvl)

void	Copy (TObject &nvl) const override

Iterator	end () const

KVNamedParameter *	FindParameter (const Char_t *name) const

KVString	Get () const

Bool_t	GetBoolValue (const Char_t *name) const

Bool_t	GetBoolValue (Int_t idx) const

Double_t	GetDoubleValue (const Char_t *name) const

Double_t	GetDoubleValue (Int_t idx) const

Int_t	GetEntries () const

Int_t	GetIntValue (const Char_t *name) const

Int_t	GetIntValue (Int_t idx) const

KVHashList *	GetList () const

const Char_t *	GetNameAt (Int_t idx) const

Int_t	GetNameIndex (const Char_t *name) const

Int_t	GetNpar () const

KVNamedParameter *	GetParameter (Int_t idx) const

const Char_t *	GetStringValue (const Char_t *name) const

const Char_t *	GetStringValue (Int_t idx) const

TString	GetTStringValue (const Char_t *name) const

TString	GetTStringValue (Int_t idx) const

template<typename value_type >
value_type	GetValue (const Char_t *name) const

template<typename value_type >
value_type	GetValue (Int_t idx) const

ULong64_t	GetValue64bit (const Char_t *name) const

Bool_t	HasBoolParameter (const Char_t *name) const

Bool_t	HasDoubleParameter (const Char_t *name) const

Bool_t	HasIntParameter (const Char_t *name) const

Bool_t	HasNumericParameter (const Char_t *name) const

Bool_t	HasParameter (const Char_t *name) const

template<typename value_type >
Bool_t	HasParameter (const Char_t *name) const

Bool_t	HasStringParameter (const Char_t *name) const

Bool_t	HasValue64bit (const Char_t *name) const

template<typename value_type >
void	IncrementValue (const Char_t *name, value_type value)

Bool_t	IsEmpty () const

Bool_t	IsOwner () const

template<typename value_type >
Bool_t	IsValue (const Char_t *name, value_type value) const

TString	List (Option_t *opt="") const

void	ls (Option_t *opt="") const override

void	Merge (const KVNameValueList &)

KVNameValueList &	operator= (const KVNameValueList &)

void	Print (Option_t *opt="") const override

virtual KVEnv *	ProduceEnvFile ()

virtual void	ReadEnv (const TEnv &)

virtual void	ReadEnvFile (const Char_t *filename)

void	RemoveParameter (const Char_t *name)

bool	Set (const KVString &)

template<typename value_type >
void	SetFirstValue (const Char_t *name, value_type value)

void	SetFromEnv (TEnv *tenv, const TString &prefix="")

void	SetIgnoreBool (Bool_t ignore=kTRUE)

template<typename value_type >
void	SetLastValue (const Char_t *name, value_type value)

void	SetOwner (Bool_t enable=kTRUE)

template<typename value_type >
void	SetValue (const Char_t *name, value_type value)

void	SetValue (const KVNamedParameter &)

void	SetValue64bit (const Char_t *name, ULong64_t)

template<typename value_type >
void	SetValueAt (const Char_t *name, value_type value, Int_t idx)

void	Sort (Bool_t order=kSortAscending)

void	WriteClass (const Char_t classname, const Char_t classdesc, const Char_t *base_class="")

virtual void	WriteEnvFile (const Char_t *filename)

void	WriteToEnv (TEnv *tenv, const TString &prefix="")

Public Member Functions inherited from TNamed
	TNamed ()

	TNamed (const char name, const char title)

	TNamed (const TNamed &named)

	TNamed (const TString &name, const TString &title)

virtual	~TNamed ()

TObject *	Clone (const char *newname="") const override

virtual void	FillBuffer (char *&buffer)

const char *	GetName () const override

const char *	GetTitle () const override

ULong_t	Hash () const override

TClass *	IsA () const override

Bool_t	IsSortable () const override

TNamed &	operator= (const TNamed &rhs)

virtual void	SetName (const char *name)

virtual void	SetNameTitle (const char name, const char title)

virtual void	SetTitle (const char *title="")

virtual Int_t	Sizeof () const

void	Streamer (TBuffer &) override

void	StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)

Public Member Functions inherited from TObject
	TObject ()

	TObject (const TObject &object)

virtual	~TObject ()

void	AbstractMethod (const char *method) const

virtual void	AppendPad (Option_t *option="")

virtual void	Browse (TBrowser *b)

ULong_t	CheckedHash ()

virtual const char *	ClassName () const

virtual void	Delete (Option_t *option="")

virtual Int_t	DistancetoPrimitive (Int_t px, Int_t py)

virtual void	Draw (Option_t *option="")

virtual void	DrawClass () const

virtual TObject *	DrawClone (Option_t *option="") const

virtual void	Dump () const

virtual void	Error (const char method, const char msgfmt,...) const

virtual void	Execute (const char method, const char params, Int_t *error=nullptr)

virtual void	Execute (TMethod method, TObjArray params, Int_t *error=nullptr)

virtual void	ExecuteEvent (Int_t event, Int_t px, Int_t py)

virtual void	Fatal (const char method, const char msgfmt,...) const

virtual TObject *	FindObject (const char *name) const

virtual TObject *	FindObject (const TObject *obj) const

virtual Option_t *	GetDrawOption () const

virtual const char *	GetIconName () const

virtual char *	GetObjectInfo (Int_t px, Int_t py) const

virtual Option_t *	GetOption () const

virtual UInt_t	GetUniqueID () const

virtual Bool_t	HandleTimer (TTimer *timer)

Bool_t	HasInconsistentHash () const

virtual void	Info (const char method, const char msgfmt,...) const

virtual Bool_t	InheritsFrom (const char *classname) const

virtual Bool_t	InheritsFrom (const TClass *cl) const

virtual void	Inspect () const

void	InvertBit (UInt_t f)

Bool_t	IsDestructed () const

virtual Bool_t	IsEqual (const TObject *obj) const

virtual Bool_t	IsFolder () const

R__ALWAYS_INLINE Bool_t	IsOnHeap () const

R__ALWAYS_INLINE Bool_t	IsZombie () const

void	MayNotUse (const char *method) const

virtual Bool_t	Notify ()

void	Obsolete (const char method, const char asOfVers, const char *removedFromVers) const

void	operator delete (void *ptr)

void	operator delete (void ptr, void vp)

void	operator delete[] (void *ptr)

void	operator delete[] (void ptr, void vp)

void *	operator new (size_t sz)

void *	operator new (size_t sz, void *vp)

void *	operator new[] (size_t sz)

void *	operator new[] (size_t sz, void *vp)

TObject &	operator= (const TObject &rhs)

virtual void	Paint (Option_t *option="")

virtual void	Pop ()

virtual Int_t	Read (const char *name)

virtual void	RecursiveRemove (TObject *obj)

void	ResetBit (UInt_t f)

virtual void	SaveAs (const char filename="", Option_t option="") const

virtual void	SavePrimitive (std::ostream &out, Option_t *option="")

void	SetBit (UInt_t f)

void	SetBit (UInt_t f, Bool_t set)

virtual void	SetDrawOption (Option_t *option="")

virtual void	SetUniqueID (UInt_t uid)

void	StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)

virtual void	SysError (const char method, const char msgfmt,...) const

R__ALWAYS_INLINE Bool_t	TestBit (UInt_t f) const

Int_t	TestBits (UInt_t f) const

virtual void	UseCurrentStyle ()

virtual void	Warning (const char method, const char msgfmt,...) const

virtual Int_t	Write (const char *name=nullptr, Int_t option=0, Int_t bufsize=0)

virtual Int_t	Write (const char *name=nullptr, Int_t option=0, Int_t bufsize=0) const

Private Attributes
Bool_t	fIgnoreBool
	do not convert "yes", "false", "on", etc. in TEnv file to boolean More...

KVHashList	fList
	list of KVNamedParameter objects More...

Additional Inherited Members
Public Types inherited from TObject
enum	EDeprecatedStatusBits

enum	EStatusBits

Static Public Member Functions inherited from TNamed
static TClass *	Class ()

static const char *	Class_Name ()

static constexpr Version_t	Class_Version ()

static const char *	DeclFileName ()

Static Public Member Functions inherited from TObject
static TClass *	Class ()

static const char *	Class_Name ()

static constexpr Version_t	Class_Version ()

static const char *	DeclFileName ()

static Longptr_t	GetDtorOnly ()

static Bool_t	GetObjectStat ()

static void	SetDtorOnly (void *obj)

static void	SetObjectStat (Bool_t stat)

Public Attributes inherited from TObject
	kBitMask

	kCanDelete

	kCannotPick

	kHasUUID

	kInconsistent

	kInvalidObject

	kIsOnHeap

	kIsReferenced

	kMustCleanup

	kNoContextMenu

	kNotDeleted

	kObjInCanvas

	kOverwrite

	kSingleKey

	kWriteDelete

	kZombie

Protected Member Functions inherited from TObject
virtual void	DoError (int level, const char location, const char fmt, va_list va) const

void	MakeZombie ()

Protected Attributes inherited from TNamed
TString	fName

TString	fTitle

Protected Attributes inherited from TObject
	kOnlyPrepStep

Constructor & Destructor Documentation

◆ KVNameValueList() [1/4]

KVNameValueList::KVNameValueList ( )

Default constructor.

Definition at line 19 of file KVNameValueList.cpp.

◆ KVNameValueList() [2/4]

KVNameValueList::KVNameValueList ( std::initializer_list< KVNamedParameter > l )

Constructor using an initializer list for a given set of KVNamedParameter objects, i.e. this contructor makes it possible to do:

KVNameValueList list{{"A",1.234},{"B",false},{"C","hello"}};
 
KVNameValueList list2 = {{"A",1.234},{"B",false},{"C","hello"}};

Definition at line 38 of file KVNameValueList.cpp.

◆ KVNameValueList() [3/4]

KVNameValueList::KVNameValueList	(	const Char_t *	name,
		const Char_t *	title = `""`
	)

Ctor with name & title

if name contains a comma-separated list of parameter/value pairs, it will be used to initialise the list (no name set)

Definition at line 60 of file KVNameValueList.cpp.

◆ KVNameValueList() [4/4]

KVNameValueList::KVNameValueList ( const KVNameValueList & NVL )

Copy constructor.

Definition at line 77 of file KVNameValueList.cpp.

◆ ~KVNameValueList()

KVNameValueList::~KVNameValueList ( )

virtual

Destructor.

Definition at line 89 of file KVNameValueList.cpp.

Member Function Documentation

◆ AddValue()

void KVNameValueList::AddValue ( const KVNamedParameter & p )

Definition at line 512 of file KVNameValueList.cpp.

◆ begin()

Iterator KVNameValueList::begin ( ) const

inline

return iterator to beginning of list

Definition at line 207 of file KVNameValueList.h.

◆ Clear()

void KVNameValueList::Clear ( Option_t * opt = "" )

overridevirtual

Clear all the stored parameters Deletes the parameter objects if owner & opt!="nodelete"

Reimplemented from TNamed.

Reimplemented in KVValues.

Definition at line 258 of file KVNameValueList.cpp.

◆ ClearSelection()

void KVNameValueList::ClearSelection ( TRegexp & sel )

virtual

Remove from list all parameters whose name matches the regular expression Examples: remove all parameters starting with "toto": TRegexp sel("^toto") remove all parameters with "toto" in name: TRegexp sel("toto")

Definition at line 273 of file KVNameValueList.cpp.

◆ Compare()

Int_t KVNameValueList::Compare ( const TObject * nvl ) const

overridevirtual

Reimplemented from TNamed.

Definition at line 443 of file KVNameValueList.cpp.

◆ Concatenate()

void KVNameValueList::Concatenate ( const KVNameValueList & nvl )

Definition at line 719 of file KVNameValueList.cpp.

◆ Copy()

void KVNameValueList::Copy ( TObject & nvl ) const

overridevirtual

Copy this to the nvl object. Any existing parameters will be destroyed

Reimplemented from TNamed.

Definition at line 241 of file KVNameValueList.cpp.

◆ end()

Iterator KVNameValueList::end ( ) const

inline

return iterator to end of list (a nullptr)

Definition at line 212 of file KVNameValueList.h.

◆ FindParameter()

KVNamedParameter * KVNameValueList::FindParameter ( const Char_t * name ) const

Definition at line 523 of file KVNameValueList.cpp.

◆ Get()

KVString KVNameValueList::Get ( ) const

Fill and return a string containing a comma-separated list of the parameter/value pairs

"param1=val1,param2=val2,..."

Such a string can be used with method Set() in order to initialize a copy of this list.

Definition at line 198 of file KVNameValueList.cpp.

◆ GetBoolValue() [1/2]

Bool_t KVNameValueList::GetBoolValue ( const Char_t * name ) const

inline

Definition at line 404 of file KVNameValueList.h.

◆ GetBoolValue() [2/2]

Bool_t KVNameValueList::GetBoolValue ( Int_t idx ) const

inline

Definition at line 432 of file KVNameValueList.h.

◆ GetDoubleValue() [1/2]

Double_t KVNameValueList::GetDoubleValue ( const Char_t * name ) const

inline

Definition at line 408 of file KVNameValueList.h.

◆ GetDoubleValue() [2/2]

Double_t KVNameValueList::GetDoubleValue ( Int_t idx ) const

inline

Definition at line 436 of file KVNameValueList.h.

◆ GetEntries()

Int_t KVNameValueList::GetEntries ( ) const

inline

Definition at line 380 of file KVNameValueList.h.

◆ GetIntValue() [1/2]

Int_t KVNameValueList::GetIntValue ( const Char_t * name ) const

inline

Definition at line 400 of file KVNameValueList.h.

◆ GetIntValue() [2/2]

Int_t KVNameValueList::GetIntValue ( Int_t idx ) const

inline

Definition at line 428 of file KVNameValueList.h.

◆ GetList()

KVHashList * KVNameValueList::GetList ( ) const

return the pointeur of the KVHashList where parameters are stored with their values

Definition at line 228 of file KVNameValueList.cpp.

◆ GetNameAt()

const Char_t * KVNameValueList::GetNameAt ( Int_t idx ) const

Definition at line 577 of file KVNameValueList.cpp.

◆ GetNameIndex()

Int_t KVNameValueList::GetNameIndex ( const Char_t * name ) const

Definition at line 559 of file KVNameValueList.cpp.

◆ GetNpar()

Int_t KVNameValueList::GetNpar ( void ) const

Definition at line 607 of file KVNameValueList.cpp.

◆ GetParameter()

KVNamedParameter * KVNameValueList::GetParameter ( Int_t idx ) const

Definition at line 529 of file KVNameValueList.cpp.

◆ GetStringValue() [1/2]

const Char_t* KVNameValueList::GetStringValue ( const Char_t * name ) const

inline

Definition at line 412 of file KVNameValueList.h.

◆ GetStringValue() [2/2]

const Char_t* KVNameValueList::GetStringValue ( Int_t idx ) const

inline

Definition at line 440 of file KVNameValueList.h.

◆ GetTStringValue() [1/2]

TString KVNameValueList::GetTStringValue ( const Char_t * name ) const

Definition at line 592 of file KVNameValueList.cpp.

◆ GetTStringValue() [2/2]

TString KVNameValueList::GetTStringValue ( Int_t idx ) const

Definition at line 614 of file KVNameValueList.cpp.

◆ GetValue() [1/2]

template<typename value_type >

value_type KVNameValueList::GetValue ( const Char_t * name ) const

inline

return the value of named parameter returns a default value (-1, false or "-1") if no parameter with such a name is present

Definition at line 390 of file KVNameValueList.h.

◆ GetValue() [2/2]

template<typename value_type >

value_type KVNameValueList::GetValue ( Int_t idx ) const

inline

return the value of parameter at position idx returns a default value (-1, false or "-1") if idx is greater than the number of stored parameters

Definition at line 419 of file KVNameValueList.h.

◆ GetValue64bit()

ULong64_t KVNameValueList::GetValue64bit ( const Char_t * name ) const

Definition at line 484 of file KVNameValueList.cpp.

◆ HasBoolParameter()

Bool_t KVNameValueList::HasBoolParameter ( const Char_t * name ) const

inline

Definition at line 349 of file KVNameValueList.h.

◆ HasDoubleParameter()

Bool_t KVNameValueList::HasDoubleParameter ( const Char_t * name ) const

inline

Returns kTRUE if the list contains a parameter with given name and type Double.

WARNING: only returns kTRUE if parameter is STRICTLY of type Double, will return false for Int parameter.

See also: HasNumericParameter()

Definition at line 353 of file KVNameValueList.h.

◆ HasIntParameter()

Bool_t KVNameValueList::HasIntParameter ( const Char_t * name ) const

inline

Returns kTRUE if the list contains a parameter with given name and type Int.

WARNING: only returns kTRUE if paramete is STRICTLY of type Int, will return false for Double parameter.

See also: HasNumericParameter()

Definition at line 339 of file KVNameValueList.h.

◆ HasNumericParameter()

Bool_t KVNameValueList::HasNumericParameter ( const Char_t * name ) const

inline

Returns kTRUE if the list contains a parameter with given name and it is of numeric type, i.e. either Int or Double. Even if the parameter is actually of String type, if the string it contains corresponds to a numeric value, this method returns kTRUE.

This is to avoid ambiguity with HasDoubleParameter() and HasIntParameter() which only return kTRUE if the parameter is strictly of the given type.

Definition at line 367 of file KVNameValueList.h.

◆ HasParameter() [1/2]

Bool_t KVNameValueList::HasParameter ( const Char_t * name ) const

Definition at line 549 of file KVNameValueList.cpp.

◆ HasParameter() [2/2]

template<typename value_type >

Bool_t KVNameValueList::HasParameter ( const Char_t * name ) const

inline

Return kTRUE if list has parameter called 'name' and it is of given type

Definition at line 332 of file KVNameValueList.h.

◆ HasStringParameter()

Bool_t KVNameValueList::HasStringParameter ( const Char_t * name ) const

inline

Definition at line 363 of file KVNameValueList.h.

◆ HasValue64bit()

Bool_t KVNameValueList::HasValue64bit ( const Char_t * name ) const

Definition at line 500 of file KVNameValueList.cpp.

◆ IncrementValue()

template<typename value_type >

void KVNameValueList::IncrementValue	(	const Char_t *	name,
		value_type	value
	)

inline

increment a parameter (define by its name) by a value if the parameter is not in the list, it is added if it's in the list increment its value

Definition at line 306 of file KVNameValueList.h.

◆ IsEmpty()

Bool_t KVNameValueList::IsEmpty ( ) const

inline

Definition at line 384 of file KVNameValueList.h.

◆ IsOwner()

Bool_t KVNameValueList::IsOwner ( ) const

Definition at line 435 of file KVNameValueList.cpp.

◆ IsValue()

template<typename value_type >

Bool_t KVNameValueList::IsValue	(	const Char_t *	name,
		value_type	value
	)		const

inline

Returns kTRUE if parameter with given name exists and is equal to given value

Definition at line 316 of file KVNameValueList.h.

◆ List()

TString KVNameValueList::List ( Option_t * opt = "" ) const

Definition at line 353 of file KVNameValueList.cpp.

◆ ls()

void KVNameValueList::ls ( Option_t * opt = "" ) const

overridevirtual

Reimplemented from TNamed.

Definition at line 400 of file KVNameValueList.cpp.

◆ Merge()

void KVNameValueList::Merge ( const KVNameValueList & other )

Definition at line 760 of file KVNameValueList.cpp.

◆ operator=()

KVNameValueList & KVNameValueList::operator= ( const KVNameValueList & o )

Definition at line 99 of file KVNameValueList.cpp.

◆ Print()

void KVNameValueList::Print ( Option_t * opt = "" ) const

overridevirtual

Print stored parameters (name, and value)

Option can be used to select type of parameters to print:

option = "int", "double", "string", or "64bit"

If you want to exclude 1 or more parameters, add "|name1,name2,..." after the option

Reimplemented from TNamed.

Reimplemented in KVValues.

Definition at line 305 of file KVNameValueList.cpp.

◆ ProduceEnvFile()

KVEnv * KVNameValueList::ProduceEnvFile ( )

virtual

Definition at line 698 of file KVNameValueList.cpp.

◆ ReadEnv()

void KVNameValueList::ReadEnv ( const TEnv & env_file )

virtual

Definition at line 655 of file KVNameValueList.cpp.

◆ ReadEnvFile()

void KVNameValueList::ReadEnvFile ( const Char_t * filename )

virtual

Definition at line 627 of file KVNameValueList.cpp.

◆ RemoveParameter()

void KVNameValueList::RemoveParameter ( const Char_t * name )

Definition at line 536 of file KVNameValueList.cpp.

◆ Set()

bool KVNameValueList::Set ( const KVString & list )

If list contains a comma-separated list of parameter/value pairs

list = "param1=val1,param2=val2,..."

then use it to initialise the parameters of the list, and return true (any existing parameters will be removed).

If list does not contain at least one '=' character, do nothing and return false.

Note on deduction of parameter types

The type of each parameter is deduced from the given values, using the following methods in the following order:

string in single quotes => string parameter (e.g. val="'7 9'")
KVString::IsDigit(val) => integer parameter if true (e.g. val="3" or val="7 9")
KVString::IsFloat(val) => double parameter if true (e.g. val="3.14e+03")
all other cases => string parameter

Note that in the case of the quoted string, the parameter is stored without the enclosing quotes (i.e. for val="'7 9'" the stored string is "7 9")

Definition at line 131 of file KVNameValueList.cpp.

◆ SetFirstValue()

template<typename value_type >

void KVNameValueList::SetFirstValue	(	const Char_t *	name,
		value_type	value
	)

inline

associate a parameter (define by its name) and a value if the parameter is not in the list, it is inserted at the begining of the list. if it's in the list replace its value and move it at the begining of the list.

Definition at line 268 of file KVNameValueList.h.

◆ SetFromEnv()

void KVNameValueList::SetFromEnv	(	TEnv *	tenv,
		const TString &	prefix = `""`
	)

Definition at line 741 of file KVNameValueList.cpp.

◆ SetIgnoreBool()

void KVNameValueList::SetIgnoreBool ( Bool_t ignore = kTRUE )

inline

When reading a list from a file using ReadEnvFile(), any string values matching TRUE, FALSE, ON, OFF, YES, NO, OK, NOT are automatically converted to boolean parameters. If you want to disable this and keep such strings as strings, call this method first.

Definition at line 462 of file KVNameValueList.h.

◆ SetLastValue()

template<typename value_type >

void KVNameValueList::SetLastValue	(	const Char_t *	name,
		value_type	value
	)

inline

associate a parameter (define by its name) and a value if the parameter is not in the list, it is inserted at the end of the list. if it's in the list replace its value and move it at the end of the list.

Definition at line 287 of file KVNameValueList.h.

◆ SetOwner()

void KVNameValueList::SetOwner ( Bool_t enable = kTRUE )

Definition at line 427 of file KVNameValueList.cpp.

◆ SetValue() [1/2]

template<typename value_type >

void KVNameValueList::SetValue	(	const Char_t *	name,
		value_type	value
	)

inline

associate a parameter (define by its name) and a value if the parameter is not in the list, it is added if it's in the list replace its value

Examples: KVClassFactory_examples.C.

Definition at line 235 of file KVNameValueList.h.

◆ SetValue() [2/2]

void KVNameValueList::SetValue ( const KVNamedParameter & p )

Definition at line 462 of file KVNameValueList.cpp.

◆ SetValue64bit()

void KVNameValueList::SetValue64bit	(	const Char_t *	name,
		ULong64_t	x
	)

Definition at line 471 of file KVNameValueList.cpp.

◆ SetValueAt()

template<typename value_type >

void KVNameValueList::SetValueAt	(	const Char_t *	name,
		value_type	value,
		Int_t	idx
	)

inline

associate a parameter (define by its name) and a value if the parameter is not in the list, it is inserted at location idx in the list. if it's in the list replace its value and move it at location idx in the list.

Definition at line 249 of file KVNameValueList.h.

◆ Sort()

void KVNameValueList::Sort ( Bool_t order = kSortAscending )

inline

Sort a list of numerical values into ascending order (by default). Use order = kSortDescending to reverse order.

Definition at line 451 of file KVNameValueList.h.

◆ WriteClass()

void KVNameValueList::WriteClass	(	const Char_t *	classname,
		const Char_t *	classdesc,
		const Char_t *	base_class = `""`
	)

Examples: KVClassFactory_examples.C.

Definition at line 730 of file KVNameValueList.cpp.

◆ WriteEnvFile()

void KVNameValueList::WriteEnvFile ( const Char_t * filename )

virtual

Definition at line 709 of file KVNameValueList.cpp.

◆ WriteToEnv()

void KVNameValueList::WriteToEnv	(	TEnv *	tenv,
		const TString &	prefix = `""`
	)

Definition at line 752 of file KVNameValueList.cpp.

Member Data Documentation

◆ fIgnoreBool

Bool_t KVNameValueList::fIgnoreBool

private

do not convert "yes", "false", "on", etc. in TEnv file to boolean

Definition at line 119 of file KVNameValueList.h.

◆ fList

KVHashList KVNameValueList::fList

private

list of KVNamedParameter objects

Definition at line 118 of file KVNameValueList.h.

Detailed Description

Create a list from a string

Adding and modifying parameters

Retrieving parameters

64-bit parameters

Classes

Public Member Functions

Private Attributes

Additional Inherited Members

Constructor & Destructor Documentation

◆ KVNameValueList() [1/4]

◆ KVNameValueList() [2/4]

◆ KVNameValueList() [3/4]

◆ KVNameValueList() [4/4]

◆ ~KVNameValueList()

Member Function Documentation

◆ AddValue()

◆ begin()

◆ Clear()

◆ ClearSelection()

◆ Compare()

◆ Concatenate()

◆ Copy()

◆ end()

◆ FindParameter()

◆ Get()

◆ GetBoolValue() [1/2]

◆ GetBoolValue() [2/2]

◆ GetDoubleValue() [1/2]

◆ GetDoubleValue() [2/2]

◆ GetEntries()

◆ GetIntValue() [1/2]

◆ GetIntValue() [2/2]

◆ GetList()

◆ GetNameAt()

◆ GetNameIndex()

◆ GetNpar()

◆ GetParameter()

◆ GetStringValue() [1/2]

◆ GetStringValue() [2/2]

◆ GetTStringValue() [1/2]

◆ GetTStringValue() [2/2]

◆ GetValue() [1/2]

◆ GetValue() [2/2]

◆ GetValue64bit()

◆ HasBoolParameter()

◆ HasDoubleParameter()

◆ HasIntParameter()

◆ HasNumericParameter()

◆ HasParameter() [1/2]

◆ HasParameter() [2/2]

◆ HasStringParameter()

◆ HasValue64bit()

◆ IncrementValue()

◆ IsEmpty()

◆ IsOwner()

◆ IsValue()

◆ List()

◆ ls()

◆ Merge()

◆ operator=()

◆ Print()

◆ ProduceEnvFile()

◆ ReadEnv()

◆ ReadEnvFile()

◆ RemoveParameter()

◆ Set()

Note on deduction of parameter types

◆ SetFirstValue()

◆ SetFromEnv()

◆ SetIgnoreBool()

◆ SetLastValue()

◆ SetOwner()

◆ SetValue() [1/2]

◆ SetValue() [2/2]

◆ SetValue64bit()

◆ SetValueAt()

◆ Sort()

◆ WriteClass()

◆ WriteEnvFile()