Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła