_snscanf_s, _snscanf_s_l, _snwscanf_s, _snwscanf_s_l

Lê dados formatados de um comprimento especificado de uma cadeia de caracteres. Essas funções são versões do , , , _snwscanf_lcom aprimoramentos de segurança, _snscanf_l_snwscanfconforme descrito em Recursos de _snscanfsegurança na CRT.

Sintaxe

int __cdecl _snscanf_s(
   const char * input,
   size_t length,
   const char * format [, argument_list]
);
int __cdecl _snscanf_s_l(
   const char * input,
   size_t length,
   const char * format,
   _locale_t locale [, argument_list]
);
int __cdecl _snwscanf_s(
   const wchar_t * input,
   size_t length,
   const wchar_t * format [, argument_list]
);
int __cdecl _snwscanf_s_l(
   const wchar_t * input,
   size_t length,
   const wchar_t * format,
   _locale_t locale [, argument_list]
);

Parâmetros

input
A cadeia de caracteres de entrada para examinar.

length
O número de caracteres a examinar em input.

format
Um ou mais especificadores de formato.

locale
A localidade a ser usada.

argument_list
Argumentos opcionais a serem atribuídos de acordo com a cadeia de caracteres de formato.

Retornar valor

Ambas as funções retornam o número de campos convertidos e atribuídos com êxito; O valor de retorno não inclui campos que foram lidos, mas não atribuídos. Um valor retornado igual a 0 indica que nenhum campo foi atribuído. O valor retornado será EOF para um erro ou se o fim da cadeia de caracteres for alcançado antes da primeira conversão. Para mais informações, confira sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l.

Se input ou format for um NULL ponteiro, o manipulador de parâmetros inválido será chamado, conforme descrito em Validação de parâmetro. Se a execução puder continuar, essas funções retornarão EOF e definirão errno para EINVAL.

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

Comentários

Essa função é como sscanf_s, exceto que ela permite que você especifique um número fixo de caracteres para examinar a partir da cadeia de caracteres de entrada. Para mais informações, confira sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l.

O parâmetro de tamanho do buffer é exigido com os caracteres de campo de tipo c, C, s, S e [. Para obter mais informações, consulte Caracteres de campo de tipo scanf.

Observação

O parâmetro de tamanho é do tipo unsigned, não size_t.

As versões dessas funções com o sufixo _l são idênticas, com a exceção de usarem o parâmetro de localidade passado, em vez da localidade do thread atual.

Mapeamentos de rotina de texto genérico

Rotina Tchar.h	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_sntscanf_s	_snscanf_s	_snscanf_s	_snwscanf_s
_sntscanf_s_l	_snscanf_s_l	_snscanf_s_l	_snwscanf_s_l

Requisitos

Rotina	Cabeçalho necessário
_snscanf_s, _snscanf_s_l	<stdio.h>
_snwscanf_s, _snwscanf_s_l	<stdio.h> ou <wchar.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

// crt_snscanf_s.c
// This example scans a string of
// numbers, using both the character
// and wide character secure versions
// of the snscanf function.

#include <stdio.h>

int main( )
{
    char        str1[] = "15 12 14...";
    wchar_t     str2[] = L"15 12 14...";
    char        s1[3];
    wchar_t     s2[3];
    int         i;
    float       fp;

    i = _snscanf_s( str1, 6,  "%s %f", s1, 3, &fp);
    printf_s("_snscanf_s converted %d fields: ", i);
    printf_s("%s and %f\n", s1, fp);

    i = _snwscanf_s( str2, 6,  L"%s %f", s2, 3, &fp);
    wprintf_s(L"_snwscanf_s converted %d fields: ", i);
    wprintf_s(L"%s and %f\n", s2, fp);
}

_snscanf_s converted 2 fields: 15 and 12.000000
_snwscanf_s converted 2 fields: 15 and 12.000000

Confira também

Especificação de largura scanf