GETOPT

名前

書式

説明

getopt を呼び出すときに使用するパラメータは、2 つの部分に分けることができる。 すなわち、getopt が解析を行うときの動作を変更するオプション部分 (上記「書式」の options と opstring) と、解析の対象になるパラメータ部分 (上記「書式」の parameters) の 2 つである。2 番目の部分は、 オプションではない最初のパラメータで、オプションの引き数でもないものから始まるか、 あるいは、'--' が最初に現れた位置の直後から始まる。なお、1 番目の部分に '-o' や '--options' オプションが存在しない場合は (訳注: そして、他のオプションや -- が存在するならば、それは「書式」セクションの第 2 の書式に当たる)、2 番目の部分の最初のパラメータが、解析の対象となるショートオプションを 1 つにまとめたショートオプションズ文字列 (すなわち optsting) として使用される。

[訳注]

「書式」セクションの第 3 の書式で、解析の対象になるパラメータをオプションから始めるときは、その前に '--' を置く必要がある。そうしないと、getopt 自体のオプションと誤解されることになる。 解析の対象をファイル名などから始めるときは、'--' を置かなくてもよい。

環境変数 GETOPT_COMPATIBLE が設定されている場合や、最初のパラメータがオプションではない場合 (すなわち、'-' で始まっていない場合で、これは「書式」セクションの第 1 の書式である)、この getopt は他のバージョンの getopt(1) と互換性のある出力を生成する。 なお、その場合でもやはりパラメータの並べ替えは行うし、指定が任意の引き数の認識もする (詳細については、「互換性」セクションを参照していただきたい)。

従来の getopt(1) の実装では、引き数などのオプションではないパラメータの中に、ホワイトスペース (訳注: 空白、タブ、改行など) や (シェル固有の) 特殊文字などがあると、それに対処することができなかった。 この問題を解決するために、この実装では、クォートした出力を生成できるようになっているが、 そうした出力は、シェルによってもう一度解釈される必要がある (たいていは、そのために eval コマンドを使用する。[訳注: もっと詳しく言うと、 PARAM=$(getopt -o 'a:b::c' -- "$@"); eval set -- "$PARAM" といった方法を用いて、位置パラメータを再構成する])。 この出力形式を使えば、ホワイトスペースや特殊文字を保護することにはなるが、それには getopt を他のバージョンともはや互換性のない形で呼び出さなければならない (すなわち、「書式」セクションの第 2 や 第 3 の書式だ)。御使用のシステムに getopt(1) のこの強化版がインストールされているかどうかを知るには、 専用のテストオプション (-T) を使用すればよい。  

オプション

-a, --alternative

ロングオプションを 1 個の '-' で始めることができるようにする。

-h, --help

ヘルプを表示して、終了する。それ以上何も出力しない。

-l, --longoptions longopts

認識すべきロング (複数の文字からなる) オプション群を指定する。 2 個以上のオプション名を、コンマで区切って一度に指定することができる。 このオプションは複数回指定することもでき、その場合も longopts が追加されていく。longouts 中の各ロングオプション名の後ろには、コロンを続けることができる。コロンが 1 個のときは、 引き数が必須だということであり、2 個のときは、 引き数は任意、すなわち、あってもなくてもよいということである。

[訳注]

ロングオプションのみを使い、ショートオプションを全く使わない場合は、-o オプションに空文字列を渡すことで (-o '') それを明示的に宣言しなければならない。「バグ」セクションを参照。

-n, --name progname

getopt(3) ルーティンが、エラーを通知する際に使用するプログラム名を指定する。 getopt(1) 自体に関するエラーは (訳注: たとえば、 getopt コマンドのオプションが間違っている場合などは)、やはり getopt コマンドがエラーの発生元として報告されることに注意していただきたい。

-o, --options shortopts

認識すべきショート (1 文字からなる) オプション群を指定する。 このオプションが指定されていない場合は、'-' で始まらない (そして、オプションの引数でもない) getopt の最初のパラメータが、 ショートオプションを一つにまとめたショートオプションズ文字列として使用される (訳注: 「書式」セクションの第 2 の書式)。shortopts 中のショートオプション各文字の後ろには、コロンを続けることができる。コロンが 1 個のときは、引き数が必須だということであり、2 個のときは、引き数は任意、すなわち、あってもなくてもよいということである。 また、shortopts の先頭に '+' や '-' という文字を付ければ、オプションの解析の仕方や、出力の生成の仕方を変更することができる (詳細については、「スキャニングモード」セクションを参照すること)。

-q, --quiet

getopt(3) の出すエラーメッセージを表示しない。

-Q, --quiet-output

通常の出力を生成しない。それでも、 -q も同時に指定しないかぎり、 getopt(3) によるエラー報告は行われる。

-s, --shell shell

クォート方式を shell のものにする。-s オプションが指定されていない場合は、 BASH のクォート方式が使われる。 指定可能な引き数は、現在のところ 'sh', 'bash', 'csh', 'tcsh' である。

