[thirdparty/bash.git] / arrayfunc.h

/* arrayfunc.h -- declarations for miscellaneous array functions in arrayfunc.c */

/* Copyright (C) 2001-2021 Free Software Foundation, Inc.

   This file is part of GNU Bash, the Bourne Again SHell.

   Bash 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 3 of the License, or
   (at your option) any later version.

   Bash 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 Bash.  If not, see <http://www.gnu.org/licenses/>.
*/

#if !defined (_ARRAYFUNC_H_)
#define _ARRAYFUNC_H_

/* Must include variables.h before including this file. */

/* An object to encapsulate the state of an array element. It can describe
   an array assignment A[KEY]=VALUE or a[IND]=VALUE depending on TYPE, or
   for passing array subscript references around, where VALUE would be
   ${a[IND]} or ${A[KEY]}.  This is not dependent on ARRAY_VARS so we can
   use it in function parameters. */

/* values for `type' field */
#define ARRAY_INVALID	-1
#define ARRAY_SCALAR	0
#define ARRAY_INDEXED	1
#define ARRAY_ASSOC	2

/* KEY will contain allocated memory if called through the assign_array_element
   code path because of how assoc_insert works. */
typedef struct element_state
{
  short type;			/* assoc or indexed, says which fields are valid */  
  short subtype;		/* `*', `@', or something else */
  arrayind_t ind;
  char *key;			/* can be allocated memory */
  char *value;
} array_eltstate_t;

#if defined (ARRAY_VARS)

/* This variable means to not expand associative array subscripts more than
   once, when performing variable expansion. */
extern int assoc_expand_once;

/* The analog for indexed array subscripts */
extern int array_expand_once;

/* Flags for array_value_internal and callers array_value/get_array_value; also
   used by array_variable_name and array_variable_part. */
#define AV_ALLOWALL	0x001	/* treat a[@] like $@ and a[*] like $* */
#define AV_QUOTED	0x002
#define AV_USEIND	0x004
#define AV_USEVAL	0x008	/* XXX - should move this */
#define AV_ASSIGNRHS	0x010	/* no splitting, special case ${a[@]} */
#define AV_NOEXPAND	0x020	/* don't run assoc subscripts through word expansion */
#define AV_ONEWORD	0x040	/* not used yet */
#define AV_ATSTARKEYS	0x080	/* accept a[@] and a[*] but use them as keys, not special values */

/* Flags for valid_array_reference. Value 1 is reserved for skipsubscript().
   Also used by unbind_array_element, which is currently the only function
   that uses VA_ALLOWALL. */
#define VA_NOEXPAND	0x001
#define VA_ONEWORD	0x002
#define VA_ALLOWALL	0x004	/* allow @ to mean all elements of the array */

extern SHELL_VAR *convert_var_to_array PARAMS((SHELL_VAR *));
extern SHELL_VAR *convert_var_to_assoc PARAMS((SHELL_VAR *));

extern char *make_array_variable_value PARAMS((SHELL_VAR *, arrayind_t, char *, char *, int));

extern SHELL_VAR *bind_array_variable PARAMS((char *, arrayind_t, char *, int));
extern SHELL_VAR *bind_array_element PARAMS((SHELL_VAR *, arrayind_t, char *, int));
extern SHELL_VAR *assign_array_element PARAMS((char *, char *, int, array_eltstate_t *));

extern SHELL_VAR *bind_assoc_variable PARAMS((SHELL_VAR *, char *, char *, char *, int));

extern SHELL_VAR *find_or_make_array_variable PARAMS((char *, int));

extern SHELL_VAR *assign_array_from_string  PARAMS((char *, char *, int));
extern SHELL_VAR *assign_array_var_from_word_list PARAMS((SHELL_VAR *, WORD_LIST *, int));

extern WORD_LIST *expand_compound_array_assignment PARAMS((SHELL_VAR *, char *, int));
extern void assign_compound_array_list PARAMS((SHELL_VAR *, WORD_LIST *, int));
extern SHELL_VAR *assign_array_var_from_string PARAMS((SHELL_VAR *, char *, int));

extern char *expand_and_quote_assoc_word PARAMS((char *, int));
extern void quote_compound_array_list PARAMS((WORD_LIST *, int));

