mirror of
git://sourceware.org/git/glibc.git
synced 2024-11-27 03:41:23 +08:00
(Environment Access): Adjust comment about setenv() being BSD-only.
This commit is contained in:
parent
344be96af4
commit
0423ee1769
@ -1360,14 +1360,15 @@ The prototypes for these functions are in @file{stdlib.h}.
|
||||
|
||||
@comment stdlib.h
|
||||
@comment BSD
|
||||
@deftypefun {int32_t} random (void)
|
||||
@deftypefun {long int} random (void)
|
||||
This function returns the next pseudo-random number in the sequence.
|
||||
The value returned ranges from @code{0} to @code{RAND_MAX}.
|
||||
|
||||
@strong{Note:} Historically this function returned a @code{long int}
|
||||
value. On 64-bit systems @code{long int} would have been larger than
|
||||
programs expected, so @code{random} is now defined to return exactly 32
|
||||
bits.
|
||||
@strong{Note:} Temporarily this function was defined to return a
|
||||
@code{int32_t} value to indicate that the return value always contains
|
||||
32 bits even if @code{long int} is wider. The standard demands it
|
||||
differently. Users must always be aware of the 32-bit limitation,
|
||||
though.
|
||||
@end deftypefun
|
||||
|
||||
@comment stdlib.h
|
||||
|
@ -364,23 +364,25 @@ the old entry is replaced by the new one.
|
||||
|
||||
Please note that you cannot remove an entry completely using this function.
|
||||
|
||||
This function is part of the BSD library. The GNU C Library provides
|
||||
this function for compatibility but it may not be available on other
|
||||
systems.
|
||||
This function was originally part of the BSD library but is now part of
|
||||
the Unix standard.
|
||||
@end deftypefun
|
||||
|
||||
@comment stdlib.h
|
||||
@comment BSD
|
||||
@deftypefun void unsetenv (const char *@var{name})
|
||||
@deftypefun int unsetenv (const char *@var{name})
|
||||
Using this function one can remove an entry completely from the
|
||||
environment. If the environment contains an entry with the key
|
||||
@var{name} this whole entry is removed. A call to this function is
|
||||
equivalent to a call to @code{putenv} when the @var{value} part of the
|
||||
string is empty.
|
||||
|
||||
This function is part of the BSD library. The GNU C Library provides
|
||||
this function for compatibility but it may not be available on other
|
||||
systems.
|
||||
The function return @code{-1} if @var{name} is a null pointer, points to
|
||||
an empty string, or points to a string containing a @code{=} character.
|
||||
It returns @code{0} if the call succeeded.
|
||||
|
||||
This function was originall part of the BSD library but is now part of
|
||||
the Unix standard. The BSD version had no return value, though.
|
||||
@end deftypefun
|
||||
|
||||
There is one more function to modify the whole environment. This
|
||||
|
Loading…
Reference in New Issue
Block a user