Partilhar via

vscanf_s, vwscanf_s

  • Artigo

Lê dados formatados do fluxo de entrada padrão. Essas versões do , vwscanftêm aprimoramentos devscanf segurança, conforme descrito em Recursos de segurança no CRT.

Sintaxe

int vscanf_s(
   const char *format,
   va_list arglist
);
int vwscanf_s(
   const wchar_t *format,
   va_list arglist
);

Parâmetros

format
Cadeia de caracteres de controle de formato.

arglist
Lista de argumentos variáveis.

Valor retornado

Retorna o número de campos convertidos e atribuídos com sucesso; O valor retornado 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 caractere de final de arquivo ou o caractere de fim de cadeia de caracteres for encontrado na primeira tentativa de ler um caractere. Se format for um NULL ponteiro, o manipulador de parâmetro inválido será invocado, conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, vscanf_s e vwscanf_s retornarão EOF e definirão errno como EINVAL.

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

Comentários

A função vscanf_s lê dados do fluxo de entrada padrão stdin e grava os dados nos locais que são fornecidos pela lista de argumentos arglist. Cada argumento na lista deve ser um ponteiro para uma variável de um tipo que corresponde a um especificador de tipo em format. Se ocorrer cópia entre cadeias de caracteres que se sobrepõem, o comportamento será indefinido.

A função vwscanf_s é uma versão de caractere largo da função vscanf_s; o argumento format para vwscanf_s é uma cadeia de caracteres larga. vwscanf_s e vscanf_s terão comportamento idêntico se o fluxo for aberto no modo ANSI. vscanf_s não dá suporte à entrada de um fluxo UNICODE.

Ao contrário vscanf de e vwscanf, vscanf_s e vwscanf_s exigem que o tamanho do buffer seja especificado para todos os parâmetros de entrada do tipo c, C, s, S ou conjuntos de controle de cadeia de caracteres que estão entre []. O tamanho do buffer em caracteres é passado como outro parâmetro imediatamente após o ponteiro para o buffer ou variável. O tamanho do buffer em caracteres para uma wchar_t cadeia de caracteres não é o mesmo que o tamanho em bytes.

O tamanho do buffer inclui o nulo de terminação. Você pode usar um campo de especificação de largura para garantir que o token lido caiba no buffer. Se nenhum campo de especificação de largura for usado e a leitura do token for muito grande para caber no buffer, nada será gravado nesse buffer.

Observação

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

Para obter mais informações, consulte Especificação de largura scanf.

Mapeamentos de rotina de texto genérico

Rotina TCHAR.H _UNICODE e _MBCS não definidos _MBCS definido _UNICODE definido
_vtscanf_s vscanf_s vscanf_s vwscanf_s

Para obter mais informações, consulte Campos de especificação de formato: scanf e wscanf funções.

Requisitos

Rotina Cabeçalho necessário
vscanf_s <stdio.h>
wscanf_s <stdio.h> ou <wchar.h>

Não há suporte para o console em aplicativos UWP (Plataforma Universal do Windows). Os identificadores de fluxo padrão associados ao console, stdin, stdout e stderr, devem ser redirecionados antes que as funções em tempo de execução C possam usá-los em aplicativos UWP. Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

// crt_vscanf_s.c
// compile with: /W3
// This program uses the vscanf_s and vwscanf_s functions
// to read formatted input.

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

int call_vscanf_s(char *format, ...)
{
    int result;
    va_list arglist;
    va_start(arglist, format);
    result = vscanf_s(format, arglist);
    va_end(arglist);
    return result;
}

int call_vwscanf_s(wchar_t *format, ...)
{
    int result;
    va_list arglist;
    va_start(arglist, format);
    result = vwscanf_s(format, arglist);
    va_end(arglist);
    return result;
}

int main( void )
{
    int   i, result;
    float fp;
    char  c, s[81];
    wchar_t wc, ws[81];
    result = call_vscanf_s("%d %f %c %C %s %S", &i, &fp, &c, 1,
                           &wc, 1, s, _countof(s), ws, _countof(ws) );
    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 = call_vwscanf_s(L"%d %f %hc %lc %S %ls", &i, &fp, &c, 2,
                            &wc, 1, s, _countof(s), ws, _countof(ws) );
    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);
}

Quando esse programa recebe a entrada no exemplo, ele produz esta saída:

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

Confira também

Suporte matemático e de ponto flutuante
E/S de fluxo
Localidade
printf, _printf_l, wprintf, _wprintf_l
scanf, _scanf_l, wscanf, _wscanf_l
scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l
vscanf, vwscanf