.\" based on the description in glibc source and infopages
.\"
.\" Corrections and additions, aeb
-.TH ARGZ_ADD 3 2007-05-18 "" "Linux Programmer's Manual"
+.TH ARGZ_ADD 3 2014-05-28 "" "Linux Programmer's Manual"
.SH NAME
argz_add, argz_add_sep, argz_append, argz_count, argz_create,
argz_create_sep, argz_delete, argz_extract, argz_insert,
.BI "error_t argz_create_sep(const char *" str ", int " sep ", char **" argz ,
.BI " size_t *" argz_len );
.sp
-.BI "error_t argz_delete(char **" argz ", size_t *" argz_len ", char *" entry );
+.BI "void argz_delete(char **" argz ", size_t *" argz_len ", char *" entry );
.sp
-.BI "void argz_extract(char *" argz ", size_t " argz_len ", char **" argv );
+.BI "void argz_extract(const char *" argz ", size_t " argz_len ", char **" argv );
.sp
.BI "error_t argz_insert(char **" argz ", size_t *" argz_len ", char *" before ,
.BI " const char *" entry );
.sp
-.BI "char *argz_next(char *" argz ", size_t " argz_len ", const char *" entry );
+.BI "char *argz_next(const char *" argz ", size_t " argz_len ", const char *" entry );
.sp
.BI "error_t argz_replace(char **" argz ", size_t *" argz_len \
", const char *" str ,
.LP
These functions are for handling argz vectors.
The pair (NULL,0) is an argz vector, and, conversely,
-argz vectors of length 0 must have NULL pointer.
+argz vectors of length 0 must have null pointer.
Allocation of nonempty argz vectors is done using
.BR malloc (3),
so that
.LP
.BR argz_append ()
appends the argz vector
-.RI ( buf ,\ buf_len )
+.RI ( buf ,\ buf_len )
after
-.RI ( *argz ,\ *argz_len )
+.RI ( *argz ,\ *argz_len )
and updates
.IR *argz
and
.BR argz_count ()
counts the number of strings, that is,
the number of null bytes (\(aq\\0\(aq), in
-.RI ( argz ,\ argz_len ).
+.RI ( argz ,\ argz_len ).
.LP
.BR argz_create ()
converts a UNIX-style argument vector
terminated by
.IR "(char\ *)\ 0" ,
into an argz vector
-.RI ( *argz ,\ *argz_len ).
+.RI ( *argz ,\ *argz_len ).
.LP
.BR argz_create_sep ()
converts the null-terminated string
.I str
into an argz vector
-.RI ( *argz ,\ *argz_len )
+.RI ( *argz ,\ *argz_len )
by breaking it up at every occurrence of the separator
.IR sep .
.LP
removes the substring pointed to by
.I entry
from the argz vector
-.RI ( *argz ,\ *argz_len )
+.RI ( *argz ,\ *argz_len )
and updates
.I *argz
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,
The array
.I argv
must have room for
-.IR argz_count ( argz , argz_len ") + 1"
+.IR argz_count ( argz ", " argz_len ") + 1"
pointers.
.LP
.BR argz_insert ()
at position
.I before
into the argz vector
-.RI ( *argz ,\ *argz_len )
+.RI ( *argz ,\ *argz_len )
and updates
.I *argz
and
Segmentation Faults.
.SH SEE ALSO
.BR envz_add (3)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.