WriteStringFormat()

Syntax

Ergebnis = WriteStringFormat(#Datei, Format)
Beschreibung
Schreibt ein BOM (Byte Order Mark) an die aktuelle Position in der Datei.

Parameter

#Datei Die Datei, in welche geschrieben werden soll.
Format Das Format, für welches die "Markierung" geschrieben werden soll. Dies kann einer der folgenden Werte sein:
  #PB_Ascii  : Schreibt überhaupt kein BOM (dies wird gewöhnlich als eine einfache ASCII-Datei interpretiert).
  #PB_UTF8   : UTF-8 BOM
  #PB_Unicode: UTF-16 (Little Endian) BOM

  #PB_UTF16BE: UTF-16 (Big Endian) BOM
  #PB_UTF32  : UTF-32 (Little Endian) BOM
  #PB_UTF32BE: UTF-32 (Big Endian) BOM
Die #PB_Ascii, #PB_UTF8 und #PB_Unicode entsprechen den von WriteString() und WriteStringN() unterstützten Flags. Nach dem Einfügen eines solchen BOM sollten alle folgenden Strings mit diesem Flag geschrieben werden. Die anderen Formate repräsentieren String-Formate, welche nicht direkt mit den String-Befehlen von PureBasic geschrieben werden können. Sie sind nur der Vollständigkeit halber enthalten.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn die Operation erfolgreich war, und Null bei einem Fehler.

Anmerkungen

Wegen des Zwischenspeicherns (Cachen) kann diese Funktion auch dann eine Erfolgsmeldung zurückgeben, wenn auf dem Ausgabegerät nicht genug Platz für die Schreib-Operation übrig ist.
Die Datei muss mit Schreib-Unterstützung geöffnet worden sein (d.h. nicht mit ReadFile()).

Die Byte Order Mark (Kennzeichen der Byte-Reihenfolge) ist eine weithin verwendete Methode, um die Kodierung einer Textdatei zu kennzeichnen. Sie befindet sich üblicherweise am Anfang einer Datei. Dies ist trotzdem kein Standard, sondern einfach eine oft verwendete Praxis. Wenn also am Anfang einer Datei kein BOM gefunden wird, bedeutet dies nicht notwendigerweise, dass es sich um eine einfache Textdatei handelt. Es kann auch einfach bedeuten, dass das Programm, welches die Datei erstellt hat, nicht diese Praxis verwendet hat. ReadStringFormat() kann verwendet werden, um ein BOM in einer Datei aufzufinden.

Für weitere Informationen siehe diesen Wikipedia Artikel.
Weitere Informationen über die Nutzung von Unicode in PureBasic-Programmen sind auch hier zu finden.

Siehe auch

ReadStringFormat(), WriteString(), WriteStringN(), CreateFile(), OpenFile()

Unterstützte OS

Alle

<- WriteString() - File Inhaltsverzeichnis - WriteStringN() ->