1 /* assoc.h -- definitions for the interface exported by assoc.c that allows
2 the rest of the shell to manipulate associative array variables. */
4 /* Copyright (C) 2008,2009 Free Software Foundation, Inc.
6 This file is part of GNU Bash, the Bourne Again SHell.
8 Bash is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 Bash is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with Bash. If not, see <http://www.gnu.org/licenses/>.
28 #define assoc_empty(h) ((h)->nentries == 0)
29 #define assoc_num_elements(h) ((h)->nentries)
31 #define assoc_create(n) (hash_create((n)))
33 #define assoc_copy(h) (hash_copy((h), 0))
35 #define assoc_walk(h, f) (hash_walk((h), (f))
37 extern void assoc_dispose
__P((HASH_TABLE
*));
38 extern void assoc_flush
__P((HASH_TABLE
*));
40 extern int assoc_insert
__P((HASH_TABLE
*, char *, char *));
41 extern PTR_T assoc_replace
__P((HASH_TABLE
*, char *, char *));
42 extern void assoc_remove
__P((HASH_TABLE
*, char *));
44 extern char *assoc_reference
__P((HASH_TABLE
*, char *));
46 extern char *assoc_subrange
__P((HASH_TABLE
*, arrayind_t
, arrayind_t
, int, int));
47 extern char *assoc_patsub
__P((HASH_TABLE
*, char *, char *, int));
48 extern char *assoc_modcase
__P((HASH_TABLE
*, char *, int, int));
50 extern HASH_TABLE
*assoc_quote
__P((HASH_TABLE
*));
51 extern HASH_TABLE
*assoc_quote_escapes
__P((HASH_TABLE
*));
52 extern HASH_TABLE
*assoc_dequote
__P((HASH_TABLE
*));
53 extern HASH_TABLE
*assoc_dequote_escapes
__P((HASH_TABLE
*));
54 extern HASH_TABLE
*assoc_remove_quoted_nulls
__P((HASH_TABLE
*));
56 extern char *assoc_to_assign
__P((HASH_TABLE
*, int));
58 extern WORD_LIST
*assoc_to_word_list
__P((HASH_TABLE
*));
59 extern WORD_LIST
*assoc_keys_to_word_list
__P((HASH_TABLE
*));
61 extern char *assoc_to_string
__P((HASH_TABLE
*, char *, int));
62 #endif /* _ASSOC_H_ */