input_line()

Считать строку символов из файла

Прототип:

#include <stdio.h>
                                       
char * input_line( FILE *fp, 
                   char *buf, 
                   int bufsize );
                                       
extern int _input_line_max;

Аргументы:

fp
Файл, из которого необходимо прочитать строку.
buf
Буфер, в который функция сохранит прочитанную строку.
bufsize
Размер буфера в байтах.

Библиотека:

libc

Описание:

Функция input_line() получает строку из файла fp и сохраняет её в buf. Функция input_line() останавливает чтение символов, когда:

Также функция input_line() буферизует последние _input_line_max строк. Переменная _input_line_max определена в <stdio.h>. Перед первым вызовом input_line() можно изменить значение _input_line_max, значение по умолчанию - 20. Пока производится чтение, клавиши KEY_UP и KEY_DOWN могут быть использованы для перемещения к предыдущей и следующей строке соответственно в циклическом буфере с прочитанными ранее строками. Символ конца строки (\n) заменяется на нуль-терминатор при получении строки.

Возвращаемое значение:

≠NULL
Указатель на полученную строку.
NULL
Возникла ошибка или достигнут конец файла. Код ошибки записан в errno.

Примеры:

#include <stdlib.h>
#include <stdio.h>
                                       
#define SIZ 256
                                       
int _input_line_max;
                                       
int main( void )
{
    FILE    *fp;
    char    *p,
            buf[SIZ];
                                       
    fp              = stdin;    /* или другой поток */
    _input_line_max = 25;       /* установить перед первым вызовом */
                                       
    while ( (p = input_line( fp, buf, SIZ )) != NULL )
    {
        printf( "%s\n", buf );
        fflush( stdout );
    }
        
    return (EXIT_SUCCESS);
}

Классификация:

ЗОСРВ «Нейтрино»

Безопасность использования
Точка остановки потока
Да
Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Нет




Предыдущий раздел: Описание API системной библиотеки