bbslib::sysconf

作者: 遊手好閒的石頭成 <shirock@mail.educities.edu.tw>
日期: 2001年4月17日

Header files

#include <bbslib/bbsdefs.h>
#include <bbslib/sysconf.h>

也可以直接引入 <bbslib.h> ， bbslib.h 會將引入所有 bbslib 的 header files 。

void load_sysconf(const char*confile);

載入組態檔。在使用下列的其他函數前，必須先呼叫一次 load_sysconf() 。

如果 confile 給 NULL 的話，則載入預設的 confile，即 "/etc/bbs/sysconf.ini" (符號 SYSCONFINI 所定義的內容) 。

load_sysconf() 會依 confile 的內容，建立一個 image file ，並載入此 image file 的內容。呼叫 load_sysconf() 的程式必須具有讀、寫指定的 confile 的權限，否則無法成功載入。

int sysconf_eval(const char* key );

傳回指定 key 的數值，若 key 不存在或其內容不為數字，則傳回 0 。 key 的內容可以負值或十六進位法表示。

char *sysconf_str(const char* key );

傳回指定 key 的字串指標，若 key 不存在，傳回 NULL ，若 key 的內容為數字，傳回字串 "(null ptr)" 。

int sysconf_strs(const char*key, char*strar[],int strar_size);

傳回指定 key 的一組字串指標，回傳值為該組字串的字串數目，若 key 不存在，傳回 0 。

參數 strar 為存放字串指標的字串指標陣列， size 表示該字串陣列的大小，為了容納表示結尾的 NULL ，最多只會存入 size-1 個字串到 strar 中。

void unload_sysconf();

卸下組態檔。

The TIP Project