diff options
author | Mattias Andrée <maandree@kth.se> | 2018-11-07 22:18:04 +0100 |
---|---|---|
committer | Mattias Andrée <maandree@kth.se> | 2018-11-07 22:18:04 +0100 |
commit | 9fc2b129167e1f2a16d942369f057f618a00d81c (patch) | |
tree | c15d15d8afc525a423ce0d43d95f676e6e5a2541 /man3/libsimple_getenv_e.3 | |
parent | Add arrayalloc man page (diff) | |
download | libsimple-9fc2b129167e1f2a16d942369f057f618a00d81c.tar.gz libsimple-9fc2b129167e1f2a16d942369f057f618a00d81c.tar.bz2 libsimple-9fc2b129167e1f2a16d942369f057f618a00d81c.tar.xz |
Move section 3 man pages to man3/ and add libsimple.h.0
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to 'man3/libsimple_getenv_e.3')
-rw-r--r-- | man3/libsimple_getenv_e.3 | 73 |
1 files changed, 73 insertions, 0 deletions
diff --git a/man3/libsimple_getenv_e.3 b/man3/libsimple_getenv_e.3 new file mode 100644 index 0000000..7e3a3ca --- /dev/null +++ b/man3/libsimple_getenv_e.3 @@ -0,0 +1,73 @@ +.TH LIBSIMPLE_GETENV_E 3 2018-10-20 libsimple +.SH NAME +libsimple_getenv_e \- get value of an environment variable or the empty string +.SH SYNOPSIS +.nf +#include <libsimple.h> + +static inline const char *libsimple_getenv_e(const char *\fIname\fP); + +#ifndef getenv_e +# define getenv_e libsimple_getenv_e +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_getenv_e () +function searches the environment of the calling +process for the environment variable +.IR name . +If it exists, its value is returned. If it does +not exist, the empty string is returned. +.PP +Modifications to the environment variable made from +within the process, its parent, or other ancestor, +that have not be come visible to other process via +replacement of the process image, are visible to the +.BR libsimple_getenv_e () +function. +.SH RETURN VALUE +If the environment variable +.I name +is defined, its value is returned, otherwise the +empty string is returned. +.SH ERRORS +The +.BR libsimple_getenv_e () +function cannot fail. +.SH ATTRIBUTES +For an explanation of the terms used in this section, see +.BR attributes (7). +.TS +allbox; +lb lb lb +l l l. +Interface Attribute Value +T{ +.BR libsimple_getenv_e () +T} Thread safety MT-Safe env +T{ +.BR libsimple_getenv_e () +T} Async-signal safety AS-Safe +T{ +.BR libsimple_getenv_e () +T} Async-cancel safety AC-Safe +.TE +.SH EXAMPLES +None. +.SH APPLICATION USAGE +None. +.SH RATIONALE +None. +.SH FUTURE DIRECTIONS +None. +.SH NOTES +None. +.SH BUGS +None. +.SH SEE ALSO +.BR libsimple_getenv_ne (3), +.BR getenv (3) |