vfscanf, vfwscanf

Lee datos con formato de un flujo. Hay disponibles versiones más seguras de estas funciones; consulte vfscanf_s, vfwscanf_s.

Sintaxis

int vfscanf(
   FILE *stream,
   const char *format,
   va_list argptr
);
int vfwscanf(
   FILE *stream,
   const wchar_t *format,
   va_list argptr
);

Parámetros

stream
Puntero a la estructura FILE .

format
Cadena de control de formato.

arglist
Lista de argumentos de variable.

Valor devuelto

Cada una de estas funciones devuelve el número de campos que se convierten y asignan correctamente. El valor devuelto no incluye campos leídos pero no asignados. Un valor devuelto de 0 indica que no se ha asignado ningún campo. Si se produce un error, o si se llega al final del flujo de archivo antes de la primera conversión, el valor devuelto es EOF para vfscanf y vfwscanf.

Estas funciones validan sus parámetros. Si stream o format es un puntero nulo, se invoca el controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, estas funciones devuelven EOF y establecen errno en EINVAL.

Comentarios

La función vfscanf lee datos de la posición actual de stream en las ubicaciones que proporciona la lista de argumentos arglist. Cada argumento de la lista debe ser un puntero a una variable de un tipo que se corresponda con un especificador de tipo en format. format controla la interpretación de los campos de entrada y tiene el mismo formato y función que el argumento format de scanf; consulte scanf para obtener una descripción de format.

vfwscanf es una versión con caracteres anchos de vfscanf; el argumento de formato para vfwscanf es una cadena de caracteres anchos. Estas funciones se comportan igual si el flujo se abre en modo ANSI. vfscanf no admite la entrada desde un flujo UNICODE.

Asignaciones de rutinas de texto genérico

Rutina TCHAR.H	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_vftscanf	vfscanf	vfscanf	vfwscanf

Para obtener más información, vea Formato de campos de especificación: scanf y wscanf funciones.

Requisitos

Función	Encabezado necesario
vfscanf	<stdio.h>
vfwscanf	<stdio.h> o <wchar.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Ejemplo

// crt_vfscanf.c
// compile with: /W3
// This program writes formatted
// data to a file. It then uses vfscanf to
// read the various data back from the file.

#include <stdio.h>
#include <stdarg.h>

FILE *stream;

int call_vfscanf(FILE * istream, char * format, ...)
{
    int result;
    va_list arglist;
    va_start(arglist, format);
    result = vfscanf(istream, format, arglist);
    va_end(arglist);
    return result;
}

int main(void)
{
    long l;
    float fp;
    char s[81];
    char c;

    if (fopen_s(&stream, "vfscanf.out", "w+") != 0)
    {
        printf("The file vfscanf.out was not opened\n");
    }
    else
    {
        fprintf(stream, "%s %ld %f%c", "a-string",
            65000, 3.14159, 'x');
        // Security caution!
        // Beware loading data from a file without confirming its size,
        // as it may lead to a buffer overrun situation.

        // Set pointer to beginning of file:
        fseek(stream, 0L, SEEK_SET);

        // Read data back from file:
        call_vfscanf(stream, "%s %ld %f%c", s, &l, &fp, &c);

        // Output data read:
        printf("%s\n", s);
        printf("%ld\n", l);
        printf("%f\n", fp);
        printf("%c\n", c);

        fclose(stream);
    }
}

a-string
65000
3.141590
x

Consulte también

E/S de secuencia
_cscanf, _cscanf_l, _cwscanf, _cwscanf_l
fprintf, _fprintf_l, fwprintf, _fwprintf_l
scanf, _scanf_l, wscanf, _wscanf_l
sscanf, _sscanf_l, swscanf, _swscanf_l
fscanf_s, _fscanf_s_l, fwscanf_s, _fwscanf_s_l
vfscanf_s, vfwscanf_s