/usr/include/jim-subcmd.h is in libjim-dev 0.75-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | /* Provides a common approach to implementing Tcl commands
* which implement subcommands
*/
#ifndef JIM_SUBCMD_H
#define JIM_SUBCMD_H
#include <jim.h>
#ifdef __cplusplus
extern "C" {
#endif
#define JIM_MODFLAG_HIDDEN 0x0001 /* Don't show the subcommand in usage or commands */
#define JIM_MODFLAG_FULLARGV 0x0002 /* Subcmd proc gets called with full argv */
/* Custom flags start at 0x0100 */
/**
* Returns JIM_OK if OK, JIM_ERR (etc.) on error, break, continue, etc.
* Returns -1 if invalid args.
*/
typedef int jim_subcmd_function(Jim_Interp *interp, int argc, Jim_Obj *const *argv);
typedef struct {
const char *cmd; /* Name of the (sub)command */
const char *args; /* Textual description of allowed args */
jim_subcmd_function *function; /* Function implementing the subcommand */
short minargs; /* Minimum required arguments */
short maxargs; /* Maximum allowed arguments or -1 if no limit */
unsigned short flags; /* JIM_MODFLAG_... plus custom flags */
} jim_subcmd_type;
/**
* Looks up the appropriate subcommand in the given command table and return
* the command function which implements the subcommand.
* NULL will be returned and an appropriate error will be set if the subcommand or
* arguments are invalid.
*
* Typical usage is:
* {
* const jim_subcmd_type *ct = Jim_ParseSubCmd(interp, command_table, argc, argv);
*
* return Jim_CallSubCmd(interp, ct, argc, argv);
* }
*
*/
const jim_subcmd_type *
Jim_ParseSubCmd(Jim_Interp *interp, const jim_subcmd_type *command_table, int argc, Jim_Obj *const *argv);
/**
* Parses the args against the given command table and executes the subcommand if found
* or sets an appropriate error if the subcommand or arguments is invalid.
*
* Can be used directly with Jim_CreateCommand() where the ClientData is the command table.
*
* e.g. Jim_CreateCommand(interp, "mycmd", Jim_SubCmdProc, command_table, NULL);
*/
int Jim_SubCmdProc(Jim_Interp *interp, int argc, Jim_Obj *const *argv);
/**
* Invokes the given subcmd with the given args as returned
* by Jim_ParseSubCmd()
*
* If ct is NULL, returns JIM_ERR, leaving any message.
* Otherwise invokes ct->function
*
* If ct->function returns -1, sets an error message and returns JIM_ERR.
* Otherwise returns the result of ct->function.
*/
int Jim_CallSubCmd(Jim_Interp *interp, const jim_subcmd_type *ct, int argc, Jim_Obj *const *argv);
#ifdef __cplusplus
}
#endif
#endif
|