FOPEN( ) (Función)

  • Artículo

Abre un archivo o puerto de comunicaciones para utilizarlo con funciones de archivo de bajo nivel.

FOPEN(cFileName [, nAttribute])

Valores devueltos

Numeric

Parámetros

  • cFileName
    Especifica el nombre del archivo que se va a abrir. cFileName puede incluir una ruta para archivos abiertos en directorios o unidades que no estén en la ruta de búsqueda actual de Microsoft Visual FoxPro. Si no se incluye la ruta, Visual FoxPro buscará el archivo en las siguientes ubicaciones:

    • El directorio predeterminado

    • La ruta de acceso establecida con SET PATH

      Nota   Visual FoxPro no reconocerá correctamente un nombre de ruta de acceso si el nombre del disco o del directorio contiene un signo de admiración (!).

  • nAttribute
    Especifica privilegios de lectura/escritura o el esquema de almacenamiento en búfer para el archivo que abra. La tabla siguiente lista cada número que puede incluir en nAttribute, y los privilegios de lectura/escritura del archivo y el esquema de almacenamiento en búfer que establece.

    nAttribute Privilegios de lectura-escritura Con búfer/Sin búfer
    0 Sólo lectura (predeterminado) Con búfer
    1 Sólo escritura Con búfer
    2 Lectura y escritura Con búfer
    10 Sólo lectura Sin búfer
    11 Sólo escritura Sin búfer
    12 Lectura y escritura Sin búfer

    Si no se incluye nAttribute o si nAttribute se evalúa a 0, el archivo se abrirá como sólo lectura y con búfer.

    Nota   Visual FoxPro no reconocerá correctamente un nombre de ruta de acceso si el nombre del disco o del directorio contiene un signo de admiración (!).

Observaciones

Si FOPEN( ) abre correctamente el archivo, devolverá el número del identificador de archivo. Si no se puede abrir el archivo, FOPEN( ) devolverá –1.

Sugerencia   Asigne el número de controlador de archivo a una variable de memoria, lo que le permitirá tener acceso al archivo o puerto de comunicaciones por la variable de memoria en otras funciones de archivo de bajo nivel.

DISPLAY STATUS y LIST STATUS permiten mostrar o enviar a una impresora la siguiente información acerca de los archivos abiertos.

  • La unidad, el directorio y el nombre del archivo
  • El número de controlador de archivo
  • La posición del puntero del archivo
  • Los atributos de lectura-escritura

Ejemplo

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

Vea también

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