CKTIS / C
sscanf — čitanje formatiranih podataka iz niza
sscanf iz <stdio.h> čita podatke iz niza završenog nul-znakom prema formatu. Rezultate pohranjuje putem pokazivača i vraća broj uspješnih dodjela (ne računajući `%n`), a ne broj pročitanih znakova.
Verzija: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdio.h>
int sscanf(const char * restrict s, const char * restrict format, ...);sscanf radi poput fscanf, ali čita niz umjesto toka. Format opisuje konverzije i potrebne doslovne znakove. %d zahtijeva int *; upotrijebite &age. Za polje name proslijedite samo name.
Provjerite povratnu vrijednost prije upotrebe podataka: ona označava broj uspješnih dodjela i može biti manja od očekivane ili jednaka 0. Direktiva %n pohranjuje broj dotad pročitanih znakova, ali ne povećava povratnu vrijednost. EOF označava pogrešku pri unosu prije završetka prve konverzije. Uspješne dodjele ne jamče da je cijeli niz potrošen.
%s preskače početne bjeline, čita riječ i dodaje nul-znak. %7s treba najmanje 8 elemenata char. Većina konverzija preskače početne bjeline; %c, %[ i %n to ne čine.
Nekompatibilna vrsta pokazivača, brojčani rezultat koji se ne može prikazati u odredišnom objektu ili kopiranje između preklapajućih objekata uzrokuje nedefinirano ponašanje. Širina polja ne provjerava brojčani raspon. U primjeru se oba rezultata upotrebljavaju tek nakon provjere count == 2.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.