FCREATE() 
 Crea y/o trunca un fichero binario a longitud cero
------------------------------------------------------------------------------
 Sintaxis

     FCREATE(<cFichero>, [<nAtributo>]) --> nManejador

 Argumentos

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

     <nAtributo> 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 <cFichero> 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 y en el de acceso de lectura/escritura.
     El atributo de fichero especificado por el argumento <nAtributo> 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 Fichpru y se abre
        para lectura y escritura:

        #include "Fileio.ch"
        //
        IF (nManejador := FCREATE("Fichpru", 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 CLIPPER.LIB,
            el fichero de cabecera asociado es Fileio.ch.

 To download this example - click here.

See Also: FCLOSE() FERROR() FOPEN()