FREADSTR() 
 Lee caracteres de un fichero binario
------------------------------------------------------------------------------
 Sintaxis

     FREADSTR(<nManejador>, <nBytes>) --> cCadena

 Argumentos

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

     <nBytes> 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 a partir de la posición de puntero del
     fichero del DOS actual. Los caracteres se leen hasta <nBytes> 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 <nBytes>. 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 CLIPPER.LIB.

 To download this example - click here.

See Also: BIN2I() BIN2L() BIN2W() FERROR() FOPEN() FREAD()