curses.ascii
— ASCII 字符工具¶
源代码: Lib/curses/ascii.py
curses.ascii
模块为 ASCII 字符提供名称常量和用于测试各种 ASCII 字符类中成员的函数。提供的常量是控制字符的名称,如下所示:
名称 |
含义 |
---|---|
|
|
|
标题开始,控制台中断 |
|
文本开始 |
|
文本结束 |
|
传输结束 |
|
请求,与 |
|
确认 |
|
响铃 |
|
退格 |
|
制表符 |
|
|
|
换行 |
|
|
|
垂直制表符 |
|
换页 |
|
回车 |
|
移出,开始备用字符集 |
|
移入,恢复默认字符集 |
|
数据链路转义 |
|
XON,用于流控制 |
|
设备控制 2,块模式流控制 |
|
XOFF,用于流控制 |
|
设备控制 4 |
|
否定确认 |
|
同步空闲 |
|
传输块结束 |
|
取消 |
|
介质结束 |
|
替换 |
|
转义 |
|
文件分隔符 |
|
组分隔符 |
|
记录分隔符,块模式终止符 |
|
单元分隔符 |
|
空格 |
|
删除 |
请注意,其中许多在现代用法中几乎没有实际意义。这些助记符源自早于数字计算机的电传打字机约定。
该模块提供以下函数,这些函数仿照标准 C 库中的函数
- curses.ascii.isalnum(c)¶
检查是否为 ASCII 字母数字字符;它等效于
isalpha(c) or isdigit(c)
。
- curses.ascii.isalpha(c)¶
检查是否为 ASCII 字母字符;它等效于
isupper(c) or islower(c)
。
- curses.ascii.isascii(c)¶
检查字符值是否适合 7 位 ASCII 字符集。
- curses.ascii.isblank(c)¶
检查是否为 ASCII 空白字符;空格或水平制表符。
- curses.ascii.iscntrl(c)¶
检查是否为 ASCII 控制字符(范围为 0x00 到 0x1f 或 0x7f)。
- curses.ascii.isdigit(c)¶
检查是否为 ASCII 十进制数字,即
'0'
到'9'
。 这等价于c in string.digits
。
- curses.ascii.isgraph(c)¶
检查是否为 ASCII 可打印字符,除了空格。
- curses.ascii.islower(c)¶
检查是否为 ASCII 小写字符。
- curses.ascii.isprint(c)¶
检查是否为任何 ASCII 可打印字符,包括空格。
- curses.ascii.ispunct(c)¶
检查是否为任何可打印 ASCII 字符,且不是空格或字母数字字符。
- curses.ascii.isspace(c)¶
检查是否为 ASCII 空白字符:空格、换行符、回车符、换页符、水平制表符、垂直制表符。
- curses.ascii.isupper(c)¶
检查是否为 ASCII 大写字母。
- curses.ascii.isxdigit(c)¶
检查是否为 ASCII 十六进制数字。 这等价于
c in string.hexdigits
。
- curses.ascii.isctrl(c)¶
检查是否为 ASCII 控制字符(序数值为 0 到 31)。
- curses.ascii.ismeta(c)¶
检查是否为非 ASCII 字符(序数值为 0x80 及以上)。
这些函数接受整数或单字符字符串;当参数是字符串时,会先使用内置函数 ord()
进行转换。
请注意,所有这些函数都会检查从您传入的字符串字符派生的序数位值;它们实际上并不了解主机机器的字符编码。
以下两个函数接受单字符字符串或整数字节值;它们返回相同类型的值。
- curses.ascii.ascii(c)¶
返回对应于 c 的低 7 位的 ASCII 值。
- curses.ascii.ctrl(c)¶
返回与给定字符对应的控制字符(字符位值与 0x1f 按位与)。
- curses.ascii.alt(c)¶
返回与给定 ASCII 字符对应的 8 位字符(字符位值与 0x80 按位或)。
以下函数接受单字符字符串或整数值;它返回一个字符串。
- curses.ascii.unctrl(c)¶
返回 ASCII 字符 c 的字符串表示形式。 如果 c 是可打印的,则此字符串是字符本身。 如果字符是控制字符 (0x00–0x1f),则字符串由一个脱字符号 (
'^'
) 后跟相应的大写字母组成。 如果字符是 ASCII 删除符 (0x7f),则字符串为'^?'
。 如果字符设置了元位 (0x80),则会剥离元位,应用前面的规则,并在结果前添加'!'
。
- curses.ascii.controlnames¶
一个包含 33 个元素的字符串数组,其中按顺序包含从 0 (NUL) 到 0x1f (US) 的 32 个 ASCII 控制字符的 ASCII 助记符,以及空格字符的助记符
SP
。