fnew_lineT_fnew_lineFnewLineFnewLine (Operator)

Name

fnew_lineT_fnew_lineFnewLineFnewLine — Ausgabe eines Zeilenumbruchs und Leeren des Ausgabepuffers in eine Textdatei.

Signatur

fnew_line( : : FileHandle : )

Beschreibung

fnew_linefnew_lineFnewLineFnewLineFnewLine gibt in der Ausgabedatei, die durch das Handle FileHandleFileHandleFileHandleFileHandlefileHandle definiert ist und mit open_fileopen_fileOpenFileOpenFileOpenFile im Textformat geöffnet worden sein muss, einen Zeilenumbruch aus. Dabei schreibt der Aufruf von fnew_linefnew_lineFnewLineFnewLineFnewLine vorher möglicherweise zurückgehaltene Daten aus dem Ausgabepuffer in die Datei (s.a. fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteString und set_system(::'flush_file', <boolean-value>:)set_system("flush_file", <boolean-value>)SetSystem("flush_file", <boolean-value>)SetSystem("flush_file", <boolean-value>)SetSystem("flush_file", <boolean-value>)).

Welche Zeichen als Zeilenumbruch geschrieben werden hängt vom Betriebssystem ab: Unter Windows wird die Zeichenfolge '\r\n'"\r\n""\r\n""\r\n""\r\n" (carriage return + line feed) als Standardzeilenumbruch verwendet, unter Linux dagegen nur '\n'"\n""\n""\n""\n" (line feed).

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

FileHandleFileHandleFileHandleFileHandlefileHandle (input_control) file → (handle)

Datei-Handle.

Beispiel (HDevelop)

  fwrite_string(FileHandle,'Good Morning')
  fnew_line(FileHandle)

Beispiel (C)

  fwrite_string(FileHandle,"Good Morning");
  fnew_line(FileHandle);

Beispiel (HDevelop)

  fwrite_string(FileHandle,'Good Morning')
  fnew_line(FileHandle)

Beispiel (HDevelop)

  fwrite_string(FileHandle,'Good Morning')
  fnew_line(FileHandle)

Beispiel (HDevelop)

  fwrite_string(FileHandle,'Good Morning')
  fnew_line(FileHandle)

Ergebnis

fnew_linefnew_lineFnewLineFnewLineFnewLine liefert den Wert 2 (H_MSG_TRUE), falls eine Ausgabedatei geöffnet ist und geschrieben werden kann. Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteString

Siehe auch

fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteString

Modul

Foundation

Operatoren