Linux Certif

Toute la documentation sur la certification Linux LPI

clearenv

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)