SCAN_OPTIONS 3.01

[戻る] [English Page]

名前

set_options - 複数のオプション登録ルーチン
set_option - オプション登録ルーチン
alias_option - オプションの別名登録ルーチン
scan_options - 複数のオプション解析ルーチン
is_option - コマンドライン解析結果の取得ルーチン
reset_options - 内部記憶領域のクリアルーチン

形式

#include <options.h>

typedef struct {
  char *opt;
  void *var;
} option_record;
opt - キーとなる文字列
var - 引数

void set_options(int n, option_record options[]);
n - 登録するキーの数
options - 登録するキーなどを格納した構造体の配列

option_complex *set_option(char *key, ...)
key, ... - キーを表す文字列と可変引数

option_complex *alias_option(char *key, char *alias);
key - 既に登録されているキーを表す文字列
alias - その別名

void scan_options(int argc, char *argv[]);
argc - コマンドライン引数の数
argv - コマンドライン引数

int is_option(char *key);
key - キーを表す文字列

int reset_options()

説明

コマンドラインオプションの規則を表すキーをオプション構造体 option_record 及び set_options もしくは手続き set_option で登録し、登録されたキーをコマンドラインから解析するルーチン群です。set_option もしくは set_options でキーを登録し、scan_options で解析と変数への代入などを行います。個々のキーに関する解析結果は is_option で取得できます。また、これらのルーチンはメモリを内部確保するので、使用後には reset_options を実行して下さい。以下はオプション解析の一連の手続き例です。
 
char title[256];
int number, color, width, height;
float weight;
int flag, mode, sw;
option_record options[] = {
  { "-title %s", title },
  { "-number %d", &number },
  { "-weight %f", &weight },
  { "-flag[-]", &flag },
  { "[-+]mode", &mode },
  { "[+-]sw", &sw },
  { "-color Red Green Blue", &color },
  { "-help", NULL },
};

set_options(8, options);
set_option("-geom %dx%d", &width, &height);
alias_option("-geom", "-geometry");
scan_options(argc, argv);
if (is_option("-help"))
  show_help();
reset_options();


キーの形式は option.h 準拠ですので、そちらを参考にして下さい。

参照

option.h

作者

山田 泰司 <taiji@aihara.co.jp>