CKTIS / C
sscanf — branje oblikovanih podatkov iz niza
sscanf iz <stdio.h> bere podatke iz niza, zaključenega z ničelnim znakom, glede na obliko. Rezultate shrani prek kazalcev in vrne število uspešnih prirejanj (brez upoštevanja `%n`), ne števila prebranih znakov.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdio.h>
int sscanf(const char * restrict s, const char * restrict format, ...);sscanf deluje kot fscanf, vendar bere niz namesto toka. Oblika opisuje pretvorbe in zahtevane dobesedne znake. %d zahteva int *; uporabi &age. Za polje name podaj samo name.
Pred uporabo podatkov preveri vrnjeno vrednost: pove, koliko prirejanj je uspelo, in je lahko manjša od pričakovane ali enaka 0. Direktiva %n shrani število do tedaj prebranih znakov, vendar ne poveča vrnjene vrednosti. EOF pomeni napako pri vhodu, preden je končana prva pretvorba. Uspešna prirejanja ne zagotavljajo, da je bil porabljen celoten niz.
%s preskoči začetne bele znake (na primer presledke in tabulatorje), prebere besedo in doda ničelni znak. %7s potrebuje vsaj 8 elementov char. Večina pretvorb preskoči začetne bele znake; %c, %[ in %n jih ne preskočijo.
Nezdružljiva vrsta kazalca, številski rezultat, ki ga ni mogoče predstaviti v ciljnem objektu, ali kopiranje med prekrivajočimi se objekti povzroči nedefinirano vedenje. Širina polja ne preverja številskega obsega. V primeru sta oba rezultata uporabljena šele po preverjanju count == 2.
Primeri
#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;
}Rezultat
Ada: 42
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.