Return to aitio.h CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / libaitio / inc

new version

    1: /*************************************************************************
    2: * (C) 2010 AITNET ltd - Sofia/Bulgaria - <misho@aitbg.com>
    3: *  by Michael Pounov <misho@openbsd-bg.org>
    4: *
    5: * $Author: misho $
    6: * $Id: aitio.h,v 1.2 2010/03/09 09:26:27 misho Exp $
    7: *
    8: *************************************************************************/
    9: #ifndef __AITIO_H
   10: #define __AITIO_H
   11: 
   12: 
   13: typedef struct _tagURLItem {
   14: 	int	vallen;
   15: 	char	*value;
   16: } url_Item_t;
   17: 
   18: struct tagIOURL {
   19: 	unsigned char	url_line[BUFSIZ];
   20: 
   21: 	url_Item_t	url_tech;
   22: 	url_Item_t	url_user;
   23: 	url_Item_t	url_pass;
   24: 	url_Item_t	url_host;
   25: 	url_Item_t	url_port;
   26: 	url_Item_t	url_path;
   27: 	url_Item_t	url_args;
   28: 
   29: 	char		*url_reserved;
   30: };
   31: 
   32: // io_GetErrno() Get error code of last operation
   33: inline int io_GetErrno();
   34: // io_GetError() Get error text of last operation
   35: inline const char *io_GetError();
   36: 
   37: 
   38: /*
   39:  * ioPromptRead() Read data from input h[0] with prompt to output h[1]
   40:  * @h = file handles h[0] = input, h[1] = output, if NULL use stdin, stdout
   41:  * @csPrompt = Prompt before input, may be NULL
   42:  * @psData = Readed data
   43:  * @dataLen = Length of data
   44:  * return: 0 EOF; -1 error:: can`t read; >0 count of readed chars
   45: */
   46: int ioPromptRead(int *h, const char *csPrompt, char * __restrict psData, int dataLen);
   47: /*
   48:  * ioPromptPassword() Read password from input h[0] with prompt to output h[1]
   49:  * @h = file handles h[0] = input, h[1] = output, if NULL use stdin, stdout
   50:  * @csPrompt = Prompt before input, may be NULL
   51:  * @psPass = Readed password
   52:  * @passLen = Length of password
   53:  * @confirm = Confirm password, 0 - get password, !=0 Ask for confirmation
   54:  * return: 0 EOF; -1 error:: can`t read; >0 count of readed chars
   55: */
   56: int ioPromptPassword(int *h, const char *csPrompt, char * __restrict psPass, int passLen, int confirm);
   57: 
   58: /*
   59:  * ioRegexVerify() Function for verify data match in regex expression
   60:  * @csRegex = Regulare expression pattern
   61:  * @csData = Data for check and verify
   62:  * @startPos = Return start positions
   63:  * @endPos = Return end positions
   64:  * return: NULL not match or error; !=NULL begin of matched data
   65: */
   66: const char *ioRegexVerify(const char *csRegex, const char *csData, int *startPos, int *endPos);
   67: /*
   68:  * ioRegexGet() Function for get data match in regex expression
   69:  * @csRegex = Regulare expression pattern
   70:  * @csData = Data from get
   71:  * @psString = Returned string if match
   72:  * @strLen = Length of string
   73:  * return: 0 not match; >0 count of returned chars
   74: */
   75: int ioRegexGet(const char *csRegex, const char *csData, char * __restrict psString, int strLen);
   76: /*
   77:  * ioRegexReplace() Function for replace data match in regex expression with newdata
   78:  * @csRegex = Regulare expression pattern
   79:  * @csData = Source data
   80:  * @csNew = Data for replace
   81:  * return: NULL not match or error; !=NULL allocated new string, must be free after use!
   82: */
   83: char *ioRegexReplace(const char *csRegex, const char *csData, const char *csNew);
   84: 
   85: /*
   86:  * io_Path2File() Parse and make path/filename pair
   87:  * @csArgs = Input argument line
   88:  * @psPath = Output Path, if ==NULL path not returned
   89:  * @pathLen = Size of path array
   90:  * @psFile = Output File
   91:  * @fileLen = Size of file array
   92:  * return: 0 error format; -1 error:: can`t read; >0 ok, number of readed items
   93: */
   94: inline int io_Path2File(const char * __restrict csArgs, char * __restrict psPath, int pathLen, 
   95: 		char * __restrict psFile, int fileLen);
   96: /*
   97:  * io_MakeAV() Parse and make attribute/value pair
   98:  * @csArgs = Input argument line
   99:  * @csDelim = Delimiter for separate
  100:  * @psAttr = Output Attribute
  101:  * @attrLen = Size of attribute array
  102:  * @psValue = Output Value, if ==NULL this element not present value or not wanted for return
  103:  * @valLen = Size of value array
  104:  * return: 0 error format; -1 error:: can`t read; >0 ok, number of readed items
  105: */
  106: inline int io_MakeAV(const char * __restrict csArgs, const char *csDelim, 
  107: 		char * __restrict psAttr, int attrLen, char * __restrict psValue, int valLen);
  108: /*
  109:  * io_SizeArray() Parse and calculate size of array
  110:  * @csArgs = Input arguments line
  111:  * @csDelim = Delimiter(s) for separate
  112:  * return: 0 error format; -1 error:: can`t read; >0 ok, number of items
  113: */
  114: inline int io_SizeArray(const char *csArgs, const char *csDelim);
  115: /*
  116:  * io_MakeArray() Parse and make array of arguments values
  117:  * @psArgs = Input arguments line
  118:  * @csDelim = Delimiter(s) for separate
  119:  * @args = Output array of arguments ... (must be free() after procced function!)
  120:  * @nargs = Requested count of arguments
  121:  * return: 0 error format; -1 error:: can`t read; >0 ok, number of readed items
  122: */
  123: inline int io_MakeArray(char * __restrict psArgs, const char *csDelim, 
  124: 		char *** __restrict args, int nargs);
  125: 
  126: /*
  127:  * ioURLGet() Parse and get data from input URL
  128:  * @csURL = Input URL line
  129:  * @url = Output parsed URL
  130:  * return: 0 error format not find tech:// and return URL like path; 
  131:  		-1 error:: can`t read; >0 ok, up bits for known elements
  132: */
  133: int ioURLGet(const char *csURL, struct tagIOURL *url);
  134: /*
  135:  * ioURLGetValue() Get value from parsed URL
  136:  * @url = Input parsed URL
  137:  * @csAttr = Attribute for search
  138:  * @psValue = Return value of attribute, if ==NULL only check for existence of attribute
  139:  * @valLen = Size of psValue array
  140:  * return: 0 error attribute not find; -1 error:: can`t read; >0 ok, find at position
  141: */
  142: int ioURLGetValue(struct tagIOURL *url, const char *csAttr, char * __restrict psValue, int valLen);
  143: /*
  144:  * ioURLGetFile() Get file from parsed URL
  145:  * @url = Input parsed URL
  146:  * @psValue = Return filename, if not specified file in url path, replace with /
  147:  * @valLen = Size of psValue array
  148:  * return: -1 error:: can`t read; 0 ok
  149: */
  150: int ioURLGetFile(struct tagIOURL *url, char * __restrict psValue, int valLen);
  151: 
  152: 
  153: #endif