diff options
Diffstat (limited to 'string/envz.h')
-rw-r--r-- | string/envz.h | 55 |
1 files changed, 55 insertions, 0 deletions
diff --git a/string/envz.h b/string/envz.h new file mode 100644 index 0000000..55224c7 --- /dev/null +++ b/string/envz.h @@ -0,0 +1,55 @@ +/* Routines for dealing with '\0' separated environment vectors + + Copyright (C) 1995 Free Software Foundation, Inc. + + Written by Miles Bader <miles@gnu.ai.mit.edu> + + This program is free software; you can redistribute it and/or + modify it under the terms of the GNU General Public License as + published by the Free Software Foundation; either version 2, or (at + your option) any later version. + + This program is distributed in the hope that it will be useful, but + WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ + +#ifndef __ENVZ_H__ +#define __ENVZ_H__ + +#include <errno.h> + +/* Envz's are argz's too, and should be created etc., using the same + routines. */ +#include <argz.h> + +/* Returns a pointer to the entry in ENVZ for NAME, or 0 if there is none. */ +char *envz_entry (char *envz, unsigned envz_len, char *name); + +/* Returns a pointer to the value portion of the entry in ENVZ for NAME, or 0 + if there is none. */ +char *envz_get (char *envz, unsigned envz_len, char *name); + +/* Adds an entry for NAME with value VALUE to ENVZ & ENVZ_LEN. If an entry + with the same name already exists in ENVZ, it is removed. If VALUE is + NULL, then the new entry will a special null one, for which envz_get will + return NULL, although envz_entry will still return an entry; this is handy + because when merging with another envz, the null entry can override an + entry in the other one. Null entries can be removed with envz_strip (). */ +error_t envz_add (char **envz, unsigned *envz_len, char *name, char *value); + +/* Adds each entry in ENVZ2 to ENVZ & ENVZ_LEN, as if with envz_add(). If + OVERRIDE is true, then values in ENVZ2 will supercede those with the same + name in ENV, otherwise not. */ +error_t +envz_merge (char **envz, unsigned *envz_len, char *envz2, unsigned envz2_len, + int override); + +/* Remove null entries. */ +void envz_strip (char **envz, unsigned *envz_len); + +#endif /* __ENVZ_H__ */ |