Provided by: manpages-pl-dev_20060617-1_all bug

NAZWA
       clearenv - czyszczenie środowiska


SKŁADNIA
       #include <stdlib.h>

       int clearenv(void);


OPIS
       Funkcja  clearenv()  czyści środowisko z wszystkich par nazwa-wartość i
       nadaje zewnętrznej zmiennej environ wartość NULL.


WARTOŚĆ ZWRACANA
       Funkcja clearenv() zwraca zero przy pomyślnym  zakończeniu,  a  wartość
       niezerową w przypadku błędu.


DOSTĘPNOŚĆ
       Brak w libc4, libc5. W glibc począwszy od glibc 2.0.


ZGODNE Z
       Różne  warianty  Uniksa  (DGUX, HPUX, QNX, ...).  POSIX.9 (bindings for
       FORTRAN77).  POSIX.1-1996 nie akceptował clearenv() ani  putenv(),  ale
       zmienił zdanie i ujął te funkcje w wykazie w jednym z późniejszychwydań
       standardu (por. B.4.6.1). Jednakże, SUSv3  dodaje  jedynie  putenv()  a
       odrzuca clearenv().


UWAGI
       Używana   w   aplikacjach,  które  są  świadome  zagrożeń.  Jeśli  jest
       niedostępna, to przypisanie
                   environ = NULL;
       prawdopodobnie zrobi to samo.

       Na stronach podręcznika dla DGUX i Tru64 jest napisane:  Jeśli  environ
       zostało  zmodyfikowane  przez  cokolwiek  innego  niż funkcje putenv(),
       getenv() lub  clearenv(),  to  clearenv()  zwróci  błąd,  pozostawiając
       niezmienione środowisko procesu.


ZOBACZ TAKŻE
       getenv(3), putenv(3), setenv(3), unsetenv(3), environ(5)