'\" te
.\"  Copyright 1989 AT&T Copyright (c) 2005, Sun Microsystems, Inc. All Rights Reserved
.TH ckrange 1 "2005 年 11 月 4 日" "SunOS 5.11" "ユーザーコマンド"
.SH 名前
ckrange, errange, helprange, valrange \- 整数の入力要求とその検証
.SH 形式
.LP
.nf
\fBckrange\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-l\fR \fIlower\fR] [\fB-u\fR \fIupper\fR] [\fB-b\fR \fIbase\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] [\fB-e\fR \fIerror\fR] [\fB-p\fR \fIprompt\fR] [\fB-k\fR \fIpid\fR [\fB-s\fR \fIsignal\fR]]
.fi

.LP
.nf
\fB/usr/sadm/bin/errange\fR [\fB-W\fR \fIwidth\fR] [\fB-e\fR \fIerror\fR] [\fB-l\fR \fIlower\fR] [\fB-u\fR \fIupper\fR] [\fB-b\fR \fIbase\fR]
.fi

.LP
.nf
\fB/usr/sadm/bin/helprange\fR [\fB-W\fR \fIwidth\fR] [\fB-h\fR \fIhelp\fR] [\fB-l\fR \fIlower\fR] [\fB-u\fR \fIupper\fR] [\fB-b\fR \fIbase\fR]
.fi

.LP
.nf
\fB/usr/sadm/bin/valrange\fR [\fB-l\fR \fIlower\fR] [\fB-u\fR \fIupper\fR] [\fB-b\fR \fIbase\fR] \fIinput\fR
.fi

.SH 機能説明
.sp
.LP
\fBckrange\fR ユーティリティーは、ユーザーに指定範囲内の整数の入力を要求して、ユーザーの応答が有効かどうかを検証します。このユーティリティーでは、ユーザーに指定範囲内の整数の入力を促すプロンプトメッセージ、ヘルプメッセージとエラーメッセージ、およびデフォルト値 (ユーザーが RETURN キーで応答した場合に返される値) をオプションにより定義します。
.sp
.LP
また、このコマンドは、有効な入力範囲も定義します。下限または上限のいずれかが定義されていない場合、範囲は一方の限界だけに制限されます。
.sp
.LP
メッセージの長さはすべて最大 79 文字に制限され、自動的に書式化されます。メッセージ定義内で 1 つのスペース文字の後にあるタブと復帰改行は削除されますが、スペースは削除されません。メッセージ定義の最初または最後にチルド文字がある場合は、そこにデフォルトテキストが挿入されて、指定したテキストとデフォルトテキストの両方を表示することができます。
.sp
.LP
プロンプトメッセージ、ヘルプメッセージ、またはエラーメッセージが定義されていない場合は、デフォルトメッセージ (「使用例」の項を参照) が表示されます。
.sp
.LP
\fBckrange\fR コマンドには、3 つのビジュアルツールモジュールがリンクされています。これらのモジュールは、\fBerrrange\fR (標準出力上にエラーメッセージを書式化して表示する)、\fBhelprange\fR (標準出力上にヘルプメッセージを書式化して表示する)、および \fBvalrange\fR (応答を検証する) です。 
.sp
.LP
\fB注:\fR input 引数として負の値を指定すると、\fBvalrange\fR 内の \fBgetopt\fR で混乱が生じます。引数の前に \fB-\fR を付けると、getopt は処理を停止します。\fBgetopt\fR のパラメータ処理については、\fBgetopt\fR(1) および \fBIntro\fR(1) を参照してください。\fBgetopt\fR は、位置指定パラメータを解析して、有効なオプションかどうかを検査するために使用されます。
.SH オプション
.sp
.LP
サポートしているオプションは、次のとおりです。
.sp
.ne 2
.mk
.na
\fB\fB-b\fR \fIbase\fR\fR
.ad
.RS 14n
.rt  
入力する整数の基数を定義します。2 から 36 までの数字でなければなりません。デフォルト値は 10 です。基数を変換するには \fBstrtol\fR(3C) を使用します。出力は常に、基数を 10 として実行されます。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-d\fR\fI default\fR\fR
.ad
.RS 14n
.rt  
\fIdefault\fR をデフォルト値として定義します。\fIdefault\fR は \fBstrtol\fR(3C) を使用して指定した基数に変換できます。指定した基数に無効な文字があると、\fBstrtol\fR はエラーを示すことなく変換を終了します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-e\fR \fIerror\fR\fR
.ad
.RS 14n
.rt  
\fIerror\fR をエラーメッセージとして定義します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-h\fR \fIhelp\fR\fR
.ad
.RS 14n
.rt  
\fIhelp\fR をヘルプメッセージとして定義します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-k\fR\fI pid\fR\fR
.ad
.RS 14n
.rt  
ユーザーが中断を選択した場合、プロセス \fBID\fR \fIpid\fR のプロセスにシグナルを送信するようにします。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-l\fR \fIlower\fR\fR
.ad
.RS 14n
.rt  
\fIlower\fR を範囲の下限として定義します。デフォルト値は、マシンの負の最大整数です。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-p\fR\fI prompt\fR\fR
.ad
.RS 14n
.rt  
\fIprompt\fR をプロンプトメッセージとして定義します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-Q\fR\fR
.ad
.RS 14n
.rt  
有効な応答として終了 (quit) を使用できないようにします。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-s\fR \fIsignal\fR\fR
.ad
.RS 14n
.rt  
終了が選択された場合、\fB-k\fR オプションで定義されたプロセス \fBID\fR \fIpid\fR のプロセスに、シグナル \fIsignal\fR を送信するようにします。シグナルを指定しないと、\fBSIGTERM\fR を送信します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-u\fR \fIupper\fR\fR
.ad
.RS 14n
.rt  
\fIupper\fR を範囲の上限として定義します。デフォルト値は、マシンの正の最大整数です。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-W\fR\fI width\fR\fR
.ad
.RS 14n
.rt  
プロンプトメッセージ、ヘルプメッセージ、およびエラーメッセージを、\fIwidth\fR の行長に書式化します。
.RE

