# 10 `curses.ascii` -- ASCII 文字に関するユーティリティ

バージョン 1.6 で 新たに追加 された仕様です。

`curses.ascii` モジュールでは、 ASCII 文字を指す 名前定数と、様々な ASCII 文字区分についてある文字が帰属するか どうかを調べる関数を提供します。 このモジュールで提供されている定数は以下の制御文字の名前です:

Name | Meaning
--- | ---
`NUL` | 空
`SOH` | ヘディング開始、コンソール割り込み
`STX` | テキスト開始
`ETX` | テキスト終了
`EOT` | テキスト伝送終了
`ENQ` | 問い合わせ、`ACK` フロー制御時に使用
`ACK` | 肯定応答
`BEL` | ベル
`BS` | 一文字後退
`TAB` | タブ
`HT` | `TAB` の別名: ``水平タブ''
`LF` | 改行
`NL` | `LF` の別名: ``改行''
`VT` | 垂直タブ
`FF` | 改頁
`CR` | 復帰
`SO` | シフトアウト、他の文字セットの開始
`SI` | シフトイン、標準の文字セットに復帰
`DLE` | データリンクでのエスケープ
`DC1` | 装置制御 1、フロー制御のための XON
`DC2` | 装置制御 2、ブロックモードフロー制御
`DC3` | 装置制御 3、フロー制御のための XOFF
`DC4` | 装置制御 4
`NAK` | 否定応答
`SYN` | 同期信号
`ETB` | ブロック転送終了
`CAN` | キャンセル
`EM` | 媒体終端
`SUB` | 代入文字
`ESC` | エスケープ文字
`FS` | ファイル区切り文字
`GS` | グループ区切り文字
`RS` | レコード区切り文字、ブロックモード終了子
`US` | 単位区切り文字
`SP` | 空白文字
`DEL` | 削除

これらの大部分は、最近は実際に定数の意味通りに使われることがほとんど ないので注意してください。これらのニーモニック符号はデジタル計算機 より前のテレプリンタにおける慣習から付けられたものです。

このモジュールでは、標準 C ライブラリの関数を雛型とする以下の関数を サポートしています:

`isalnum`( | c)

  ASCII 英数文字かどうかを調べます; "`isalpha(c) or isdigit(c)`" と等価です。

`isalpha`( | c)

  ASCII アルファベット文字かどうかを調べます; "`isupper(c) or islower(c)`" と等価です。

`isascii`( | c)

  文字が 7 ビット ASCII 文字に合致するかどうかを調べます。

`isblank`( | c)

  ASCII 余白文字かどうかを調べます。

`iscntrl`( | c)

  ASCII 制御文字 (0x00 から 0x1f の範囲) かどうかを調べます。

`isdigit`( | c)

  ASCII 10 進数字、すなわち "`0`" から "`9`" までの 文字かどうかを調べます。 "`c in string.digits`" と等価です。

`isgraph`( | c)

  空白以外の ASCII 印字可能文字かどうかを調べます。

`islower`( | c)

  ASCII 小文字かどうかを調べます。

`isprint`( | c)

  空白文字を含め、 ASCII 印字可能文字かどうかを調べます。

`ispunct`( | c)

  空白または英数字以外の ASCII 印字可能文字かどうかを調べます。

`isspace`( | c)

  ASCII 余白文字、すなわち空白、改行、復帰、改頁、水平タブ、 垂直タブかどうかを調べます。

`isupper`( | c)

  ASCII 大文字かどうかを調べます。

`isxdigit`( | c)

  ASCII 16 進数字かどうかを調べます。 "`c in string.hexdigits`" と等価です。

`isctrl`( | c)

  ASCII 制御文字 (0 から 31 までの値) かどうかを調べます。

`ismeta`( | c)

  非 ASCII 文字 (0x80 またはそれ以上の値) かどうかを調べます。

これらの関数は数字も文字列も使えます; 引数を文字列にした場合、 組み込み関数 `ord()` を使って変換されます。

これらの関数は全て、関数に渡した文字列の最初の文字から得られた ビット値を調べるので注意してください; 関数はホスト計算機で使われている 文字列エンコーディングについて何ら関知しません。文字列エンコーディング について関知する (そして国際化に関するプロパティを正しく扱う) 関数 については、 モジュール `string` を参照してください。

以下の 2 つの関数は、引数として 1 文字の文字列または整数で表したバイト値の どちらでもとり得ます; これらの関数は引数と同じ型で値を返します。

`ascii`( | c)

  ASCII 値を返します。c の下位 7 ビットに対応します。

`ctrl`( | c)

  与えた文字に対応する制御文字を返します (0x1f とビット単位で論理積 を取ります) 。

`alt`( | c)

  与えた文字に対応する 8 ビット文字を返します (0x80 とビット単位で論理和 を取ります) 。

以下の関数は 1 文字からなる文字列値または整数値を引数に取り、文字列 を返します。

`unctrl`( | c)

  ASCII 文字 c の文字列表現を返します。もし c が印字可能 文字であれば、返される文字列は c そのものになります。 もし c が制御文字 (0x00-0x1f) であれば、 キャレット ("`^`") と、その後ろに続く c に対応した 大文字からなる文字列になります。c が ASCII 削除文字 (0x7f) であれば、文字列は `'^?'` になります。c のメタビット (0x80) がセットされていれば、メタビットは取り去られ、前述のルール が適用され、"`!`" が前につけられます。

`controlnames`
  0 (NUL) から 0x1f (US) までの 32 の ASCII 制御文字と、空白文字 "`SP`" のニーモニック符号名からなる 33 要素の文字列によるシーケンスです。