![]() | Patrick's Programming Library Version 6.4.21 - Dokumentation |
Komplexes mehrdimensionales Array mit Strings als Schlüssel. Mehr ...
Öffentliche Typen | |
enum | PPLDataType { UNKNOWN =0, CINT =2, CSTRING =4, CASSOCARRAY =5, CBINARY =6, CWSTRING =8, CARRAY =9, CBOOL =10, CDATETIME =11 } |
Enumeration der verschiedenen Datenobjekte, die in der Library verwendet werden. Mehr ... | |
Öffentliche Methoden | |
int | DataType () const |
Liefert den Datentyp des Objekts zurück. Mehr ... | |
int | IsType (int type) const |
Konstruktoren und Destruktoren | |
CAssocArray () | |
Konstruktor des Assoziativen Arrays. Mehr ... | |
CAssocArray (const CAssocArray &a) | |
Konstruktor des Assoziativen Arrays. Mehr ... | |
CAssocArray (const CArray &a) | |
Konstruktor des Assoziativen Arrays. Mehr ... | |
CAssocArray (const CAssocArray *a) | |
Konstruktor des Assoziativen Arrays. Mehr ... | |
~CAssocArray () | |
Destruktor der Klasse. Mehr ... | |
Informationen ausgeben/auslesen | |
void | List (const char *prefix=NULL) const |
Inhalt des Arrays ausgeben. Mehr ... | |
int | Count (bool recursive=false) const |
Anzahl Schlüssel zählen. Mehr ... | |
int | Count (const char *key, bool recursive=false) const |
Anzahl Schlüssel für ein bestimmtes Element zählen. Mehr ... | |
int | Validate (const char *prefix=NULL) |
Array überprüfen. Mehr ... | |
Werte setzen | |
int | Add (const char *key, const char *value, int size=-1) |
String hinzufügen. Mehr ... | |
int | Add (const char *key, ppldds value) |
Integer hinzufügen. Mehr ... | |
int | Set (const char *key, const char *value, int size=-1) |
String hinzufügen. Mehr ... | |
int | Set (const char *key, const CString &value, int size=-1) |
CString hinzufügen. Mehr ... | |
int | Set (const char *key, const CWString &value, int size=-1) |
Unicode CWString hinzufügen. Mehr ... | |
int | Setf (const char *key, const char *fmt,...) |
Formatierten String hinzufügen. Mehr ... | |
int | Set (const char *key, const CAssocArray &array) |
int | Set (const char *key, CAssocArray *array, bool copy=true) |
Assoziatives Array hinzufügen. Mehr ... | |
int | Set (const char *key, const CArray &array) |
Einfaches CArray hinzufügen. Mehr ... | |
int | Set (const char *key, const CDirEntry &d) |
Verzeichnis-Eintrag in das Array kopieren. Mehr ... | |
int | Set (const char *key, const CBinary &bin) |
int | Set (const char *key, CBinary *bin, bool copy=true) |
CBinary hinzufügen. Mehr ... | |
int | Set (const char *key, const CDateTime &date) |
int | SetPointer (const char *key, const void *ptr) |
Pointer hinzufügen. Mehr ... | |
int | Copy (const CAssocArray *a) |
CAssocArray kopieren. Mehr ... | |
int | Copy (const CAssocArray &a) |
CAssocArray kopieren. Mehr ... | |
int | Copy (const CDirEntry &d) |
Verzeichnis-Eintrag in das Array kopieren. Mehr ... | |
int | Copy (const CArray &a) |
CArray kopieren. Mehr ... | |
int | Copy (const char *key, const CAssocArray &a, const char *sourcekey=NULL) |
Einzelnen Schlüssel eines CAssocArray kopieren. Mehr ... | |
int | Merge (const char *key, const CAssocArray &a) |
CAssocArray kopieren. Mehr ... | |
Werte erweitern (nur Strings) | |
int | Concat (const char *key, const char *value, const char *concat="\n", int size=-1) |
String-Wert eines Schlüssels erweitern. Mehr ... | |
int | Concatf (const char *key, const char *concat, const char *fmt,...) |
String-Wert eines Schlüssels um einen formatierten String erweitern. Mehr ... | |
Werte löschen | |
void | Clear () |
Inhalt des Arrays löschen. Mehr ... | |
int | Delete (const char *key) |
Einzelnen Schlüssel löschen. Mehr ... | |
int | Deletef (const char *fmt,...) |
Einzelnen Schlüssel löschen. Mehr ... | |
Import und Export von Daten | |
int | Size () |
Liefert Anzahl Bytes, die für ExportBinary erforderlich sind. Mehr ... | |
int | CreateFromTemplate (const char *templ, const char *linedelimiter="\n", const char *splitchar="=", const char *concat="\n", bool dotrim=false) |
Wandelt ein Key-Value Template in ein Assoziatives Array um. Mehr ... | |
int | CreateFromConfig (const char *content, const char *splitchar=":", const char *concat="\n", bool dotrim=false) |
Wandelt eine Konfigurationsdatei in ein Assoziatives Array um. Mehr ... | |
void | ToTemplate (CString &s, const char *prefix=NULL, const char *linedelimiter="\n", const char *splitchar="=") |
Inhalt des Arrays in ein Template exportieren. Mehr ... | |
int | ExportBinary (void *buffer, int buffersize, int *realsize) |
Inhalt des Arrays in einem plattform-unabhängigen Binären-Format exportieren. Mehr ... | |
CBinary * | ExportBinary () |
int | ImportBinary (const void *buffer, int buffersize) |
Daten aus einem vorherigen Export wieder importieren. Mehr ... | |
int | ImportBinary (const CBinary &bin) |
Daten aus einem vorherigen Export wieder importieren. Mehr ... | |
Werte direkt auslesen | |
ARRAY_RESULT | GetValue (const char *key) const |
Liefert einen Pointer auf das Element zum angegebenen Schlüssel zurück. Mehr ... | |
const char * | GetChar (const char *key) const |
Liefert den Wert zum angegebenen Schlüssel zurück. Mehr ... | |
const char * | Get (const char *key) const |
Liefert den Wert zum angegebenen Schlüssel zurück. Mehr ... | |
const char * | Getf (const char *fmt,...) const |
Liefert den Wert zum angegebenen Schlüssel zurück. Mehr ... | |
CString * | GetString (const char *key) const |
Liefert den Wert zum angegebenen Schlüssel zurück. Mehr ... | |
CDateTime | GetDateTime (const char *key) const |
CString * | GetStringf (const char *fmt,...) const |
Liefert den Wert zum angegebenen Schlüssel zurück. Mehr ... | |
CString * | GetCString (const char *key) const |
Liefert den Wert zum angegebenen Schlüssel zurück. Mehr ... | |
CString * | GetCStringf (const char *fmt,...) const |
Liefert den Wert zum angegebenen Schlüssel zurück. Mehr ... | |
CWString * | GetCWString (const char *key) const |
Liefert den Wert zum angegebenen Schlüssel zurück. Mehr ... | |
CWString * | GetCWStringf (const char *fmt,...) const |
Liefert den Wert zum angegebenen Schlüssel zurück. Mehr ... | |
int | GetCArray (CArray &a, const char *key=NULL) const |
CAssocArray * | GetArray (const char *key) const |
Liefert das Assoziative Array zum angegebenen Schlüssel zurück. Mehr ... | |
CAssocArray * | GetArrayf (const char *fmt,...) const |
Liefert das Assoziative Array zum angegebenen Schlüssel zurück. Mehr ... | |
CBinary * | GetBinary (const char *key) const |
Liefert das Binary-Object zum angegebenen Schlüssel zurück. Mehr ... | |
CBinary * | GetBinaryf (const char *fmt,...) const |
Liefert das Binary-Object zum angegebenen Schlüssel zurück. Mehr ... | |
int | ToInt (const char *key) const |
long | ToLong (const char *key) const |
long long | ToLongLong (const char *key) const |
bool | ToBool (const char *key) const |
CString | ToCString (const char *key) const |
CWString | ToCWString (const char *key) const |
CAssocArray | ToCAssocArray (const char *key) const |
CArray | ToCArray (const char *key) const |
CBinary | ToCBinary (const char *key) const |
bool | HaveKey (const char *key) const |
void * | GetPointer (const char *key) const |
Liefert den Void-Pointer zum angegebenen Schlüssel zurück. Mehr ... | |
void * | GetPointerf (const char *fmt,...) const |
Liefert den Void-Pointer zum angegebenen Schlüssel zurück. Mehr ... | |
int | GetKey (CString &key, const char *value, bool recursive=false) |
Liefert den ersten passenden Key, auf den value matched. Mehr ... | |
Werte prüfen | |
int | IsTrue (const char *key) const |
Prüft, ob der Schlüssel vorhanden und "wahr" ist. Mehr ... | |
int | IsFalse (const char *key) const |
Prüft, ob der Schlüssel vorhanden und "falsch" ist. Mehr ... | |
int | IsString (ARRAY_RESULT res) const |
Prüft, ob es sich bei dem Ergebnis um einen CString handelt. Mehr ... | |
int | IsCString (ARRAY_RESULT res) const |
Prüft, ob es sich bei dem Ergebnis um einen CString handelt. Mehr ... | |
int | IsCWString (ARRAY_RESULT res) const |
Prüft, ob es sich bei dem Ergebnis um einen CWString handelt. Mehr ... | |
int | IsArray (ARRAY_RESULT res) const |
Prüft, ob es sich bei dem Ergebnis um einen CAssocArray handelt. Mehr ... | |
int | IsPointer (ARRAY_RESULT res) const |
Prüft, ob es sich bei dem Ergebnis um einen Pointer handelt. Mehr ... | |
int | IsBinary (ARRAY_RESULT res) const |
Prüft, ob es sich bei dem Ergebnis um ein CBinary handelt. Mehr ... | |
int | GetDatatype (ARRAY_RESULT res) const |
Datentyp eines Elements zurückliefern. Mehr ... | |
Array durchwandern | |
void | Reset () |
Zeiger für das Durchwandern des Arrays zurücksetzen. Mehr ... | |
ARRAY_RESULT | GetFirst () |
Erstes Element aus dem Array holen. Mehr ... | |
ARRAY_RESULT | GetNext () |
Nächstes Element aus dem Array holen. Mehr ... | |
ARRAY_RESULT | GetLast () |
Letztes Element aus dem Array holen. Mehr ... | |
ARRAY_RESULT | GetPrevious () |
Vorhergehendes Element aus dem Array holen. Mehr ... | |
void | Reset (CTreeWalker &walk) const |
ARRAY_RESULT | GetFirst (CTreeWalker &walk) const |
ARRAY_RESULT | GetNext (CTreeWalker &walk) const |
CAssocArray * | GetFirstArray () |
Erstes CAssocArray innerhalb dieses Arrays finden. Mehr ... | |
CAssocArray * | GetNextArray () |
Nächstes CAssocArray innerhalb dieses Arrays finden. Mehr ... | |
CAssocArray * | GetLastArray () |
Letztes CAssocArray innerhalb dieses Arrays finden. Mehr ... | |
CAssocArray * | GetPreviousArray () |
Vorheriges CAssocArray innerhalb dieses Arrays finden. Mehr ... | |
CAssocArray * | GetFirstArray (CTreeWalker &walk) const |
Erstes CAssocArray innerhalb dieses Arrays finden. Mehr ... | |
CAssocArray * | GetNextArray (CTreeWalker &walk) const |
Nächstes CAssocArray innerhalb dieses Arrays finden. Mehr ... | |
CAssocArray * | GetLastArray (CTreeWalker &walk) const |
Letztes CAssocArray innerhalb dieses Arrays finden. Mehr ... | |
CAssocArray * | GetPreviousArray (CTreeWalker &walk) const |
Vorheriges CAssocArray innerhalb dieses Arrays finden. Mehr ... | |
int | GetFirstArray (CAssocArray &res) |
int | GetNextArray (CAssocArray &res) |
int | GetLastArray (CAssocArray &res) |
int | GetPreviousArray (CAssocArray &res) |
int | GetFirst (char **key, char **value) |
Ersten String im Array finden und Key und Value zurückgeben. Mehr ... | |
int | GetFirst (CString *key, CString *value) |
Ersten String im Array finden und Key und Value in CStrings speichern. Mehr ... | |
int | GetFirst (CString &key, CString &value) |
Ersten String im Array finden und Key und Value in CStrings speichern. Mehr ... | |
int | GetNext (char **key, char **value) |
Nächsten String im Array finden und Key und Value zurückgeben. Mehr ... | |
int | GetNext (CString &key, CString &value) |
Ersten String im Array finden und Key und Value in CStrings speichern. Mehr ... | |
int | GetNext (CString *key, CString *value) |
Ersten String im Array finden und Key und Value in CStrings speichern. Mehr ... | |
int | GetLast (char **key, char **value) |
Letzten String im Array finden und Key und Value zurückgeben. Mehr ... | |
int | GetLast (CString &key, CString &value) |
Letzten String im Array finden und Key und Value in CStrings speichern. Mehr ... | |
int | GetLast (CString *key, CString *value) |
Letzten String im Array finden und Key und Value in CStrings speichern. Mehr ... | |
int | GetPrevious (char **key, char **value) |
Vorherigen String im Array finden und Key und Value zurückgeben. Mehr ... | |
int | GetPrevious (CString &key, CString &value) |
Vorherigen String im Array finden und Key und Value in CStrings speichern. Mehr ... | |
int | GetPrevious (CString *key, CString *value) |
Vorherigen String im Array finden und Key und Value in CStrings speichern. Mehr ... | |
CString * | GetString (ARRAY_RESULT res) const |
CString eines Ergebnisses zurückgeben. Mehr ... | |
CString * | GetCString (ARRAY_RESULT res) const |
CString eines Ergebnisses zurückgeben. Mehr ... | |
CWString * | GetCWString (ARRAY_RESULT res) const |
CWString eines Ergebnisses zurückgeben. Mehr ... | |
const char * | GetChar (ARRAY_RESULT res) const |
String eines Ergebnisses zurückgeben. Mehr ... | |
CAssocArray * | GetArray (ARRAY_RESULT res) const |
CAssocArray eines Ergebnisses zurückgeben. Mehr ... | |
void * | GetPointer (ARRAY_RESULT res) const |
Void-Pointer eines Ergebnisses zurückgeben. Mehr ... | |
CBinary * | GetBinary (ARRAY_RESULT res) const |
CBinary eines Ergebnisses zurückgeben. Mehr ... | |
const char * | GetKey (ARRAY_RESULT res, CString *str=NULL) const |
Liefert den Schlüsselnamen eines Ergebnisses zurück. Mehr ... | |
const char * | GetKey (ARRAY_RESULT res, CString &key) const |
Liefert den Schlüsselnamen eines Ergebnisses zurück. Mehr ... | |
const char * | GetCurrentKey (CString *str=NULL) const |
Liefert den Namen des aktuellen Schlüssels zurück. Mehr ... | |
const char * | GetCurrentKey (CString &key) const |
Liefert den Namen des aktuellen Schlüssels zurück. Mehr ... | |
Operatoren | |
const char * | operator[] (const char *key) const |
String zu einem Key auslesen. Mehr ... | |
CAssocArray & | operator= (const CAssocArray &a) |
CAssocArray kopieren. Mehr ... | |
CAssocArray & | operator= (const CArray &a) |
CArray kopieren. Mehr ... | |
CAssocArray & | operator= (const CAssocArray *a) |
CAssocArray kopieren. Mehr ... | |
CAssocArray & | operator= (CDirEntry &d) |
CDirEntry oder CDir kopieren. Mehr ... | |
CAssocArray & | operator= (CDirEntry *d) |
CDirEntry oder CDir kopieren. Mehr ... | |
Geschützte Attribute | |
ppluint8 | type |
Private Methoden | |
ARRAY_RESULT | CreateTree (const char *key) |
Interne Funktion, die ein Element im Baum sucht oder anlegt. Mehr ... | |
ARRAY_RESULT | FindInternal (const char *key) const |
Interne Funktion zum Suchen eines Elements. Mehr ... | |
Private Attribute | |
ppluint64 | maxint |
Enthält die höchste bisher als Schlüssel verwendete Ziffer. Mehr ... | |
int | num |
Anzahl Elemente in diesem Array. Mehr ... | |
CTree | Tree |
Der Baum, in dem die Elemente abgelegt werden. Mehr ... | |
"ebene1/ebene2/key"
einen Wert, werden automatisch folgende Aktionen ausgeführt:
|
inherited |
Enumeration der verschiedenen Datenobjekte, die in der Library verwendet werden
Aufzählungswerte | |
---|---|
UNKNOWN |
Unbekannter Datentyp. |
CINT |
Klasse vom Typ CInt. |
CSTRING |
Klasse vom Typ CString. |
CASSOCARRAY |
Klasse vom Typ CAssocArray. |
CBINARY |
Klasse vom Typ CBinary. |
CWSTRING |
Klasse vom Typ CWString. |
CARRAY |
Klasse vom Typ CArray. |
CBOOL |
Klasse vom Typ CBool. |
CDATETIME |
Klasse vom Typ CDateTime. |
ppl6::CAssocArray::CAssocArray | ( | ) |
ppl6::CAssocArray::CAssocArray | ( | const CAssocArray & | a | ) |
[in] | a | Ein anderes CAssocArray, dessen Inhalt kopiert werden soll |
ppl6::CAssocArray::CAssocArray | ( | const CArray & | a | ) |
[in] | a | Ein CArray, dessen Inhalt kopiert werden soll |
ppl6::CAssocArray::CAssocArray | ( | const CAssocArray * | a | ) |
[in] | a | Ein anderes CAssocArray, dessen Inhalt kopiert werden soll |
ppl6::CAssocArray::~CAssocArray | ( | ) |
int ppl6::CAssocArray::Add | ( | const char * | key, |
const char * | value, | ||
int | size = -1 |
||
) |
[in] | key | Name des Schlüssels |
[in] | value | Pointer auf den Wert für den Schlüssel |
[in] | size | Optionaler Parameter, der die Anzahl Bytes angibt, die aus dem value Wert übernommen werden sollen |
int ppl6::CAssocArray::Add | ( | const char * | key, |
ppldds | value | ||
) |
[in] | key | Name des Schlüssels |
[in] | value | Integer-Wert |
void ppl6::CAssocArray::Clear | ( | ) |
int ppl6::CAssocArray::Concat | ( | const char * | key, |
const char * | value, | ||
const char * | concat = "\n" , |
||
int | size = -1 |
||
) |
[in] | key | Name des Schlüssels |
[in] | value | String, der an den vorhandenen Wert angefügt werden soll |
[in] | concat | Optionales Trennzeichen. Wurde es angegeben und enthält der Schlüssel bereits einen Wert, wird zunächst das Trennzeichen concat angefügt und danach erst der neue String value . |
[in] | size | Optionaler Parameter, der die Anzahl anzufügender Bytes angibt. Wird er nicht angegeben, wird der komplette String aus value übernommen |
int ppl6::CAssocArray::Concatf | ( | const char * | key, |
const char * | concat, | ||
const char * | fmt, | ||
... | |||
) |
[in] | key | Name des Schlüssels |
[in] | concat | Optionales Trennzeichen. Wurde es angegeben und enthält der Schlüssel bereits einen Wert, wird zunächst das Trennzeichen concat angefügt und danach erst der neue String value . |
[in] | fmt | Format-String, der an den vorhandenen Wert angefügt werden soll |
[in] | ... | Beliebig viele Werte für den Format-String fmt |
int ppl6::CAssocArray::Copy | ( | const CAssocArray * | a | ) |
[in] | a | Pointer auf das zu kopierende CAssocArray |
int ppl6::CAssocArray::Copy | ( | const CAssocArray & | a | ) |
[in] | a | Das zu kopierende CAssocArray |
int ppl6::CAssocArray::Copy | ( | const CDirEntry & | d | ) |
[in] | d | Pointer auf eine CDirEntry oder CDir-Klasse |
int ppl6::CAssocArray::Copy | ( | const CArray & | a | ) |
Da CAssocArray als Datentyp kein CArray unterstützt, wird dieses automatisch in ein CAssocArray umgewandelt.
[in] | a | Pointer auf das zu kopierende CArray |
int ppl6::CAssocArray::Copy | ( | const char * | key, |
const CAssocArray & | a, | ||
const char * | sourcekey = NULL |
||
) |
[in] | key | Name des Ziel-Schlüssels in diesem Array |
[in] | a | Pointer auf das zu kopierende CAssocArray |
[in] | sourcekey | Optionaler Name des Schlüssels im angegebenen Array, der kopiert werden soll. Wird er nicht angegeben wird als Quell-Schlüssel der Wert von key übernommen. |
int ppl6::CAssocArray::Count | ( | bool | recursive = false | ) | const |
[in] | recursive | Falls recursive auf true gesetzt wird die Funktion rekusriv für jeden Schlüssel aufgerufen, dessen Wert ebenfalls ein Array ist. |
int ppl6::CAssocArray::Count | ( | const char * | key, |
bool | recursive = false |
||
) | const |
[in] | key | Schlüssel-Name eines Assoziativen Arrays innerhalb dieses Arrays |
[in] | recursive | Falls recursive auf true gesetzt wird die Funktion rekusriv für jeden Schlüssel aufgerufen, dessen Wert ebenfalls ein Array ist. |
int ppl6::CAssocArray::CreateFromConfig | ( | const char * | content, |
const char * | splitchar = ":" , |
||
const char * | concat = "\n" , |
||
bool | dotrim = false |
||
) |
CreateFromConfig
wandelt einen Konfigurations-Text mit mehreren Abschnitten im Key-Value-Format in ein Assoziatives Array um. Ein Abschnitt beginnt immer mit einem Keywort in Eckigen klammern und enthält Key-Value-Paare. Zeilen mit Raute (#) am Anfang werden als Kommentarzeilen interpretiert und ignoriert.[in] | content | Ein Char-Pointer auf einen Null-Terminierten String, der die Konfiguration enthält. |
[in] | splitchar | Das Zeichen, was als Trennzeichen zwischen Schlüssel (Key) und Wert (Value) interpretiert werden soll. Der Default ist der Doppelpunkt (:) |
[in] | concat | Ist concat gesetzt und kommen im Text mehrere identische Schlüssel vor, werden die Werte zu einem String zusammengeführt, wobei als Trennzeichen concat verwendet wird. Ist concat NULL, wird ein vorhandener Schlüssel überschrieben. Der Default ist, dass gleiche Schlüssel mit Newline aneinander gehangen werden. |
[in] | dotrim | Ist dotrim=true , werden einzelnen Werte vor dem Einfügen ins Array mit der Funktion ppl6::trim getrimmt, also Leerzeilen, Tabs und Zeilenumbrüche am Anfang und Ende gelöscht. Der Default ist false . |
int ppl6::CAssocArray::CreateFromTemplate | ( | const char * | templ, |
const char * | linedelimiter = "\n" , |
||
const char * | splitchar = "=" , |
||
const char * | concat = "\n" , |
||
bool | dotrim = false |
||
) |
CreateFromTemplate
wandelt einen Text im Key-Value-Format in ein Assoziatives Array um. Leere Zeilen oder Zeilen mit Raute (#) am Anfang (Kommentarzeilen) werden ignoriert.[in] | templ | Entweder ein char-Pointer auf einen Null-Terminierten String oder ein Pointer auf die String-Klasse CString |
[in] | linedelimiter | Das Zeichen, was als Zeilenende interpretiert werden soll. Default ist Newline |
[in] | splitchar | Das Zeichen, was als Trennzeichen zwischen Schlüssel (Key) und Wert (Value) interpretiert werden soll. Der Default ist das Gleichheitszeichen (=) |
[in] | concat | Ist concat gesetzt und kommen im Text mehrere identische Schlüssel vor, werden die Werte zu einem String zusammengeführt, wobei als Trennzeichen concat verwendet wird. Ist concat NULL, wird ein vorhandener Schlüssel überschrieben. Der Default ist, dass gleiche Schlüssel mit Newline aneinander gehangen werden. |
[in] | dotrim | Ist dotrim=true , werden einzelnen Werte vor dem Einfügen ins Array mit der Funktion ppl6::trim getrimmt, also Leerzeilen, Tabs und Zeilenumbrüche am Anfang und Ende gelöscht. Der Default ist false . |
|
private |
[in] | key | Pointer auf den Namen des Schlüssels |
Das Element ebene1/schlüssel1
ist im Baum bereits vorhanden und beinhaltet einen String. Nun wird das neue Element ebene1/schlüssel1/unterschlüssel1
angelegt. Da Schlüssel eindeutig sein müssen, wird der String ebene1/schlüssel1
gelöscht und in ein Array umgewandelt.
|
inherited |
Diese Funktion liefert den Datentyp des Objekts zurück.
int ppl6::CAssocArray::Delete | ( | const char * | key | ) |
[in] | key | Pointer auf den Namen des zu löschenden Schlüssels |
int ppl6::CAssocArray::Deletef | ( | const char * | fmt, |
... | |||
) |
[in] | fmt | Pointer auf einen Formatstring, den den Namen des zu löschenden Schlüssels enthält. |
[in] | ... | Beliebig viele Parameter für den Formatstring |
int ppl6::CAssocArray::ExportBinary | ( | void * | buffer, |
int | buffersize, | ||
int * | realsize | ||
) |
[in] | buffer | Pointer auf einen ausreichend großen Puffer. Die Größe des benötigten Puffers kann zuvor mit der Funktion CAssocArray::Size ermittelt werden. Wird als Buffer NULL übergeben, wird in der Variable realsize ebenfalls die Anzahl Bytes zurückgegeben |
[in] | buffersize | Die Größe des Puffers in Bytes |
[out] | realsize | In dieser Variable wird gespeichert, wieviele Bytes tatsächlich für den Export verwendet wurden |
CBinary * ppl6::CAssocArray::ExportBinary | ( | ) |
|
private |
key
) in seine einzelnen Elemente. Als Trennzeichen wird wie bei einer Unix-Pfadangabe das Slash (/) verwendet. Die Funktion sucht zunächst auf das erste Element im eigenen Baum. Ist dies vorhanden und handelt es sich bei dessen Datentyp wieder um ein CAssocArray, wird deren FindInternal-Funktion mit dem restlichen Schlüssel rekursiv aufgerufen. Dies geschieht solange, bis das letzte Element des Keys gefunden wurde.[in] | key | Pointer auf den String mit dem gesuchten Schlüssel |
Die Funktion wird von allen Get...- und Concat-Funktionen verwendet.
const char * ppl6::CAssocArray::Get | ( | const char * | key | ) | const |
[in] | key | Pointer auf den Namen des gewünschten Schlüssels |
CAssocArray * ppl6::CAssocArray::GetArray | ( | const char * | key | ) | const |
[in] | key | Pointer auf den Namen des Schlüssels |
CAssocArray * ppl6::CAssocArray::GetArray | ( | ARRAY_RESULT | res | ) | const |
[in] | res | Ergebnis aus einer vorhergehenden GetFirst*, GetNext*, etc. Funktion, die zum Durchwandern des Arrays verwendet wurde. |
CAssocArray * ppl6::CAssocArray::GetArrayf | ( | const char * | fmt, |
... | |||
) | const |
[in] | fmt | Pointer auf einen Formatstring, der den Namen des gewünschten Schlüssels ergibt |
[in] | ... | Beliebig viele weitere Parameter, die im Formatstring benötigt werden. |
CBinary * ppl6::CAssocArray::GetBinary | ( | const char * | key | ) | const |
[in] | key | Pointer auf den Namen des Schlüssels |
CBinary * ppl6::CAssocArray::GetBinary | ( | ARRAY_RESULT | res | ) | const |
[in] | res | Ergebnis aus einer vorhergehenden GetFirst*, GetNext*, etc. Funktion, die zum Durchwandern des Arrays verwendet wurde. |
CBinary * ppl6::CAssocArray::GetBinaryf | ( | const char * | fmt, |
... | |||
) | const |
[in] | fmt | Pointer auf einen Formatstring, der den Namen des gewünschten Schlüssels ergibt |
[in] | ... | Beliebig viele weitere Parameter, die im Formatstring benötigt werden. |
int ppl6::CAssocArray::GetCArray | ( | CArray & | a, |
const char * | key = NULL |
||
) | const |
const char * ppl6::CAssocArray::GetChar | ( | const char * | key | ) | const |
[in] | key | Pointer auf den Namen des gewünschten Schlüssels |
const char * ppl6::CAssocArray::GetChar | ( | ARRAY_RESULT | res | ) | const |
[in] | res | Ergebnis aus einer vorhergehenden GetFirst*, GetNext*, etc. Funktion, die zum Durchwandern des Arrays verwendet wurde. |
CString * ppl6::CAssocArray::GetCString | ( | const char * | key | ) | const |
Liefert den Wert zum angegebenen Schlüssel zurück.
[in] | key | Pointer auf den Namen des Schlüssels |
CString * ppl6::CAssocArray::GetCString | ( | ARRAY_RESULT | res | ) | const |
[in] | res | Ergebnis aus einer vorhergehenden GetFirst*, GetNext*, etc. Funktion, die zum Durchwandern des Arrays verwendet wurde. |
CString * ppl6::CAssocArray::GetCStringf | ( | const char * | fmt, |
... | |||
) | const |
const char * ppl6::CAssocArray::GetCurrentKey | ( | CString * | str = NULL | ) | const |
[in] | str | Optionaler Pointer auf einen CString, in dem der Schlüssel gespeichert werden soll. Wird er nicht angegeben, wird nur der Pointer auf den Schlüsselnamen zurückgegeben. |
const char * ppl6::CAssocArray::GetCurrentKey | ( | CString & | key | ) | const |
[in] | key | Ein CString, in dem der Schlüssel gespeichert werden soll. |
CWString * ppl6::CAssocArray::GetCWString | ( | const char * | key | ) | const |
[in] | key | Pointer auf den Namen des Schlüssels |
CWString * ppl6::CAssocArray::GetCWString | ( | ARRAY_RESULT | res | ) | const |
[in] | res | Ergebnis aus einer vorhergehenden GetFirst*, GetNext*, etc. Funktion, die zum Durchwandern des Arrays verwendet wurde. |
CWString * ppl6::CAssocArray::GetCWStringf | ( | const char * | fmt, |
... | |||
) | const |
[in] | fmt | Pointer auf einen Formatstring, der den Namen des gewünschten Schlüssels ergibt |
[in] | ... | Beliebig viele weitere Parameter, die im Formatstring benötigt werden. |
int ppl6::CAssocArray::GetDatatype | ( | ARRAY_RESULT | res | ) | const |
[in] | res | Ergebnis einer vorherigen Abfrage mit GetFirst, GetNext, GetLast oder GetPrevious |
CDateTime ppl6::CAssocArray::GetDateTime | ( | const char * | key | ) | const |
const char * ppl6::CAssocArray::Getf | ( | const char * | fmt, |
... | |||
) | const |
[in] | fmt | Pointer auf einen Formatstring, der den Namen des gewünschten Schlüssels ergibt |
[in] | ... | Beliebig viele weitere Parameter, die im Formatstring benötigt werden. |
ARRAY_RESULT ppl6::CAssocArray::GetFirst | ( | ) |
Mit folgenden Funktionen kann der Inhalt des Wertes ausgelesen werden:
ARRAY_RESULT ppl6::CAssocArray::GetFirst | ( | CTreeWalker & | walk | ) | const |
int ppl6::CAssocArray::GetFirst | ( | char ** | key, |
char ** | value | ||
) |
[in] | key | Pointer auf einen Charpointer, in dem der Pointer auf den Schlüsselname abgelegt werden soll |
[in] | value | Pointer auf einen Charpointer, in dem der Pointer auf den Wert abgelegt werden soll |
value
wird jedoch bei CWString-Werten von Unicode nach UTF-8 konvertiert. Die Rückgabewerte sind aufsteigen sortiert nach Schlüssel.[in] | key | Pointer auf einen CString in dem der Schlüsselname abgelegt werden soll |
[in] | value | Pointer auf einen CString in dem der Wert abgelegt werden soll |
value
wird jedoch bei CWString-Werten von Unicode nach UTF-8 konvertiert. Die Rückgabewerte sind aufsteigen sortiert nach Schlüssel.[in] | key | Pointer auf einen CString in dem der Schlüsselname abgelegt werden soll |
[in] | value | Pointer auf einen CString in dem der Wert abgelegt werden soll |
value
wird jedoch bei CWString-Werten von Unicode nach UTF-8 konvertiert. Die Rückgabewerte sind aufsteigen sortiert nach Schlüssel.CAssocArray * ppl6::CAssocArray::GetFirstArray | ( | ) |
CAssocArray * ppl6::CAssocArray::GetFirstArray | ( | CTreeWalker & | walk | ) | const |
int ppl6::CAssocArray::GetFirstArray | ( | CAssocArray & | res | ) |
int ppl6::CAssocArray::GetKey | ( | CString & | key, |
const char * | value, | ||
bool | recursive = false |
||
) |
value
übereinstimmt. Der Schlüssel-Name des ersten passenden Elements wird zurückgegeben.[out] | key | In diesem String wird der gefundene Schlüssel gespeichert |
[in] | value | Der gesuchte Wert |
[in] | recursive | Optionaler Parameter. Wenn gesetzt, werden alle Ebenen des Arrays rekursiv durchsucht. Wenn nicht (=default), wird nur die erste Ebene durchsucht. |
key
gespeichert. Konnte der Wert nicht gefunden werden, gibt die Funktion false (0) zurück und key
bleibt unverändert. const char * ppl6::CAssocArray::GetKey | ( | ARRAY_RESULT | res, |
CString * | str = NULL |
||
) | const |
[in] | res | Ergebnis aus einer vorhergehenden GetFirst*, GetNext*, etc. Funktion, die zum Durchwandern des Arrays verwendet wurde. |
[in] | str | Optionaler Pointer auf einen CString, in dem der Schlüssel gespeichert werden soll. Wird er nicht angegeben, wird nur der Pointer auf den Schlüsselnamen zurückgegeben. |
const char * ppl6::CAssocArray::GetKey | ( | ARRAY_RESULT | res, |
CString & | key | ||
) | const |
[in] | res | Ergebnis aus einer vorhergehenden GetFirst*, GetNext*, etc. Funktion, die zum Durchwandern des Arrays verwendet wurde. |
[in] | key | Ein CString, in dem der Schlüssel gespeichert werden soll. |
ARRAY_RESULT ppl6::CAssocArray::GetLast | ( | ) |
int ppl6::CAssocArray::GetLast | ( | char ** | key, |
char ** | value | ||
) |
[in] | key | Pointer auf einen Charpointer, in dem der Pointer auf den Schlüsselname abgelegt werden soll |
[in] | value | Pointer auf einen Charpointer, in dem der Pointer auf den Wert abgelegt werden soll |
value
wird jedoch bei CWString-Werten von Unicode nach UTF-8 konvertiert. Die Rückgabewerte sind absteigend sortiert nach Schlüssel.[in] | key | Referenz auf einen CString in dem der Schlüsselname abgelegt werden soll |
[in] | value | Referenz auf einen CString in dem der Wert abgelegt werden soll |
value
wird jedoch bei CWString-Werten von Unicode nach UTF-8 konvertiert. Die Rückgabewerte sind absteigend sortiert nach Schlüssel.[in] | key | Pointer auf einen CString in dem der Schlüsselname abgelegt werden soll |
[in] | value | Pointer auf einen CString in dem der Wert abgelegt werden soll |
value
wird jedoch bei CWString-Werten von Unicode nach UTF-8 konvertiert. Die Rückgabewerte sind absteigend sortiert nach Schlüssel.CAssocArray * ppl6::CAssocArray::GetLastArray | ( | ) |
CAssocArray * ppl6::CAssocArray::GetLastArray | ( | CTreeWalker & | walk | ) | const |
int ppl6::CAssocArray::GetLastArray | ( | CAssocArray & | res | ) |
ARRAY_RESULT ppl6::CAssocArray::GetNext | ( | ) |
ARRAY_RESULT ppl6::CAssocArray::GetNext | ( | CTreeWalker & | walk | ) | const |
int ppl6::CAssocArray::GetNext | ( | char ** | key, |
char ** | value | ||
) |
[in] | key | Pointer auf einen Charpointer, in dem der Pointer auf den Schlüsselname abgelegt werden soll |
[in] | value | Pointer auf einen Charpointer, in dem der Pointer auf den Wert abgelegt werden soll |
value
wird jedoch bei CWString-Werten von Unicode nach UTF-8 konvertiert. Die Rückgabewerte sind aufsteigen sortiert nach Schlüssel.[in] | key | Pointer auf einen CString in dem der Schlüsselname abgelegt werden soll |
[in] | value | Pointer auf einen CString in dem der Wert abgelegt werden soll |
value
wird jedoch bei CWString-Werten von Unicode nach UTF-8 konvertiert. Die Rückgabewerte sind aufsteigen sortiert nach Schlüssel.[in] | key | Pointer auf einen CString in dem der Schlüsselname abgelegt werden soll |
[in] | value | Pointer auf einen CString in dem der Wert abgelegt werden soll |
value
wird jedoch bei CWString-Werten von Unicode nach UTF-8 konvertiert. Die Rückgabewerte sind aufsteigen sortiert nach Schlüssel.CAssocArray * ppl6::CAssocArray::GetNextArray | ( | ) |
CAssocArray * ppl6::CAssocArray::GetNextArray | ( | CTreeWalker & | walk | ) | const |
int ppl6::CAssocArray::GetNextArray | ( | CAssocArray & | res | ) |
void * ppl6::CAssocArray::GetPointer | ( | const char * | key | ) | const |
[in] | key | Pointer auf den Namen des Schlüssels |
void * ppl6::CAssocArray::GetPointer | ( | ARRAY_RESULT | res | ) | const |
[in] | res | Ergebnis aus einer vorhergehenden GetFirst*, GetNext*, etc. Funktion, die zum Durchwandern des Arrays verwendet wurde. |
void * ppl6::CAssocArray::GetPointerf | ( | const char * | fmt, |
... | |||
) | const |
[in] | fmt | Pointer auf einen Formatstring, der den Namen des gewünschten Schlüssels ergibt |
[in] | ... | Beliebig viele weitere Parameter, die im Formatstring benötigt werden. |
ARRAY_RESULT ppl6::CAssocArray::GetPrevious | ( | ) |
int ppl6::CAssocArray::GetPrevious | ( | char ** | key, |
char ** | value | ||
) |
[in] | key | Pointer auf einen Charpointer, in dem der Pointer auf den Schlüsselname abgelegt werden soll |
[in] | value | Pointer auf einen Charpointer, in dem der Pointer auf den Wert abgelegt werden soll |
value
wird jedoch bei CWString-Werten von Unicode nach UTF-8 konvertiert. Die Rückgabewerte sind absteigend sortiert nach Schlüssel.[in] | key | Referenz auf einen CString in dem der Schlüsselname abgelegt werden soll |
[in] | value | Referenz auf einen CString in dem der Wert abgelegt werden soll |
value
wird jedoch bei CWString-Werten von Unicode nach UTF-8 konvertiert. Die Rückgabewerte sind absteigend sortiert nach Schlüssel.[in] | key | Pointer auf einen CString in dem der Schlüsselname abgelegt werden soll |
[in] | value | Pointer auf einen CString in dem der Wert abgelegt werden soll |
value
wird jedoch bei CWString-Werten von Unicode nach UTF-8 konvertiert. Die Rückgabewerte sind absteigend sortiert nach Schlüssel.CAssocArray * ppl6::CAssocArray::GetPreviousArray | ( | ) |
CAssocArray * ppl6::CAssocArray::GetPreviousArray | ( | CTreeWalker & | walk | ) | const |
int ppl6::CAssocArray::GetPreviousArray | ( | CAssocArray & | res | ) |
CString * ppl6::CAssocArray::GetString | ( | const char * | key | ) | const |
[in] | key | Pointer auf den Namen des Schlüssels |
CString * ppl6::CAssocArray::GetString | ( | ARRAY_RESULT | res | ) | const |
[in] | res | Ergebnis aus einer vorhergehenden GetFirst*, GetNext*, etc. Funktion, die zum Durchwandern des Arrays verwendet wurde. |
CString * ppl6::CAssocArray::GetStringf | ( | const char * | fmt, |
... | |||
) | const |
[in] | fmt | Pointer auf einen Formatstring, der den Namen des gewünschten Schlüssels ergibt |
[in] | ... | Beliebig viele weitere Parameter, die im Formatstring benötigt werden. |
ARRAY_RESULT ppl6::CAssocArray::GetValue | ( | const char * | key | ) | const |
[in] | key | Pointer auf den Namen des Schlüssels |
bool ppl6::CAssocArray::HaveKey | ( | const char * | key | ) | const |
int ppl6::CAssocArray::ImportBinary | ( | const void * | buffer, |
int | buffersize | ||
) |
[in] | buffer | Pointer auf den Puffer, der die zu importierenden Daten enthält |
[in] | buffersize | Größe des Puffers |
int ppl6::CAssocArray::ImportBinary | ( | const CBinary & | bin | ) |
[in] | bin | Pointer auf eine CBinary Klassem die die zu importierenden Daten enthält |
int ppl6::CAssocArray::IsArray | ( | ARRAY_RESULT | res | ) | const |
[in] | res | Ergebnis einer vorherigen Abfrage mit GetFirst, GetNext, GetLast oder GetPrevious |
int ppl6::CAssocArray::IsBinary | ( | ARRAY_RESULT | res | ) | const |
[in] | res | Ergebnis einer vorherigen Abfrage mit GetFirst, GetNext, GetLast oder GetPrevious |
int ppl6::CAssocArray::IsCString | ( | ARRAY_RESULT | res | ) | const |
[in] | res | Ergebnis einer vorherigen Abfrage mit GetFirst, GetNext, GetLast oder GetPrevious |
int ppl6::CAssocArray::IsCWString | ( | ARRAY_RESULT | res | ) | const |
[in] | res | Ergebnis einer vorherigen Abfrage mit GetFirst, GetNext, GetLast oder GetPrevious |
int ppl6::CAssocArray::IsFalse | ( | const char * | key | ) | const |
[in] | key | Pointer auf den gewünschten Schlüssel |
int ppl6::CAssocArray::IsPointer | ( | ARRAY_RESULT | res | ) | const |
[in] | res | Ergebnis einer vorherigen Abfrage mit GetFirst, GetNext, GetLast oder GetPrevious |
int ppl6::CAssocArray::IsString | ( | ARRAY_RESULT | res | ) | const |
[in] | res | Ergebnis einer vorherigen Abfrage mit GetFirst, GetNext, GetLast oder GetPrevious |
int ppl6::CAssocArray::IsTrue | ( | const char * | key | ) | const |
[in] | key | Pointer auf den gewünschten Schlüssel |
|
inherited |
void ppl6::CAssocArray::List | ( | const char * | prefix = NULL | ) | const |
[in] | prefix | Optionaler Text, der bei der Ausgabe jedem Element vorangestellt wird |
int ppl6::CAssocArray::Merge | ( | const char * | key, |
const CAssocArray & | a | ||
) |
[in] | key | Name des Schlüssels |
[in] | a | Pointer auf das zu kopierende CAssocArray |
CAssocArray & ppl6::CAssocArray::operator= | ( | const CAssocArray & | a | ) |
[in] | a | Referenz auf das Array, das kopiert werden soll |
CAssocArray & ppl6::CAssocArray::operator= | ( | const CArray & | a | ) |
[in] | a | Referenz auf das Array, das kopiert werden soll |
CAssocArray & ppl6::CAssocArray::operator= | ( | const CAssocArray * | a | ) |
[in] | a | Pointer auf das Array, das kopiert werden soll |
CAssocArray & ppl6::CAssocArray::operator= | ( | CDirEntry & | d | ) |
CAssocArray & ppl6::CAssocArray::operator= | ( | CDirEntry * | d | ) |
const char * ppl6::CAssocArray::operator[] | ( | const char * | key | ) | const |
[in] | key | Name des gewünschten Schlüssels |
void ppl6::CAssocArray::Reset | ( | ) |
void ppl6::CAssocArray::Reset | ( | CTreeWalker & | walk | ) | const |
int ppl6::CAssocArray::Set | ( | const char * | key, |
const char * | value, | ||
int | size = -1 |
||
) |
[in] | key | Name des Schlüssels |
[in] | value | Pointer auf den Wert für den Schlüssel |
[in] | size | Optionaler Parameter, der die Anzahl Bytes angibt, die aus dem value Wert übernommen werden sollen |
int ppl6::CAssocArray::Set | ( | const char * | key, |
const CString & | value, | ||
int | size = -1 |
||
) |
[in] | key | Name des Schlüssels |
[in] | value | Pointer auf den Wert für den Schlüssel |
[in] | size | Optionaler Parameter, der die Anzahl Bytes angibt, die aus dem value Wert übernommen werden sollen |
int ppl6::CAssocArray::Set | ( | const char * | key, |
const CWString & | value, | ||
int | size = -1 |
||
) |
[in] | key | Name des Schlüssels |
[in] | value | Pointer auf den Wert für den Schlüssel |
[in] | size | Optionaler Parameter, der die Anzahl Zeichen angibt, die aus dem value Wert übernommen werden sollen |
int ppl6::CAssocArray::Set | ( | const char * | key, |
const CAssocArray & | array | ||
) |
int ppl6::CAssocArray::Set | ( | const char * | key, |
CAssocArray * | array, | ||
bool | copy = true |
||
) |
[in] | key | Name des Schlüssels |
[in] | array | Pointer auf das hinzuzufügende CAssocArray |
[in] | copy | Optionaler Parameter der angibt, ob das Array kopiert werden soll (true) oder nur der Pointer auf das existierende Array übernommen werden soll (false) |
int ppl6::CAssocArray::Set | ( | const char * | key, |
const CArray & | array | ||
) |
[in] | key | Name des Schlüssels |
[in] | array | Pointer auf das hinzuzufügende CArray |
int ppl6::CAssocArray::Set | ( | const char * | key, |
const CDirEntry & | d | ||
) |
[in] | key | Name des Schlüssels |
[in] | d | Pointer auf eine CDirEntry oder CDir-Klasse |
int ppl6::CAssocArray::Set | ( | const char * | key, |
const CBinary & | bin | ||
) |
int ppl6::CAssocArray::Set | ( | const char * | key, |
CBinary * | bin, | ||
bool | copy = true |
||
) |
[in] | key | Name des Schlüssels |
[in] | bin | Pointer auf das hinzuzufügende CBinary |
[in] | copy | Optionaler Parameter der angibt, ob das Binary kopiert werden soll (true) oder nur dessen Pointer übernommen werden soll (false) |
int ppl6::CAssocArray::Set | ( | const char * | key, |
const CDateTime & | date | ||
) |
int ppl6::CAssocArray::Setf | ( | const char * | key, |
const char * | fmt, | ||
... | |||
) |
[in] | key | Name des Schlüssels |
[in] | fmt | Pointer auf den Format-String des Wertes |
[in] | ... | Beliebig viele Parameter, die vom Formatstring verwendet werden |
int ppl6::CAssocArray::SetPointer | ( | const char * | key, |
const void * | pointer | ||
) |
[in] | key | Name des Schlüssels |
[in] | pointer | Pointer auf die Daten |
int ppl6::CAssocArray::Size | ( | ) |
bool ppl6::CAssocArray::ToBool | ( | const char * | key | ) | const |
CArray ppl6::CAssocArray::ToCArray | ( | const char * | key | ) | const |
CAssocArray ppl6::CAssocArray::ToCAssocArray | ( | const char * | key | ) | const |
CBinary ppl6::CAssocArray::ToCBinary | ( | const char * | key | ) | const |
CString ppl6::CAssocArray::ToCString | ( | const char * | key | ) | const |
CWString ppl6::CAssocArray::ToCWString | ( | const char * | key | ) | const |
int ppl6::CAssocArray::ToInt | ( | const char * | key | ) | const |
long ppl6::CAssocArray::ToLong | ( | const char * | key | ) | const |
long long ppl6::CAssocArray::ToLongLong | ( | const char * | key | ) | const |
void ppl6::CAssocArray::ToTemplate | ( | CString & | s, |
const char * | prefix = NULL , |
||
const char * | linedelimiter = "\n" , |
||
const char * | splitchar = "=" |
||
) |
[out] | s | String, in dem das Template gespeichert werden soll. Der String wird von der Funktion nicht gelöscht, der Inhalt des Arrays wird angehangen! |
[in] | prefix | Optionaler Prefix, der jedem Key vorangestellt werden soll |
[in] | linedelimiter | Optionaler Pointer auf einen String, der am Zeilenende ausgegeben werden soll. Der Default ist ein einzelnes Newline. |
[in] | splitchar | Optionaler Pointer auf einen String, der als Trennzeichen zwischen Schlüssel und Wert verwendet werden soll. Der Default ist ein Gleichheitszeichen. |
int ppl6::CAssocArray::Validate | ( | const char * | prefix = NULL | ) |
|
private |
|
private |
|
private |
|
protectedinherited |