GETLINE(3)

NOMBRE
getline, getdelim - entrada de cadena delimitada

SINOPSIS
#define _GNU_SOURCE
#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);

DESCRIPCIÓN
getline() lee una línea entera, almacenando la dirección del buffer que contiene el texto en *lineptr. Al final del buffer se coloca el valor null y además se incluye el carácter nueva línea si se encontró el delimitador nueva línea.

Si *lineptr es NULL, la rutina getline() reservará un buffer para contener la línea, que debe ser liberado por el programa de usuario. Alternativamente, antes de llamar a getline(), *lineptr puede contener un puntero a un buffer reservado via malloc() de tamaño *n bytes. Si el buffer no es lo suficientemente grande para almacenar la línea leída, getline() redimensiona el buffer para que quepa con realloc(), actualizando *lineptr y *n si es necesario. En cualquier caso, si la llamada tiene éxito, *lineptr y *n serán actualizados para reflejar la dirección del buffer y el tamaño respectivamente.

getdelim() funciona como getline(), salvo que se puede especificar otro delimitador de línea distinto de nueva línea en el argumento delimiter. Como con getline(), no se añade un carácter delimitador si no hay ninguno presente en la entrada antes de que se alcanze el fin del fichero.

VALOR DEVUELTO
En caso de éxito, getline() y getdelim() devuelven el número de caracteres leídos, incluyendo el carácter delimitador, pero sin incluir el carácter null del final. Este valor puede usarse para manejar los carácters null embebidos en la línea leída.

Ambas funciones devuelven -1 si fallan al leer una línea (incluyendo la condición de fin de fichero).

ERRORES

EINVAL
    Parámetros incorrectos (n o lineptr son NULL, o stream no es válido).

EJEMPLO
#define _GNU_SOURCE
#include <stdio.h>
#include <stdlib.h>

int main(void)
{
	FILE * fp;
	char * line = NULL;
	size_t len = 0;
	ssize_t read;
	fp = fopen("/etc/motd", "r");
	if (fp == NULL)
		exit(EXIT_FAILURE);
	while ((read = getline(&line, &len, fp)) != -1) {
		printf("Retrieved line of length %zu :\n", read);
		printf("%s", line);
	}
	if (line)
		free(line);
	return EXIT_SUCCESS;
}

CONFORME A
Tanto getline() como getdelim() son extensiones de GNU. Están disponibles desde libc 4.6.27.

VÉASE TAMBIÉN
read(2), fopen(3), fread(3), gets(3), fgets(3), scanf(3)