`curses.ascii` --- ASCII 字元工具集¶

原始碼： Lib/curses/ascii.py

curses.ascii 模組提供了 ASCII 字元的名稱常量，以及用於測試各種 ASCII 字元類成員資格的函式。提供的常量是控制字元的名稱，如下所示：

名稱	含義
curses.ascii.NUL¶
curses.ascii.SOH¶	標題開始，控制檯中斷
curses.ascii.STX¶	文字開始
curses.ascii.ETX¶	文字結束
curses.ascii.EOT¶	傳輸結束
curses.ascii.ENQ¶	請求，與 `ACK` 流程控制一起使用
curses.ascii.ACK¶	確認
curses.ascii.BEL¶	響鈴
curses.ascii.BS¶	退格
curses.ascii.TAB¶	製表符
curses.ascii.HT¶	`TAB` 的別名：“水平製表符”
curses.ascii.LF¶	換行
curses.ascii.NL¶	`LF` 的別名：“新行”
curses.ascii.VT¶	垂直製表符
curses.ascii.FF¶	換頁
curses.ascii.CR¶	回車
curses.ascii.SO¶	移出，啟用備用字元集
curses.ascii.SI¶	移入，恢復預設字元集
curses.ascii.DLE¶	資料鏈路轉義
curses.ascii.DC1¶	XON，用於流控制
curses.ascii.DC2¶	裝置控制2，塊模式流控制
curses.ascii.DC3¶	XOFF，用於流控制
curses.ascii.DC4¶	裝置控制4
curses.ascii.NAK¶	否定確認
curses.ascii.SYN¶	同步空閒
curses.ascii.ETB¶	傳輸塊結束
curses.ascii.CAN¶	取消
curses.ascii.EM¶	介質結束
curses.ascii.SUB¶	替換
curses.ascii.ESC¶	轉義
curses.ascii.FS¶	檔案分隔符
curses.ascii.GS¶	組分隔符
curses.ascii.RS¶	記錄分隔符，塊模式終止符
curses.ascii.US¶	單元分隔符
curses.ascii.SP¶	空格
curses.ascii.DEL¶	刪除

請注意，其中許多在現代用法中已無多少實際意義。這些助記符源於數字計算機出現之前的電傳印表機慣例。

此模組提供了下列函式，模仿自標準 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)¶: 檢查是否為空白字元；空格或水平製表符。

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) 的三十二個 ASCII 控制字元的助記符，外加空格字元的助記符 SP。