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

语言：

errstr(1)

ckstr, errstr, helpstr, valstr - 显示提示；验证并返回字符串答复

ckstr [-Q] [-W width] [ [-r regexp] [...]] [-l length] 
     [-d default] [-h help] [-e error] [-p prompt] 
     [-k pid [- s signal]]

/usr/sadm/bin/errstr [-W width] [-e error] [-l length] 
     [ [-r regexp] [...]]

/usr/sadm/bin/helpstr [-W width] [-h help] [-l length] 
     [ [-r regexp] [...]]

/usr/sadm/bin/valstr [-l length] [ [-r regexp] [...]] input

ckstr 实用程序可提示用户并验证回复。其作用之一是定义回复应该为字符串的提示消息、帮助和错误消息的文本以及缺省值（用户按 RETURN 键时返回）。

该命令返回的答复必须符合定义的正则表达式，而且长度不能超过指定的值。如果未指定正则表达式，则有效输入的字符串必须符合以下条件：长度小于或等于定义的长度而且没有内部空格、前导空格或结尾空格。如果未定义长度，则不检查长度。

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

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

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

支持以下选项：

–d default: 将缺省值定义为 default。缺省值不进行验证，因此无需符合任何条件。
–e error: 将错误消息定义为 error。
–h help: 将帮助消息定义为 help。
–k pid: 指定如果用户选择退出，将向进程 ID pid 发送信号。
–l length: 指定输入的最大长度。
–p prompt: 将提示消息定义为 prompt。
–Q: 指定不允许退出作为有效的响应。
–r regexp: 指定验证输入要依据的正则表达式 regexp。可以包含空格。如果定义了多个表达式，答复只需符合其中一个。
–s signal: 指定如果选择退出，将向使用 –k 选项定义的进程 ID pid 发送信号 signal。如果未指定信号，将使用 SIGTERM。
–W width: 指定提示、帮助和错误消息的格式设置：行长度为 width。

支持下列操作数：

示例 1 缺省提示

ckstr 的缺省提示为：

example% ckstr
Enter an appropriate value [?,q]:

示例 2 缺省错误消息

缺省错误消息取决于涉及的验证类型。消息将告知用户长度或模式不符。缺省错误消息为：

example% /usr/sadm/bin/errstr
ERROR: Please enter a string which contains no embedded,
leading or trailing spaces or tabs.

示例 3 缺省帮助消息

缺省帮助消息也取决于涉及的验证类型。如果已定义正则表达式，则消息为：

example% /usr/sadm/bin/helpstr –r regexp
Please enter a string which matches the following pattern:
regexp

其他消息将定义长度要求和字符串定义。

示例 4 使用退出选项

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

示例 5 使用 valstr 模块

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

example% /usr/sadm/bin/valstr
usage: valstr [–l length] [[–r regexp] [ . . . ]] input

将返回以下退出值：

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

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