CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiNode / Zeichenketten /
const char * CxiNode :: GetItemTest (CxiName pname, int index = -1) const
Spezialfall von GetItem
pname:
Name der Variablen
index:
Index innerhalb der Stringliste
return:
bei Erfolg Adresse des Wertes der Variablen im CxiNode-Datenpuffer, im Fehlerfall pname oder "<Error>"
Diese Funktion ist für Meldungsausgaben und Fehlerbehandlungsroutinen vorgesehen und liefert stets einen gültigen Zeiger ungleich NULL zurück. Im Erfolgsfall verhält sie sich genauso wie GetItem, die Hinweise dort sind unbedingt zu beachten.
Bei einem Fehler arbeitet GetItemTest wie folgt:
Ist pname ein gültiger Zeiger ungleich NULL, so wird pname zurückgegeben.
Ansonsten wird ein Zeiger auf den konstanten statischen String "<Error>" zurückgegeben.
Portabilität:
Diese Funktion ist in allen unterstützten Systemen verfügbar.
Siehe auch:
GetItemStr
GetItem
QueryItemCount
FindInList
IsInList
IsEqual...
GetStr
GetAsStr
GetAsNum
GetLst
SetStr (mit Beispiel)
SetLst
InsertItem
AppendItem
DeleteItem