ckkeywd(1)


ckkeywd -- キーワードの入力要求とその検証

形式

 
   ckkeywd [-Q] [-W width] [-d default] [-h help] [-e error] [-p prompt] 
   	[-k pid [-s signal]] [keyword . . .] 

機能説明

ckkeywd はユーザに対してプロンプトを出力し、ユーザの応答入力を検査します。プロンプトメッセージ(ユーザにキーワードのうちいづれかを選択させるメッセージ)、ヘルプメッセージ、エラーメッセージ、および省略時の値(ユーザが <Return> キーのみを入力した場合に返すもの)をオプションで定義することが可能です。ユーザの入力は定義されているキーワードリストのうちの 1 つに一致しなければなりません。

メッセージの長さは 70 文字を超えると、自動的に編集されます。定義中のすべての空白類(復帰改行文字も含む)は除去されます。-W オプションを用いると、自動編集をキャンセルします。チルダ(~)をメッセージの先頭または最後に入れた場合、その場所に省略時のテキストが挿入され、指定するテキストと省略時のテキストの両方を表示することができます。

プロンプトメッセージ、ヘルプメッセージまたはエラーメッセージが定義されていない場合、省略時メッセージ(「注意」参照)が表示されます。

-Q
終了入力を無効にします。

-W
プロンプトメッセージ、ヘルプメッセージ、エラーメッセージを width の行長に編集します。

-d
default を省略時の値として定義します。この値は検査の対象にならないので、いかなる基準にも合わせる必要はありません。

-h
help をヘルプメッセージとして定義します。

-e
error をエラーメッセージとして定義します。

-p
prompt をプロンプトメッセージとして定義します。

-k
ユーザが中断を選択した場合、プロセス ID pid のプロセスにシグナルを送信します。

-s
ユーザが終了を選択した場合、-k オプションで指定した pid プロセスに signal を送信します。シグナルを指定しない場合、SIGTERM を送信します。

keyword
ユーザの応答入力を照合するキーワード、またはそのリストを定義します。

終了コード

0
正常終了した場合

1
入力で EOF が検出された場合

1
使用法に誤りがあった場合

3
ユーザが終了(quit)を選択した場合

4
選択すべきキーワードが何もない場合

注意

ckkeywd の省略時のプロンプトメッセージは次のとおりです。

Enter appropriate value [keyword[, . . . ],?,q]

省略時のエラーメッセージは次のとおりです。

ERROR - Please enter one of the following keywords:
keyword[, . . . ]

省略時のヘルプメッセージは次のとおりです。

Please enter one of the following keywords:
keyword[, . . . ]

終了(quit)を選択した場合(それを許可していれば)、戻り値 3 が返され、文字 q を表示します。


SCO UnixWare Forum Beta Release (BL12) -- September 1997
© 1997 The Santa Cruz Operation, Inc. All rights reserved.