Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

sscanf — ler dados formatados de uma cadeia de caracteres

sscanf de <stdio.h> lê dados de uma cadeia de caracteres terminada em nulo, de acordo com um formato. Guarda os resultados através de ponteiros e devolve o número de atribuições bem-sucedidas (sem contar `%n`), não o número de caracteres lidos.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

#include <stdio.h>
int sscanf(const char * restrict s, const char * restrict format, ...);

sscanf funciona como fscanf, mas lê uma cadeia de caracteres em vez de um fluxo. O formato descreve as conversões e os caracteres literais necessários. %d requer um int *; use &age. Para o array name, passe o próprio name.

Verifique o valor devolvido antes de utilizar os dados: conta as atribuições bem-sucedidas e pode ser inferior ao esperado ou igual a 0. A diretiva %n guarda o número de caracteres lidos até esse momento, mas não incrementa o valor devolvido. EOF indica um erro de entrada antes de a primeira conversão terminar. As atribuições bem-sucedidas não garantem que toda a cadeia tenha sido consumida.

%s ignora os espaços em branco iniciais, lê uma palavra e acrescenta um carácter nulo. %7s precisa de, pelo menos, 8 elementos char. A maioria das conversões ignora os espaços em branco iniciais; %c, %[ e %n não o fazem.

Um tipo de ponteiro incompatível, um resultado numérico não representável no objeto de destino ou uma cópia entre objetos sobrepostos causa comportamento indefinido. A largura do campo não verifica o intervalo numérico. No exemplo, ambos os resultados só são utilizados depois de verificar count == 2.

Exemplos

#include <stdio.h>

int main(void)
{
    const char input[] = "Ada 42";
    char name[8];
    int age;
    int count = sscanf(input, "%7s %d", name, &age);

    if (count != 2) {
        puts("Parse failed");
        return 1;
    }

    printf("%s: %d\n", name, age);
    return 0;
}

Resultado

Ada: 42

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes