open_fileopen_fileOpenFileOpenFile (Operator)

Name

open_fileopen_fileOpenFileOpenFile — Öffnen einer Datei im ASCII- oder Binärformat.

Signatur

open_file( : : FileName, FileType : FileHandle)

Beschreibung

open_fileopen_fileOpenFileOpenFileOpenFile öffnet eine Datei im ASCII-Format oder im Binärformat. Der Name der Datei wird im Parameter FileNameFileNameFileNameFileNamefileName übergeben. Der Operator gibt das Datei-Handle FileHandleFileHandleFileHandleFileHandlefileHandle zurück. Mit dem Parameter FileTypeFileTypeFileTypeFileTypefileType wird der Typ der Datei bestimmt.

Die folgenden Einstellungen für FileTypeFileTypeFileTypeFileTypefileType werden unterstützt:

'input'"input""input""input""input":

Öffnet eine bereits vorhandene Eingabedatei im ASCII-Format lesend.

'output'"output""output""output""output":

Öffnet eine neue Ausgabedatei im ASCII-Format schreibend.

'append'"append""append""append""append":

Öffnet eine bereits vorhandene Ausgabedatei im ASCII-Format am Ende der Datei schreibend.

'input_binary'"input_binary""input_binary""input_binary""input_binary":

Öffnet eine bereits vorhandene Eingabedatei im Binärformat lesend.

'output_binary'"output_binary""output_binary""output_binary""output_binary":

Öffnet eine neue Ausgabedatei im Binärformat schreibend.

'append_binary'"append_binary""append_binary""append_binary""append_binary":

Öffnet eine bereits vorhandene Ausgabedatei im Binärformat am Ende der Datei schreibend.

Für Aus- und Eingaben auf dem Terminal sind die „Dateinamen“ 'standard'"standard""standard""standard""standard" ('input'"input""input""input""input" und 'output'"output""output""output""output") und 'error'"error""error""error""error" (nur 'output'"output""output""output""output") reserviert.

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.

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

FileNameFileNameFileNameFileNamefileName (input_control) filename → (string)

Name der zu öffnenden Datei.

Defaultwert: 'standard' "standard" "standard" "standard" "standard"

Wertevorschläge: 'standard'"standard""standard""standard""standard", 'error'"error""error""error""error", '/tmp/dat.dat'"/tmp/dat.dat""/tmp/dat.dat""/tmp/dat.dat""/tmp/dat.dat"

FileTypeFileTypeFileTypeFileTypefileType (input_control) string → (string)

Art der Datei.

Defaultwert: 'output' "output" "output" "output" "output"

Werteliste: 'append'"append""append""append""append", 'append_binary'"append_binary""append_binary""append_binary""append_binary", 'input'"input""input""input""input", 'input_binary'"input_binary""input_binary""input_binary""input_binary", 'output'"output""output""output""output", 'output_binary'"output_binary""output_binary""output_binary""output_binary"

FileHandleFileHandleFileHandleFileHandlefileHandle (output_control) file → (integer)

Datei-Handle.

Beispiel (HDevelop)

* Creating an output file with the name '/tmp/log.txt' and writing
* of a string:
   open_file('/tmp/log.txt','output',FileHandle)
   fwrite_string(FileHandle,'these are the first and last lines')
   fnew_line(FileHandle)
   close_file(FileHandle)

Beispiel (C)

/* Creating an output file with the name '/tmp/log.txt' and writing */
/* of a string:                                                    */
   open_file("/tmp/log.txt","output",&FileHandle) ;
   fwrite_string(FileHandle,"these are the first and last lines") ;
   fnew_line(FileHandle) ;
   close_file(FileHandle);

Beispiel (HDevelop)

* Creating an output file with the name '/tmp/log.txt' and writing
* of a string:
   open_file('/tmp/log.txt','output',FileHandle)
   fwrite_string(FileHandle,'these are the first and last lines')
   fnew_line(FileHandle)
   close_file(FileHandle)

Beispiel (HDevelop)

* Creating an output file with the name '/tmp/log.txt' and writing
* of a string:
   open_file('/tmp/log.txt','output',FileHandle)
   fwrite_string(FileHandle,'these are the first and last lines')
   fnew_line(FileHandle)
   close_file(FileHandle)

Beispiel (HDevelop)

* Creating an output file with the name '/tmp/log.txt' and writing
* of a string:
   open_file('/tmp/log.txt','output',FileHandle)
   fwrite_string(FileHandle,'these are the first and last lines')
   fnew_line(FileHandle)
   close_file(FileHandle)

Ergebnis

Sind die Parameterwerte korrekt, dann liefert open_fileopen_fileOpenFileOpenFileOpenFile den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Exception-Behandlung durchgeführt.

Nachfolger

fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteString, fread_charfread_charFreadCharFreadCharFreadChar, fread_stringfread_stringFreadStringFreadStringFreadString, fread_linefread_lineFreadLineFreadLineFreadLine, fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItem, fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem, close_fileclose_fileCloseFileCloseFileCloseFile

Siehe auch

close_fileclose_fileCloseFileCloseFileCloseFile, fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteString, fread_charfread_charFreadCharFreadCharFreadChar, fread_stringfread_stringFreadStringFreadStringFreadString, fread_linefread_lineFreadLineFreadLineFreadLine

Modul

Foundation

Operatoren