scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l

Artigo
08/25/2010

Ler dados do fluxo de entrada padrão em formato.Essas são sistema autônomo versões de scanf, _scanf_l, wscanf, _wscanf_l com aprimoramentos de segurança conforme descrito em Aprimoramentos de segurança no CRT.

int scanf_s(
   const char *format [,
      argument]... 
);
int _scanf_s_l(
   const char *format,
   locale_t locale [,
      argument]... 
);
int wscanf_s(
   const wchar_t *format [,
      argument]... 
);
int _wscanf_s_l(
   const wchar_t *format,
   locale_t locale [,
      argument]... 
);

Parâmetros

format
Seqüência de caracteres de controle de formato.
argument
Argumentos opcionais.
locale
A localidade para usar.

Valor de retorno

Retorna o número de campos convertido com êxito e atribuídos; o valor retornado não inclui campos que foram lidos, mas não atribuídos.Um valor retornado 0 indica que nenhum campo foi atribuído.O valor retornado é EOF um erro ou se o caractere de participante de arquivo ou o caractere de participante de seqüência é encontrado na primeira tentativa de ler um caractere. If format é um NULL ponteiro, o manipulador de parâmetro inválido é invocado, sistema autônomo descrito em Validação de parâmetro. Se a execução for permitida para continuar, scanf_s e wscanf_s retornar EOF e conjunto errno para EINVAL.

Para obter informações sobre estes e outros códigos de erro, consulte _doserrno, errno, _sys_errlist e _sys_nerr.

Comentários

The scanf_s função lê os dados do fluxo de entrada padrão stdin e grava os dados no local fornecido pelo argument. Cada argument deve ser um ponteiro para uma variável de tipo que corresponde a um especificador de tipo em format. Se copiar ocorre entre cadeias de caracteres que se sobrepõem, o comportamento é indefinido.

wscanf_s é uma versão de caractere largo da scanf_s; o format argumento para wscanf_s é uma seqüência de caracteres largos. wscanf_s e scanf_s tenham comportamento idêntico idêntico se o fluxo é aberto no modo ANSI. scanf_s atualmente não oferece suporte a entrada de um fluxo UNICODE.

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.

Ao contrário de scanf e wscanf, scanf_s e wscanf_s exigir o dimensionar do buffer seja especificado para todos os parâmetros do tipo de entrada c, C, s, S, ou [. O dimensionar do buffer é passado sistema autônomo um parâmetro adicional imediatamente após o ponteiro para o buffer ou variável.Por exemplo, se estiver lendo uma seqüência de caracteres, o dimensionar do buffer para essa seqüência é passada sistema autônomo a seguir:

char s[10];

scanf("%9s", s, 10);

O dimensionar do buffer inclui o nulo de terminação.Um campo de largura da especificação pode ser usado para garantir que o token de ler em caberão no buffer.Se nenhum campo especificação de largura é usado e o token de leitura é muito grande ajuste no buffer, nada será gravado para esse buffer.

Observação:
O parâmetro dimensionar é do tipo unsigned, não size_t.

No caso de caracteres, um pode ler um único caractere da seguinte maneira:

char c;

scanf("%c", &c, 1);

Durante a leitura de vários caracteres para seqüências de caracteres terminados não-nulo, inteiros são usados sistema autônomo a especificação de largura e o dimensionar do buffer.

char c[4];

scanf("%4c", &c, 4); // not null terminated

For more information, see scanf especificação de largura.

Mapeamentos de rotina de texto genérica

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_MBCS definido	_UNICODE definido
_tscanf_s	scanf_s	scanf_s	wscanf_s
_tscanf_s_l	_scanf_s_l	_scanf_s_l	_wscanf_s_l

Para obter mais informações, consulte Os campos de especificação de formato — scanf funções e wscanf funções.

Requisitos

Rotina	Cabeçalho necessário
scanf_s, _scanf_s_l	<stdio.h>
wscanf_s, _wscanf_s_l	<stdio.h> ou <wchar.h>

Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.

Exemplo

// crt_scanf_s.c
// This program uses the scanf_s and wscanf_s functions
// to read formatted input.
  
#include <stdio.h>

int main( void )
{
   int      i,
            result;
   float    fp;
   char     c,
            s[81];
   wchar_t  wc,
            ws[81];

   result = scanf_s( "%d %f %c %C %s %S", &i, &fp, &c, 1,
                     &wc, 1, s, 80, ws, 80 );
   printf( "The number of fields input is %d\n", result );
   printf( "The contents are: %d %f %c %C %s %S\n", i, fp, c,
           wc, s, ws);
   result = wscanf_s( L"%d %f %hc %lc %S %ls", &i, &fp, &c, 2,
                      &wc, 1, s, 80, ws, 80 );
   wprintf( L"The number of fields input is %d\n", result );
   wprintf( L"The contents are: %d %f %C %c %hs %s\n", i, fp,
            c, wc, s, ws);
}

71 98.6 h z Byte characters 36 92.3 y n Wide characters

The number of fields input is 6 The contents are: 71 98.599998 h z Byte characters The number of fields input is 6 The contents are: 36 92.300003 y n Wide characters