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

InsertItem - Zeichenkettenliste erweitern

CxiError CxiNode :: InsertItem (CxiName pname, int index, const char *pval, CxiLong options = 0)
CxiError cxiInsertItem ...P (CxiHandle self, CxiName pname, int index, const char *pval, CxiLong options)

Fügt in eine String-Liste ein

pname:
Name einer cxiTypeLst-Variablen oder Pfadangabe und Variablenname

index:
Index innerhalb der Stringliste, vor dem eingefügt werden soll

pval:
Hinzuzufügende(r) String(s)

options:
ODER-Verknüpfung je einer Option der folgenden Gruppen:
ART DES PARAMETERS pval:
cxiOptInsertString (=0, Vorgabe): einzelner nullterminierter String;
cxiOptInsertArgs (=1): Argumentstring, mit Leerzeichen getrennt;
VERHALTEN IM FEHLERFALL:
cxiOptInsertSmart (=0, Vorgabe): Liste automatisch anlegen;
cxiOptInsertFail: Variable weder anlegen noch ersetzen;
cxiOptInsertForce: Bestehende Variable ersetzen

return:
0 ok, sonst Fehler

InsertItem fügt in eine bestehende Liste vor dem Element mit der Nummer index ein. Bei Angabe von cxiOptInsertString (Vorgabe) wird pval als ein einzelnes neues Element in die Liste eingefügt. Bei cxiOptInsertArgs wird pval wie eine Kommandozeile in mehrere Parameter zerlegt, die dann einzeln in die Liste aufgenommen werden.

Die folgenden Abschnitte beschreiben das Verhalten im Fehlerfall:

cxiOptInsertSmart (Vorgabe): Existiert keine Variable mit dem Namen pname, so wird sie erzeugt. Wurde eine Variable pname mit einem anderen Typ als cxiTypeLst gefunden, so wird der Fehler cxiErrorTypeMismatch gemeldet.

cxiOptInsertFail: Existiert keine Variable mit dem Namen pname, so wird der Fehler cxiErrorVarNotFound zurückgegeben. Existiert eine Variable mit dem Namen pname, die nicht vom Typ cxiTypeLst ist, so wird der Fehler cxiErrorTypeMismatch gemeldet.

cxiOptInsertForce: Existiert keine Variable mit dem Namen pname, so wird sie erzeugt. Existiert eine String-Variable mit dem Namen pname, wird sie automatisch in eine einelementige Liste konvertiert. Wurde eine Variable pname mit einem anderen Typ als cxiTypeLst oder cxiTypeStr gefunden, so wird sie durch eine leere Liste ersetzt.

Die Elemente einer Variable vom Typ cxiTypeLst sind beginnend mit 0 durchnummeriert. Der Parameter index gibt entweder direkt die Nummer des gewünschten Elements an (Werte größer oder gleich 0), oder er ist eine relative Position vom Ende der Liste ausgehend (negativer Wert). Der Wert 0 kennzeichnet also das erste, -1 das letzte Element der Liste.

Wird ein Index angegeben, der hinter dem Ende der Liste liegt, fügt InsertItem hinten an die Liste an; liegt der Index vor dem Anfang der Liste oder ist er 0, wird vorn angefügt.

Beachten Sie, dass ein Aufruf dieser Funktion mit dem Index -1 vor dem letzten Element einfügt. Zum Anhängen muss ein Index eingesetzt werden, der größer als die Anzahl Elemente der Liste ist; besser ist es jedoch, die Funktion AppendItem zu verwenden.

Portabilität:
Diese Funktionen sind in allen unterstützten Systemen verfügbar.

Siehe auch:
AppendItem
DeleteItem
SetLst (mit Beispiel)
GetLst
GetAsNum (mit Beispiel)
GetItem
GetItemStr
GetItemTest
QueryItemCount
FindInList
IsInList
IsEqual...