CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiNode / Typübergreifende Funktionen /
CxiError CxiNode :: SetFromLine (const char *items, CxiLong options = 0)
CxiError cxiSetFromLine (CxiHandle self, const char *items, CxiLong options)
Setzt Variablen des Blocks aus einer Textzeile
items:
String mit Variablennamen und -werten
options:
unbenutzt, es muss 0 übergeben werden
return:
0 ok, sonst Fehler
Diese Funktion ist fast identisch zu SetFromStringOrFile, sie kann jedoch Leerzeichen und Kommentare erkennen und ignorieren. Konkret werden folgende von SetFromStringOrFile abweichende Interpretationen vorgenommen:
Leerzeichen und alle nicht druckbaren Steuerzeichen (ASCII-Codes 1 bis 32) außerhalb von Anführungszeichen werden ignoriert.
Die Zeichenfolge // außerhalb von Anführungszeichen beginnt einen Kommentar, der Rest des Parameters items wird ignoriert.
Mit SetFromLine kann auf einfache Weise eine Datei als CxiTree eingelesen werden, dazu ist nacheinander jede Zeile an diese Funktion zu übergeben.
Portabilität:
Diese Funktion ist ab Version 2.09 24 definiert und in allen unterstützten Systemen verfügbar.
Siehe auch:
SetFromStringOrFile - String oder Datei in Block konvertieren
SetFromString - String in Block konvertieren
CxiTree-Konstruktor mit Beispiel