Cher: Created page with 'Навигация: Главная страница/Система ejudge/Проверяющие программы/libchecker/[[Libchecker:Функци…'

2010-07-04T19:54:39Z

Created page with 'Навигация: Главная страница/Система ejudge/Проверяющие программы/libchecker/[[Libchecker:Функци…'

New page

Навигация: [[Main Page|Главная страница]]/[[Система ejudge]]/[[Проверяющие программы]]/[[libchecker]]/[[Libchecker:Функции|Функции]]/[[Libchecker:Чтение файла как текста|Чтение файла как текста]]/<tt>[[Libchecker:checker_read_line_ex|checker_read_line_ex]]</tt>

Функция <tt>checker_read_line_ex</tt> — чтение одной строки текста из [[текстовый файл|текстового файла]].

int
checker_read_line_ex(
FILE *f,
[[libchecker:checker_error_func_t|checker_error_func_t]] error_func,
const char *name,
int eof_error_flag,
char **out_str);

Функция считывает одну строку текста из файла <tt>f</tt> в память.
Параметр <tt>name</tt> — это дополнительный пояснительный текст, который будет выводиться в случае ошибки. В частности, этот текст может задавать название считываемого из файла параметра (например, <tt>"имя узла графа"</tt>).
Параметр <tt>eof_error_flag</tt> определяет, должна ли диагностироваться ошибка в случае, если выполняется попытка чтения строки после конца файла.
Если параметр <tt>eof_error_flag</tt> равен 0, то при попытке чтения после конца файла функция просто вернет значение -1.
Если же этот параметр имеет ненулевое значение, то в случае достижения конца файла будет вызвана функция вывода сообщения об ошибке, переданная в параметре <tt>error_func</tt>.

Функция предназначена для работы с текстовыми файлами. Если при чтении строки в файле был считан символ, который не может находиться в текстовом файле, вызывается функция вывода сообщения об ошибке, переданная в параметре <tt>error_func</tt>.

В переменную, на которую указывает параметр <tt>out_str</tt>, будет записана считанная строка. Строка дополняется нулевым байтом. Пробельные символы (включая \n) из конца строки не удаляются. Память для содержимого строки выделяется на куче с помощью функций <tt>[[libchecker:xmalloc|xmalloc]]</tt> и <tt>[[libchecker:xrealloc|xrealloc]]</tt>.

Если при чтении произошла ошибка ввода, программа завершается, и диагностируется [[внутренняя ошибка проверки]]. Для этого используется функция <tt>[[libchecker:fatal_CF|fatal_CF]]</tt>.

Функция возвращает длину считанной строки, либо значение -1, если был достигнут конец файла, и параметр <tt>eof_error_flag</tt> равен 0.

Libchecker:checker read line ex - Revision history

Cher: Created page with 'Навигация: Главная страница/Система ejudge/Проверяющие программы/libchecker/[[Libchecker:Функци…'