sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l

Artigo
02/25/2013

Dados a partir de uma seqüência de caracteres formatada de leitura.Estas são as versões do sscanf, _sscanf_l, swscanf, _swscanf_l com aprimoramentos de segurança, conforme descrito em Recursos de segurança no CRT.

int sscanf_s(
   const char *buffer,
   const char *format [,
   argument ] ...
);
int _sscanf_s_l(
   const char *buffer,
   const char *format,
   locale_t locale [,
   argument ] ...
);
int swscanf_s(
   const wchar_t *buffer,
   const wchar_t *format [,
   argument ] ...
);
int _swscanf_s_l(
   const wchar_t *buffer,
   const wchar_t *format,
   locale_t locale [,
   argument ] ...
);

Parâmetros

buffer
Dados armazenados
format
Seqüência de caracteres de controle de formato.Para obter mais informações, consulte Especificações de formato.
argument
Argumentos opcionais
locale
O código de idioma

Valor de retorno

Cada uma dessas funções retorna o número de campos atribuídos; e convertido com êxito o valor de retorno não inclui campos que foram lidos, mas não atribuídos.Um valor de retorno 0 indica que não há campos foram atribuídos.O valor de retorno é EOF um erro, ou se o final da seqüência de caracteres é alcançado antes da conversão primeira.

Se buffer ou format é um NULL o ponteiro, o manipulador de parâmetro inválido é invocado, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, essas funções retornam -1 e defina errno paraEINVAL

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

Comentários

O sscanf_s função lê dados de buffer em localização fornecida por cada argument.Os argumentos depois da seqüência de formato especificam os ponteiros para variáveis com um tipo que corresponde a um especificador de tipo em format.Ao contrário da versão menos segura sscanf, um parâmetro de tamanho do buffer é necessário ao usar os caracteres de campo do tipo c, C, s, S e [.O tamanho do buffer em caracteres deve ser fornecido como um parâmetro adicional após cada buffer que o exija.Para obter mais informações, consulte scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l e scanf caracteres de campo de tipo.

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

O format controles de argumento, a interpretação da entrada campos e tenha o mesmo formulário e funcionar como o format argumento para o scanf_s função.Se copiar ocorre entre cadeias de caracteres que se sobrepõem, o comportamento é indefinido.

swscanf_sé uma versão de caractere largo de sscanf_s; os argumentos para swscanf_s são seqüências de caracteres largos.sscanf_snão manipula multibyte caracteres hexadecimais.swscanf_snão manipula hexadecimal de largura total Unicode ou caracteres de "zona de compatibilidade".Caso contrário, swscanf_s e sscanf_s se comportam de forma idêntica.

As versões dessas funções com o _l sufixo são idênticas exceto que eles usam o parâmetro de localidade passado em vez da localidade do thread atual.

Mapeamentos de rotina de texto genérico

TCHAR.Rotina H	_ Unicode & _ MBCS do arquivo não definido	_ MBCS do arquivo definido	_ Unicode definido
_stscanf_s	sscanf_s	sscanf_s	swscanf_s
_stscanf_s_l	_sscanf_s_l	_sscanf_s_l	_swscanf_s_l

Requisitos

Rotina	Cabeçalho necessário
sscanf_s, _sscanf_s_l	<stdio.h>
swscanf_s, _swscanf_s_l	<stdio.h> ou <wchar.h>

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

Exemplo

// crt_sscanf_s.c
// This program uses sscanf_s to read data items
// from a string named tokenstring, then displays them.

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

int main( void )
{
   char  tokenstring[] = "15 12 14...";
   char  s[81];
   char  c;
   int   i;
   float fp;

   // Input various data from tokenstring:
   // max 80 character string plus NULL terminator
   sscanf_s( tokenstring, "%s", s, _countof(s) );
   sscanf_s( tokenstring, "%c", &c, sizeof(char) );
   sscanf_s( tokenstring, "%d", &i );
   sscanf_s( tokenstring, "%f", &fp );

   // Output the data read
   printf_s( "String    = %s\n", s );
   printf_s( "Character = %c\n", c );
   printf_s( "Integer:  = %d\n", i );
   printf_s( "Real:     = %f\n", fp );
}