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.