getline(3)                 Library Functions Manual                 getline(3)

NAZWA
       getline, getdelim - wprowadzanie lancuchow rozgraniczonych

BIBLIOTEKA
       Standardowa biblioteka C (libc, -lc)

SKLADNIA
       #include <stdio.h>

       ssize_t getline(char **restrict lineptr, size_t *restrict n,
                       FILE *restrict stream);
       ssize_t getdelim(char **restrict lineptr, size_t *restrict n,
                       int delim, FILE *restrict stream);

   Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):

       getline(), getdelim():
           Od glibc 2.10:
               _POSIX_C_SOURCE >= 200809L
           Przed glibc 2.10:
               _GNU_SOURCE

OPIS
       getline() odczytuje cala linie ze strumienia stream, przechowujac adres
       bufora zawierajacego tekst w *lineptr. Bufor jest zakonczony znakiem
       NULL i zawiera znak nowej linii, jesli go napotkano.

       If *lineptr is set to NULL before the call, then getline()  will
       allocate a buffer for storing the line.  This buffer should be freed by
       the user program even if getline()  failed.

       Alternatywnie, przed wywolaniem getline() *lineptr moze zawierac
       wskaznik do bufora przydzielonego za pomoca malloc() o rozmiarze *n
       bajtow. Gdy rozmiar bufora nie jest wystarczajacy do umieszczenia w nim
       odczytanej linii, getline() rozszerzy go do odpowiedniego rozmiaru za
       pomoca realloc(), modyfikujac *lineptr i *n, jesli bedzie to potrzebne.

       W kazdym razie, po pomyslnym wywolaniu *lineptr i *n beda
       zaktualizowane tak, aby odzwierciedlic, odpowiednio, adres i rozmiar
       bufora.

       getdelim() dziala jak getline(), z tym wyjatkiem ze jako argument
       delimiter mozna podac ogranicznik linii inny niz znak nowej linii.
       Podobnie jak dla getline(), znak ogranicznika nie jest dodawany, gdy
       nie wystepowal w danych wejsciowych przed osiagnieciem konca pliku.

WARTOSC ZWRACANA
       On success, getline()  and getdelim()  return the number of characters
       read, including the delimiter character, but not including the
       terminating null byte ('\0').  This value can be used to handle
       embedded null bytes in the line read.

       Both functions return -1 on failure to read a line (including
       end-of-file condition).  In the event of a failure, errno is set to
       indicate the error.

       If *lineptr was set to NULL before the call, then the buffer should be
       freed by the user program even on failure.

BLEDY
       EINVAL Bledne wartosci parametrow (n lub lineptr rowne NULL lub
              nieprawidlowy stream).

       ENOMEM Nie powiodl sie przydzial pamieci dla bufora linii.

ATRYBUTY
       Informacje o pojeciach uzywanych w tym rozdziale mozna znalezc w
       podreczniku attributes(7).

       +---------------------------+--------------------------+---------------+
       |Interfejs                  | Atrybut                  | Wartosc       |
       +---------------------------+--------------------------+---------------+
       |getline(), getdelim()      | Bezpieczenstwo watkowe   | MT-bezpieczne |
       +---------------------------+--------------------------+---------------+
STANDARDY
       POSIX.1-2008.

HISTORIA
       GNU, POSIX.1-2008.

PRZYKLADY
       #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;

           if (argc != 2) {
               fprintf(stderr, "Usage: %s <file>\n", argv[0]);
               exit(EXIT_FAILURE);
           }

           stream = fopen(argv[1], "r");
           if (stream == NULL) {
               perror("fopen");
               exit(EXIT_FAILURE);
           }

           while ((nread = getline(&line, &len, stream)) != -1) {
               printf("Retrieved line of length %zd:\n", nread);
               fwrite(line, nread, 1, stdout);
           }

           free(line);
           fclose(stream);
           exit(EXIT_SUCCESS);
       }

ZOBACZ TAKZE
       read(2), fgets(3), fopen(3), fread(3), scanf(3)

TLUMACZENIE
       Autorami polskiego tlumaczenia niniejszej strony podrecznika sa:
       Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>, Robert Luberda
       <robert@debian.org> i Michal Kulach <michal.kulach@gmail.com>

       Niniejsze tlumaczenie jest wolna dokumentacja. Blizsze informacje o
       warunkach licencji mozna uzyskac zapoznajac sie z GNU General Public
       License w wersji 3 <https://www.gnu.org/licenses/gpl-3.0.html> lub
       nowszej. Nie przyjmuje sie ZADNEJ ODPOWIEDZIALNOSCI.

       Bledy w tlumaczeniu strony podrecznika prosimy zglaszac na adres listy
       dyskusyjnej <manpages-pl-list@lists.sourceforge.net>.

Linux man-pages 6.06       31 pazdziernika 2023 r.                  getline(3)