CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiNode / Zeichenketten /

GetItemStr - Zeichenkette direkt abfragen

const char * CxiNode :: GetItemStr (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 Leerstring ("")

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 liefert GetItemStr immer "" (einen Zeiger auf ein Nullbyte) zurück.

Portabilität:
Diese Funktion ist in allen unterstützten Systemen verfügbar.

Siehe auch:
GetItemTest
GetItem
QueryItemCount
FindInList
IsInList
IsEqual...
GetStr
GetAsStr
GetAsNum
GetLst
SetStr (mit Beispiel)
SetLst
InsertItem
AppendItem
DeleteItem