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

QueryItemCount - Anzahl Listenelemente abfragen

int CxiNode :: QueryItemCount (CxiName pname, int pdef = -1) const
int cxiQueryItemCount ...P (CxiHandle self, CxiName pname, int pdef)

Liefert die Anzahl der Elemente einer Listenvariablen

pname:
Name der Variablen oder Pfadangabe und Variablenname

pdef:
Rückgabewert für den Fehlerfall

return:
bei Erfolg Anzahl der Elemente der Liste (größer oder gleich 0), im Fehlerfall pdef

QueryItemCount kann auf alle Variablen vom Typ cxiTypeLst (Stringliste) und cxiTypeStr (Strings) angewendet werden und liefert im ersten Fall die Anzahl der Strings in der Liste zurück, im zweiten Fall die Konstante 1 (ein String wird wie eine einelementige Liste aufgefasst). Da die Anzahl direkt im Block abgespeichert ist, arbeitet diese Funktion schneller als eine Schleife mit Aufrufen von GetItem.

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

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