open_fileopen_fileOpenFileopen_fileOpenFileOpenFile (Operator)

Name

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

Signatur

open_file( : : FileName, FileType : FileHandle)

Beschreibung

open_fileopen_fileOpenFileopen_fileOpenFileOpenFile öffnet eine Datei im ASCII-Format oder im Binärformat. Der Name der Datei wird im Parameter FileNameFileNameFileNameFileNameFileNamefileName übergeben. Der Operator gibt das Datei-Handle FileHandleFileHandleFileHandleFileHandleFileHandlefileHandle zurück. Mit dem Parameter FileTypeFileTypeFileTypeFileTypeFileTypefileType wird der Typ der Datei bestimmt.

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

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

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

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

Öffnet eine neue Ausgabedatei im ASCII-Format schreibend.

'append'"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""input_binary":

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

'output_binary'"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""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""standard" ('input'"input""input""input""input""input" und 'output'"output""output""output""output""output") und 'error'"error""error""error""error""error" (nur 'output'"output""output""output""output""output") reserviert.

Parallelisierung

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

FileNameFileNameFileNameFileNameFileNamefileName (input_control) filename → (string)

Name der zu öffnenden Datei.

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

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

FileTypeFileTypeFileTypeFileTypeFileTypefileType (input_control) string → (string)

Art der Datei.

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

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

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

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_fileOpenFileopen_fileOpenFileOpenFile den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Exception-Behandlung durchgeführt.

Nachfolger

fwrite_stringfwrite_stringFwriteStringfwrite_stringFwriteStringFwriteString, fread_charfread_charFreadCharfread_charFreadCharFreadChar, fread_stringfread_stringFreadStringfread_stringFreadStringFreadString, fread_linefread_lineFreadLinefread_lineFreadLineFreadLine, fread_serialized_itemfread_serialized_itemFreadSerializedItemfread_serialized_itemFreadSerializedItemFreadSerializedItem, fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItem, close_fileclose_fileCloseFileclose_fileCloseFileCloseFile

Siehe auch

close_fileclose_fileCloseFileclose_fileCloseFileCloseFile, fwrite_stringfwrite_stringFwriteStringfwrite_stringFwriteStringFwriteString, fread_charfread_charFreadCharfread_charFreadCharFreadChar, fread_stringfread_stringFreadStringfread_stringFreadStringFreadString, fread_linefread_lineFreadLinefread_lineFreadLineFreadLine

Modul

Foundation

Operatoren