.SH オペランド
.sp
.LP
次のオペランドを指定できます。
.sp
.ne 2
.mk
.na
\fB\fIinput\fR\fR
.ad
.RS 9n
.rt  
上限、下限、および基数と照合される入力
.RE

.SH 使用例
.LP
\fB例 1 \fRデフォルトのプロンプト
.sp
.LP
\fBckrange\fR のデフォルトのプロンプトは、次のとおりです (基数は 10)

.sp
.in +2
.nf
example% \fBckrange\fR
Enter an integer between \fIlower_bound \fRand
\fIupper_bound \fR[\fIlower_bound\(miupper_bound\fR,?,q]:
.fi
.in -2
.sp

.LP
\fB例 2 \fRデフォルトのエラーメッセージ
.sp
.LP
デフォルトのエラーメッセージは、次のとおりです (基数は 10)。

.sp
.in +2
.nf
example% \fB/usr/sadm/bin/errange\fR
ERROR: Please enter an integer between \fIlower_bound \e\fR
     and \fIupper_bound\fR.
.fi
.in -2
.sp

.LP
\fB例 3 \fRデフォルトのヘルプメッセージ
.sp
.LP
デフォルトのヘルプメッセージは、次のとおりです (基数は 10)。

.sp
.in +2
.nf
example% \fB/usr/sadm/bin/helprange\fR
Please enter an integer between \fIlower_bound\fR and \fIupper_bound\fR.
.fi
.in -2
.sp

.LP
\fB例 4 \fR基数を 10 以外の数に変更した場合のメッセージ
.sp
.LP
基数を 10 以外の数に設定した場合、メッセージは "integer" から "base \fIbase\fR integer" に変更されます。たとえば、

.sp
.in +2
.nf
example% \fB/usr/sadm/bin/helprange -b 36\fR
.fi
.in -2
.sp

.LP
\fB例 5 \fR終了 (quit) オプションの使用
.sp
.LP
終了オプションを選択した場合 (かつ使用できる場合) は、リターンコード \fB3\fR と共に \fBq\fR が返されます。終了を入力すると、後に復帰改行が続きます。

.LP
\fB例 6 \fRvalrange モジュールの使用
.sp
.LP
\fBvalrange\fR モジュールは、標準エラー出力に使用法に関するメッセージを作成します。正常終了した場合は \fB0\fR、失敗した場合には 0 以外の値を返します。

.sp
.in +2
.nf
example% \fB/usr/sadm/bin/valrange\fR
usage: valrange [-l lower] [-u upper] [-b base] input
.fi
.in -2
.sp

.SH 終了ステータス
.sp
.LP
次の終了ステータスが返されます。
.sp
.ne 2
.mk
.na
\fB\fB0\fR\fR
.ad
.RS 5n
.rt  
正常終了。
.RE

.sp
.ne 2
.mk
.na
\fB\fB1\fR\fR
.ad
.RS 5n
.rt  
入力で \fBEOF\fR が検出された、\fB-W\fR オプションで負の行長が指定された、または使用法に誤りがあった。
.RE

.sp
.ne 2
.mk
.na
\fB\fB2\fR\fR
.ad
.RS 5n
.rt  
使用方法のエラー。
.RE

.sp
.ne 2
.mk
.na
\fB\fB3\fR\fR
.ad
.RS 5n
.rt  
ユーザー終了 (quit)。
.RE

.SH 属性
.sp
.LP
属性についての詳細は、マニュアルページの \fBattributes\fR(5) を参照してください。
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
属性タイプ属性値
_
使用条件system/core-os
.TE

.SH 関連項目
.sp
.LP
\fBIntro\fR(1), \fBgetopt\fR(1), \fBstrtol\fR(3C), \fBattributes\fR(5), \fBsignal.h\fR(3HEAD)