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
|
#ifndef _H_ARGV_
#define _H_ARGV_
/** \ingroup rpmio
* \file rpmio/argv.h
*/
typedef const char * ARGstr_t;
typedef ARGstr_t * ARGV_t;
typedef int * ARGint_t;
struct ARGI_s {
unsigned nvals;
ARGint_t vals;
};
typedef struct ARGI_s * ARGI_t;
#ifdef __cplusplus
extern "C" {
#endif
/**
* 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_t argv, FILE * fp)
/*@globals fileSystem @*/
/*@modifies *fp, fileSystem @*/;
/**
* Destroy an argi array.
* @param argi argi array
* @return NULL always
*/
/*@null@*/
ARGI_t argiFree(/*@only@*/ /*@null@*/ ARGI_t argi)
/*@modifies argi @*/;
/**
* Destroy an argv array.
* @param argv argv array
* @return NULL always
*/
/*@null@*/
ARGV_t argvFree(/*@only@*/ /*@null@*/ ARGV_t argv)
/*@modifies argv @*/;
/**
* Return no. of elements in argi array.
* @param argi argi array
* @return no. of elements
*/
int argiCount(/*@null@*/ const ARGI_t argi)
/*@*/;
/**
* Return data from argi array.
* @param argi argi array
* @return argi array data address
*/
/*@null@*/
ARGint_t argiData(/*@null@*/ const ARGI_t argi)
/*@*/;
/**
* Return no. of elements in argv array.
* @param argv argv array
* @return no. of elements
*/
int argvCount(/*@null@*/ const ARGV_t argv)
/*@*/;
/**
* Return data from argv array.
* @param argv argv array
* @return argv array data address
*/
/*@null@*/
ARGV_t argvData(/*@null@*/ const ARGV_t argv)
/*@*/;
/**
* Compare argv arrays (qsort/bsearch).
* @param a 1st instance address
* @param b 2nd instance address
* @return result of comparison
*/
/*@-exportlocal@*/
int argvCmp(const void * a, const void * b)
/*@*/;
/*@=exportlocal@*/
/**
* 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 *))
/*@modifies *argv @*/;
/**
* 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)
*/
/*@dependent@*/ /*@null@*/
ARGV_t argvSearch(ARGV_t argv, ARGstr_t val,
int (*compar)(const void *, const void *))
/*@*/;
/**
* Add an int to an argi array.
* @retval *argip argi array
* @param ix argi array index (or -1 to append)
* @param val int arg to add
* @return 0 always
*/
int argiAdd(/*@out@*/ ARGI_t * argip, int ix, int val)
/*@modifies *argip @*/;
/**
* Add a string to an argv array.
* @retval *argvp argv array
* @param val string arg to append
* @return 0 always
*/
int argvAdd(/*@out@*/ ARGV_t * argvp, ARGstr_t val)
/*@modifies *argvp @*/;
/**
* Append one argv array to another.
* @retval *argvp argv array
* @param av argv array to append
* @return 0 always
*/
int argvAppend(/*@out@*/ ARGV_t * argvp, const ARGV_t av)
/*@modifies *argvp @*/;
/**
* Split a string into an argv array.
* @retval *argvp argv array
* @param str string arg to split
* @param seps seperator characters
* @return 0 always
*/
int argvSplit(ARGV_t * argvp, const char * str, const char * seps)
/*@modifies *argvp @*/;
#ifdef __cplusplus
}
#endif
#endif /* _H_ARGV_ */
|
