CKTIS / C
sscanf — čítanie formátovaných údajov z reťazca
sscanf z <stdio.h> číta údaje z reťazca ukončeného nulovým znakom podľa formátu. Výsledky ukladá prostredníctvom ukazovateľov a vracia počet úspešných priradení (bez započítania `%n`), nie počet prečítaných znakov.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdio.h>
int sscanf(const char * restrict s, const char * restrict format, ...);sscanf funguje ako fscanf, ale číta reťazec namiesto prúdu. Formát opisuje konverzie a požadované doslovné znaky. %d vyžaduje int *; použite &age. Pri poli name odovzdajte samotné name.
Pred použitím údajov skontrolujte návratovú hodnotu: udáva počet úspešných priradení a môže byť menšia, než sa očakáva, alebo rovná 0. Direktíva %n uloží počet doteraz prečítaných znakov, ale nezvyšuje návratovú hodnotu. EOF označuje chybu vstupu pred dokončením prvej konverzie. Úspešné priradenia nezaručujú, že sa spotreboval celý reťazec.
%s preskočí úvodné biele znaky, načíta slovo a pridá nulový znak. %7s potrebuje aspoň 8 prvkov char. Väčšina konverzií preskočí úvodné biele znaky; %c, %[ a %n to nerobia.
Nekompatibilný typ ukazovateľa, číselný výsledok, ktorý nemožno reprezentovať v cieľovom objekte, alebo kopírovanie medzi prekrývajúcimi sa objektmi spôsobuje nedefinované správanie. Šírka poľa nekontroluje číselný rozsah. V príklade sa oba výsledky použijú až po kontrole count == 2.
Prí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ýsledok
Ada: 42
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.