extern int kvpair_assignment_p PARAMS((WORD_LIST *));
extern char *expand_and_quote_kvpair_word PARAMS((char *));

extern int unbind_array_element PARAMS((SHELL_VAR *, char *, int));
extern int skipsubscript PARAMS((const char *, int, int));

extern void print_array_assignment PARAMS((SHELL_VAR *, int));
extern void print_assoc_assignment PARAMS((SHELL_VAR *, int));

extern arrayind_t array_expand_index PARAMS((SHELL_VAR *, char *, int, int));
extern int valid_array_reference PARAMS((const char *, int));
extern int tokenize_array_reference PARAMS((char *, int, char **));

extern char *array_value PARAMS((const char *, int, int, array_eltstate_t *));
extern char *get_array_value PARAMS((const char *, int, array_eltstate_t *));

extern char *array_keys PARAMS((char *, int, int));

extern char *array_variable_name PARAMS((const char *, int, char **, int *));
extern SHELL_VAR *array_variable_part PARAMS((const char *, int, char **, int *));

extern void init_eltstate (array_eltstate_t *);
extern void flush_eltstate (array_eltstate_t *);

#else

#define AV_ALLOWALL	0
#define AV_QUOTED	0
#define AV_USEIND	0
#define AV_USEVAL	0
#define AV_ASSIGNRHS	0
#define AV_NOEXPAND	0
#define AV_ONEWORD	0
#define AV_ATSTARKEYS	0

#define VA_NOEXPAND	0
#define VA_ONEWORD	0
#define VA_ALLOWALL	0

#endif

