Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

sscanf — čtení formátovaných dat z řetězce

sscanf z <stdio.h> čte data z řetězce ukončeného nulovým znakem podle formátu. Výsledky ukládá prostřednictvím ukazatelů a vrací počet úspěšných přiřazení (bez započtení `%n`), nikoli počet přečtených znaků.

Verze: C23; repository compiler flag, production runtime not attested

Syntaxe

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

sscanf funguje jako fscanf, ale čte řetězec místo proudu. Formát popisuje konverze a požadované doslovné znaky. %d vyžaduje int *; použijte &age. U pole name předejte samotné name.

Před použitím dat zkontrolujte návratovou hodnotu: udává počet úspěšných přiřazení a může být menší, než se očekává, nebo rovna 0. Direktiva %n uloží počet dosud přečtených znaků, ale nezvyšuje návratovou hodnotu. EOF označuje chybu vstupu před dokončením první konverze. Úspěšná přiřazení nezaručují, že byl spotřebován celý řetězec.

%s přeskočí počáteční bílé znaky, načte slovo a připojí nulový znak. %7s potřebuje alespoň 8 prvků char. Většina konverzí počáteční bílé znaky přeskočí; %c, %[ a %n nikoli.

Nekompatibilní typ ukazatele, číselný výsledek, který nelze reprezentovat v cílovém objektu, nebo kopírování mezi překrývajícími se objekty způsobuje nedefinované chování. Šířka pole nekontroluje číselný rozsah. V příkladu se oba výsledky použijí až po kontrole count == 2.

Příklady

#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;
}

Výsledek

Ada: 42

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje