#ifndef _H_ARGV_
#define _H_ARGV_
-/** \ingroup rpmio
+/** \ingroup rpmargv
* \file rpmio/argv.h
*/
};
typedef struct ARGI_s * ARGI_t;
-/**
+/** \ingroup rpmargv
* Print argv array elements.
* @param msg output message prefix (or NULL)
* @param argv argv array
*/
void argvPrint(const char * msg, ARGV_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
* 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(const ARGI_t argi);
-/**
+/** \ingroup rpmargv
* Return data from argi array.
* @param argi argi array
* @return argi array data address
*/
ARGint_t argiData(const ARGI_t argi);
-/**
+/** \ingroup rpmargv
* Return no. of elements in argv array.
* @param argv argv array
* @return no. of elements
*/
int argvCount(const ARGV_t argv);
-/**
+/** \ingroup rpmargv
* Return data from argv array.
* @param argv argv array
* @return argv array data address
*/
ARGV_t argvData(const ARGV_t argv);
-/**
+/** \ingroup rpmargv
* Compare argv arrays (qsort/bsearch).
* @param a 1st instance address
* @param b 2nd instance address
*/
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()
*/
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
ARGV_t argvSearch(ARGV_t argv, ARGstr_t val,
int (*compar)(const void *, const void *));
-/**
+/** \ingroup rpmargv
* Add an int to an argi array.
* @retval *argip argi array
* @param ix argi array index (or -1 to append)
*/
int argiAdd(ARGI_t * argip, int ix, int val);
-/**
+/** \ingroup rpmargv
* Add a string to an argv array.
* @retval *argvp argv array
* @param val string arg to append
*/
int argvAdd(ARGV_t * argvp, ARGstr_t val);
-/**
+/** \ingroup rpmargv
* Append one argv array to another.
* @retval *argvp argv array
* @param av argv array to append
*/
int argvAppend(ARGV_t * argvp, const ARGV_t av);
-/**
+/** \ingroup rpmargv
* Split a string into an argv array.
* @retval *argvp argv array
* @param str string arg to split
extern "C" {
#endif
-/**
+/** \ingroup rpmurl
* Supported URL types.
*/
typedef enum urltype_e {
typedef struct urlinfo_s * urlinfo;
-/**
+/** \ingroup rpmurl
* URL control structure.
*/
struct urlinfo_s {
extern int _url_debug; /*!< URL debugging? */
-/**
+/** \ingroup rpmurl
* Create a URL info structure instance.
* @return new instance
*/
urlinfo urlNew(void);
-/**
+/** \ingroup rpmurl
* Free a URL info structure instance.
* @param u URL control structure
* @return dereferenced instance (NULL if freed)
*/
urlinfo urlFree(urlinfo u);
-/**
+/** \ingroup rpmurl
* Return type of URL.
* @param url url string
* @return type of url
*/
urltype urlIsURL(const char * url);
-/**
+/** \ingroup rpmurl
* Return path component of URL.
* @param url url string
* @retval pathp pointer to path component of url
*/
urltype urlPath(const char * url, const char ** pathp);
-/**
+/** \ingroup rpmurl
* Parse URL string into a control structure.
* @param url url string
* @retval uret address of new control instance pointer
*/
int urlSplit(const char * url, urlinfo * uret);
-/**
+/** \ingroup rpmurl
* Copy data from URL to local file.
* @param url url string of source
* @param dest file name of destination