_FGets( ) (Rutina de biblioteca API)
Copia en el búfer una sola línea del archivo especificado a partir de la posición actual en el archivo.
unsigned int _FGets(FCHAN chan, char FAR *buffer, int maxlen)
FCHAN chan; /* File channel of file from which to copy. */
char FAR *buffer; /* Buffer address. */
int maxlen; /* Maximum length of line in bytes. */
Observaciones
_FGets( ) copia una línea de longitud maxlen delimitada por un retorno de carro. El retorno de carro se convierte en un terminador nulo y se almacena en el búfer. Los avances de línea se pasan por alto y no se copian en el búfer. _FGets( ) devuelve el número de bytes copiados al búfer.
Para obtener más información acerca de cómo crear una biblioteca API e integrarla con Visual FoxPro, vea Acceso a la API de Visual FoxPro.
Ejemplo
El siguiente ejemplo abre un archivo especificado por un parámetro, tras lo cual copia y muestra cada línea del archivo.
Código Visual FoxPro
SET LIBRARY TO FGETS
fc = FCREATE("x", 0)
= FPUTS(fc, REPL("X", 512), 512)
= FCLOSE(fc)
= XFGETS("x")
DELETE FILE x
Código C
#include <pro_ext.h>
#define BUFFSIZE 256
static char lineBuffer[BUFFSIZE];
void putLong(long n)
{
Value val;
val.ev_type = 'I';
val.ev_long = n;
val.ev_width = 10;
_PutValue(&val);
}
FAR Example(ParamBlk FAR *parm)
{
FCHAN fchan;
// Null terminate file name
if (!_SetHandSize(parm->p[0].val.ev_handle,
parm->p[0].val.ev_length+1))
{
_Error(182); // "Insufficient memory"
}
_HLock(parm->p[0].val.ev_handle);
((char FAR *) _HandToPtr(parm->p[0].val.ev_handle))
[parm->p[0].val.ev_length] = '\0';
if ((fchan=_FOpen((char FAR*)_HandToPtr(parm->p[0].val.ev_handle),
FC_NORMAL)) < 0)
{
_UserError("Could not open file.");
}
_HUnLock(parm->p[0].val.ev_handle);
while (!_FEOF(fchan))
{
_FGets(fchan, lineBuffer, BUFFSIZE);
_PutStr(lineBuffer); _PutChr('\n');
}
_FClose(fchan);
}
FoxInfo myFoxInfo[] = {
{"XFGETS", (FPFI) Example, 1, "C"},
};
FoxTable _FoxTable = {
(FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo
};
Vea también
_FRead( ) (Rutina de biblioteca API) | _FSeek( ) (Rutina de biblioteca API) | Acceso a la API de Visual FoxPro