unsetenv(3c) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

unsetenv(3c)

unsetenv(3C)             Standard C Library Functions             unsetenv(3C)

NAME
       unsetenv - remove an environment variable

SYNOPSIS
       #include <stdlib.h>

       int unsetenv(const char *name);

DESCRIPTION
       The unsetenv() function removes all instaces of an environment variable
       from  the  environment of the calling process. The name argument points
       to a string that is the name of the variable to be removed.  The  named
       variable  cannot  contain  an '=' character. If the named variable does
       not exist in the current environment, the environment is unchanged  and
       the function is considered to have completed successfully.


       If the application modifies environ or the pointers to which it points,
       the  behavior  of  unsetenv() is undefined. The unsetenv() function up‐
       dates the list of pointers to which environ points.

RETURN VALUES
       Upon successful completion, 0 is returned. Otherwise, -1  is  returned,
       errno set to indicate the error, and the environment is left unchanged.

ERRORS
       The unsetenv() function will fail if:

       EINVAL    The  name  argument  is  a  null  pointer, points to an empty
                 string, or points to a string containing an '=' character.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE  VALUE _ Interface StabilityCommitted _ MT-LevelMT-Safe _ Stan‐
       dardSee standards(7).


SEE ALSO
       getenv(3C), putenv(3C), setenv(3C), attributes(7), standards(7)

HISTORY
       The unsetenv() function was added to Oracle Solaris in the  Solaris  10
       3/05 release.


       Prior  to the Oracle Solaris 11.4.27 release, unsetenv() removed only a
       single instance of the named variable from the environment.

Oracle Solaris 11.4               4 Aug 2022                      unsetenv(3C)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3