База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

sscanf — четене на форматирани данни от низ

sscanf от <stdio.h> чете данни от низ, завършващ с нулев знак, според зададен формат. Записва резултатите чрез указатели и връща броя на успешните присвоявания (без да брои `%n`), а не броя на прочетените знаци.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

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

sscanf работи като fscanf, но чете низ вместо поток. Форматът описва преобразуванията и необходимите буквални знаци. %d изисква int *; използвайте &age. За масива name подайте самия name.

Проверете върнатата стойност, преди да използвате данните: тя отчита успешните присвоявания и може да е по-малка от очакваното или равна на 0. Директивата %n записва броя на прочетените дотогава знаци, но не увеличава върнатата стойност. EOF показва грешка при входа, преди да завърши първото преобразуване. Успешните присвоявания не гарантират, че целият низ е бил изразходван.

%s пропуска началните празни знаци, прочита дума и добавя нулев знак. %7s изисква поне 8 елемента char. Повечето преобразувания пропускат началните празни знаци; %c, %[ и %n не го правят.

Несъвместим тип указател, числов резултат, който не може да се представи в целевия обект, или копиране между припокриващи се обекти води до неопределено поведение. Ширината на полето не проверява числовия обхват. В примера и двата резултата се използват едва след проверката count == 2.

Примери

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

Резултат

Ada: 42

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници