NAZWA

       alloca - przydzielanie pamięci, która jest automatycznie zwalniana

SKŁADNIA

       #include <alloca.h>

       void *alloca(size_t rozmiar);

OPIS

       Funkcja  alloca()  przydziela  rozmiar  bajtów  pamięci na ramce stosu procedury, z której
       została wywołana. Ta  tymczasowa  przestrzeń  jest  automatycznie  zwalniana  po  powrocie
       funkcji, która wywołuje alloca() do miejsca wywołania.

WARTOŚĆ ZWRACANA

       Funkcja  alloca()  zwraca  wskaźnik  do  początku przydzielonej pamięci. Gdy przydzielenie
       pamięci spowoduje przepełnienie stosu, zachowanie programu nie jest określone.

ATRYBUTY

       Informacje  o  pojęciach  używanych  w  tym  rozdziale   można   znaleźć   w   podręczniku
       attributes(7).

       ┌──────────┬────────────────────────┬─────────┐
       │Interfejs │ Atrybut                │ Wartość │
       ├──────────┼────────────────────────┼─────────┤
       │alloca()  │ Bezpieczeństwo wątkowe │ MT-Safe │
       └──────────┴────────────────────────┴─────────┘

ZGODNE Z

       Funkcja nie występuje w POSIX.1.

       Istnieją dowody, że funkcja alloca() występowała w 32V, PWB, PWB.2, 3BSD i 4BSD. W BSD 4.3
       istnieje dla niej strona podręcznika. Linux korzysta z wersji GNU.

UWAGI

       Funkcja alloca() zależy od maszyny i kompilatora. W  przypadku  niektórych  aplikacji  jej
       użycie  może  poprawić  wydajność  w  porównaniu  do użycia malloc(3) i free(3). W pewnych
       przypadkach może także uprościć zwalnianie pamięci w aplikacjach, używających   longjmp(3)
       lub siglongjmp(3). W pozostałych przypadkach użycie tej funkcji nie jest zalecane.

       Ponieważ  przestrzeń  alokowana  przez  alloca() jest przydzielana z przestrzeni stosu, to
       przestrzeń ta jest automatycznie zwalniana, jeśli nastąpi przeskoczenie powrotu z  funkcji
       przez wywołanie longjmp(3) lub siglongjmp(3).

       Pamięci przydzielonej przez alloca() nie można zwalniać za pomocą free(3)!

   Uwagi dotyczące wersji GNU
       Zwyczajowo  gcc(1)  zamienia  wywołania  alloca na kod wplatany (inlined). Nie będzie tego
       robił, gdy podana zostanie jedna z opcji: -ansi, -std=c89, -std=c99  lub  -std=c11  i  nie
       jest  dołączony  plik  nagłówkowy  <alloca.h>.  W  przeciwnym wypadku (bez opcji -ansi lub
       -std=c*) wersja glibc pliku <stdlib.h> dołącza  plik  <alloca.h>  zawierający  następujące
       linie:

           #ifdef  __GNUC__
           #define alloca(size)   __builtin_alloca (size)
           #endif

       co ma niepożądane konsekwencje, gdy ma się własną wersję tej funkcji.

       To,  że  kod tej funkcji jest wplatany, powoduje niemożliwość pobrania jej adresu, jak też
       niemożliwość zmiany jej zachowania poprzez konsolidację z inną biblioteką,

       Kod wplatany często składa się z pojedynczej instrukcji modyfikującej wskaźnik stosu, lecz
       nie  sprawdzającej  jego  przepełnienia.   Zatem  nigdy  nie  jest  zwracana  wartość NULL
       świadcząca o błędzie.

BŁĘDY

       Nie ma żadnego powiadomienia w  sytuacji,  gdy  nie  można  powiększyć  przestrzeni  stosu
       (Jednakże  po  niepoprawnej  alokacji,  program najprawdopodobniej otrzyma sygnał SIGSEGV,
       jeśli spróbuje uzyskać dostęp do niezaalokowanej przestrzeni).

       W wielu systemach alloca() nie może być używana w obrębie  listy  argumentów  w  wywołaniu
       funkcji,  gdyż  zarezerwowana  przez  alloca()  przestrzeń  stosu  znalazłaby się w środku
       przestrzeni stosu przeznaczonej na argumenty funkcji.

ZOBACZ TAKŻE

       brk(2), longjmp(3), malloc(3)

O STRONIE

       Angielska wersja tej strony  pochodzi  z  wydania  4.07  projektu  Linux  man-pages.  Opis
       projektu,  informacje  dotyczące  zgłaszania  błędów oraz najnowszą wersję oryginału można
       znaleźć pod adresem https://www.kernel.org/doc/man-pages/.

TŁUMACZENIE

       Autorami polskiego tłumaczenia niniejszej strony podręcznika man  są:  Adam  Byrtek  (PTM)
       <abyrtek@priv.onet.pl>, Andrzej Krzysztofowicz (PTM) <ankry@mif.pg.gda.pl>, Robert Luberda
       <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>.

       Polskie tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów  na
       stronie   http://sourceforge.net/projects/manpages-pl/.   Jest   zgodne   z  wersją   4.07
       oryginału.