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

CKTIS / C

fgets — функция за поток в C23

`fgets(s, n, stream)` от `<stdio.h>` прочита най-много `n - 1` знака в масива `s` и спира след прочетен знак за нов ред или при край на файла. Прочетеният нов ред остава в масива, а функцията добавя `\0` след данните.

Версия: C23

Синтаксис

char *fgets(char * restrict s, int n, FILE * restrict stream);

fgets(s, n, stream) от <stdio.h> прочита най-много n - 1 знака в масива s и спира след прочетен знак за нов ред или при край на файла. Прочетеният нов ред остава в масива, а функцията добавя \0 след данните.

Примерът записва red\nblue в tmpfile() и вика fgets два пъти. 4 1 blue показва, че първият буфер има четири знака с \n, а вторият прочита последния ред без завършващ нов ред.

При успех връща s, а при грешка или EOF преди първия знак — null; различете причината с feof и ferror. Подайте положително n, което не надхвърля истинския капацитет или диапазона на int. Дълъг ред може да изисква няколко извиквания, а вграден байт \0 означава, че strlen не описва всички прочетени знаци.

Примери

#include <stdio.h>
#include <string.h>

int main(void) {
    FILE *stream = tmpfile();
    if (stream == NULL) return 1;
    if (fputs("red\nblue", stream) == EOF) { fclose(stream); return 1; }
    rewind(stream);
    char first[8];
    char second[8];
    if (fgets(first, sizeof first, stream) == NULL || fgets(second, sizeof second, stream) == NULL) {
        fclose(stream);
        return 1;
    }
    printf("%zu %d %s\n", strlen(first), strchr(first, '\n') != NULL, second);
    return fclose(stream) == 0 ? 0 : 1;
}

Резултат

4 1 blue

Примерът записва `red\nblue` в `tmpfile()` и вика `fgets` два пъти. `4 1 blue` показва, че първият буфер има четири знака с `\n`, а вторият прочита последния ред без завършващ нов ред.

Източници