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

FindInList - String oder Listenelement suchen

int CxiNode :: FindInList (CxiName pname, const char *pcomp, CxiLong options = 0) const
int cxiFindInList ...P (CxiHandle self, CxiName pname, const char *pcomp, CxiLong options)

Sucht eine Zeichenkette in einer Stringvariablen oder einer Stringliste

pname:
Name der Variablen (String oder Stringliste, Pfad bei ...P-Variante und C++)

pcomp:
Vergleichsstring

options:
Art des Vergleichs:
0 = Vollständiger Vergleich ohne Groß/Klein-Unterscheidung (stricmp)
1 = Vollständiger Vergleich mit Groß/Klein-Unterscheidung (strcmp)
2 = Teilstring in Variable enthalten (strstr)

return:
>= 0: Index des gefundenen Listenelements
-1: Kein passendes Listenelement gefunden
-2: Variable nicht gefunden oder sonstiger Fehler

Diese Funktion führt Vergleichsoperationen zwischen Zeichenkettenvariablen und einem Vergleichsstring durch. Als Ergebnis wird der Index des gefundenen Strings innerhalb der Liste zurückgegeben. Stringvariablen werden wie einelementige Listen aufgefasst. Das erste Listenelement trägt die Nummer 0.

Portabilität:
Diese Funktion ist ab Version 2.05 definiert und in allen unterstützten Systemen verfügbar.

Siehe auch:
IsInList
GetItem
GetItemStr
GetItemTest
QueryItemCount
IsEqual...
GetStr
GetAsStr
GetAsNum
GetLst
SetStr
SetLst
InsertItem
AppendItem
DeleteItem