1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
|
#ifndef _H_ARGV_
#define _H_ARGV_
/** \ingroup rpmargv
* \file argv.h
*
* Argument Manipulation API.
*/
#include <stdio.h>
#include <rpm/rpmtypes.h>
#ifdef __cplusplus
extern "C" {
#endif
typedef char ** ARGV_t;
typedef char * const *ARGV_const_t;
typedef int * ARGint_t;
struct ARGI_s {
unsigned nvals;
ARGint_t vals;
};
typedef struct ARGI_s * ARGI_t;
typedef struct ARGI_s const * const ARGI_const_t;
/** \ingroup rpmargv
* Print argv array elements.
* @param msg output message prefix (or NULL)
* @param argv argv array
* @param fp output file handle (NULL uses stderr)
*/
void argvPrint(const char * msg, ARGV_const_t argv, FILE * fp);
/** \ingroup rpmargv
* Destroy an argi array.
* @param argi argi array
* @return NULL always
*/
ARGI_t argiFree(ARGI_t argi);
/** \ingroup rpmargv
* Create an empty argv array.
* @return pointer to empty argv
*/
ARGV_t argvNew(void);
/** \ingroup rpmargv
* Destroy an argv array.
* @param argv argv array
* @return NULL always
*/
ARGV_t argvFree(ARGV_t argv);
/** \ingroup rpmargv
* Return no. of elements in argi array.
* @param argi argi array
* @return no. of elements
*/
int argiCount(ARGI_const_t argi);
/** \ingroup rpmargv
* Return data from argi array.
* @param argi argi array
* @return argi array data address
*/
ARGint_t argiData(ARGI_const_t argi);
/** \ingroup rpmargv
* Return no. of elements in argv array.
* @param argv argv array
* @return no. of elements
*/
int argvCount(ARGV_const_t argv);
/** \ingroup rpmargv
* Return data from argv array.
* @param argv argv array
* @return argv array data address
*/
ARGV_t argvData(ARGV_t argv);
/** \ingroup rpmargv
* Compare argv arrays (qsort/bsearch).
* @param a 1st instance address
* @param b 2nd instance address
* @return result of comparison
*/
int argvCmp(const void * a, const void * b);
/** \ingroup rpmargv
* Sort an argv array.
* @param argv argv array
* @param compar strcmp-like comparison function, or NULL for argvCmp()
* @return 0 always
*/
int argvSort(ARGV_t argv, int (*compar)(const void *, const void *));
/** \ingroup rpmargv
* Find an element in an argv array.
* @param argv argv array
* @param val string to find
* @param compar strcmp-like comparison function, or NULL for argvCmp()
* @return found string (NULL on failure)
*/
ARGV_t argvSearch(ARGV_const_t argv, const char *val,
int (*compar)(const void *, const void *));
/** \ingroup rpmargv
* Add an int to an argi array.
* @param[out] *argip argi array
* @param ix argi array index (or -1 to append)
* @param val int arg to add
* @return 0 always
*/
int argiAdd(ARGI_t * argip, int ix, int val);
/** \ingroup rpmargv
* Add a string to an argv array.
* @param[out] *argvp argv array
* @param val string arg to append
* @return 0 always
*/
int argvAdd(ARGV_t * argvp, const char *val);
/** \ingroup rpmargv
* Add a string to an argv array, does not need to be nil-terminated.
* @param[out] *argvp argv array
* @param val string arg to append
* @param len string arg length
* @return 0 always
*/
int argvAddN(ARGV_t * argvp, const char *val, size_t len);
/** \ingroup rpmargv
* Add a number to an argv array (converting to a string).
* @param[out] *argvp argv array
* @param val numeric arg to append
* @return 0 always
*/
int argvAddNum(ARGV_t * argvp, int val);
/** \ingroup rpmargv
* Append one argv array to another.
* @param[out] *argvp argv array
* @param av argv array to append
* @return 0 always
*/
int argvAppend(ARGV_t * argvp, ARGV_const_t av);
enum argvFlags_e {
ARGV_NONE = 0,
ARGV_SKIPEMPTY = (1 << 0), /* omit empty strings from result */
};
typedef rpmFlags argvFlags;
/** \ingroup rpmargv
* Split a string into an argv array.
* @param str string arg to split
* @param seps separator characters
* @param flags flags to control behavior
* @return argv array
*/
ARGV_t argvSplitString(const char * str, const char * seps, argvFlags flags);
/** \ingroup rpmargv
* Split a string into an argv array.
* @param[out] *argvp argv array
* @param str string arg to split
* @param seps separator characters
* @return 0 always
*/
int argvSplit(ARGV_t * argvp, const char * str, const char * seps);
/** \ingroup rpmargv
* Join an argv array into a string.
* @param *argv argv array to join
* @param sep separator string to use
* @return malloc'ed string
*/
char *argvJoin(ARGV_const_t argv, const char *sep);
#ifdef __cplusplus
}
#endif
#endif /* _H_ARGV_ */
|
