FOPEN( )-Funktion

  • Artikel

Öffnet eine Datei oder einen DFÜ-Anschluss für die Verwendung mit Dateifunktionen auf niedriger Ebene.

FOPEN(cFileName [, nAttribute])

Rückgabewerte

Numerisch

Parameter

  • cFileName
    Gibt den Namen der Datei an, die geöffnet werden soll. So können Dateien in Verzeichnissen, Ordnern, auf Laufwerken oder Datenträgern geöffnet werden, die nicht Bestandteil des aktuellen Microsoft Visual FoxPro-Suchpfads sind. Wird kein Pfad angegeben, sucht Visual FoxPro die Datei im

    • Standardverzeichnis

    • Pfad, der mit SET PATH festgelegt wurde

      Anmerkung   Visual FoxPro kann einen Pfadnamen nicht richtig erkennen, wenn ein Laufwerks- oder Verzeichnisname ein Ausrufezeichen (!) enthält.

  • nAttribute
    Gibt für die zu öffnende Datei Lese-/Schreibrechte und ein Pufferungsschema an. In der folgenden Tabelle werden die zulässigen Werte für nAttribute mit den entsprechenden Einstellungen für die Lese-/Schreibrechte und die Pufferung aufgeführt.

    nAttribute Lese-/Schreibrechte Gepuffert/ungepuffert
    0 (Standard) Schreibgeschützt Gepuffert
    1 Lesegeschützt Gepuffert
    2 Lesen/Schreiben Gepuffert
    10 Schreibgeschützt Ungepuffert
    11 Lesegeschützt Ungepuffert
    12 Lesen/Schreiben Ungepuffert

    Wenn nAttribute nicht angegeben ist oder nAttribute den Wert 0 ergibt, wird die Datei schreibgeschützt geöffnet und gepuffert.

    Anmerkung   Visual FoxPro kann einen Pfadnamen nicht richtig erkennen, wenn ein Laufwerks- oder Verzeichnisname ein Ausrufezeichen (!) enthält.

Hinweise

Wird die Datei mit FOPEN( ) erfolgreich geöffnet, gibt die Funktion das Dateihandle der Datei zurück. FOPEN( ) gibt –1 zurück, wenn die Datei bzw. der Anschluss nicht geöffnet werden kann.

Tipp   Weisen Sie das Dateihandle einer Speichervariablen zu, so dass Sie in anderen Dateifunktionen auf niedriger Ebene über die Speichervariable auf die Datei zugreifen können.

Folgende Informationen über Dateien, die mit FOPEN( ) geöffnet werden, können mit DISPLAY STATUS oder LIST STATUS angezeigt bzw. zum Drucker übertragen werden

  • Laufwerk und Verzeichnis oder Datenträger und Ordner sowie der Dateiname
  • Dateihandle
  • Position des Dateizeigers
  • Lese-/Schreibattribute

Beispiel

IF FILE('errors.txt')  && Does file exist? 
   gnErrFile = FOPEN('errors.txt',12)  && If so, open read-write
ELSE
   gnErrFile = FCREATE('errors.txt')  && If not, create it
ENDIF
IF gnErrFile < 0  && Check for error opening file
   WAIT 'Cannot open or create output file' WINDOW NOWAIT
ELSE  && If no error, write to file
   =FWRITE(gnErrFile, 'Error information to be written here')
ENDIF
=FCLOSE(gnErrFile)  && Close file
MODIFY FILE errors.txt NOWAIT  && Open file in edit window

Siehe auch

CLOSE ALL | FCHSIZE( ) | FCLOSE( ) | FCREATE( ) | FEOF( ) | FFLUSH( ) | FGETS( ) | FPUTS( ) | FREAD( ) | FSEEK( ) | FWRITE( )