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 werden unterstützt:

FileTypeFileTypeFileTypeFileTypeFileTypefileType            Ergebnis
----------------------------------------------------------------------------------------
'input'"input""input""input""input""input"             Eine bereits vorhandene Eingabedatei wird im ASCII-Format
                    lesend geöffnet.
                    
'output'"output""output""output""output""output"            Eine neue Ausgabedatei wird im ASCII-Format schreibend
                    geöffnet.
                    
'append'"append""append""append""append""append"            Eine bereits vorhandene Ausgabedatei wird am Ende der Datei
                    schreibend im ASCII-Format geöffnet.
                    
'input_binary'"input_binary""input_binary""input_binary""input_binary""input_binary"      Eine bereits vorhandene Eingabedatei wird im Binärformat
                    lesend geöffnet.
                    
'output_binary'"output_binary""output_binary""output_binary""output_binary""output_binary"     Eine neue Ausgabedatei wird im Binärformat schreibend
                    geöffnet.
                    
'append_binary'"append_binary""append_binary""append_binary""append_binary""append_binary"     Eine bereits vorhandene Ausgabedatei wird am Ende der Datei
                    schreibend im Binärformat geöffnet.

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: exclusive (läuft parallel nur zu unabhängigen Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

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