CKTIS / C
sscanf — odczyt sformatowanych danych z napisu
sscanf z <stdio.h> odczytuje dane z napisu zakończonego znakiem zerowym według formatu. Zapisuje wyniki przez wskaźniki i zwraca liczbę udanych przypisań (z wyłączeniem `%n`), a nie liczbę odczytanych znaków.
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <stdio.h>
int sscanf(const char * restrict s, const char * restrict format, ...);sscanf działa jak fscanf, lecz czyta napis zamiast strumienia. Format opisuje konwersje i wymagane znaki dosłowne. %d wymaga int *; użyj &age. Dla tablicy name przekaż samo name.
Sprawdzaj wynik przed użyciem danych: oznacza liczbę udanych przypisań i może być mniejszy od oczekiwanego lub równy 0. Dyrektywa %n zapisuje liczbę dotychczas odczytanych znaków, ale nie zwiększa wartości zwracanej. EOF oznacza błąd wejścia przed zakończeniem pierwszej konwersji. Udane przypisania nie gwarantują zużycia całego napisu.
%s pomija początkowe białe znaki, czyta słowo i dopisuje znak zerowy. %7s wymaga co najmniej 8 elementów char. Większość konwersji pomija początkowe białe znaki; %c, %[ i %n tego nie robią.
Niezgodny typ wskaźnika, wynik liczbowy niemieszczący się w obiekcie lub kopiowanie między nakładającymi się obiektami powodują niezdefiniowane zachowanie. Szerokość pola nie zapewnia kontroli zakresu liczbowego. W przykładzie oba wyniki są używane dopiero po sprawdzeniu count == 2.
Przykłady
#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;
}Wynik
Ada: 42
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.