CrystalSpace

Public API Reference

Main Page | Modules | Class Hierarchy | Alphabetical List | Class List | File List | Class Members | File Members | Related Pages

csConfigDocument Class Reference

iConfigFile implementation for configurations stored in documents. More...

#include <csutil/cfgdoc.h>

Inheritance diagram for csConfigDocument:

iConfigFile iBase List of all members.

Public Member Functions

virtual const char * GetFileName () const
 Get configuration file name.
virtual iVFSGetVFS () const
 Get the VFS object on which this file is stored (if any).
virtual void SetFileName (const char *, iVFS *)
 Set config file name.
virtual bool Load (const char *iFileName, iVFS *=0, bool Merge=false, bool NewWins=true)
 Load a configuration file.
virtual bool Save ()
 Save configuration to the same place from which it was loaded.
virtual bool Save (const char *iFileName, iVFS *=0)
 Save configuration into the given file (on VFS or on the physical filesystem).
virtual void Clear ()
 Delete all options and rewind all iterators.
virtual csPtr< iConfigIteratorEnumerate (const char *Subsection=0)
 Enumerate selected keys.
virtual bool KeyExists (const char *Key) const
 Test if a key exists.
virtual bool SubsectionExists (const char *Subsection) const
 Test if at least one key exists with the given Subsection prefix.
virtual int GetInt (const char *Key, int Def=0) const
 Get an integer value from the configuration.
virtual float GetFloat (const char *Key, float Def=0.0) const
 Get a float value from the configuration.
virtual const char * GetStr (const char *Key, const char *Def="") const
 Get a string value from the configuration.
virtual bool GetBool (const char *Key, bool Def=false) const
 Get a boolean value from the configuration.
virtual const char * GetComment (const char *Key) const
 Get the comment of the given key, or 0 if no comment exists.
virtual void SetStr (const char *Key, const char *Val)
 Set an null-terminated string value.
virtual void SetInt (const char *Key, int Value)
 Set an integer value.
virtual void SetFloat (const char *Key, float Value)
 Set a floating-point value.
virtual void SetBool (const char *Key, bool Value)
 Set a boolean value.
virtual bool SetComment (const char *Key, const char *Text)
 Set the comment for given key.
virtual void DeleteKey (const char *Key)
 Delete a key and its value and comment.
virtual const char * GetEOFComment () const
 return the final comment at the end of the configuration file
virtual void SetEOFComment (const char *Text)
 set the final comment at the end of the configuration file

Detailed Description

iConfigFile implementation for configurations stored in documents.

Todo:
Write support

Definition at line 39 of file cfgdoc.h.


Member Function Documentation

virtual void csConfigDocument::Clear  )  [virtual]
 

Delete all options and rewind all iterators.

Implements iConfigFile.

virtual void csConfigDocument::DeleteKey const char *  Key  )  [virtual]
 

Delete a key and its value and comment.

Implements iConfigFile.

virtual csPtr<iConfigIterator> csConfigDocument::Enumerate const char *  Subsection = 0  )  [virtual]
 

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.

virtual bool csConfigDocument::GetBool const char *  Key,
bool  Def = false
const [virtual]
 

Get a boolean value from the configuration.

The optional default value (Def parameter) will be used if the key was not found.

Implements iConfigFile.

virtual const char* csConfigDocument::GetComment const char *  Key  )  const [virtual]
 

Get the comment of the given key, or 0 if no comment exists.

Implements iConfigFile.

virtual const char* csConfigDocument::GetEOFComment  )  const [virtual]
 

return the final comment at the end of the configuration file

Implements iConfigFile.

virtual const char* csConfigDocument::GetFileName  )  const [virtual]
 

Get configuration file name.

Implements iConfigFile.

virtual float csConfigDocument::GetFloat const char *  Key,
float  Def = 0.0
const [virtual]
 

Get a float value from the configuration.

The optional default value (Def parameter) will be used if the key was not found.

Implements iConfigFile.

virtual int csConfigDocument::GetInt const char *  Key,
int  Def = 0
const [virtual]
 

Get an integer value from the configuration.

The optional default value (Def parameter) will be used if the key was not found.

Implements iConfigFile.

virtual const char* csConfigDocument::GetStr const char *  Key,
const char *  Def = ""
const [virtual]
 

Get a string value from the configuration.

The optional default value (Def parameter) will be used if the key was not found.

Implements iConfigFile.

virtual iVFS* csConfigDocument::GetVFS  )  const [virtual]
 

Get the VFS object on which this file is stored (if any).

Returns 0 if this file resides within the real (non-VFS) filesystem.

Implements iConfigFile.

virtual bool csConfigDocument::KeyExists const char *  Key  )  const [virtual]
 

Test if a key exists.

Implements iConfigFile.

virtual bool csConfigDocument::Load const char *  iFileName,
iVFS = 0,
bool  Merge = false,
bool  NewWins = true
[virtual]
 

Load a configuration file.

If the file resides in a real filesystem, rather than a VFS filesystem, then pass 0 for the VFS argument.

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.

virtual bool csConfigDocument::Save const char *  iFileName,
iVFS = 0
[virtual]
 

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.

virtual bool csConfigDocument::Save  )  [virtual]
 

Save configuration to the same place from which it was loaded.

Returns true if the save operation succeeded.

Implements iConfigFile.

virtual void csConfigDocument::SetBool const char *  Key,
bool  Value
[virtual]
 

Set a boolean value.

Implements iConfigFile.

virtual bool csConfigDocument::SetComment const char *  Key,
const char *  Text
[virtual]
 

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 0 to remove the comment entirely. The comment may contain newline characters. Returns false if the key does not exist.

Implements iConfigFile.

virtual void csConfigDocument::SetEOFComment const char *  Text  )  [virtual]
 

set the final comment at the end of the configuration file

Implements iConfigFile.

virtual void csConfigDocument::SetFileName const char *  ,
iVFS
[virtual]
 

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.

virtual void csConfigDocument::SetFloat const char *  Key,
float  Value
[virtual]
 

Set a floating-point value.

Implements iConfigFile.

virtual void csConfigDocument::SetInt const char *  Key,
int  Value
[virtual]
 

Set an integer value.

Implements iConfigFile.

virtual void csConfigDocument::SetStr const char *  Key,
const char *  Val
[virtual]
 

Set an null-terminated string value.

Implements iConfigFile.

virtual bool csConfigDocument::SubsectionExists const char *  Subsection  )  const [virtual]
 

Test if at least one key exists with the given Subsection prefix.

Implements iConfigFile.


The documentation for this class was generated from the following file:
Generated for Crystal Space by doxygen 1.3.9.1