OpenFile()

Syntax

Ergebnis = OpenFile(#Datei, Dateiname$)

Öffnet eine Datei zum Lesen/Schreiben oder erstellt eine neue Datei, falls sie nocht nicht existiert.

Parameter

#Datei	Gibt die Nummer zum Identifizieren der Datei an. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
Dateiname$	Gibt den Dateinamen und den Pfad zur Datei an. Wenn der Dateiname keinen vollständigen Dateipfad enthält, wird dieser relativ zum aktuellen Verzeichnis interpretiert.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn die Datei erfolgreich erstellt wurde, und Null bei einem Fehler. Wenn #PB_Any als #Datei Parameter verwendet wurde, dann wird bei Erfolg die neu generierte Nummer zurückgegeben.

Anmerkungen

Diese Funktion schlägt fehl, wenn die Datei nicht mit Schreib-Rechten geöffnet werden kann, zum Beispiel wenn sich die Datei auf einem "Read-Only" Datei-System wie einer CD befindet. Um eine Datei nur zum Lesen ("Read-Only") zu öffnen, verwenden Sie die ReadFile() Funktion. Zum Überschreiben einer existierenden Datei mit einer neuen und leeren Datei, verwenden Sie die Funktion CreateFile().

Der Dateizeiger wird an den Anfang der Datei gesetzt. Um Daten an das Ende einer Datei anzuhängen, verwenden Sie die FileSeek() und Lof() Funktionen, um den Zeiger an das Ende der Datei zu setzen.

Beispiel

  If OpenFile(0, "Test.txt")    ; öffnet eine existierende Datei oder erstellt eine, wenn sie noch nicht existiert
    FileSeek(0, Lof(0))         ; springt an das Ende der Datei (das Ergebnis von Lof() wird hierfür verwendet)
    WriteStringN(0, "... another line at the end.")
    CloseFile(0)
  EndIf

Siehe auch

CreateFile(), ReadFile(), CloseFile()

Unterstützte OS

Alle