GNU
2019-03-06
Aliases: getdelim(3), getdelim(3), getdelim(3), getdelim(3), getdelim(3), getdelim(3), getdelim(3), getdelim(3), getdelim(3), getdelim(3)
man-pages-ru
Russian man pages from the Linux Documentation Project
manpages-dev
Manual pages about using GNU/Linux for development
man-pages
Linux kernel and C library user-space interface documentation
ИМЯ
getline, getdelim - разделяет входные данные на строки
ОБЗОР
#include <stdio.h>
ssize_t getline(char **lineptr, size_t *n, FILE *stream);
ssize_t getdelim(char **lineptr, size_t *n, int delim, FILE *stream);
Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):
getline(), getdelim():
Начиная с glibc 2.10: | |
_POSIX_C_SOURCE >= 200809L | |
До glibc 2.10: | |
_GNU_SOURCE |
ОПИСАНИЕ
Функция getline() считывает целую строку из stream, сохраняет адрес буфера с текстом в *lineptr. Буфер завершается null и включает символ новой строки, если был найден разделитель для новой строки.
Если *lineptr равно NULL и *n равно 0 перед вызовом, то getline() выделит буфер для хранения строки. Этот буфер должен быть высвобожден программой пользователя, даже если getline() завершилась с ошибкой.
Как альтернатива, перед вызовом getline(), *lineptr может содержать указатель на буфер, выделенный с помощью malloc(3) размером *n байтов. Если буфер недостаточно велик для размещения строки, то getline() изменяет размер буфера с помощью realloc(3), обновляя *lineptr и *n при необходимости.
В любом случае при успешном выполнении вызова *lineptr и *n будут содержать правильный адрес буфера и его размер, соответственно.
Функция getdelim() работает аналогично getline(), за исключением того, что в аргументе delimiter можно задать разделитель строки, отличный от символа новой строки. Как и с getline(), символ-разделитель не добавляется, если его было в входных данных до конца файла.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При успешном выполнении getline() и getdelim() возвращают количество считанных символов, включая символ разделителя, но не включая завершающий байт null (\(aq\0\(aq). Это значение может использоваться для обработки встроенных байтов null при чтении строки.
Обе функции возвращают -1 при ошибках чтения строки (включая условие достижения конца файла). При возникновении ошибки в errno сохраняется её значение.
ОШИБКИ
EINVAL | Некорректные параметры (n или lineptr равно NULL или неправильное значение stream). |
ENOMEM | Не удалось выделить или переместить строчный буфер. |
АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение |
getline(), getdelim() | Безвредность в нитях | MT-Safe |
СООТВЕТСТВИЕ СТАНДАРТАМ
Изначально, функции getline() и getdelim() были расширениями GNU. Позднее они были стандартизированы в POSIX.1-2008.
ПРИМЕР
#define _GNU_SOURCE #include <stdio.h> #include <stdlib.h>
int main(int argc, char *argv[]) {
FILE *stream;
char *line = NULL;
size_t len = 0;
ssize_t nread;
FILE *stream;
char *line = NULL;
size_t len = 0;
ssize_t nread;
if (argc != 2) {
fprintf(stderr, "Использование: %s <файл>\n", argv[0]);
exit(EXIT_FAILURE);
}
fprintf(stderr, "Использование: %s <файл>\n", argv[0]);
exit(EXIT_FAILURE);
}
stream = fopen(argv[1], "r");
if (stream == NULL) {
perror("fopen");
exit(EXIT_FAILURE);
}
if (stream == NULL) {
perror("fopen");
exit(EXIT_FAILURE);
}
while ((nread = getline(&line, &len, stream)) != -1) {
printf("Retrieved line of length %zu:\n", nread);
fwrite(line, nread, 1, stdout);
}
printf("Retrieved line of length %zu:\n", nread);
fwrite(line, nread, 1, stdout);
}
free(line);
fclose(stream);
exit(EXIT_SUCCESS); }
fclose(stream);
exit(EXIT_SUCCESS); }