Lee caracteres de un fichero binario

Sintaxis

     FREADSTR(, ) –> cCadena

Argumentos

es el manejador de ficheros obtenido de FOPEN(), FCREATE() o predefinido por el DOS.

es el número de bytes que deben leerse, comenzando en la posición del puntero del fichero del DOS actual.

Devuelve

FREADSTR() devuelve una cadena de caracteres de un máximo de 65.535 (64K) bytes. Un valor de retorno nulo (“”) indica un error o el final del fichero.

 Descripción

FREADSTR() es una función de fichero de bajo nivel que lee caracteres de un fichero binario abierto que comienza en la posición de puntero del fichero del DOS actual. Los caracteres se leen hasta o hasta que se encuentra un carácter nulo (CHR(0)). Se leen todos los caracteres incluyendo los de control, con la excepción de CHR(0). El puntero del fichero avanza . Si este número es mayor que el número de bytes desde la posición del puntero hasta el final del fichero, el puntero se sitúa en el último byte del fichero.

¡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

     ¦  El ejemplo de la página siguiente muestra los valores ASCII de los primeros 16 bytes de un fichero de texto:

        #include “Fileio.ch”

        //

        nManejador := FOPEN(“Nuevo.txt”, FC_NORMAL)

        IF FERROR() != 0

           ? “Error de apertura de fichero:”, FERROR()

        ELSE

           cCadena := FREADSTR(nManejador, 16)

           ? cCadena

           FCLOSE(nManejador)

        ENDIF

 Ficheros:  La biblioteca asociada es DPXBASE.CH.