Products Support Documentation Download
rdmcmdlineapi.h File Reference

Header for command line parsing API. More...

#include "rdmcmdlinetypes.h"
#include "rdmretcodetypes.h"
Include dependency graph for rdmcmdlineapi.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions

RDM_RETCODE rdm_cmdlineInit (RDM_CMDLINE *cmd, int32_t argc, const char *const argv[], const char *description, const RDM_CMDLINE_OPT *opts)
 Initialize an RDM_CMDLINE buffer and validate the command line. More...
 
const char * rdm_cmdlineNextLongOption (RDM_CMDLINE *cmd, const char **arg)
 Get next option or argument. More...
 
char rdm_cmdlineNextShortOption (RDM_CMDLINE *cmd, const char **arg)
 Get next option or argument. More...
 

Detailed Description

Header for command line parsing API.

Definition in file rdmcmdlineapi.h.

Function Documentation

◆ rdm_cmdlineInit()

RDM_RETCODE rdm_cmdlineInit ( RDM_CMDLINE cmd,
int32_t  argc,
const char *const  argv[],
const char *  description,
const RDM_CMDLINE_OPT opts 
)

Initialize an RDM_CMDLINE buffer and validate the command line.

This function initializeds an RDM_CMDLINE buffer and parses the command line given. This function must be called before any of the other rdm_cmd functions are called.

If sOKAY is returned call rdm_cmdlineNextShortOption or rdm_cmdlineNextLongOption to get all the option and arguments.

If any error or status other that sOKAY are returned no handle is allocated and you are done parsing the command line and should not continue with normal execution.

Return values
sOKAYSuccess
sCMD_USAGEUsage information was printed and normal execution should not proceed
sCMD_VERSIONThe version number was printed and normal execution should not proceed
eBASE_COMMANDCommand line error and normal execution should not proceed
See also
rdm_cmdlineNextShortOption
rdm_cmdlineNextLongOption
Parameters
[in]cmdA pointer to an RDM_CMDLINE buffer for the command line parser
[in]argcThe number of arguments in argv not counting argv[0]
[in]argvThe command and following options and arguments that are to be parsed
[in]descriptionDescription
[in]optsThe option and argument description for the command line parser

◆ rdm_cmdlineNextLongOption()

const char* rdm_cmdlineNextLongOption ( RDM_CMDLINE cmd,
const char **  arg 
)

Get next option or argument.

This function returns the next option or argument as a string as specified in the long option of the matching RDM_CMDLINE_OPT provided to rdm_cmdAllocCmd. If the long option is specified as NULL the short option is returned instead.

Returns
The matching option
See also
rdm_cmdlineInit
rdm_cmdlineNextShortOption
Parameters
[in]cmdThe RDM_CMDLINE handle for the command line parser initialized by rdm_cmdlineInit
[out]argA pointer to a string pointer where any argument will be returned. NULL means there were no argument. The returned string should not be freed by the application

◆ rdm_cmdlineNextShortOption()

char rdm_cmdlineNextShortOption ( RDM_CMDLINE cmd,
const char **  arg 
)

Get next option or argument.

This function returns the next option or argument as a single character as specified in the short option of the matching RDM_CMDLINE_OPT provided to rdm_cmdAllocCmd.

This function should not be used in the case where some short options are specified with the empty string. Use rdm_cmdlineNextLongOption instead.

Returns
The next short option character.
See also
rdm_cmdlineInit
rdm_cmdlineNextLongOption
Parameters
[in]cmdThe RDM_CMDLINE handle for the command line parser initialized by rdm_cmdlineInit
[out]argA pointer to a string pointer where any argument will be returned. NULL means there were no argument. The returned string should not be freed by the application