WriteStringN

WriteStringN()

Syntax

Ergebnis = WriteStringN(#Datei, Text$ [, Format])

Beschreibung

Schreibt einen String in eine Datei und fügt einen Zeilenvorschub (englisch "End of Line"-Zeichen) hinzu.

Parameter

#Datei Die Datei, in welche geschrieben werden soll.

Text$ Der zu schreibende String.
Format (optional)
Das Format, in welchem der String geschrieben werden soll. Dies kann einer der folgenden Werte sein:
  #PB_Ascii  : Schreibt den String im ASCII-Format, auch wenn das Programm im Unicode-Modus kompiliert ist
  #PB_UTF8   : Schreibt den String im UTF8-Format, auch wenn das Programm im ASCII-Modus kompiliert ist
  #PB_Unicode: Schreibt den String im UTF16-Format (das Programm kann entweder in Unicode- oder ASCII-Modus kompiliert sein)
Wenn dieses Flag nicht gesetzt wird, dann hängt das Format für das Schreiben des Strings von der entsprechenden Einstellung des zuvor verwendeten CreateFile() bzw. OpenFile() Befehls ab.

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()).

Um ein BOM ("Byte Order Mark" oder auch "Kennzeichen der Byte-Reihenfolge) einzufügen, mit dessen Hilfe später das String-Kodierungs-Format der Datei identifiziert werden kann, verwenden Sie die Funktion WriteStringFormat()
Um einen String ohne einen Zeilenvorschub ("Newline") zu schreiben, verwenden Sie die Funktion FastLink "WriteString()".

Für ein Beispiel siehe den CreateFile() Befehl.

Siehe auch

ReadString(), WriteString(), WriteStringFormat(), CreateFile(), OpenFile()

Unterstützte OS

Alle

<- WriteStringFormat() - File Inhaltsverzeichnis - WriteUnicodeCharacter() ->

#Datei	Die Datei, in welche geschrieben werden soll.
Text$	Der zu schreibende String.
Format (optional)	Das Format, in welchem der String geschrieben werden soll. Dies kann einer der folgenden Werte sein: #PB_Ascii : Schreibt den String im ASCII-Format, auch wenn das Programm im Unicode-Modus kompiliert ist #PB_UTF8 : Schreibt den String im UTF8-Format, auch wenn das Programm im ASCII-Modus kompiliert ist #PB_Unicode: Schreibt den String im UTF16-Format (das Programm kann entweder in Unicode- oder ASCII-Modus kompiliert sein) Wenn dieses Flag nicht gesetzt wird, dann hängt das Format für das Schreiben des Strings von der entsprechenden Einstellung des zuvor verwendeten CreateFile() bzw. OpenFile() Befehls ab.