_cscanf, _cscanf_l, _cwscanf, _cwscanf_l

Article
03/26/2013

Données mises en forme de lectures de la console.Les versions sécurisées de ces fonctions sont disponibles ; consultez _cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l.

Important

Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans les fenêtres d'exécution.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /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] ... 
);

Paramètres

format
Chaîne de format.
argument
Paramètres facultatifs.
locale
Les paramètres régionaux à utiliser.

Valeur de retour

Le nombre de champs qui ont été correctement convertis et assignés.La valeur de retour n'inclut pas les champs qui ont été lus mais non assigné.La valeur de retour est EOF pour qu'une tentative lire et de fin de fichier.Cela peut se produire lorsque l'entrée au clavier est redirigée au niveau de le système d'exploitation de ligne de commande.Une valeur de retour de 0 signifie qu'un champ n'a été assigné.

Notes

La fonction d' _cscanf lit des données directement de la console dans les emplacements spécifiés par argument.La fonction d' _getche est utilisée pour lire des caractères.Chaque paramètre optionnel doit être un pointeur vers une variable avec un type qui correspond à un spécificateur de type dans format.Les contrôles de format la traduction des champs d'entrée et a la même forme et fonction de le paramètre d' format pour la fonction d' scanf .Pendant qu' _cscanf répercute normalement le caractère d'entrée, ce n'est pas si le dernier appel à a été _ungetch.

Cette fonction valide ses paramètres.Si le format est NULL, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution pour continuer, errno a la valeur EINVAL et la fonction retourne EOF.

Les versions de ces fonctions avec le suffixe d' _l sont identiques sauf qu'elles utilisent le paramètre de paramètres régionaux passé au lieu des paramètres régionaux du thread actuel.

Mappages de routines de texte générique

Routine de TCHAR.H	_UNICODE et non définis _MBCS	_MBCS défini	_UNICODE défini
_tcscanf	_cscanf	_cscanf	_cwscanf
_tcscanf_l	_cscanf_l	_cscanf_l	_cwscanf_l

Configuration requise

Routine	En-tête requis
_cscanf,_cscanf_l	<conio.h>
_cwscanf, _cwscanf_l	<conio.h> ou <wchar.h>

Pour plus d'informations de compatibilité, consultez l' Compatibilité dans l'introduction.

Exemple

// 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" );
}

Entrée

1 2 3

Sortie

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

Voir aussi

Référence

E/S de console et de port

_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

Partager via