This commit is contained in:
Michael Kerrisk 2007-12-22 22:01:09 +00:00
parent 2bbf22921c
commit e7c0f078db
2 changed files with 23 additions and 26 deletions

View File

@ -87,7 +87,7 @@ delimiter ':'.
.LP
.BR argz_append ()
appends the argz vector
.RI ( buf , buf_len )
.RI ( buf ,\ buf_len )
after
.RI ( *argz ,\ *argz_len )
and updates
@ -102,7 +102,7 @@ will be increased by
.BR argz_count ()
counts the number of strings, that is,
the number of null bytes ('\\0'), in
.RI ( argz , argz_len ).
.RI ( argz ,\ argz_len ).
.LP
.BR argz_create ()
converts a Unix-style argument vector
@ -134,7 +134,7 @@ and
is the opposite of
.BR argz_create ().
It takes the argz vector
.RI ( argz , argz_len )
.RI ( argz ,\ argz_len )
and fills the array starting at
.I argv
with pointers to the substrings, and a final NULL,
@ -153,7 +153,7 @@ It inserts the argument
at position
.I before
into the argz vector
.RI ( *argz ,\ *argz_len )
.RI ( *argz ,\ *argz_len )
and updates
.I *argz
and

View File

@ -12,27 +12,24 @@ envz_remove, envz_strip \- environment string support
.sp
.B "#include <envz.h>"
.sp
.B "error_t"
.BI "envz_add(char **" envz ", size_t *" envz_len ,
.ti 16n
.BI "error_t envz_add(char **" envz ", size_t *" envz_len ,
.ti 20n
.BI "const char *" name ", const char *" value );
.sp
.B "char *"
.BI "envz_entry(const char *" envz ", size_t *" envz_len ", const char *" name );
.BI "char *envz_entry(const char *" envz ", size_t *" envz_len \
", const char *" name );
.sp
.B "char *"
.BI "envz_get(const char *" envz ", size_t *" envz_len ", const char *" name );
.BI "char *envz_get(const char *" envz ", size_t *" envz_len \
", const char *" name );
.sp
.B "error_t"
.BI "envz_merge(char **" envz ", size_t *" envz_len ,
.ti 16n
.BI "error_t envz_merge(char **" envz ", size_t *" envz_len ,
.ti 20n
.BI "const char *" envz2 ", size_t " envz2_len ", int " override );
.sp
.B "void"
.BI "envz_remove(char **" envz ", size_t *" envz_len ", const char *" name );
.BI "void envz_remove(char **" envz ", size_t *" envz_len \
", const char *" name );
.sp
.B "void"
.BI "envz_strip(char **" envz ", size_t *" envz_len );
.BI "void envz_strip(char **" envz ", size_t *" envz_len );
.SH DESCRIPTION
These functions are glibc-specific.
.LP
@ -58,11 +55,11 @@ is non-NULL) or
(in case
.I value
is NULL) to the envz vector
.RI (* envz ,* envz_len )
.RI ( *envz ,\ *envz_len )
and updates
.RI * envz
.I *envz
and
.RI * envz_len .
.IR *envz_len .
If an entry with the same
.I name
existed, it is removed.
@ -71,14 +68,14 @@ existed, it is removed.
looks for
.I name
in the envz vector
.RI ( envz , envz_len )
.RI ( envz ,\ envz_len )
and returns the entry if found, or NULL if not.
.LP
.BR envz_get ()
looks for
.I name
in the envz vector
.RI ( envz , envz_len )
.RI ( envz ,\ envz_len )
and returns the value if found, or NULL if not.
(Note that the value can also be NULL, namely when there is
an entry for
@ -89,7 +86,7 @@ without '=' sign.)
adds each entry in
.I envz2
to
.RI * envz ,
.IR *envz ,
as if with
.BR envz_add ().
If
@ -97,14 +94,14 @@ If
is true, then values in
.I envz2
will supersede those with the same name in
.RI * envz ,
.IR *envz ,
otherwise not.
.LP
.BR envz_remove ()
removes the entry for
.I name
from
.RI (* envz ,* envz_len )
.RI ( *envz ,\ *envz_len )
if there was one.
.LP
.BR envz_strip ()