--- libaitio/inc/aitio.h 2010/03/04 09:54:23 1.1.1.1.2.4 +++ libaitio/inc/aitio.h 2010/03/11 00:17:52 1.2.2.3 @@ -3,7 +3,7 @@ * by Michael Pounov * * $Author: misho $ -* $Id: aitio.h,v 1.1.1.1.2.4 2010/03/04 09:54:23 misho Exp $ +* $Id: aitio.h,v 1.2.2.3 2010/03/11 00:17:52 misho Exp $ * *************************************************************************/ #ifndef __AITIO_H @@ -29,6 +29,19 @@ struct tagIOURL { char *url_reserved; }; +struct tagIOCmd { + const char *cmd_name; + int (*cmd_func)(void *, FILE *, char **); + const char *cmd_doc; + const char *cmd_help; + char *(*cmd_comp)(const char *, int); +}; + +typedef struct tagIOCmd ioCommands_t; +typedef char *io_CompEntry_t(const char *, int); +typedef char **io_Completion_t(const char *, int, int); + + // io_GetErrno() Get error code of last operation inline int io_GetErrno(); // io_GetError() Get error text of last operation @@ -83,11 +96,24 @@ int ioRegexGet(const char *csRegex, const char *csData char *ioRegexReplace(const char *csRegex, const char *csData, const char *csNew); /* + * io_Path2File() Parse and make path/filename pair + * @csArgs = Input argument line + * @psPath = Output Path, if ==NULL path not returned + * @pathLen = Size of path array + * @psFile = Output File + * @fileLen = Size of file array + * return: 0 error format; -1 error:: can`t read; >0 ok, number of readed items +*/ +inline int io_Path2File(const char * __restrict csArgs, char * __restrict psPath, int pathLen, + char * __restrict psFile, int fileLen); +/* * io_MakeAV() Parse and make attribute/value pair * @csArgs = Input argument line * @csDelim = Delimiter for separate * @psAttr = Output Attribute + * @attrLen = Size of attribute array * @psValue = Output Value, if ==NULL this element not present value or not wanted for return + * @valLen = Size of value array * return: 0 error format; -1 error:: can`t read; >0 ok, number of readed items */ inline int io_MakeAV(const char * __restrict csArgs, const char *csDelim, @@ -127,6 +153,63 @@ int ioURLGet(const char *csURL, struct tagIOURL *url); * return: 0 error attribute not find; -1 error:: can`t read; >0 ok, find at position */ int ioURLGetValue(struct tagIOURL *url, const char *csAttr, char * __restrict psValue, int valLen); +/* + * ioURLGetFile() Get file from parsed URL + * @url = Input parsed URL + * @psValue = Return filename, if not specified file in url path, replace with / + * @valLen = Size of psValue array + * return: -1 error:: can`t read; 0 ok +*/ +int ioURLGetFile(struct tagIOURL *url, char * __restrict psValue, int valLen); + +/* + * ioCLIComp() Initialize completion CLI features + * @cmdComplete = Completion function + * @cmdEntry = Compentry function + * return: none +*/ +inline void ioCLIComp(io_Completion_t *cmdComplete, io_CompEntry_t *cmdEntry); +/* + * ioCLIExec() Execute CLI main loop + * @cmdList = Commands list + * @out = Output handle + * @csPrompt = Prompt text + * return: -1 error, 0 = exit w/^+D, 1 done. +*/ +int ioCLIExec(ioCommands_t *cmdList, FILE *out, const char *csPrompt); + +/* + * io_Cmd_Unsupported() Builtin helper function for unsupported commands + * @cmds = Commands list + * @out = Output handle + * @args = Parsed arguments array + * return: -1 error, 0 = ok, 1 exit from Cli! +*/ +int io_Cmd_Unsupported(void *cmds, FILE *out, char ** __restrict args); +/* + * io_Cmd_Help() Builtin helper function for Help screen + * @cmds = Commands list + * @out = Output handle + * @args = Parsed arguments array + * return: -1 error, 0 = ok +*/ +int io_Cmd_Help(void *cmds, FILE *out, char ** __restrict args); +/* + * io_Cmd_Exit() Builtin helper function for Exit from Cli + * @cmds = Commands list + * @out = Output handle + * @args = Parsed arguments array + * return: 1 exit from Cli! +*/ +int io_Cmd_Exit(void *cmds, FILE *out, char ** __restrict args); + +/* + * io_Comp_Filename() Builtin helper function for filename completion arguments + * @text = Text line + * @state = Position state + * return: NULL not found filename, != NULL filename +*/ +char *io_Comp_Filename(const char *text, int state); #endif