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.