Стандартная библиотека C -<stdio.h>

Введение

stdio .hЭтот заголовочный файл определяет три типа переменных, ряд макросов и различные функции для выполнения ввода и вывода.

<stdio.h>Это заголовочный файл в стандартной библиотеке C, который определяет различные функции и типы для работы с файлами и стандартными потоками ввода-вывода.

Переменные библиотеки

Ниже перечислены типы переменных, определённые в заголовочном файле stdio.h:

Порядковый номерПеременные и описание
1size_t
Это беззнаковый целочисленный тип, который являетсяsizeofрезультатом ключевого слова, указывающим размер объекта.
2FILE
Тип файлового потока, тип объекта, подходящий для хранения информации о файловом потоке.
3fpos_t
Тип позиции файла, тип объекта, подходящий для хранения любой позиции в файле.

Библиотечные макросы

Ниже приведены макросы, определённые в заголовочном файле stdio.h:

Порядковый номерМакросы и описание
1NULL
Этот макрос является значением константы нулевого указателя.
2_IOFBF、_IOLBFи _IONBF
Эти макросы раскрываются в целочисленные константные выражения с определёнными значениями и подходят для третьего параметра функцииsetvbuf.
3BUFSIZ
Этот макрос — целое число, представляющее размер буфера, используемый функциейsetbuf.
4EOF
Этот макрос — отрицательное целое число, указывающее, что достигнут конец файла.
5FOPEN_MAX
Этот макрос — целое число, представляющее количество файлов, которые система может открыть одновременно.
6FILENAME_MAX
Этот макрос — целое число, представляющее максимальную длину имени файла, которое может хранить массив символов. Если реализация не имеет ограничений, это значение должно быть рекомендуемым максимумом.
7L_tmpnam
Этот макрос — целое число, представляющее максимальную длину массива символов, который может хранить временное имя файла, созданное функцией tmpnam.
8SEEK_CUR, SEEK_ENDиSEEK_SET
Эти макросы вfseekиспользуются в функциях для позиционирования в разных местах внутри файла.
9TMP_MAX
Этот макрос — максимальное количество уникальных имён файлов, которые может сгенерировать функция tmpnam.
10stderr, stdinиstdout
Эти макросы — указатели на тип FILE, соответствующие стандартному потоку ошибок, стандартному потоку ввода и стандартному потоку вывода соответственно.

Библиотечные функции

Ниже перечислены функции, определённые в заголовочном файле stdio.h:

