GoAhead2.5源代码分析之4-用户管理用到的一些函数（uemf.c misc.c）

Uemf.c和misc.c(用户管理用到的一些函数)

void error(E_ARGS_DEC, int etype, char_t *fmt, ...)

功能：将出现的错误根据错误类型，输出对应字符串

说明：函数中使用了var_start,var_end, var_arg等宏

下面我们来探讨如何写一个简单的可变参数的C函数。写可变参数的 C函数要在程序中用到以下这些宏：

void va_start( va_list arg_ptr, prev_param );

type va_arg( va_list arg_ptr, type ); 

void va_end( va_list arg_ptr ); 

va在这里是variable-argument(可变参数)的意思。 

这些宏定义在stdarg.h中，所以用到可变参数的程序应该包含这个 头文件。下面我们写一个简单的可变参数的函数，改函数至少有一个整数 参数，第二个参数也是整数，是可选的.函数只是打印这两个参数的值.。

void simple_va_fun(int i, ...) 

{

va_list arg_ptr; 

int j=0; 

va_start(arg_ptr, i); 

j=va_arg(arg_ptr, int); 

va_end(arg_ptr); 

printf("%d %d\n", i, j); 

return; 

} 

我们可以在我们的头文件中这样声明我们的函数：

extern void simple_va_fun(int i, ...); 

我们在程序中可以这样调用：

simple_va_fun(100); 

simple_va_fun(100,200); 

从这个函数的实现可以看到,我们使用可变参数应该有以下步骤：

1)首先在函数里定义一个va_list型的变量，这里是arg_ptr,这个变 量是指向参数的指针；

2)然后用va_start宏初始化变量arg_ptr，这个宏的第二个参数是第 一个可变参数的前一个参数，是一个固定的参数.；

3)然后用va_arg返回可变的参数,并赋值给整数j. va_arg的第二个 参数是你要返回的参数的类型，这里是int型；

4)最后用va_end宏结束可变参数的获取.然后你就可以在函数里使 用第二个参数了。如果函数有多个可变参数的，依次调用va_arg获 取各个参数。

-----------------------------------------------------------------------------------------------------------------

 

void (*errorSetHandler(void (*function)(int etype, char_t *msg))) (int etype, char_t *msg)

功能：重新赋予错误处理函数

说明：

-----------------------------------------------------------------------------------------------------------------

 

void trace(int level, char_t *fmt, ...)

功能：向日志文件trace.txt中输出踪迹

说明：

-----------------------------------------------------------------------------------------------------------------

 

void traceRaw(char_t *buf)

功能：向日志文件trace.txt中输出踪迹

说明：

-----------------------------------------------------------------------------------------------------------------

 

void (*traceSetHandler(void (*function)(int level, char_t *buf))) (int level, char *buf)

功能：赋予新的trace函数

说明：

-----------------------------------------------------------------------------------------------------------------

char_t *strlower(char_t *string)

功能：将字符串转换为小写的

说明：

-----------------------------------------------------------------------------------------------------------------

 

char_t *strupper(char_t *string)

功能：将字符串转换为大写的

说明：

-----------------------------------------------------------------------------------------------------------------

 

char_t *stritoa(int n, char_t *string, int width)

功能：将整数转换为字符串

说明：

-----------------------------------------------------------------------------------------------------------------

 

void defaultErrorHandler(int etype, char_t *msg)

功能：默认的错误处理handler

说明：

-----------------------------------------------------------------------------------------------------------------

 

void defaultTraceHandler(int level, char_t *buf)

功能：默认的trace处理handler

说明：

-----------------------------------------------------------------------------------------------------------------

 

char_t *basicGetProduct()

功能：返回uemf

说明：

-----------------------------------------------------------------------------------------------------------------

 

char_t *basicGetAddress()

功能：返回localhost

说明：

-----------------------------------------------------------------------------------------------------------------

 

===========================================================

-----------------------------------------------------------------------------------------------------------------

 

int fmtAlloc(char_t **s, int n, char_t *fmt, ...)

功能：分配一段按照fmt形式的内存，里面存放字符串fmt

说明：

-----------------------------------------------------------------------------------------------------------------

 

int fmtStatic(char_t *s, int n, char_t *fmt, ...)

功能：分配一段按照fmt形式的内存，里面存放字符串fmt

说明：

-----------------------------------------------------------------------------------------------------------------

 

int fmtRealloc(char_t **s, int n, int msize, char_t *fmt, ...)

功能：分配一段按照fmt形式的内存，里面存放字符串fmt

说明：

-----------------------------------------------------------------------------------------------------------------

 

int fmtValloc(char_t **s, int n, char_t *fmt, va_list arg)

功能：分配一段按照fmt形式的内存，里面存放字符串fmt

说明：

-----------------------------------------------------------------------------------------------------------------

 

static int dsnprintf(char_t **s, int size, char_t *fmt, va_list arg, int msize)

功能：输出一段字符

说明：这个函数比较复杂，需要认真看。

-----------------------------------------------------------------------------------------------------------------

 

static int gstrnlen(char_t *s, unsigned int n)

功能：获得字符串的长度

说明：

-----------------------------------------------------------------------------------------------------------------

 

static void put_char(strbuf_t *buf, char_t c)

功能：向buf中输出一个字符

说明：

-----------------------------------------------------------------------------------------------------------------

 

static void put_string(strbuf_t *buf, char_t *s, int len, int width,       int prec, enum flag f)

功能：向buf中输出字符串

说明：

-----------------------------------------------------------------------------------------------------------------

 

static void put_ulong(strbuf_t *buf, unsigned long int value, int base,int upper, char_t *prefix, int width, int prec, enum flag f)

功能：向buf中输出long数

说明：

-----------------------------------------------------------------------------------------------------------------

 

char_t *ascToUni(char_t *ubuf, char *str, int nBytes)

功能：将asc字符串转换为uni字符串

说明：

-----------------------------------------------------------------------------------------------------------------

 

char *uniToAsc(char *buf, char_t *ustr, int nBytes)

功能：将uni字符串转换为asc字符串

说明：

-----------------------------------------------------------------------------------------------------------------

 

char_t *ballocAscToUni(char *cp, int alen)

功能：将asc字符串转换为uni字符串

说明：

-----------------------------------------------------------------------------------------------------------------

 

char *ballocUniToAsc(char_t *unip, int ulen)

功能：将uni字符串转换为asc字符串

说明：

-----------------------------------------------------------------------------------------------------------------

 

unsigned int hextoi(char_t *hexstring)

功能：将16进制字符串转换整数

说明：

-----------------------------------------------------------------------------------------------------------------

 

unsigned int gstrtoi(char_t *s)

功能：将字符串转换为整数，可以是16、10进制数

说明：

-----------------------------------------------------------------------------------------------------------------