table of contents
GETLINE(3) | Manuel du programmeur Linux | GETLINE(3) |
NOM¶
getline, getdelim - Saisie de chaîne délimitéeSYNOPSIS¶
#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);
Exigences de macros de test de fonctionnalités pour la glibc (consultez feature_test_macros(7)) :
- Depuis la glibc 2.10 :
- _POSIX_C_SOURCE >= 200809L || _XOPEN_SOURCE >= 700
- Avant la glibc 2.10 :
- _GNU_SOURCE
DESCRIPTION¶
getline() lit une ligne entière dans stream et stocke l'adresse du tampon contenant le texte dans *lineptr. Le tampon se termine par un caractère nul et inclut le caractère saut-de-ligne, si un tel séparateur a été trouvé.Quoi qu'il en soit, en cas de succès, *lineptr et *n seront mis à jour afin de rendre compte respectivement de l'adresse et de la taille du tampon.
VALEUR RENVOYÉE¶
En cas de succès, getline() et getdelim() renvoient le nombre de caractères lus, séparateur inclus, mais sans compter l'octet nul final. Cette valeur peut être utilisée afin de traiter les octets nuls insérés dans la ligne lue.ERREURS¶
- EINVAL
- Paramètres erronés (n ou lineptr valent NULL, ou bien stream n'est pas valide).
VERSIONS¶
Ces fonctions sont présentes depuis la libc 4.6.27.CONFORMITɶ
getline() tout comme getdelim() sont des extensions GNU. Elles ont été standardisées dans POSIX.1-2008.EXEMPLE¶
#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("Réception d'une ligne de longueur %zu :\n", read); printf("%s", line); } free(line); exit(EXIT_SUCCESS); }
VOIR AUSSI¶
read(2), fgets(3), fopen(3), fread(3), gets(3), scanf(3)COLOPHON¶
Cette page fait partie de la publication 3.44 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse <http://www.kernel.org/doc/man-pages/>.TRADUCTION¶
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>. Stéphan Rafin (2002), Alain Portal <http://manpagesfr.free.fr/> (2006). Florentin Duneau et l'équipe francophone de traduction de Debian (2006-2009). Veuillez signaler toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le paquet manpages-fr. Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C <section> <page_de_man> ».12 juin 2010 | GNU |