#endif /* !_ARRAYFUNC_H_ */
Commit	Line	Data
	1	/* arrayfunc.h -- declarations for miscellaneous array functions in arrayfunc.c */
	2
	3	/* Copyright (C) 2001-2021 Free Software Foundation, Inc.
	4
	5	This file is part of GNU Bash, the Bourne Again SHell.
	6
	7	Bash is free software: you can redistribute it and/or modify
	8	it under the terms of the GNU General Public License as published by
	9	the Free Software Foundation, either version 3 of the License, or
	10	(at your option) any later version.
	11
	12	Bash is distributed in the hope that it will be useful,
	13	but WITHOUT ANY WARRANTY; without even the implied warranty of
	14	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	15	GNU General Public License for more details.
	16
	17	You should have received a copy of the GNU General Public License
	18	along with Bash. If not, see <http://www.gnu.org/licenses/>.
	19	*/
	20
	21	#if !defined (_ARRAYFUNC_H_)
	22	#define _ARRAYFUNC_H_
	23
	24	/* Must include variables.h before including this file. */
	25
	26	/* An object to encapsulate the state of an array element. It can describe
	27	an array assignment A[KEY]=VALUE or a[IND]=VALUE depending on TYPE, or
	28	for passing array subscript references around, where VALUE would be
	29	${a[IND]} or ${A[KEY]}. This is not dependent on ARRAY_VARS so we can
	30	use it in function parameters. */
	31
	32	/* values for `type' field */
	33	#define ARRAY_INVALID -1
	34	#define ARRAY_SCALAR 0
	35	#define ARRAY_INDEXED 1
	36	#define ARRAY_ASSOC 2
	37
	38	/* KEY will contain allocated memory if called through the assign_array_element
	39	code path because of how assoc_insert works. */
	40	typedef struct element_state
	41	{
	42	short type; /* assoc or indexed, says which fields are valid */
	43	short subtype; /* `', `@', or something else /
	44	arrayind_t ind;
	45	char key; / can be allocated memory */
	46	char *value;
	47	} array_eltstate_t;
	48
	49	#if defined (ARRAY_VARS)
	50
	51	/* This variable means to not expand associative array subscripts more than
	52	once, when performing variable expansion. */
	53	extern int assoc_expand_once;
	54
	55	/* The analog for indexed array subscripts */
	56	extern int array_expand_once;
	57
	58	/* Flags for array_value_internal and callers array_value/get_array_value; also
	59	used by array_variable_name and array_variable_part. */
	60	#define AV_ALLOWALL 0x001 /* treat a[@] like $@ and a[] like $ */
	61	#define AV_QUOTED 0x002
	62	#define AV_USEIND 0x004
	63	#define AV_USEVAL 0x008 /* XXX - should move this */
	64	#define AV_ASSIGNRHS 0x010 /* no splitting, special case ${a[@]} */
	65	#define AV_NOEXPAND 0x020 /* don't run assoc subscripts through word expansion */
	66	#define AV_ONEWORD 0x040 /* not used yet */
	67	#define AV_ATSTARKEYS 0x080 /* accept a[@] and a[] but use them as keys, not special values /
	68
	69	/* Flags for valid_array_reference. Value 1 is reserved for skipsubscript().
	70	Also used by unbind_array_element, which is currently the only function
	71	that uses VA_ALLOWALL. */
	72	#define VA_NOEXPAND 0x001
	73	#define VA_ONEWORD 0x002
	74	#define VA_ALLOWALL 0x004 /* allow @ to mean all elements of the array */
	75
	76	extern SHELL_VAR convert_var_to_array PARAMS((SHELL_VAR ));
	77	extern SHELL_VAR convert_var_to_assoc PARAMS((SHELL_VAR ));
	78
	79	extern char make_array_variable_value PARAMS((SHELL_VAR , arrayind_t, char , char , int));
	80
	81	extern SHELL_VAR bind_array_variable PARAMS((char , arrayind_t, char *, int));
	82	extern SHELL_VAR bind_array_element PARAMS((SHELL_VAR , arrayind_t, char *, int));
	83	extern SHELL_VAR assign_array_element PARAMS((char , char , int, array_eltstate_t ));
	84
	85	extern SHELL_VAR bind_assoc_variable PARAMS((SHELL_VAR , char , char , char *, int));
	86
	87	extern SHELL_VAR find_or_make_array_variable PARAMS((char , int));
	88
	89	extern SHELL_VAR assign_array_from_string PARAMS((char , char *, int));
	90	extern SHELL_VAR assign_array_var_from_word_list PARAMS((SHELL_VAR , WORD_LIST *, int));
	91
	92	extern WORD_LIST expand_compound_array_assignment PARAMS((SHELL_VAR , char *, int));
	93	extern void assign_compound_array_list PARAMS((SHELL_VAR , WORD_LIST , int));
	94	extern SHELL_VAR assign_array_var_from_string PARAMS((SHELL_VAR , char *, int));
	95
	96	extern char expand_and_quote_assoc_word PARAMS((char , int));
	97	extern void quote_compound_array_list PARAMS((WORD_LIST *, int));
	98
	99	extern int kvpair_assignment_p PARAMS((WORD_LIST *));
	100	extern char expand_and_quote_kvpair_word PARAMS((char ));
	101
	102	extern int unbind_array_element PARAMS((SHELL_VAR , char , int));
	103	extern int skipsubscript PARAMS((const char *, int, int));
	104
	105	extern void print_array_assignment PARAMS((SHELL_VAR *, int));
	106	extern void print_assoc_assignment PARAMS((SHELL_VAR *, int));
	107
	108	extern arrayind_t array_expand_index PARAMS((SHELL_VAR , char , int, int));
	109	extern int valid_array_reference PARAMS((const char *, int));
	110	extern int tokenize_array_reference PARAMS((char , int, char *));
	111
	112	extern char array_value PARAMS((const char , int, int, array_eltstate_t *));
	113	extern char get_array_value PARAMS((const char , int, array_eltstate_t *));
	114
	115	extern char array_keys PARAMS((char , int, int));
	116
	117	extern char array_variable_name PARAMS((const char , int, char *, int ));
	118	extern SHELL_VAR array_variable_part PARAMS((const char , int, char *, int ));
	119
	120	extern void init_eltstate (array_eltstate_t *);
	121	extern void flush_eltstate (array_eltstate_t *);
	122
	123	#else
	124
	125	#define AV_ALLOWALL 0
	126	#define AV_QUOTED 0
	127	#define AV_USEIND 0
	128	#define AV_USEVAL 0
	129	#define AV_ASSIGNRHS 0
	130	#define AV_NOEXPAND 0
	131	#define AV_ONEWORD 0
	132	#define AV_ATSTARKEYS 0
	133
	134	#define VA_NOEXPAND 0
	135	#define VA_ONEWORD 0
	136	#define VA_ALLOWALL 0
	137
	138	#endif
	139
	140	#endif /* !_ARRAYFUNC_H_ */