fscanf_s, _fscanf_s_l, fwscanf_s, _fwscanf_s_lfscanf_s, _fscanf_s_l, fwscanf_s, _fwscanf_s_l

Lee datos con formato de un flujo.Reads formatted data from a stream. Estas versiones de fscanf, _fscanf_l, fwscanf, _fwscanf_l incluyen mejoras de seguridad, tal y como se describe en Características de seguridad de CRT.These versions of fscanf, _fscanf_l, fwscanf, _fwscanf_l have security enhancements, as described in Security Features in the CRT.

SintaxisSyntax

int fscanf_s(
   FILE *stream,
   const char *format [,
   argument ]...
);
int _fscanf_s_l(
   FILE *stream,
   const char *format,
   locale_t locale [,
   argument ]...
);
int fwscanf_s(
   FILE *stream,
   const wchar_t *format [,
   argument ]...
);
int _fwscanf_s_l(
   FILE *stream,
   const wchar_t *format,
   locale_t locale [,
   argument ]...
);

ParámetrosParameters

misionesstream
Puntero a la estructura FILE.Pointer to FILE structure.

formatformat
Cadena de control de formato.Format-control string.

argumentargument
Argumentos opcionales.Optional arguments.

localelocale
Configuración regional que se va a usar.The locale to use.

Valor devueltoReturn Value

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.Each of these functions returns the number of fields that are successfully converted and assigned; the return value does not include fields that were read but not assigned. Un valor devuelto de 0 indica que no se ha asignado ningún campo.A return value of 0 indicates that no fields were assigned. Si se produce un error, o si se alcanza el final de la secuencia de archivo antes de la primera conversión, el valor devuelto es EOF para fscanf_s y fwscanf_s.If an error occurs, or if the end of the file stream is reached before the first conversion, the return value is EOF for fscanf_s and fwscanf_s.

Estas funciones validan sus parámetros.These functions validate their parameters. 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, tal y como se describe en validación de parámetros.If stream is an invalid file pointer, or format is a null pointer, these functions invoke the invalid parameter handler, as described in Parameter Validation. Si la ejecución puede continuar, estas funciones devuelven EOF y establecen errno en EINVAL.If execution is allowed to continue, these functions return EOF and set errno to EINVAL.

ObservacionesRemarks

La función fscanf_s lee datos de la posición actual de la secuencia en las ubicaciones que se proporcionan por el argumento (si existe).The fscanf_s function reads data from the current position of stream into the locations that are given by argument (if any). Cada argumento debe ser un puntero a una variable de un tipo que se corresponda con un especificador de tipo en formato.Each argument must be a pointer to a variable of a type that corresponds to a type specifier in format. el formato controla la interpretación de los campos de entrada y tiene el mismo formato y función que el argumento de formato para scanf_s; vea campos de especificación de formato: funciones scanf y wscanf para obtener una descripción de formato.format controls the interpretation of the input fields and has the same form and function as the format argument for scanf_s; see Format Specification Fields: scanf and wscanf Functions for a description of format. fwscanf_s es una versión con caracteres anchos de fscanf_s; el argumento de formato para fwscanf_s es una cadena de caracteres anchos.fwscanf_s is a wide-character version of fscanf_s; the format argument to fwscanf_s is a wide-character string. Estas funciones se comportan igual si el flujo se abre en modo ANSI.These functions behave identically if the stream is opened in ANSI mode. en la actualidad, fscanf_s no admite la entrada de una secuencia Unicode.fscanf_s doesn't currently support input from a UNICODE stream.

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, sy el campo de tipo que se va a pasar como argumento inmediatamente después de la variable.The main difference between the more secure functions (that have the _s suffix) and the other versions is that the more secure functions require the size in characters of each c, C, s, S, and [ type field to be passed as an argument immediately following the variable. Para obtener más información, consulte scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l y scanf (Especificación de ancho).For more information, see scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l and scanf Width Specification.

Nota

El parámetro de tamaño es del tipo unsigned , no size_t.The size parameter is of type unsigned, not size_t.

Las versiones de estas funciones que tienen el sufijo _L son idénticas, salvo que utilizan el parámetro de configuración regional que se pasa en lugar de la configuración regional del subproceso actual.The versions of these functions that have the _l suffix are identical except that they use the locale parameter that's passed in instead of the current thread locale.

Asignaciones de rutina de texto genéricoGeneric-Text Routine Mappings

Rutina TCHAR.HTCHAR.H routine _UNICODE y _MBCS no definidos_UNICODE & _MBCS not defined _MBCS definido_MBCS defined _UNICODE definido_UNICODE defined
_ftscanf_s_ftscanf_s fscanf_sfscanf_s fscanf_sfscanf_s fwscanf_sfwscanf_s
_ftscanf_s_l_ftscanf_s_l _fscanf_s_l_fscanf_s_l _fscanf_s_l_fscanf_s_l _fwscanf_s_l_fwscanf_s_l

RequisitosRequirements

FunciónFunction Encabezado necesarioRequired header
fscanf_s, _fscanf_s_lfscanf_s, _fscanf_s_l <stdio.h>
fwscanf_s, _fwscanf_s_lfwscanf_s, _fwscanf_s_l <stdio.h> o <wchar.h><stdio.h> or <wchar.h>

Para obtener información adicional sobre compatibilidad, consulte Compatibilidad.For additional compatibility information, see Compatibility.

EjemploExample

// crt_fscanf_s.c
// This program writes formatted
// data to a file. It then uses fscanf to
// read the various data back from the file.

#include <stdio.h>
#include <stdlib.h>

FILE *stream;

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

   errno_t err = fopen_s( &stream, "fscanf.out", "w+" );
   if( err )
      printf_s( "The file fscanf.out was not opened\n" );
   else
   {
      fprintf_s( stream, "%s %ld %f%c", "a-string",
               65000, 3.14159, 'x' );
      // Set pointer to beginning of file:
      fseek( stream, 0L, SEEK_SET );

      // Read data back from file:
      fscanf_s( stream, "%s", s, _countof(s) );
      fscanf_s( stream, "%ld", &l );

      fscanf_s( stream, "%f", &fp );
      fscanf_s( stream, "%c", &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

Consulte tambiénSee also

E/S de secuenciaStream I/O
_cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l_cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l
fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_lfprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l
scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_lscanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l
sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_lsscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l
fscanf, _fscanf_l, fwscanf, _fwscanf_lfscanf, _fscanf_l, fwscanf, _fwscanf_l