.\" Copyright 2002 walter harms (walter.harms@informatik.uni-oldenburg.de)
+.\"
+.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
.\" Distributed under GPL
+.\" %%%LICENSE_END
+.\"
.\" 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,
", const char *" str );
.sp
.BI "error_t argz_add_sep(char **" argz ", size_t *" argz_len ,
-.ti 20n
-.BI "const char *" str ", int " delim );
+.BI " const char *" str ", int " delim );
.sp
.BI "error_t argz_append(char **" argz ", size_t *" argz_len ,
-.ti 20n
-.BI "const char *" buf ", size_t " buf_len );
+.BI " const char *" buf ", size_t " buf_len );
.sp
.BI "size_t argz_count(const char *" argz ", size_t " argz_len );
.sp
.BI "error_t argz_create(char * const " argv "[], char **" argz ,
-.ti 20n
-.BI "size_t *" argz_len );
+.BI " size_t *" argz_len );
.sp
.BI "error_t argz_create_sep(const char *" str ", int " sep ", char **" argz ,
-.ti 20n
-.BI "size_t *" argz_len );
+.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 ,
-.ti 20n
-.BI "const char *" entry );
+.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 ,
-.ti 20n
-.BI "const char *" with ", unsigned int *" replace_count );
+.BI " const char *" with ", unsigned int *" replace_count );
.sp
.BI "void argz_stringify(char *" argz ", size_t " len ", int " sep );
.fi
.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
converts a UNIX-style argument vector
.IR argv ,
terminated by
-.IR "(char *) 0" ,
+.IR "(char\ *)\ 0" ,
into an argz vector
.RI ( *argz ,\ *argz_len ).
.LP
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 ()
It transforms the argz vector into a normal string by replacing
all null bytes (\(aq\\0\(aq) except the last by
.IR sep .
-.SH "RETURN VALUE"
+.SH RETURN VALUE
All argz functions that do memory allocation have a return type of
-\fIerror_t\fP, and return 0 for success, and \fBENOMEM\fP
+.IR error_t ,
+and return 0 for success, and
+.B ENOMEM
if an allocation error occurs.
.SH CONFORMING TO
These functions are a GNU extension.
.SH BUGS
Argz vectors without a terminating null byte may lead to
Segmentation Faults.
-.SH "SEE ALSO"
+.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/.