错误处理
如果没有出现错误,初始化函数应该返回0,否则返回1。如果发生一个错误,func_init()应该在message参数中存储错误信息返回给客户。错误信息缓冲区是GBASE_ERRMSG_SIZE(目前在GBase中这个长度是512字符)个字符长,该缓冲区长度不宜设置过大,一般不要超过80字符。
函数返回值
对long long和double函数,主函数func()的返回值即是函数返回值。对字符串函数,字符串可以在result和length参数中被返回。result是255个字节长的一个缓冲区,如果返回结果不超过255,就可以把返回结果放到result中,这样做的一个好处就是不用去管理result的内存。例如:
memcpy(result, “result value”, 12);
*length = 12;
return result;
但是如果返回结果超过255个字节,就需要在func_init()或func()中申请空间并在func_deinit()中释放了,注意不要产生内存泄露。例如:
在func_init中:
initid->ptr = (char *) malloc(MAX_LEN);
在func_deinit中:
free(initid->ptr);
为了在主函数中表明一个NULL返回值,设定is_null为1:
*is_null = 1;
为了在函数中表明一个错误返回,设定error参数为1:
*error = 1;
如果,某一行func()设置*error为1,则当前行函数值是NULL,但是并不影响后续行的结果,func ()将继续被调用。