Чтобы лучше понять функции, изучайте их в следующей последовательности, поскольку файл, созданный в первой функции, будет использоваться в последующих функциях.
Порядковый номерФункции и описание
1int fclose(FILE *stream)
Закрывает поток stream. Сбрасывает все буферы.
2void clearerr(FILE *stream)
Очищает индикаторы конца файла и ошибки для заданного потока stream.
3int feof(FILE *stream)
Проверяет индикатор конца файла для заданного потока stream.
4int ferror(FILE *stream)
Проверяет индикатор ошибки для заданного потока stream.
5int fflush(FILE *stream)
Сбрасывает выходной буфер потока stream.
6int fgetpos(FILE *stream, fpos_t *pos)
Получает текущую позицию в файле потока stream и записывает её в pos.
7FILE *fopen(const char *filename, const char *mode)
Открывает файл, на который указывает filename, используя заданный режим mode.
8size_t fread(void *ptr, size_t size, size_t nmemb, FILE *stream)
Читает данные из заданного потока stream в массив, на который указывает ptr.
9FILE *freopen(const char *filename, const char *mode, FILE *stream)
Связывает новое имя файла filename с заданным открытым потоком stream, при этом закрывая старый файл в потоке.
10int fseek(FILE *stream, long int offset, int whence)
Устанавливает позицию в файле для потока stream в заданное смещение offset, параметрoffsetозначает, что от заданногоwhenceзадается количество байтов для поиска позиции.
11int fsetpos(FILE *stream, const fpos_t *pos)
Устанавливает позицию файла для заданного потока stream в заданную позицию. Параметрpos— это позиция, возвращаемая функцией fgetpos.
12long int ftell(FILE *stream)
Возвращает текущую позицию файла для заданного потока stream.
13size_t fwrite(const void *ptr, size_t size, size_t nmemb, FILE *stream)
Записывает данные из массива, на который указывает ptr, в заданный поток stream.
14int remove(const char *filename)
Удаляет заданное имя файла filename, после чего к нему больше нельзя получить доступ.
15int rename(const char *old_filename, const char *new_filename)
Изменяет имя файла, на которое указывает old_filename, на new_filename.
16void rewind(FILE *stream)
Устанавливает позицию в файле заданного потока stream на начало файла.
17void setbuf(FILE *stream, char *buffer)
Определяет, как должен буферизоваться поток stream.
18int setvbuf(FILE *stream, char *buffer, int mode, size_t size)
Ещё одна функция, которая определяет, как должен буферизоваться поток stream.
19FILE *tmpfile(void)
Создаёт временный файл в двоичном режиме обновления (wb+).
20char *tmpnam(char *str)
Генерирует и возвращает допустимое временное имя файла, которое ранее не существовало.
21int fprintf(FILE *stream, const char *format, ...)
Отправляет форматированный вывод в поток stream.
22int printf(const char *format, ...)
Отправляет форматированный вывод в стандартный вывод stdout.
23int sprintf(char *str, const char *format, ...)
Отправляет форматированный вывод в строку.
24int vfprintf(FILE *stream, const char *format, va_list arg)
Отправляет форматированный вывод в поток stream, используя список аргументов.
25int vprintf(const char *format, va_list arg)
Отправляет форматированный вывод в стандартный вывод stdout, используя список аргументов.
26int vsprintf(char *str, const char *format, va_list arg)
Отправляет форматированный вывод в строку, используя список аргументов.
27int fscanf(FILE *stream, const char *format, ...)
Считывает форматированный ввод из потока stream.
28int scanf(const char *format, ...)
Считывает форматированный ввод из стандартного ввода stdin.
29int sscanf(const char *str, const char *format, ...)
Считывает форматированный ввод из строки.
30int fgetc(FILE *stream)
Получает следующий символ (беззнаковый символ) из указанного потока stream и перемещает индикатор позиции вперёд.
31char *fgets(char *str, int n, FILE *stream)
Считывает строку из указанного потока stream и сохраняет её в строке, на которую указывает str. Когда(n-1)символов прочитано, или когда прочитан символ новой строки, или когда достигнут конец файла, чтение останавливается, в зависимости от того, что наступит раньше.
32int fputc(int char, FILE *stream)
Записывает символ (беззнаковый символ), указанный аргументом char, в указанный поток stream и перемещает индикатор позиции вперёд.
33int fputs(const char *str, FILE *stream)
Записывает строку в указанный поток stream, исключая нулевой символ.
34int getc(FILE *stream)
Получает следующий символ (беззнаковый символ) из указанного потока stream и перемещает индикатор позиции вперёд.
35int getchar(void)
Считывает символ (беззнаковый символ) из стандартного ввода stdin.
36char *gets(char *str)
Считывает строку из стандартного ввода stdin и сохраняет её в строке, на которую указывает str. Останавливается при чтении символа новой строки или при достижении конца файла, в зависимости от ситуации.
37int putc(int char, FILE *stream)
Записывает символ (беззнаковый символ), указанный аргументом char, в указанный поток stream и перемещает индикатор позиции вперёд.
38int putchar(int char)
Записывает символ (беззнаковый символ), указанный аргументом char, в стандартный вывод stdout.
39int puts(const char *str)
Записывает строку в стандартный вывод stdout, до нулевого символа, не включая его. К выводу добавляется символ новой строки.
40int ungetc(int char, FILE *stream)
Возвращает символ char (беззнаковый символ) обратно в указанный поток stream, чтобы он стал следующим символом для чтения.
41void perror(const char *str)
Выводит описательное сообщение об ошибке в стандартный поток ошибок stderr. Сначала выводится строка str, затем двоеточие, а затем пробел.
42int snprintf(char *str, size_t size, const char *format, ...)
Форматирует строку в str.

Пример

Ниже приведены некоторые примеры использования<stdio.h>Примеры функций в:

Открытие и закрытие файлов:

Пример

#include <stdio.h>

int main() {
    FILE *file = fopen("example.txt", "r");
    if (file == NULL) {
        perror("Ошибка файла");
        return 1;
    }
    // Выполнить файловые операции
    fclose(file);
    return 0;
}

Чтение содержимого файла:

Пример

#include <stdio.h>

int main() {
    FILE *file = fopen("example.txt", "r");
    if (file == NULL) {
        perror("Ошибка файла");
        return 1;
    }

    char buffer[256];
    while (fgets(buffer, sizeof(buffer), file) != NULL) {
        printf("%s", buffer);
    }

    fclose(file);
    return 0;
}
Запись содержимого файла:

Пример

#include <stdio.h>

int main() {
    FILE *file = fopen("example.txt", "w");
    if (file == NULL) {
        perror("Ошибка файла");
        return 1;
    }

    fprintf(file, "Hello, World!"\n");

    fclose(file);
    return 0;
}

Примечания

  • ИспользованиеfopenПосле открытия файла обязательно используйтеfcloseЗакрывает файл, чтобы избежать утечек файловых ресурсов.
  • ИспользованиеfgetsПри чтении строк обязательно обращайте внимание на размер буфера, чтобы избежать переполнения буфера.
  • Использованиеprintf、scanfПри использовании функций обязательно обращайте внимание на правильность строки формата, чтобы избежать неопределённого поведения.

Понимая и используя<stdio.h>Предоставленные функции позволяют удобно выполнять операции с файлами и стандартным вводом/выводом, а также писать более надёжные и гибкие программы на C.

Другие расширения