CXI-Basis-Programmierreferenz / Version 2 / Tools / INI-Dateien /

WriteIniFileString - Schreiben eines Eintrags (String)

char * cxiWriteIniFileString (const char *fname, const char *sname, const char *vname, const char *value)

Schreiben eines INI-Eintrags

fname:
Name der INI-Datei

sname:
Name des Abschnitts ohne Klammern

vname:
Name der Variablen

value:
Neuer Wert der Variablen

return:
0 ok, sonst Fehler

Diese Funktion ändert eine Variable in einer INI-Datei. Zum Löschen einer Variablen ist value=NULL anzugeben.

Um einen ganzen Abschnitt zu löschen, ist vname=NULL zu übergeben.

Diese Funktion ist ein Sonderfall von UpdateIniFile.

Anmerkungen:
Die Datei und der Abschnitt werden angelegt, falls sie nicht existieren.
Existiert die Variable bereits, wird sie an gleicher Stelle ersetzt.
Existiert der Abschnitt, aber nicht die Variable, so wird sie am Anfang des Abschnitts eingefügt.
Existiert der Abschnitt nicht, wird er am Anfang der Datei neu erstellt.
Wird die Variable neu angelegt oder ersetzt, generiert diese Funktion die passenden Anführungszeichen. Dies führt dazu, dass beim Einlesen mittels CxiTree-Konstruktor, SetFromStringOrFile oder ReadIniFileString die Zeichenfolge immer als Zeichenkette mit allen Leer- und Sonderzeichen interpretiert wird.
Enthält der Wert value sowohl einfache (') wie doppelte (") Anführungszeichen, wird ein Fehler gemeldet (cxiErrorWriteIniFileNoQuote).

Portabilität:
Diese Funktion ist ab Version 2.11 in allen unterstützten Systemen verfügbar. Einige spätere Unterreleases der Version 2.10 für OS/2 und Win16 enthalten bereits eine eingeschränkte Version dieser Funktion.

Siehe auch:
ReadIniFileString - Lesen eines Eintrags (String)
UpdateIniFile - Schreiben eines Eintrags (allgemein)

Beispiel:

Eintragen der Variablen "welt" in den Abschnitt [hallo]
in der Datei "otto.ini" im aktuellen Verzeichnis,
der Wert ist "Dies ist ein Test".

  #include "cxib.h"

  CxiError rc = cxiWriteIniFileString
                ("otto.ini", "hallo", "welt", "Dies ist ein Test");

  if (rc != cxiNoError) { ...Fehlerbehandlung... }