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

SetStr - Zeichenkette setzen

CxiError CxiNode :: SetStr (CxiName pname, const char *pval)
CxiError cxiSetStr ...P (CxiHandle self, CxiName pname, const char *pval)

Setzt eine nullterminierte String-Variable

pname:
Name der Variablen oder Pfadangabe und Variablenname

pval:
Wert der Variablen

return:
0 ok, sonst Fehler

Operatorschreibweise:
Objekt [pname] = pval

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

Für pval kann jede beliebige Zeichenkette angegeben werden. Sie darf alle Zeichencodes von 1 bis 255 enthalten. Es gibt auch keine Längenbeschränkung außer cxiMaxVarSize. Leerstrings ("", Länge 0) sind erlaubt.

Wird für pval ein NULL-Pointer übergeben, löscht SetStr die angegebene Variable. Dieser Fall ist der Aufrufsyntax des SET-Befehls auf der Kommandozeile nachempfunden und wird daher nicht als Fehler aufgefasst.

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

Siehe auch:
GetStr
GetAsStr
GetAsNum
GetItem
GetItemStr
GetItemTest
QueryItemCount
FindInList
IsInList
IsEqual...
RegisterResource (mit Beispiel)

Beispiel:

#include "cxib.h"

int main ()
{
  CxiNode cxi1;
  long wert = 12;
  CxiError rc = cxi1.SetStr ("STRVAR", "Ein String");
  if (rc)
  {
    // Fehlerbehandlung...
  }

  // ...

  char buffer [256];
  strcpy (buffer, "<Fehler>");
  if (cxi1.GetStr ("STRVAR", buffer, sizeof buffer) == 0)
  {
    // Fehlerbehandlung...
  }

  // ...

  printf ("Die Variable STRVAR hat den Wert: %s\n",
          cxi1.GetItem ("STRVAR"));

  return 0;
}