名前 | 形式 | 機能説明 | オプション | オペランド | 終了ステータス | 属性 | 関連項目 | 注意事項
ckitem ユーティリティは、メニューを作成し、ユーザーにプロンプトを出力してメニュー項目から 1 つの項目を選択するように促します。さらに、ユーザーの応答入力を検証します。このコマンドのオプションでは、プロンプトメッセージ、ヘルプメッセージとエラーメッセージ、およびデフォルト値 (ユーザーがキャリッジリターンで応答した場合に返される値) を定義します。
デフォルトでは、メニューは書式化されており、各項目の前に番号が付けられ、端末上に複数の列で出力されます。列の長さは、選択した最大長の項目によって決まります。項目はアルファベット順に表示されます。
メッセージの長さはすべて最大 70 文字に制限され、自動的に書式化されます。定義中の空白 (復帰改行を含む) はすべて削除されます。-W オプションは、自動書式化を取り消します。メッセージ定義の最初または最後にチルド文字がある場合は、そこにデフォルトテキストが挿入されて、指定したテキストとデフォルトテキストの両方を表示することができます。
プロンプトメッセージ、ヘルプメッセージ、またはエラーメッセージが定義されていない場合は、デフォルトメッセージ (「注意事項」の項を参照) が表示されます。
ckitem コマンドには、2 つのビジュアルツールモジュールがリンクされています。これらのモジュールは、erritem (エラーメッセージを書式化して表示する) と helpitem (ヘルプメッセージを書式化して表示する) です。これらのモジュールは、FML オブジェクトと組み合わせて使用する必要があります。この場合、FML オブジェクトはプロンプトを定義します。これらのモジュールに choice が定義されている場合、メッセージには利用可能なメニューの選択項目が含まれます。
次のオプションを指定できます。
default をデフォルト値として定義します。デフォルト値は検証されないため、どのような基準も満たす必要はありません。
error をエラーメッセージとして定義します。
filename を表示されるメニュー項目のリストを含むファイルとして定義します。(このファイルの書式は、token<tab>description です。ポンド記号 (#) で始まる行は注釈として指定され、無視されます。)
help をヘルプメッセージとして定義します。
非表示メニュー項目 (メニューに表示されない選択項目) を定義します。(たとえば、非表示項目として使用される "all" は、有効なオプションですが、メニューには表示されません。任意の数の非表示項目を定義できます。) 非表示項目があることを、プロンプトメッセージまたはヘルプメッセージのどちらかで、ユーザーに知らせるようにします。
ユーザーが中断を選択した場合、プロセス ID pid のプロセスにシグナルを送信するようにします。
メニューの上に表示するラベル、label を定義します。
ユーザーが選択できるメニュー項目の最大数を定義します。デフォルト値は 1 です。
メニュー項目をアルファベット順で表示しないようにします。
1 つのメニュートークンだけが返されるようにします。
prompt をプロンプトメッセージとして定義します。
有効な応答として終了 (quit) を使用できないようにします。
終了が選択された場合、-k オプションで定義されたプロセス ID pid のプロセスに、シグナル signal を送信するようにします。シグナルを指定しないと、SIGTERM
を送信します。
メニュー項目に番号を付けずに表示するようにします。
プロンプトメッセージ、ヘルプメッセージ、およびエラーメッセージを、width の行長に書式化します。
次の終了ステータスが返されます。
正常な終了
入力で EOF
が検出された、-W オプションで負の行長が指定された、-f オプションでファイルが開けない、あるいは使用法に誤りがあった
ユーザー終了 (quit)
選択すべき項目がない
次の属性については、attributes(5) のマニュアルページを参照してください。
属性タイプ | 属性値 |
---|---|
使用条件 | SUNWcsu |
ユーザーは、メニュー項目に番号が付いている場合はその項目の番号を、あるいは、その項目を一意に識別するのに必要な長さの文字列を入力できます。長いメニューはページに分割され、各ページには 10 個の項目が表示されます。
メニュー項目が、-f オプションで指定したファイルとコマンド行の両方に定義されている場合、メニュー項目は通常、アルファベット順に表示されます。ただし、アルファベット順での表示を抑制する -n オプションが使用されている場合は、ファイルに定義された項目が最初に表示され、次にコマンド行に定義されたオプションが表示されます。
ckitem のデフォルトのプロンプトは次のとおりです。
Enter selection [?,??,q]: |
1 つの疑問符はヘルプメッセージを表示してから、プロンプトを再表示します。2 つの疑問符は、ヘルプメッセージを表示してから、メニューラベル、メニュー、およびプロンプトを再表示します。
番号を入力した場合のデフォルトのエラーメッセージは、次のとおりです。
ERROR: Bad numeric choice specification |
文字列を入力した場合のデフォルトのエラーメッセージは、次のとおりです。
ERROR: Entry does not match available menu selection. Enter the number of the menu item you wish to select, the token which is associated with the menu item, or a partial string which uniquely identifies the token for the menu item. Enter ?? to reprint the menu. |
デフォルトのヘルプメッセージは、次のとおりです。
Enter the number of the menu item you wish to select, the token which is associated with the menu item, or a partial string which uniquely identifies the token for the menu item. Enter ? to reprint the menu. |
終了オプションを選択した場合 (かつ使用できる場合) は、リターンコード 3 と共に q が返されます。