-T, --test

現在使っている getopt(1) が、強化バージョンか古いバージョンかをテストする。 このオプションは何も出力しないが、エラーステータスを 4 にする。 getopt(1) の他の実装や、このバージョンでも環境変数 GETOPT_COMPATIBLE が設定されている場合は、 '--' を返して、エラーステータスを 0 にする。

-u, --unquoted

出力をクォートしない。このモードでは、ホワイトスペースや (シェルによって様々な) 特殊文字が、 (getopt(1) の他の実装におけると同様に) 望ましからぬ混乱を引き起こしかねないことに、注意していただきたい。

-V, --version

バージョン情報を表示して、終了する。それ以上何も出力しない。

構文解析

[訳注]

getopt の使い方の簡単な例を挙げる。 たとえば、シェル関数やシェルスクリプト中に次のように書く。

    PARAM=$(getopt -o 'a:b::c' -- "$@")
    eval set -- "$PARAM"

このようにして、シェル関数やスクリプトに渡された引き数群を、位置パラメータを利用して、 どれがオプションで、どれがそのオプション引き数、どれがそれ以外か、わかりやすく、 処理しやすいように再構成するわけである。詳しくは、「出力」セクションや、 「用例」で述べているスクリプトの見本を参照していただきたい。

「シェル関数を呼んだときに渡す各パラメータは、getopt に渡されるパラメータリスト中のパラメータと 1 対 1 で対応していなければならない」というのは、 シェル関数やシェルスクリプトに渡すパラメータでも、 それが空白などを含むようならクォートしなければならないのはもちろん、以下で説明するような getopt コマンドのパラメータの書式にも従っていなければならないということである。 たとえば、引き数が任意のショートオプション -b に引き数を指定する場合は、-bXXX などと、間に空白を置かずに指定しなければならない。

パラメータ群は左から右へ解析される。各パラメータは、ショートオプション、ロングオプション、 オプションの引き数、オプションとは無関係なパラメータに分割分類される。

単純なショートオプションは、1 個の '-' に 1 個のショートオプション文字が続くものである。 オプションが引き数を必須にしている場合は、オプション文字の直後に続けてもよく、 次のパラメータとして (すなわち、コマンドライン上でホワイトスペースを間に置いて) 書いてもよい。オプションの引き数が任意の場合は、それが存在するなら、 オプション文字の直後に続けなければならない。

1 個の '-' の後ろに数個のショートオプションをまとめて指定することもできる。 ただし、最後のオプション以外のすべてのオプションが、 必須や任意の引き数を取らないという条件がある (例外として、最後のオプションは引き数を取ることができる)。

ロングオプションは、通常 '--' で始まり、ロングオプション名がそれに続く。 オプションが引き数を必須にしている場合は、ロングオプション名の直後に '=' で区切って続けてもよく、次の引き数として (すなわち、コマンドライン上でホワイトスペースを間に置いて) 書いてもよい。 オプションの引き数が任意の場合は、それが存在するなら、ロングオプション名の直後に '=' で区切って続けなければならない ('=' を続けたものの、その後に何も指定しない場合は、引き数が存在しないかのように解釈される。 これはちょっとしたバグである。「バグ」セクションを参照)。 ロングオプションは、短縮しても他のオプションと区別が付くかぎり、短縮できる。

'-' で始まっていないパラメータで、直前のオプションの必須の引き数でもないものは、 いずれもオプションとは無関係なパラメータである。また、'--' というパラメータの後にあるパラメータは、常にオプションとは無関係なパラメータと解釈される。 環境変数 POSIXLY_CORRECT が設定されている場合や、ショートオプションズ文字列 (訳注: 「書式」の optstring) が '+' で始まっている場合は、オプションとは無関係な最初のパラメータが見つかった時点で、 残りのすべてのパラメータは、オプションとは無関係なパラメータと解釈される。  

出力

たとえば、引き数が必須なのに存在しないとか、未知のオプションがあるとかいう理由で、 パラメータの解析中に問題が起きたときは、エラーメッセージが標準エラーに表示され、 問題を起こした要素については、何も出力されない。 そして、ゼロ以外のエラーステータスが返される。

ショートオプションに対しては、1 個の '-' とオプション文字が、ひとつのパラメータとして生成される。 オプションに引き数がある場合は、次のパラメータはその引き数である。 オプションの引き数が任意なとき、その引き数が見つからなかった場合は、 クォーティングモードでは、次のパラメータが生成されるが、空のパラメータになる。 クォートなしのモード (互換モード) では、2 番目のパラメータは生成されない。 なお、getopt(1) の他の実装では、任意の引数をサポートしていないことが多い。

1 個の '-' の後ろに複数のショートオプションが指定されている場合は、 各オプションがそれぞれ独立したパラメータとして出力されることになる。

