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

GetStr - Zeichenkette auslesen

CxiString CxiNode :: GetStr (CxiName pname, const char *pdef = 0) const
char * CxiNode :: GetStr (CxiName pname, char *pbuffer, CxiShort psize, char *pdef = 0) const
char * cxiGetStr ...P (CxiHandle self, CxiName pname, char *pbuffer, CxiShort psize, char *pdef)

Liest eine String-Variable

pname:
Name der Variablen oder Pfadangabe und Variablenname

pbuffer:
Puffer für den Wert der Variablen, der Inhalt des Puffers wird im Fehlerfall nicht verändert

psize:
Länge des Puffers, wird nicht verändert

pdef:
Rückgabewert für den Fehlerfall (Vorgabe 0)

return:
char *: bei Erfolg pbuffer, bei Fehler pdef
CxiString: CxiString-Objekt (bei Fehler wird pdef kopiert)

ACHTUNG ('char *'-Variante): Bei einem Fehler wird der Zeiger pdef zurückgegeben, der String pdef wird NICHT nach pbuffer kopiert! Soll der Vorgabewert im Puffer stehen, so muss der Puffer vor dem Aufruf dieser Funktion mit dem Vorgabewert initialisiert werden und dann beim Aufruf pdef=0 (Vorgabe) gesetzt werden. In diesem Fall liefert GetStr bei einem Fehler 0 und bei Erfolg != 0, im Puffer steht in jedem Fall der gewünschte Wert.

Resource-Referenzen werden aufgelöst. Ist dies nicht möglich, wird ein Fehler zurückgegeben.

String-Variablen werden im Gegensatz zu Zeigervariablen in den Datenbereich des Blocks kopiert und sind daher zwischen Prozessen austauschbar und in eine Datei abspeicherbar.

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

Siehe auch:
SetStr (mit Beispiel)
GetItem
GetItemStr
GetItemTest
QueryItemCount
FindInList
IsInList
IsEqual...