curlib.h

下拉菜单的源程序

/*----------------------------------------------------------------------------*
 * Function: 获得指定的菜单项的状态.
 * Argument:
 *           menu_t *hmenu - 菜单句柄(即菜单的入口指针).
 *           int position - 指定菜的单项的位置(1...n).
 *           uchar *flag - 控制标志:MF_ENABLED,MF_GRAYED,MF_CHECKED,MF_UNCHECKED
 * Return  : 
 *           >= 0 菜单项的先前状态.
 *           <  0 菜单项不存在或是一分隔符.
 *----------------------------------------------------------------------------*/
extern int get_menuitem_status(menu_t *hmenu,int position,uchar *flag);
/*----------------------------------------------------------------------------*
 * Function: 允许,禁止或变灰指定的菜单项.
 * Argument:
 *           menu_t *hmenu - 菜单句柄(即菜单的入口指针).
 *           int position - 指定菜的单项的位置(1...n).
 *           uchar flag - 控制标志:MF_ENABLED,MF_GRAYED,MF_CHECKED,MF_UNCHECKED
 * Return  : 
 *           >= 0 菜单项的先前状态.
 *           <  0 菜单项不存在或是一分隔符.
 *----------------------------------------------------------------------------*/
extern int set_menuitem_status(menu_t *hmenu,int position,uchar flag);
/*----------------------------------------------------------------------------*
 * Function: 获得主菜单的句柄.
 * Argument:
 *           None.
 * Return  : 
 *           menu_t * - 菜单句柄(即菜单的入口指针).
 *           NULL 如果该菜单项没有子菜单或没有找到该菜单项.
 *----------------------------------------------------------------------------*/
extern menu_t *get_menu();
/*----------------------------------------------------------------------------*
 * Function: 获得指定的菜单项的激活的子菜单的句柄.
 * Argument:
 *           menu_t *hmenu - 菜单句柄(即菜单的入口指针).
 *           int position - 指定菜的单项的位置(1...n).
 * Return  : 
 *           menu_t * - 子菜单句柄(即子菜单的入口指针).
 *           NULL 如果该菜单项没有子菜单或没有找到该菜单项.
 *----------------------------------------------------------------------------*/
extern menu_t *get_submenu(menu_t *hmenu,int position);

/****************************************************************************** 
 * <第五章> 字符串操作函数.                                                   *
 ******************************************************************************/
/*----------------------------------------------------------------------------*
 * Function: SPACE(生成空格).
 * Argument: 
 *           int num - 空格数目.
 * Return  : 
 *           char * - 指针.                                  
 *           NULL - 长度小于0或太大.
 *----------------------------------------------------------------------------*/
extern char *space(int num);
/*----------------------------------------------------------------------------*
 * FUNCTION: 删除字符串右边空格和TAB键(str的值要变).
 * Argument:
 *           char *str - 字符串.
 * Return  : 
 *           指针.                                  
 *----------------------------------------------------------------------------*/
extern char *rtrim(char *str);
/*----------------------------------------------------------------------------*
 * FUNCTION: 删除字符串左边空格和TAB键(str的值要变).
 * Argument:
 *           char *str - 字符串.
 * Return  : 
 *           指针.                                  
 *----------------------------------------------------------------------------*/
extern char *ltrim(char *str);
/*----------------------------------------------------------------------------*
 * Function: 由分隔符分开的子串总数目.
 * Argument:
 *           char *str - 串.
 *           char ch   - 分隔字符.
 * Return  : 
 *           > 0 总数目(1...n).
 *           = 0 没有匹配项.
 *----------------------------------------------------------------------------*/
extern int get_item_num(char *str,char ch);
/*----------------------------------------------------------------------------*
 * Function: 读取分隔符分开的第几个子串.
 * Argument:
 *           char *str - 源串.
 *           char ch   - 分隔字符.
 *           int  num  - 第几个(0..n).
 * Return  :
 *           结果子串,没有匹配项,则返回其本身.
 *           NULL, 超过子串数目.
 *----------------------------------------------------------------------------*/
extern char *get_item(char *str,char ch,int num);
/*----------------------------------------------------------------------------*
 * Function: 检查字串中,整数部分的有效位数.
 * Argument: 
 *           char *numbuf - 字串.
 * Return  : 
 *           >= 0 整数部分的位数.
 *           < 0 Error.
 *----------------------------------------------------------------------------*/
extern int get_intlen(char *numbuf);
/*----------------------------------------------------------------------------*
 * Function: 由分隔符分开的子串最大长度.
 * Argument:
 *           char *str - 串.
 *           char ch   - 分隔字符.
 * Return  :
 *           >= 0 最大长度.
 *           < 0  不存在.
 *----------------------------------------------------------------------------*/
extern int get_item_maxlen(char *str,char ch);
/*----------------------------------------------------------------------------*
 * Function: 检查字符是否在字符串中出现,并且返回序号(0...N).
 * Argument:
 *           char *str - 字符串.
 *           char c - 字符.
 * Return  :
 *           >= 0 if in.
 *           = -1 if not in.
 *----------------------------------------------------------------------------*/
extern int is_in(char *str,char ch);
/*----------------------------------------------------------------------------*
 * FUNCTION: 求字符在字符串中出现的次数(1...N).
 * Argument:
 *           char *str - 字符串.
 *           char c - 字符.
 * Return  :
 *           > 0 if in.
 *           = 0 if not in.
 *----------------------------------------------------------------------------*/
