![]() |
Public API Reference |
#include <cfgmgr.h>
Inheritance diagram for csConfigManager:
Public Methods | |
csConfigManager (iConfigFile *DynamicDomain, bool Optimize) | |
Create a new config manager object. More... | |
virtual | ~csConfigManager () |
Delete this config manager. More... | |
virtual void | AddDomain (iConfigFile *, int priority) |
add a configuration domain. More... | |
virtual iConfigFile * | AddDomain (char const *path, iVFS *, int priority) |
add a configuration domain. More... | |
virtual void | RemoveDomain (iConfigFile *) |
remove a configuration domain. More... | |
virtual void | RemoveDomain (char const *path) |
remove a configuration domain. More... | |
virtual iConfigFile * | LookupDomain (char const *path) const |
return a pointer to a single config domain. More... | |
virtual void | SetDomainPriority (char const *path, int priority) |
set the priority of a config domain. More... | |
virtual void | SetDomainPriority (iConfigFile *, int priority) |
set the priority of a config domain. More... | |
virtual int | GetDomainPriority (char const *path) const |
return the priority of a config domain. More... | |
virtual int | GetDomainPriority (iConfigFile *) const |
return the priority of a config domain. More... | |
virtual bool | SetDynamicDomain (iConfigFile *) |
Change the dynamic domain. More... | |
virtual iConfigFile * | GetDynamicDomain () const |
return a pointer to the dynamic config domain. More... | |
virtual void | SetDynamicDomainPriority (int priority) |
set the priority of the dynamic config domain. More... | |
virtual int | GetDynamicDomainPriority () const |
return the priority of the dynamic config domain. More... | |
virtual void | FlushRemoved () |
flush all removed config files (only required in optimize mode). More... | |
virtual const char * | GetFileName () const |
Get configuration file name. More... | |
virtual iVFS * | GetVFS () const |
Get the VFS object on which this file is stored (if any). More... | |
virtual void | SetFileName (const char *, iVFS *) |
Set config file name. More... | |
virtual bool | Load (const char *iFileName, iVFS *=NULL, bool Merge=false, bool NewWins=true) |
Load a configuration file. More... | |
virtual bool | Save () |
Save configuration to the same place from which it was loaded. More... | |
virtual bool | Save (const char *iFileName, iVFS *=NULL) |
Save configuration into the given file (on VFS or on the physical filesystem). More... | |
virtual void | Clear () |
Delete all options and rewind all iterators. More... | |
void | CleanUp () |
FlushRemoved() and delete all domains. More... | |
virtual csPtr< iConfigIterator > | Enumerate (const char *Subsection=NULL) |
Enumerate selected keys. More... | |
virtual bool | KeyExists (const char *Key) const |
Test if a key exists. More... | |
virtual bool | SubsectionExists (const char *Subsection) const |
Test if at least one key exists with the given Subsection prefix. More... | |
virtual int | GetInt (const char *Key, int Def=0) const |
Get an integer value from the configuration. More... | |
virtual float | GetFloat (const char *Key, float Def=0.0) const |
Get a float value from the configuration. More... | |
virtual const char * | GetStr (const char *Key, const char *Def="") const |
Get a string value from the configuration. More... | |
virtual bool | GetBool (const char *Key, bool Def=false) const |
Get a boolean value from the configuration. More... | |
virtual const char * | GetComment (const char *Key) const |
Get the comment of the given key, or NULL if no comment exists. More... | |
virtual void | SetStr (const char *Key, const char *Val) |
Set an null-terminated string value. More... | |
virtual void | SetInt (const char *Key, int Value) |
Set an integer value. More... | |
virtual void | SetFloat (const char *Key, float Value) |
Set a floating-point value. More... | |
virtual void | SetBool (const char *Key, bool Value) |
Set a boolean value. More... | |
virtual bool | SetComment (const char *Key, const char *Text) |
Set the comment for given key. More... | |
virtual void | DeleteKey (const char *Key) |
Delete a key and its value and comment. More... | |
virtual const char * | GetEOFComment () const |
return the final comment at the end of the configuration file. More... | |
virtual void | SetEOFComment (const char *Text) |
set the final comment at the end of the configuration file. More... |
See the description of the SCF interface iConfigManager for full details.
Definition at line 30 of file csutil/cfgmgr.h.
|
Create a new config manager object. If 'Optimize' is set to 'true', then the config manager will enable some optimizations, which you may or may not want:
|
|
Delete this config manager.
|
|
add a configuration domain.
Implements iConfigManager. |
|
add a configuration domain.
Implements iConfigManager. |
|
FlushRemoved() and delete all domains.
|
|
Delete all options and rewind all iterators.
Implements iConfigFile. |
|
Delete a key and its value and comment.
Implements iConfigFile. |
|
Enumerate selected keys. If a subsection is given, only those keys which are prefixed by the subsection string will be enumerated. The returned iterator does not yet point to a valid key. You must call Next() to set it to the first key. Implements iConfigFile. |
|
flush all removed config files (only required in optimize mode).
Implements iConfigManager. |
|
Get a boolean value from the configuration.
Implements iConfigFile. |
|
Get the comment of the given key, or NULL if no comment exists.
Implements iConfigFile. |
|
return the priority of a config domain.
Implements iConfigManager. |
|
return the priority of a config domain.
Implements iConfigManager. |
|
return a pointer to the dynamic config domain.
Implements iConfigManager. |
|
return the priority of the dynamic config domain.
Implements iConfigManager. |
|
return the final comment at the end of the configuration file.
Implements iConfigFile. |
|
Get configuration file name. Also consult GetVFS() to determine which (if any) VFS object was used for the file's storage. Implements iConfigFile. |
|
Get a float value from the configuration.
Implements iConfigFile. |
|
Get an integer value from the configuration.
Implements iConfigFile. |
|
Get a string value from the configuration.
Implements iConfigFile. |
|
Get the VFS object on which this file is stored (if any). Returns NULL if this file resides within the real (non-VFS) filesystem. Implements iConfigFile. |
|
Test if a key exists.
Implements iConfigFile. |
|
Load a configuration file.
If the file resides in a real filesystem, rather than a VFS filesystem, then pass NULL for the VFS argument. This will clear all options before loading the new options, even if the file cannot be opened. You can set the Merge flag to merge the newly loaded configuration information into the existing information. If you do so, nothing will happen if the named file doesn't exist. The NewWins flag determines the behavior in case of configuration key conflicts. If true, then the new configuration value replaces the old for that key. If false, then the old value is kept, and the new value is ignored. The recorded file name will be set to the name of the newly loaded file if the Merge flag is false; otherwise it will retain the old name. Implements iConfigFile. |
|
return a pointer to a single config domain.
Implements iConfigManager. |
|
remove a configuration domain.
Implements iConfigManager. |
|
remove a configuration domain.
Implements iConfigManager. |
|
Save configuration into the given file (on VFS or on the physical filesystem). If the second parameter is skipped, the file will be written to the physical filesystem, otherwise it is stored on given VFS filesystem. This method does not change the internally stored file name. Implements iConfigFile. |
|
Save configuration to the same place from which it was loaded. Returns true if the save operation succeeded. Implements iConfigFile. |
|
Set a boolean value.
Implements iConfigFile. |
|
Set the comment for given key. In addition to an actual comment, you can use "" for Text to place an empty comment line before this key, or NULL to remove the comment entirely. The comment may contain newline characters. Returns false if the key does not exist. Implements iConfigFile. |
|
set the priority of a config domain.
Implements iConfigManager. |
|
set the priority of a config domain.
Implements iConfigManager. |
|
Change the dynamic domain. The given config object must already be registered with AddDomain(). Returns false if this is not the case. Implements iConfigManager. |
|
set the priority of the dynamic config domain.
Implements iConfigManager. |
|
set the final comment at the end of the configuration file.
Implements iConfigFile. |
|
Set config file name. You can use this if you want Save() to write to another file. This will set the dirty flag. Implements iConfigFile. |
|
Set a floating-point value.
Implements iConfigFile. |
|
Set an integer value.
Implements iConfigFile. |
|
Set an null-terminated string value.
Implements iConfigFile. |
|
Test if at least one key exists with the given Subsection prefix.
Implements iConfigFile. |