Crea y/o trunca un fichero binario a longitud cero

Sintaxis

     FCREATE(, []) –> nManejador

Argumentos

es el nombre del fichero que va a crearse. Si el fichero ya existe, su longitud se trunca a cero sin aviso previo.

es uno de los atributos de fichero binario que se muestran en la tabla siguiente. Si se omite este argumento, el valor por defecto es cero.

     Atributos de Fichero Binario

     ————————————————————————

     Valor   Fileio.ch Atributo   Descripción

     ————————————————————————

     0       FC_NORMAL Normal     Crea un fichero de lectura/escritura normal

                                  (por defecto)

     1       FC_READONLY          Sólo lectura   Crea un fichero de sólo

                                  lectura

     2       FC_HIDDEN Oculto     Crea un fichero oculto

     4       FC_SYSTEM Sistema    Crea un fichero de sistema

     ————————————————————————

Devuelve

FCREATE() devuelve el número de manejador de fichero de DOS del nuevo fichero binario en el rango 0-65.535. Si se produce un error, FCREATE() devuelve -1 y FERROR() se establece de forma que indique un código de error.

Descripción

FCREATE() es una función de fichero de bajo nivel que crea un nuevo fichero o abre y trunca uno existente. Si no existe, se crea y se abre para escritura. Si existe y puede abrirse para escritura, se trunca a una longitud de cero. Si no puede abrirse para escritura, FCREATE() devuelve -1 y FERROR() devuelve el valor de error apropiado.

Cuando FCREATE() crea un nuevo fichero de forma satisfactoria, éste se deja abierto en modo compartido compatible y en el de acceso de lectura/escritura. El atributo de fichero especificado por el argumento se aplica al nuevo fichero cuando se cierra, permitiendo la escritura en un fichero recién creado de sólo lectura. Si desea obtener una lista de modos de acceso, consulte FOPEN().

Puesto que se requiere un manejador de ficheros para identificar un fichero abierto para otras funciones de fichero, el valor de retorno de FCREATE() se asigna siempre a una variable para su utilización posterior.

Al igual que otras funciones de fichero, FCREATE() no utiliza los valores SET DEFAULT o SET PATH para su operación. En su lugar, escribe en el directorio actual del DOS a menos que se establezca una vía de forma explícita.

¡Advertencia!  Esta función permite el acceso de bajo nivel a los ficheros y dispositivos del DOS. Debe utilizarse con gran precaución y requiere un conocimiento profundo del sistema operativo.

Ejemplos

     ¦  En este ejemplo se crea un fichero llamado Fichprueba y lo abre para lectura y escritura:

        #include «Fileio.ch»

        //

        IF (nManejador := FCREATE(«Fichprueba», FC_NORMAL)) == -1

           ? «No se puede crear el fichero:», FERROR()

           BREAK

        ELSE

           FWRITE(nManejador, «Hola a todos»)

           FCLOSE(nManejador)

        ENDIF

 Ficheros:  La biblioteca asociada es DPXBASE.CH, el fichero de cabecera asociado es Fileio.ch.