Se recomienda usar Visual Studio 2017

vfscanf_s, vfwscanf_s

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Lee datos con formato de un flujo. Estas versiones de vfscanf, vfwscanf tienen mejoras de seguridad, como se describe en características de seguridad de CRT.

int vfscanf_s(   
   FILE *stream,  
   const char *format,  
   va_list arglist  
);  
int vfwscanf_s(   
   FILE *stream,  
   const wchar_t *format,  
   va_list arglist  
);  
  

Parámetros

stream
Puntero a la estructura FILE .

format
Cadena de control de formato.

arglist
Lista de argumentos de variable.

Cada una de estas funciones devuelve el número de campos que se convierten y asignan correctamente; el valor devuelto no incluye los campos que se leyeron pero no se asignaron. 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_s y vfwscanf_s.

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

El vfscanf_s función lee los datos desde la posición actual de stream en las ubicaciones que se proporcionan en el arglist lista de argumentos (si existe). Cada argumento de la lista debe ser un puntero a una variable de un tipo que se corresponde con un especificador de tipo en format. formatcontrola la interpretación de la entrada de campos y tiene el mismo formato y función que el format argumento para scanf_s; vea campos de especificación de formato: funciones scanf y wscanf para obtener una descripción de format. vfwscanf_ses una versión con caracteres anchos de vfscanf_s; el argumento format para vfwscanf_s es una cadena de caracteres anchos. Estas funciones se comportan igual si el flujo se abre en modo ANSI. vfscanf_s no admite actualmente la entrada desde un flujo UNICODE.

La diferencia principal entre las funciones más seguras (que tienen el sufijo _s) y las demás versiones es que las funciones más seguras requieren el tamaño en caracteres de cada c, C, s, S y el campo de tipo [ que se va a pasar como argumento inmediatamente después de la variable. Para obtener más información, consulte scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l y scanf especificación de ancho.

System_CAPS_ICON_note.jpg Nota

El parámetro de tamaño es del tipo unsigned, no size_t.

Asignaciones de rutina de texto genérico

Rutina TCHAR.H_UNICODE y _MBCS no definidos_MBCS definido_UNICODE definido
_vftscanf_svfscanf_svfscanf_svfwscanf_s
FunciónEncabezado necesario
vfscanf_s<stdio.h>
vfwscanf_s<stdio.h> o <wchar.h>

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

// crt_vfscanf_s.c  
// compile with: /W3  
// This program writes formatted  
// data to a file. It then uses vfscanf_s to  
// read the various data back from the file.  
  
#include <stdio.h>  
#include <stdarg.h>  
#include <stdlib.h>  
  
FILE *stream;  
  
int call_vfscanf_s(FILE * istream, char * format, ...)  
{  
    int result;  
    va_list arglist;  
    va_start(arglist, format);  
    result = vfscanf_s(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_s.out", "w+") != 0)  
    {  
        printf("The file vfscanf_s.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_s(stream, "%s %ld %f%c", s, _countof(s), &l, &fp, &c, 1);  
  
        // 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  

System::IO::StreamReader::ReadLine. Consulte también Parse métodos, como System::Double::Parse.

E/S de secuencia
_cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l
fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l
scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l
sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l
fscanf, _fscanf_l, fwscanf, _fwscanf_l
vfscanf, vfwscanf

Mostrar: