valrange - 手册页部分 1：用户命令

语言：

valrange(1)

ckrange, errange, helprange , valrange - 提示输入并验证整数

ckrange [-Q] [-W width] [-l lower] [-u upper] [-b base] 
     [-d default] [-h help] [-e error] [-p prompt] 
     [-k pid [-s signal]]

/usr/sadm/bin/errange [-W width] [-e error] [-l lower] 
     [-u upper] [-b base]

/usr/sadm/bin/helprange [-W width] [-h help] [-l lower] 
     [-u upper] [-b base]

/usr/sadm/bin/valrange [-l lower] [-u upper] [-b base] input

ckrange 实用程序可提示用户输入指定范围内的整数，并确定其回复是否有效。其作用之一是定义回复应该为指定范围内整数的提示消息、帮助和错误消息的文本以及缺省值（用户按 RETURN 键时返回）。

该命令也可以定义有效输入的范围。如果未定义下限或上限，则范围只有一端有界限。

所有消息的长度均不得超过 79 个字符，消息格式将自动设置。将删除消息定义中一个空格字符后的制表符和换行符，但是不删除空格。如果在消息定义开头或结尾输入波浪号，将在该位置插入缺省文本，这样便可同时显示定制文本和缺省文本。

如果未定义提示、帮助或错误消息，将显示缺省消息（如“示例”部分所定义）。

有三个可视化工具模块与 ckrange 命令关联。分别是 errange（用于标准输出中错误消息的格式设置和显示）、helprange（用于标准输出中帮助消息的格式设置和显示）和 valrange（用于验证回复）。

注意：负数形式的“输入”参数会干扰 getopt 解析 valrange 的参数。如果在参数前面插入 "−"，getopt 处理会停止。有关 getopt 参数处理的信息，请参见 getopt(1) 和 Intro(1)。getopt 用于解析位置参数并检查合法选项。

支持以下选项：

–b base: 定义输入基数。必须为 2 到 36，缺省值为 10。基数转换使用 strtol(3C)。输出中基数始终为 10。
–d default: 将缺省值定义为 default。可以使用 strtol(3C) 按所需基数对 default 进行转换。指定的基数中任何字符无效都会终止 strtol 转换，但是不会报告错误。
–e error: 将错误消息定义为 error。
–h help: 将帮助消息定义为 help。
–k pid: 指定如果用户选择退出，将向进程 ID pid 发送信号。
–l lower: 将范围下限定义为 lower。缺省值为计算机的最大负向长度。
–p prompt: 将提示消息定义为 prompt。
–Q: 指定不允许退出作为有效的响应。
–s signal: 指定如果选择退出，将向使用 –k 选项定义的进程 ID pid 发送信号 signal。如果未指定信号，将使用 SIGTERM。
–u upper: 将范围上限定义为 upper。缺省值为计算机的最大正向长度。
–W width: 指定提示、帮助和错误消息的格式设置：行长度为 width。

支持下列操作数：

示例 1 基数为 10 时的缺省提示

基数为 10 时 ckrange 的缺省提示为：

example% ckrange
Enter an integer between lower_bound and
upper_bound [lower_bound−upper_bound,?,q]:

示例 2 基数为 10 时的缺省错误消息

基数为 10 时缺省错误消息为：

example% /usr/sadm/bin/errange
ERROR: Please enter an integer between lower_bound \
     and upper_bound.

示例 3 基数为 10 时的缺省帮助消息

基数为 10 时缺省帮助消息为：

example% /usr/sadm/bin/helprange
Please enter an integer between lower_bound and upper_bound.

示例 4 基数不为 10 时消息的更改

如果将基数设置为除 10 以外的数字，消息中的 "integer" 将更改为 "base base integer"。例如，

example% /usr/sadm/bin/helprange -b 36

示例 5 使用退出选项

如果选择了退出选项（并且经过允许），将返回 q 以及返回代码 3。退出输入时会添加一个尾随的换行符。

示例 6 使用 valrange 模块

valrange 模块将生成有关标准错误的使用消息。如果成功，将返回0 ；如果失败，将返回非零值。

example% /usr/sadm/bin/valrange
usage: valrange [-l lower] [-u upper] [-b base] input

将返回以下退出值：

有关下列属性的说明，请参见 attributes(5)：

属性类型	属性值
可用性	system/core-os