名前 | 形式 | 機能説明 | オプション | オペランド | 終了ステータス | 属性 | 関連項目 | 注意事項
ckdate ユーティリティは、ユーザーに入力を要求するプロンプトを出力し、ユーザーの応答を検証します。このユーティリティでは、ユーザーに日付の入力を促すプロンプトメッセージ、ヘルプメッセージとエラーメッセージ、およびデフォルト値 (ユーザーが RETURN キーで応答した場合に返される値) をオプションにより定義できます。ユーザーの応答は、date コマンドで定義されている書式に一致したものでなければなりません。
メッセージの長さはすべて最大 70 文字に制限され、自動的に書式化されます。定義中の空白 (復帰改行を含む) はすべて削除されます。-W オプションは、自動書式化を取り消します。メッセージ定義の最初または最後にチルド文字がある場合は、そこにデフォルトテキストが挿入されて、指定したテキストとデフォルトテキストの両方を表示することができます。
プロンプトメッセージ、ヘルプメッセージ、またはエラーメッセージが定義されていない場合は、デフォルトメッセージ (「注意事項」の項を参照) が表示されます。
ckdate コマンドには、3 つのビジュアルツールモジュールがリンクされています。これらのモジュールは、errdate (エラーメッセージを書式化して表示する)、helpdate (ヘルプメッセージを書式化して表示する)、および valdate (応答を検証する) です。これらのモジュールは、FML オブジェクトと組み合わせて使用する必要があります。この場合、FML オブジェクトはプロンプトを定義します。errdate および helpdate の各モジュールに format が定義されている場合、メッセージには、指定した書式も含まれます。
次のオプションを指定できます。
default をデフォルト値として定義します。デフォルト値は、どのような書式も満たす必要はありません。
error をエラーメッセージとして定義します。
入力を検証するときの基準となる書式を指定します。指定できる書式とその定義は、次のとおりです。
省略された月の名前 (jan、feb、mar)
完全な月の名前 %d = 日 (01 〜 31)
%m/%d/%y の形式の日付 (デフォルトの書式)
日 (1 〜 31、1 桁の数字の前にはブランクが挿入されます)
省略形の月の名前。%b%と同じ
月 (01 〜 12)
西暦中の年 (たとえば、89)
CCYY の形式の年 (たとえば、1989)
help をヘルプメッセージとして定義します。
ユーザーが中断を選択した場合、プロセス ID pid のプロセスにシグナルを送信するようにします。
prompt をプロンプトメッセージとして定義します。
有効な応答として終了 (quit) を使用できないように指定します。
終了が選択された場合、-k オプションで定義されたプロセス ID pid のプロセスに、シグナル signal を送信するようにします。シグナルを指定しないと、SIGTERM
を送信します。
プロンプトメッセージ、ヘルプメッセージ、およびエラーメッセージを、width の行長に書式化します。
次の終了ステータスが返されます。
正常な終了
入力で EOF
が検出された、-W オプションで負の行長が指定された、あるいは使用法に誤りがあった
ユーザー終了 (quit)
不正な書式引数
次の属性については、attributes(5) のマニュアルページを参照してください。
属性タイプ | 属性値 |
---|---|
使用条件 | SUNWcsu |
ckdate のデフォルトのプロンプトは、次のとおりです。
Enter the date [?,q]: |
デフォルトのエラーメッセージは、次のとおりです。
ERROR - Please enter a date. Format is <format>. |
デフォルトのヘルプメッセージは、次のとおりです。
Please enter a date. Format is <format>. |
終了 (quit) オプションを選択した場合 (かつ使用できる場合)、リターンコード 3 と共に q が返されます。valdate モジュールは、出力を生成しません。正常終了した場合は 0、失敗した場合には 0 以外の値を返します。