vscanf_s, vwscanf_s

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.

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

Mapeamentos de rotina de texto genérico

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

Requisitos

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