kenmirrors/asterisk
1
0
Fork 0
mirror of https://github.com/asterisk/asterisk.git synced 2025-10-07 13:49:18 +00:00
Code Issues Packages Projects Releases Wiki Activity

add the ability to define a structure type for argument parsing when it would be useful to be able to pass it between functions

Browse Source 
git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@100305 65c4cc65-6c06-0410-ace0-fbb531ad65f3
This commit is contained in:
Kevin P. Fleming
2008-01-24 22:26:04 +00:00
parent 1fd8f0fe8c
commit 8b7dc8e93e
1 changed files with 20 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
include/asterisk/app.h
View File

@@ -267,11 +267,11 @@ int ast_app_group_list_unlock(void);
#define AST_APP_ARG(name) char *name #define AST_APP_ARG(name) char *name
/*! /*!
\brief Declare a structure to hold the application's arguments. \brief Declare a structure to hold an application's arguments.
\param name The name of the structure \param name The name of the structure
\param arglist The list of arguments, defined using AST_APP_ARG \param arglist The list of arguments, defined using AST_APP_ARG
This macro defines a structure intended to be used in a call This macro declares a structure intended to be used in a call
to ast_app_separate_args(). The structure includes all the to ast_app_separate_args(). The structure includes all the
arguments specified, plus an argv array that overlays them and an arguments specified, plus an argv array that overlays them and an
argc argument counter. The arguments must be declared using AST_APP_ARG, argc argument counter. The arguments must be declared using AST_APP_ARG,
@@ -281,12 +281,28 @@ int ast_app_group_list_unlock(void);
ast_app_separate_args() will perform that function before parsing ast_app_separate_args() will perform that function before parsing
the arguments. the arguments.
*/ */
#define AST_DECLARE_APP_ARGS(name, arglist) \ #define AST_DECLARE_APP_ARGS(name, arglist) AST_DEFINE_APP_ARGS_TYPE(, arglist) name
/*!
\brief Define a structure type to hold an application's arguments.
\param type The name of the structure type
\param arglist The list of arguments, defined using AST_APP_ARG
This macro defines a structure type intended to be used in a call
to ast_app_separate_args(). The structure includes all the
arguments specified, plus an argv array that overlays them and an
argc argument counter. The arguments must be declared using AST_APP_ARG,
and they will all be character pointers (strings).
\note This defines a structure type, but does not declare an instance
of the structure. That must be done separately.
*/
#define AST_DEFINE_APP_ARGS_TYPE(type, arglist) \
struct { \ struct { \
unsigned int argc; \ unsigned int argc; \
char *argv[0]; \ char *argv[0]; \
arglist \ arglist \
} name }
/*! /*!
\brief Performs the 'standard' argument separation process for an application. \brief Performs the 'standard' argument separation process for an application.