FGETS( ) (Función)

  • Artículo

Devuelve un conjunto de bytes desde un archivo o un puerto de comunicaciones abierto con una función de archivo de bajo nivel hasta encontrar un retorno de carro.

FGETS(nFileHandle [, nBytes])

Valores devueltos

Character

Parámetros

  • nFileHandle
    Especifica el controlador numérico del archivo o el puerto de comunicación desde el que FGETS( ) devuelve datos.

  • nBytes
    Especifica el número de bytes devueltos por FGETS( ). FGETS( ) devuelve nBytes a menos que encuentre primero un retorno de carro. FGETS( ) devuelve datos entre la posición inicial del puntero del archivo y el retorno de carro si se encuentra un retorno de carro dentro de los nBytes bytes.

    FGETS( ) devuelve un máximo de 8192 bytes. Si se omite nBytes, FGETS( ) devuelve de forma predeterminada 254 bytes.

Observaciones

Puede leer un archivo línea a línea si ejecuta varias funciones FGETS( ).

FGETS( ) devuelve un conjunto de bytes como una cadena de caracteres. Se devuelven los datos encontrados a partir de la posición actual del puntero del archivo y hasta que se encuentra un retorno de carro. El puntero de archivo se coloca entonces en el byte inmediatamente siguiente al retorno de carro. El retorno de carro no se devuelve como parte de la cadena y los saltos de línea se descartan.

Ejemplo

** TEST.TXT must exist ** STORE FOPEN('test.txt') TO gnFileHandle && Open the file STORE FSEEK(gnFileHandle, 0, 2) TO gnEnd && Move pointer to EOF STORE FSEEK(gnFileHandle, 0) TO gnTop && Move pointer to BOF IF gnEnd <= 0 && Is file empty? WAIT WINDOW 'This file is empty!' NOWAIT ELSE && If not gcString = FGETS(gnFileHandle, gnEnd) && Store contents ? gcString ENDIF = FCLOSE(gnFileHandle) && Close the file

Vea también

FCHSIZE( ) | FCLOSE( ) | FCREATE( ) | FEOF( ) | FFLUSH( ) | FILETOSTR( ) | FOPEN( ) | FPUTS( ) | FREAD( ) | FSEEK( ) | FWRITE( )