_cscanf, _cscanf_l, _cwscanf, _cwscanf_l

Lee dio formato a los datos de la consola.Versiones más seguras de estas funciones están disponibles; vea _cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l.

Nota importanteImportante

Esta API no se puede utilizar en las aplicaciones que se ejecutan en tiempo de ejecución de Windows.Para obtener más información, vea Funciones CRT no compatibles con /ZW.

int _cscanf( 
   const char *format [,
   argument] ... 
);
int _cscanf_l( 
   const char *format,
   locale_t locale [,
   argument] ... 
);
int _cwscanf( 
   const wchar_t *format [,
   argument] ... 
);
int _cwscanf_l( 
   const wchar_t *format,
   locale_t locale [,
   argument] ... 
);

Parámetros

  • format
    Cadena de la Formato-CONTROL.

  • argument
    Parámetros opcionales.

  • locale
    La configuración regional a utilizar.

Valor devuelto

El número de campos que se convierten y asignados correctamente.El valor devuelto no incluye los campos que se leyeron pero no asignados.El valor devuelto es EOF para que un intento lea al final del archivo.Esto puede ocurrir cuando la entrada de teclado se redirige en el nivel de la línea de comandos del sistema operativo.Devuelve un valor de 0 indica que no se asignó ningún campos.

Comentarios

La función de _cscanf lee datos directamente de la consola en las ubicaciones especificadas por argument.La función de _getche se utiliza para leer los caracteres.Cada parámetro opcional debe ser un puntero a una variable con un tipo que corresponde a un especificador de tipo en format.Controles de formato la interpretación de los campos de entrada y tienen el mismo formato y función que el parámetro de format para la función de scanf.Mientras _cscanf repite normalmente el carácter de entrada, no lo hace cuando la última llamada estaba a _ungetch.

Esta función valida sus parámetros.Si el formato es NULL, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, errno se establece en EINVAL y la función devuelve EOF.

Las versiones de estas funciones con el sufijo de _l son idénticas salvo que utilizan el parámetro locale pasado en lugar de la configuración regional del subproceso actual.

Asignaciones de la rutina de Genérico- texto

Rutina de TCHAR.H

_UNICODE y _MBCS no definidos

_MBCS definido

_UNICODE definido

_tcscanf

_cscanf

_cscanf

_cwscanf

_tcscanf_l

_cscanf_l

_cscanf_l

_cwscanf_l

Requisitos

Rutina

Encabezado necesario

_cscanf,_cscanf_l

<conio.h>

_cwscanf, _cwscanf_l

<conio.h> o <wchar.h>

Para obtener más información de compatibilidad, vea Compatibilidad en la Introducción.

Ejemplo

// crt_cscanf.c
// compile with: /c /W3
/* This program prompts for a string
 * and uses _cscanf to read in the response.
 * Then _cscanf returns the number of items
 * matched, and the program displays that number.
 */

#include <stdio.h>
#include <conio.h>

int main( void )
{
   int   result, i[3];

   _cprintf_s( "Enter three integers: ");
   result = _cscanf( "%i %i %i", &i[0], &i[1], &i[2] ); // C4996
   // Note: _cscanf is deprecated; consider using _cscanf_s instead
   _cprintf_s( "\r\nYou entered " );
   while( result-- )
      _cprintf_s( "%i ", i[result] );
   _cprintf_s( "\r\n" );
}

Entrada

1 2 3

Output

Enter three integers: 1 2 3
You entered 3 2 1

Vea también

Referencia

E/S de la consola y de puerto

_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

fscanf, _fscanf_l, fwscanf, _fwscanf_l

scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l

sscanf, _sscanf_l, swscanf, _swscanf_l