ロングオプションに対しては、'--' と省略なしのオプション名がひとつのパラメータとして生成される。 この動作は、入力中でオプションが短縮されているかどうかや、1 個の '-' とともに指定されているかどうか (訳注: -a オプションを使った場合) とは、関係がない。引き数の処理は、ショートオプションの場合と同じである。

通常、オプションとは無関係なパラメータの出力が生成されるのは、 すべてのオプションとその引き数が生成されてからである。 それから、'--' が 1 個のパラメータとして生成され、 その後で、オプションとは無関係なパラメータが、 見つかった順序で、それぞれ独立したパラメータとして生成される。 ただし、ショートオプションズ文字列の最初の文字が '-' のときだけは別で、その場合は、オプションとは無関係なパラメータの出力は、 入力中のそれが見つかった位置で生成される (この動作は、「書式」セクションの第 1 の書式が使用されている場合には、サポートされない。 その場合は、ショートオプションズ文字列の前にある '-' や '+' は、すべて無視される)。  

クォート

次の場合には、引用符による保護が行われない。環境変数 GETOPT_COMPATIBLE が設定されている場合、「書式」セクションの第 1 の書式が使われている場合、'-u' オプションが指定されている場合。

クォート方式はシェルごとに異なる。自分が使用しているシェルの方式を選ぶには、'-s' オプションを使えばよい。現在サポートしているシェルは、'sh', 'bash', 'csh', 'tcsh' である。実のところ、sh 風のクォート方式と csh 風のクォート方式という、2 つの系統しか区別していない。 別のシェルスクリプト言語を使用している場合でも、この 2 つの系統のどちらかが多分使えるだろう。  

スキャニングモード

先頭文字が '+' の場合や、環境変数 POSIXLY_CORRECT が設定されている場合は、オプションではないパラメータで (すなわち、'-' で始まっていないパラメータで)、かつオプションの引き数でもないものが最初に見つかった時点で、 解析はストップする。残りのパラメータはすべて、オプションとは無関係なパラメータと見なされる。

先頭文字が '-' の場合、オプションとは無関係なパラメータは、 それが見つかった位置に出力される。それに対して、通常の動作では、 そうしたパラメータは、1 個の '--' というパラメータが生成された後で、 出力の末尾に全部まとめて置かれるのである。 なお、このモードでも、'--' というパラメータはやはり生成されるが、必ず最後のパラメータになる。  

互換性

getopt の最初のパラメータの最初の文字が '-' でない場合、getopt は互換モードになる。 最初のパラメータは、ショートオプションをひとつにまとめた文字列と見なされ、 他のすべての引き数は、解析の対象になる。 この場合でも、環境変数 POSIXLY_CORRECT が設定されていないかぎり、パラメータの並べ替えは行う。 (すなわち、オプションとは無関係なすべてのパラメータは、最後に出力される)。

環境変数 GETOPT_COMPATIBLE は getopt を強制的に互換モードにする。この環境変数と POSIXLY_CORRECT の両方を設定すると、「気難しい」プログラムのために 100% の互換性が得られる。 しかし、通常はどちらも設定する必要がない。

互換モードでは、ショートオプションズ文字列の先頭に付く '-' や '+' は無視される。  

返り値

用例

環境変数

POSIXLY_CORRECT

この環境変数は getopt(3) ルーティンによって調べられる。これが設定されている場合、 オプションでもオプションの引き数でもないパラメータが見つかった時点で、解析は停止する。 それ以降のすべてのパラメータは、'-' で始まっているかどうかに関係なく、オプションとは無関係なパラメータとして解釈される。

GETOPT_COMPATIBLE

getopt に対して強制的に「書式」セクションの第 1 の呼び出し形式を使わせる。

バグ

[訳注]

バグとは言っても、不具合ではなく、この getopt コマンドが getopt(3) 関数とは、仕様が微妙に違うということを言っているらしい。すなわち、getopt(3) (getopt_long(3)) 関数は、引き数が任意のロングオプションに引数がない場合と、 空の引き数を渡された場合とを区別している。それに対して、この getopt コマンドの方は、ロングオプションであれ、ショートオプションであれ、 引き数が任意のオプションに引数がない場合と、空の引き数を渡された場合とを区別せず、 どちらも同じように処理している。

ショートオプションを全く使いたくない場合の getopt コマンドの構文は、あまり直感的ではない (ショートオプションズ文字列を明示的に空文字列にしなければならないのだ)。

[訳注]

すなわち、getopt -o '' --longoptions ... のように使用しなければならない。

作者

関連項目

入手方法

関連キーワード

Linux マニュアル 一覧

[man1] [man2] [man3] [man4] [man5] [man6] [man7] [man8]
[a] [b] [c] [d] [e] [f] [g] [h] [i] [j] [k] [l] [m] [n] [o] [p] [q] [r] [s] [t] [u] [v] [w] [x] [y] [z]

Index

名前

書式

説明

オプション

構文解析

出力

クォート

スキャニングモード

互換性

返り値

用例

環境変数

バグ

作者

関連項目

入手方法