GOptionEntry

GOption struct con

每當我們執行一個命令時後面可能需要一些參數,舉例來說,在terminal中輸入ls -l main.c . GOptionEntry就是GLib提供一個方便我們設定這些參數的結構
typedef struct {
const gchar *long_name; //就是一個參數的完整的名字比如ls -all
gchar short_name; //一個可列印的ASICC字元(character),也就是long_name的簡寫,ls -all 可以寫成ls -a
gint flags; //來自GOptionFlags
GOptionARG arg; // 這個參數的類型,來自GOptionArg, 如G_OPTION_ARG_STRING
gpointer arg_data; //如果arg的類型是G_OPTION_ARG_ARG_CALLBACK, arg_data指向一個GOptionArgFunc類型的callback function,否則,它指向存儲數據的位置,arg_data的具體類型依賴arg的類型
const gchar *description;//該參數在幫助中輸出的信息 -a --all don't ignore entries staring with .
const gchar *arg_description;//選項後面的緊接著的參數說明
} GOptionEntry;
使用,例如我們安裝兩個參數時可以申明一個結構數組
gchar* pointer = NULL;
const GOptionEntry options[] ={
{"-all", 'a', 0, G_OPTION_ARG_STRING, &pointer, "don't ignore staring with .", NULL},
{.........},
{NULL}
};
解析程式後面所跟�的command line��,�程中�使用到一�始宣告的��自���:options[0]、options[1] (型��GOptionEntry)、opt_ctx (型��GOptionContext)。GOptionContext主要用��定�如何解析所代入的command line��,值得注意的是GOptionContext�不允���者�其�容做直接存取的�作,也就是�法�成像是opt_ctx->xxx = ooo;,取而代之,��者得使用GLib所提供的函式�此��的�容做�定。
n g_option_context_new() ─ 建立新的GOptionContext
n g_option_context_set_translation_domain() ─ �定以UTF -8�做�解���依�
n g_option_context_set_ignore_unknown_options() ─ �定�遇到�法辨�的���容�是忽略�是�示成�� (TRUE:忽略, FALSE:��)
n g_option_context_set_help_enabled() ─ �定是否支援--help此一�� (TRUE:支援, FALSE:不支援)
n g_option_context_add_main_entries() ─ �入所有支援的command line����
n g_option_context_set_summary() ─ �有支援--help���,呼叫此函式所�入的summary�容���示在help�
n g_option_context_parse() ─ 解析所�入的command line��。�使用者�入--help且--help有被支援�,此函式�根�上述的�定自��生help檔案。�注意,此函式�行完�後�修改 argv的�容 (�除--和-),另外�呼叫g_option_context_parse()解析command line��的�候,此函��根�GOptionEntry中的arg�定arg_data��入何值。以本程式�例,G_OPTION_ARG_NONE��後面的��(become_daemon)�容�成TRUE;而G_OPTION_ARG_FILENAME ���使用者所�入的字串存入後面的��(user_pidfile)
n g_option_context_free() ─ �放使用完�的GOptionContext
一個具體的函式例子流程:
gpointer iter; //具體的類型自己決定
GOptionEntry options[] = {
{......},
{......},
{NULL}
};
GError* error = NULL;
GOptionContext * opt_ctx = g_option_context_new(...);
g_option_context_add_main_entries(opt_ctx, options, NULL);
g_option_context_parse(....);
g_option_context_free();

相關詞條

相關搜尋

熱門詞條

聯絡我們