FCREATE( )-Funktion

Erstellt und öffnet eine Datei auf systemnaher Ebene.

FCREATE(cFileName [, nFileAttribute])

Rückgabewerte

Numerisch

Parameter

• cFileName
  Gibt den Namen der zu erstellenden Datei an. Sie können neben dem Dateinamen auch einen Laufwerkbuchstaben und einen Pfad angeben. Wenn Laufwerkbuchstabe und Pfad nicht angegeben werden, wird die Datei im Standardverzeichnis erstellt.

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

• nFileAttribute
  Gibt die Attribute der zu erstellenden Datei an. In der folgenden Tabelle sind die verfügbaren Dateiattribute aufgeführt.

  nFileAttribute	Dateiattribute
  0	Lesen/Schreiben (Standard)
  1	Schreibgeschützt
  2	Versteckt
  3	Schreibgeschützt/Versteckt
  4	System
  5	Schreibgeschützt/System
  6	System/Versteckt
  7	Schreibgeschützt/Versteckt/System

  In Dateien, die mit einem anderen nFileAttribute-Argument außer 0 erstellt wurden, können Sie erst dann mit FPUTS( ) oder FWRITE( ) schreiben, wenn die Datei geschlossen und wieder geöffnet wurde.

  Wenn Sie Informationen über die mit FCREATE( ) erstellten und geöffneten Dateien anzeigen oder drucken möchten, verwenden Sie DISPLAY STATUS oder LIST STATUS. Mit DISPLAY STATUS bzw. LIST STATUS erhalten Sie folgende Informationen zu allen Dateien, die mit einer Dateifunktion auf systemnaher Ebene geöffnet oder erstellt wurden:

  • Laufwerk, Verzeichnis und Dateiname
  • Numerisches Dateihandle
  • Position des Dateizeigers
  • Lese-/Schreibattribute

Hinweise

Wenn bereits eine Datei mit diesem Namen vorhanden ist, wird sie ohne Warnung überschrieben.

FCREATE( ) ordnet der Datei ein Dateihandle zu, mit dem Sie bei anderen Dateifunktionen auf systemnaher Ebene von Visual FoxPro auf diese Datei verweisen können. Wenn eine Datei erstellt wird, gibt FCREATE( ) das Dateihandle zurück. Wenn die Datei nicht erstellt werden kann, wird der Wert –1 zurückgegeben.

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

Mit FCREATE( ) kann kein DFÜ-Anschluss geöffnet werden. Verwenden Sie stattdessen FOPEN( ).

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
IF gnErrFile > 0
MODIFY FILE errors.txt NOWAIT  && Open file in edit window
ENDIF  

Siehe auch

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