/* Routines for dealing with '\0' separated arg vectors.
- Copyright (C) 1995,96,97,98,99,2000,2004,2007 Free Software Foundation, Inc.
+ Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2004, 2007, 2009, 2010
+ Free Software Foundation, Inc.
This file is part of the GNU C Library.
This program is free software: you can redistribute it and/or modify
along with this program. If not, see <http://www.gnu.org/licenses/>. */
#ifndef _ARGZ_H
-#define _ARGZ_H 1
+#define _ARGZ_H 1
#define __need_error_t
#include <errno.h>
-#include <string.h> /* Need size_t, and strchr is called below. */
+#include <string.h> /* Need size_t, and strchr is called below. */
#ifndef const
# define const const
ENOMEM is returned, otherwise 0. The result can be destroyed using free. */
extern error_t argz_create (char *const __argv[], char **restrict __argz,
- size_t *restrict __len);
+ size_t *restrict __len);
/* Make a '\0' separated arg vector from a SEP separated list in
STRING, returning it in ARGZ, and the total length in LEN. If a
The result can be destroyed using free. */
extern error_t argz_create_sep (const char *restrict string,
- int __sep, char **restrict __argz,
- size_t *restrict __len);
+ int __sep, char **restrict __argz,
+ size_t *restrict __len);
/* Returns the number of strings in ARGZ. */
to hold them all. */
extern void argz_extract (const char *restrict __argz, size_t __len,
- char **restrict __argv);
+ char **restrict __argv);
/* Make '\0' separated arg vector ARGZ printable by converting all the '\0's
except the last into the character SEP. */
/* Append BUF, of length BUF_LEN to the argz vector in ARGZ & ARGZ_LEN. */
extern error_t argz_append (char **restrict __argz,
- size_t *restrict __argz_len,
- const char *restrict __buf, size_t __buf_len)
+ size_t *restrict __argz_len,
+ const char *restrict __buf, size_t __buf_len)
;
/* Append STR to the argz vector in ARGZ & ARGZ_LEN. */
extern error_t argz_add (char **restrict __argz,
- size_t *restrict __argz_len,
- const char *restrict str);
+ size_t *restrict __argz_len,
+ const char *restrict str);
/* Append SEP separated list in STRING to the argz vector in ARGZ &
ARGZ_LEN. */
extern error_t argz_add_sep (char **restrict __argz,
- size_t *restrict __argz_len,
- const char *restrict string, int __delim)
+ size_t *restrict __argz_len,
+ const char *restrict string, int __delim)
;
/* Delete ENTRY from ARGZ & ARGZ_LEN, if it appears there. */
extern void argz_delete (char **restrict __argz,
- size_t *restrict __argz_len,
- char *restrict __entry);
+ size_t *restrict __argz_len,
+ char *restrict __entry);
/* Insert ENTRY into ARGZ & ARGZ_LEN before BEFORE, which should be an
existing entry in ARGZ; if BEFORE is NULL, ENTRY is appended to the end.
ARGZ, ENOMEM is returned, else 0. */
extern error_t argz_insert (char **restrict __argz,
- size_t *restrict __argz_len,
- char *restrict __before,
- const char *restrict __entry);
+ size_t *restrict __argz_len,
+ char *restrict __before,
+ const char *restrict __entry);
/* Replace any occurrences of the string STR in ARGZ with WITH, reallocating
ARGZ as necessary. If REPLACE_COUNT is non-zero, *REPLACE_COUNT will be
incremented by number of replacements performed. */
extern error_t argz_replace (char **restrict __argz,
- size_t *restrict __argz_len,
- const char *restrict str,
- const char *restrict __with,
- unsigned int *restrict __replace_count);
+ size_t *restrict __argz_len,
+ const char *restrict str,
+ const char *restrict __with,
+ unsigned int *restrict __replace_count);
\f
/* Returns the next entry in ARGZ & ARGZ_LEN after ENTRY, or NULL if there
are no more. If entry is NULL, then the first entry is returned. This
*/
extern char *argz_next (const char *restrict __argz, size_t __argz_len,
- const char *restrict __entry);
+ const char *restrict __entry);
#ifdef __USE_EXTERN_INLINES
__extern_inline char *
__NTH (argz_next (const char *__argz, size_t __argz_len,
- const char *__entry))
+ const char *__entry))
{
if (__entry)
{
if (__entry < __argz + __argz_len)
- __entry = strchr (__entry, '\0') + 1;
+ __entry = strchr (__entry, '\0') + 1;
return __entry >= __argz + __argz_len ? (char *) NULL : (char *) __entry;
}
}
__extern_inline char *
__NTH (argz_next (const char *__argz, size_t __argz_len,
- const char *__entry))
+ const char *__entry))
{
return argz_next (__argz, __argz_len, __entry);
}