ckint(1)

名称

ckint, errint, helpint, valint - 显示提示；验证并返回整数值

用法概要

ckint [-Q] [-W width] [-b base] [-d default] [-h help] 
     [-e error] [-p prompt] [-k pid [-s signal]]

/usr/sadm/bin/errint [-W width] [-b base] [-e error]

/usr/sadm/bin/helpint [-W width] [-b base] [-h help]

/usr/sadm/bin/valint [-b base] input

描述

ckint 实用程序可提示用户，然后验证回复。其作用之一是定义回复应该为整数的提示消息、帮助和错误消息的文本以及缺省值（用户按回车时返回）。

所有消息的长度均不得超过 70 个字符，消息格式将自动设置。定义中使用的任何空格（包括换行符）都将除去。使用 –W 选项可以取消自动格式设置。如果在消息定义开头或结尾输入波浪号，将在该位置插入缺省文本，这样便可同时显示定制文本和缺省文本。

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

有三个可视化工具模块与 ckint 命令关联。分别是 errint（用于错误消息的格式设置和显示）、helpint（用于帮助消息的格式设置和显示）和 valint（用于验证回复）。这些模块应该与 FML 对象一起使用。在这种情况下，FML 对象将定义提示。如果在 errint 和 helpint 模块中定义了 base，则消息将指明应当采用的输入基数。

选项

支持以下选项：

–b base

定义输入基数。必须为 2 到 36，缺省值为 10。

–d default

将缺省值定义为 default。缺省值不进行验证，因此无需符合任何条件。

–e error

将错误消息定义为 error。

–h help

将帮助消息定义为 help。

–k pid

指定如果用户选择异常中止，将向进程 ID pid 发送信号。

–p prompt

将提示消息定义为 prompt。

–Q

指定不允许退出作为有效的响应。

–s signal

指定如果选择退出，将向使用 –k 选项定义的进程 ID pid 发送信号 signal。如果未指定信号，将使用 SIGTERM。

–W width

指定提示、帮助和错误消息的格式设置：行长度为 width。

操作数

支持下列操作数：

input

要根据 base 条件验证的输入。

退出状态

将返回以下退出值：

0

成功执行。

1

输入中出现 EOF、–W 选项中的宽度为负数或者用法错误。

3

用户终止（退出）。

属性

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

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

另请参见

attributes(5)

附注

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

Enter an integer [?,q]:

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

ERROR - Please enter an integer.

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

Please enter an integer.

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

如果选择了退出选项（并且经过允许），将返回 q 以及返回代码 3。valint 模块不会生成任何输出。如果成功，将返回0 ；如果失败，将返回非零值。