extern int count_chnum(char *str,char ch);
/*----------------------------------------------------------------------------*
 * Function: 检查字符串 substr 是否为字符串 str 的子串,并且返回序号.
 * Argument:
 *           char *substr - 子串.
 *           char *str - 字符串.
 * Return  : 
 *           0...n  index on str,if found.
 *           -1     if not found.
 *----------------------------------------------------------------------------*/
extern int index_on_str(char *substr,char *str);
/*----------------------------------------------------------------------------*
 * Function: <字串>在<字串表>中序号(0...N).
 * Argument:
 *           char *str - 字符串.
 *           char **strtab - 字符串表.
 * Return  :
 *           0...n  index on strtab,if found.
 *           -1     if not found.
 * Notes   : 字串表 以 '\0' 串结束.
 *----------------------------------------------------------------------------*/
extern int index_on_strtab(char *str,char **strtab);
/*----------------------------------------------------------------------------*
 * Function: Ring Bell.
 * Argument:
 *           int num - Bell numbers.
 * Return  : None.
 *----------------------------------------------------------------------------*/
extern void beeps(int num);
/*----------------------------------------------------------------------------*
 * FUNCTION: 连接若干子串(最后一个串之后,以NULL结束)
 * Argument:
 *           char *strbuf - 第一个字符串,连接后的串返回到该串中.
 *           多个字串,以NULL结束.
 * Return  : 
 *           None.
 *----------------------------------------------------------------------------*/
extern int strcatm();
/*----------------------------------------------------------------------------*
 * FUNCTION: 截取子字符串(string不变). 
 * Argument:
 *           char *string - 字符串.
 *           int start - 开始位置.
 *           int number - 截取长度.
 * Return  : 
 *           char * - 子字符串指针.                                  
 *----------------------------------------------------------------------------*/
extern char *substr(char *string,int start,int number);
/*----------------------------------------------------------------------------*
 * FUNCTION: 反转字串(string要改变), 如:"1234" -> "4321".
 * Argument:
 *           char *string - 字符串.
 * Return  : 
 *           char * - 字符串指针.                                  
 *----------------------------------------------------------------------------*/
extern char *strrev(char *string);
/*----------------------------------------------------------------------------*
 * FUNCTION: 把string2插入string1中.
 * Argument:
 *           char *string1 - 字符串1.
 *           int start - 开始位置.
 *           int number - 长度.
 *           char *string2 - 字符串2.
 * Return  : 
 *           char * - 字符串指针.                                  
 *----------------------------------------------------------------------------*/
extern char *ins_str(char *string1,int start,int number,char *string2);
/*----------------------------------------------------------------------------*
 * FUNCTION: 把string中的字符c1替换c2.
 * Argument:
 *           char *string - 字符串.
 *           char *c1 - 字符1.
 *           char *c2 - 字符2.
 * Return  : 
 *           char * - 字符串指针.                                  
 *----------------------------------------------------------------------------*/
extern char *strcce(char *string,char c1,char c2);
/*----------------------------------------------------------------------------*
 * FUNCTION: 字符删除.
 * Argument:
 *           char *string - 字符串.
 *           char *c - 删除的字符.
 * Return  : 
 *           char * - 字符串指针.                                  
 *----------------------------------------------------------------------------*/
extern char *strcd(char *string,char c);
/*----------------------------------------------------------------------------*
 * FUNCTION: 把字串(可以转换的字符)转成大写.
 * Argument:
 *           char *string - 字符串.
 * Return  : 
 *           char * - 字符串指针.                                  
 *----------------------------------------------------------------------------*/
extern char *str_toupper(char *string);
/*----------------------------------------------------------------------------*
 * FUNCTION: 把字串(可以转换的字符)转成小写
 * Argument:
 *           char *string - 字符串.
 * Return  : 
 *           char * - 字符串指针.                                  
 *----------------------------------------------------------------------------*/
extern char *str_tolower(char *string);
/*----------------------------------------------------------------------------*
 * FUNCTION: 把可以转换的字符转成大写.
 * Argument:
 *           char *ch - 字符串.
 * Return  : 
 *           char - 字符.                                  
 * Comment : 系统的 islower(ch) 函数在 ch>0xe0 时也返回 2 ,
 *           导致 toupper(ch) 函数错误.
 *----------------------------------------------------------------------------*/
extern int my_toupper(char ch);

/****************************************************************************** 
 * <第章> 字符串转换函数.                                                   *
 ******************************************************************************/
/*----------------------------------------------------------------------------*
 * FUNCTION: 浮点数转成字串.
 * Argument:
 *           double value - 浮点数.
 *           char *string - 字符串.
 *           int dec - 小数点位置.
 *           int width - 浮点数宽度.
 * Return  : 
 *           char * - 字符串指针.                                  
 *----------------------------------------------------------------------------*/
extern char *ftoa(double value,char *string,int dec,int width);
/*----------------------------------------------------------------------------*
 * FUNCTION: 长整数转成字串.
 * Argument:
 *           long value - 长整数.
 *           char *string - 字符串.
 *           int ch - 空格的替换字符.
 *           int width - 长整数宽度.
 * Return  : 
 *           char * - 字符串指针.                                  
 *----------------------------------------------------------------------------*/
extern char *ltoa(long value,char *string,int ch,int width);
/*----------------------------------------------------------------------------*
 * FUNCTION: 整型转成字串.
 * Argument:
 *           int value - 整数.
 *           char *string - 字符串.
 *           int ch - 空格的替换字符.
 *           int width - 整数宽度.