_cscanf, _cscanf_l, _cwscanf, _cwscanf_l
Leituras de dados do console em formato.Versões mais seguras dessas funções estão disponível; consulte _cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l.
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] ...
);
format
Seqüência de caracteres de controle de formato.argument
Parâmetros opcionais.locale
A localidade para usar.
O número de campos que foram convertidos com êxito e atribuídos.O valor retornado não inclui campos que foram lidos, mas não atribuídos.O valor retornado é EOF para uma tentativa de leitura no participante do arquivo. Isso pode ocorrer quando a entrada do teclado é redirecionada no nível de linha de comando do sistema operacional.Um valor retornado 0 indica que não há campos foram atribuídos.
The _cscanf função lê os dados diretamente do console em locais fornecidos pelo argument. The _getche função é usada para ler caracteres.Cada parâmetro opcional deve ser um ponteiro para uma variável com um tipo que corresponde a um especificador de tipo de format. O formato controla a interpretação dos campos de entrada e tenha o mesmo formulário e funcione sistema autônomo a format parâmetro para o scanf função.Ao mesmo tempo em que _cscanf Exibe o caractere de entrada, normalmente ele não faz isso se a última telefonar _ungetch.
Esta função valida os parâmetros.Se o formato for nulo, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. If execution is allowed to continue, errno is set to EINVAL and the function returns EOF.
As versões dessas funções com o _l sufixo são idênticas exceto que usarem o parâmetro de localidade passado em vez da localidade do thread corrente.
Mapeamentos de rotina de texto genérica
Rotina TCHAR.H |
_UNICODE e _MBCS não definido |
_MBCS definido |
_UNICODE definido |
---|---|---|---|
_tcscanf |
_cscanf |
_cscanf |
_cwscanf |
_tcscanf_l |
_cscanf_l |
_cscanf_l |
_cwscanf_l |
Rotina |
Cabeçalho necessário |
---|---|
_cscanf, _cscanf_l |
<conio.h> |
_cwscanf, _cwscanf_l |
<conio.h> ou <wchar.h> |
Para obter mais informações de compatibilidade, consulte Compatibilidade na introdução.
// 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" );
}
1 2 3
Enter three integers: 1 2 3
You entered 3 2 1
_cprintf, _cprintf_l, _cwprintf, _cwprintf_l
fscanf, _fscanf_l, fwscanf, _fwscanf_l