Стандартная библиотека C -<stdio.h>
Введение
stdio .hЭтот заголовочный файл определяет три типа переменных, ряд макросов и различные функции для выполнения ввода и вывода.
<stdio.h>Это заголовочный файл в стандартной библиотеке C, который определяет различные функции и типы для работы с файлами и стандартными потоками ввода-вывода.
Переменные библиотеки
Ниже перечислены типы переменных, определённые в заголовочном файле stdio.h:
| Порядковый номер | Переменные и описание |
|---|---|
| 1 | size_t Это беззнаковый целочисленный тип, который являетсяsizeofрезультатом ключевого слова, указывающим размер объекта. |
| 2 | FILE Тип файлового потока, тип объекта, подходящий для хранения информации о файловом потоке. |
| 3 | fpos_t Тип позиции файла, тип объекта, подходящий для хранения любой позиции в файле. |
Библиотечные макросы
Ниже приведены макросы, определённые в заголовочном файле stdio.h:
| Порядковый номер | Макросы и описание |
|---|---|
| 1 | NULL Этот макрос является значением константы нулевого указателя. |
| 2 | _IOFBF、_IOLBFи _IONBF Эти макросы раскрываются в целочисленные константные выражения с определёнными значениями и подходят для третьего параметра функцииsetvbuf. |
| 3 | BUFSIZ Этот макрос — целое число, представляющее размер буфера, используемый функциейsetbuf. |
| 4 | EOF Этот макрос — отрицательное целое число, указывающее, что достигнут конец файла. |
| 5 | FOPEN_MAX Этот макрос — целое число, представляющее количество файлов, которые система может открыть одновременно. |
| 6 | FILENAME_MAX Этот макрос — целое число, представляющее максимальную длину имени файла, которое может хранить массив символов. Если реализация не имеет ограничений, это значение должно быть рекомендуемым максимумом. |
| 7 | L_tmpnam Этот макрос — целое число, представляющее максимальную длину массива символов, который может хранить временное имя файла, созданное функцией tmpnam. |
| 8 | SEEK_CUR, SEEK_ENDиSEEK_SET Эти макросы вfseekиспользуются в функциях для позиционирования в разных местах внутри файла. |
| 9 | TMP_MAX Этот макрос — максимальное количество уникальных имён файлов, которые может сгенерировать функция tmpnam. |
| 10 | stderr, stdinиstdout Эти макросы — указатели на тип FILE, соответствующие стандартному потоку ошибок, стандартному потоку ввода и стандартному потоку вывода соответственно. |
Библиотечные функции
Ниже перечислены функции, определённые в заголовочном файле stdio.h:
Чтобы лучше понять функции, изучайте их в следующей последовательности, поскольку файл, созданный в первой функции, будет использоваться в последующих функциях.
| Порядковый номер | Функции и описание |
|---|---|
| 1 | int fclose(FILE *stream) Закрывает поток stream. Сбрасывает все буферы. |
| 2 | void clearerr(FILE *stream) Очищает индикаторы конца файла и ошибки для заданного потока stream. |
| 3 | int feof(FILE *stream) Проверяет индикатор конца файла для заданного потока stream. |
| 4 | int ferror(FILE *stream) Проверяет индикатор ошибки для заданного потока stream. |
| 5 | int fflush(FILE *stream) Сбрасывает выходной буфер потока stream. |
| 6 | int fgetpos(FILE *stream, fpos_t *pos) Получает текущую позицию в файле потока stream и записывает её в pos. |
| 7 | FILE *fopen(const char *filename, const char *mode) Открывает файл, на который указывает filename, используя заданный режим mode. |
| 8 | size_t fread(void *ptr, size_t size, size_t nmemb, FILE *stream) Читает данные из заданного потока stream в массив, на который указывает ptr. |
| 9 | FILE *freopen(const char *filename, const char *mode, FILE *stream) Связывает новое имя файла filename с заданным открытым потоком stream, при этом закрывая старый файл в потоке. |
| 10 | int fseek(FILE *stream, long int offset, int whence) Устанавливает позицию в файле для потока stream в заданное смещение offset, параметрoffsetозначает, что от заданногоwhenceзадается количество байтов для поиска позиции. |
| 11 | int fsetpos(FILE *stream, const fpos_t *pos) Устанавливает позицию файла для заданного потока stream в заданную позицию. Параметрpos— это позиция, возвращаемая функцией fgetpos. |
| 12 | long int ftell(FILE *stream) Возвращает текущую позицию файла для заданного потока stream. |
| 13 | size_t fwrite(const void *ptr, size_t size, size_t nmemb, FILE *stream) Записывает данные из массива, на который указывает ptr, в заданный поток stream. |
| 14 | int remove(const char *filename) Удаляет заданное имя файла filename, после чего к нему больше нельзя получить доступ. |
| 15 | int rename(const char *old_filename, const char *new_filename) Изменяет имя файла, на которое указывает old_filename, на new_filename. |
| 16 | void rewind(FILE *stream) Устанавливает позицию в файле заданного потока stream на начало файла. |
| 17 | void setbuf(FILE *stream, char *buffer) Определяет, как должен буферизоваться поток stream. |
| 18 | int setvbuf(FILE *stream, char *buffer, int mode, size_t size) Ещё одна функция, которая определяет, как должен буферизоваться поток stream. |
| 19 | FILE *tmpfile(void) Создаёт временный файл в двоичном режиме обновления (wb+). |
| 20 | char *tmpnam(char *str) Генерирует и возвращает допустимое временное имя файла, которое ранее не существовало. |
| 21 | int fprintf(FILE *stream, const char *format, ...) Отправляет форматированный вывод в поток stream. |
| 22 | int printf(const char *format, ...) Отправляет форматированный вывод в стандартный вывод stdout. |
| 23 | int sprintf(char *str, const char *format, ...) Отправляет форматированный вывод в строку. |
| 24 | int vfprintf(FILE *stream, const char *format, va_list arg) Отправляет форматированный вывод в поток stream, используя список аргументов. |
| 25 | int vprintf(const char *format, va_list arg) Отправляет форматированный вывод в стандартный вывод stdout, используя список аргументов. |
| 26 | int vsprintf(char *str, const char *format, va_list arg) Отправляет форматированный вывод в строку, используя список аргументов. |
| 27 | int fscanf(FILE *stream, const char *format, ...) Считывает форматированный ввод из потока stream. |
| 28 | int scanf(const char *format, ...) Считывает форматированный ввод из стандартного ввода stdin. |
| 29 | int sscanf(const char *str, const char *format, ...) Считывает форматированный ввод из строки. |
| 30 | int fgetc(FILE *stream) Получает следующий символ (беззнаковый символ) из указанного потока stream и перемещает индикатор позиции вперёд. |
| 31 | char *fgets(char *str, int n, FILE *stream) Считывает строку из указанного потока stream и сохраняет её в строке, на которую указывает str. Когда(n-1)символов прочитано, или когда прочитан символ новой строки, или когда достигнут конец файла, чтение останавливается, в зависимости от того, что наступит раньше. |
| 32 | int fputc(int char, FILE *stream) Записывает символ (беззнаковый символ), указанный аргументом char, в указанный поток stream и перемещает индикатор позиции вперёд. |
| 33 | int fputs(const char *str, FILE *stream) Записывает строку в указанный поток stream, исключая нулевой символ. |
| 34 | int getc(FILE *stream) Получает следующий символ (беззнаковый символ) из указанного потока stream и перемещает индикатор позиции вперёд. |
| 35 | int getchar(void) Считывает символ (беззнаковый символ) из стандартного ввода stdin. |
| 36 | char *gets(char *str) Считывает строку из стандартного ввода stdin и сохраняет её в строке, на которую указывает str. Останавливается при чтении символа новой строки или при достижении конца файла, в зависимости от ситуации. |
| 37 | int putc(int char, FILE *stream) Записывает символ (беззнаковый символ), указанный аргументом char, в указанный поток stream и перемещает индикатор позиции вперёд. |
| 38 | int putchar(int char) Записывает символ (беззнаковый символ), указанный аргументом char, в стандартный вывод stdout. |
| 39 | int puts(const char *str) Записывает строку в стандартный вывод stdout, до нулевого символа, не включая его. К выводу добавляется символ новой строки. |
| 40 | int ungetc(int char, FILE *stream) Возвращает символ char (беззнаковый символ) обратно в указанный поток stream, чтобы он стал следующим символом для чтения. |
| 41 | void perror(const char *str) Выводит описательное сообщение об ошибке в стандартный поток ошибок stderr. Сначала выводится строка str, затем двоеточие, а затем пробел. |
| 42 | int snprintf(char *str, size_t size, const char *format, ...) Форматирует строку в str. |
Пример
Ниже приведены некоторые примеры использования<stdio.h>Примеры функций в:
Открытие и закрытие файлов:
Пример
int main() {
FILE *file = fopen("example.txt", "r");
if (file == NULL) {
perror("Ошибка файла");
return 1;
}
// Выполнить файловые операции
fclose(file);
return 0;
}
Чтение содержимого файла:
Пример
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;
}
Пример
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.