CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiNode / Sonstige Variablentypen /

SetBin - Binärblock setzen

CxiError CxiNode :: SetBin (CxiName pname, const void *pval, CxiShort psize)
CxiError cxiSetBin ...P (CxiHandle self, CxiName pname, const void *pval, CxiShort psize)

Setzt eine beliebig formatierte, nicht konvertierbare Variable

pname:
Name der Variablen oder Pfadangabe und Variablenname

pval:
Zeiger auf Wert der Variablen

psize:
Länge des Wertes, maximal cxiMaxVarSize

return:
0 ok, sonst Fehler

Der Wert wird aus dem Puffer in den Variablenbereich kopiert. Der Puffer kann daher anschließend anderweitig benutzt oder freigegeben werden.

Binärvariablen werden bei Abspeicherung in Datei oder Übertragung innerhalb einer Message nicht konvertiert.

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

Siehe auch:
GetBin
SetCar
GetCar

Beispiel:

#include "cxib.h"

typedef struct
{
  // irgendwas
}
EineStruktur;

int main ()
{
  CxiNode cxi1;
  EineStruktur es;
  // es mit Daten füllen...
  CxiError rc = cxi1.SetBin ("BINARYVAR", &es, sizeof es);
  if (rc)
  {
    // Fehlerbehandlung...
  }

  // ...

  EineStruktur es2;
  CxiShort es2size = sizeof es2;
  rc = cxi1.GetBin ("BINARYVAR", &es2, &es2size);
  if (rc || es2size != sizeof es2)
  {
    // Fehlerbehandlung...
  }

  return 0;
}