組み込み関数
************

Python インタプリタには数多くの関数と型が組み込まれており、いつでも利
用できます。それらをここにアルファベット順に挙げます。

+---------------------------+-------------------------+-------------------------+---------------------------+
| 組み込み関数                                                                                              |
|===========================|=========================|=========================|===========================|
| **A** "abs()" "aiter()"   | **E** "enumerate()"     | **L** "len()" "list()"  | **R** "range()" "repr()"  |
| "all()" "any()" "anext()" | "eval()" "exec()"       | "locals()"  **M**       | "reversed()" "round()"    |
| "ascii()"  **B** "bin()"  | **F** "filter()"        | "map()" "max()"         | **S** "set()" "setattr()" |
| "bool()" "breakpoint()"   | "float()" "format()"    | "memoryview()" "min()"  | "slice()" "sorted()"      |
| "bytearray()" "bytes()"   | "frozenset()"  **G**    | **N** "next()"  **O**   | "staticmethod()" "str()"  |
| **C** "callable()"        | "getattr()" "globals()" | "object()" "oct()"      | "sum()" "super()"  **T**  |
| "chr()" "classmethod()"   | **H** "hasattr()"       | "open()" "ord()"  **P** | "tuple()" "type()"  **V** |
| "compile()" "complex()"   | "hash()" "help()"       | "pow()" "print()"       | "vars()"  **Z** "zip()"   |
| **D** "delattr()"         | "hex()"  **I** "id()"   | "property()"            | **_** "__import__()"      |
| "dict()" "dir()"          | "input()" "int()"       |                         |                           |
| "divmod()"                | "isinstance()"          |                         |                           |
|                           | "issubclass()" "iter()" |                         |                           |
+---------------------------+-------------------------+-------------------------+---------------------------+

abs(x)

   数の絶対値を返します。引数は整数、浮動小数点数または "__abs__()" が
   実装されたオブジェクトです。引数が複素数なら、その絶対値
   (magnitude) が返されます。

aiter(async_iterable)

   *asynchronous iterable* から  *asynchronous iterator* を返します。
   "x.__aiter__()" を呼び出すのと等価です。

   なお、 "iter()" とは異なり、 "aiter()" は第二引数を持ちません。

   バージョン 3.10 で追加.

all(iterable)

   *iterable* の全ての要素が真ならば (もしくは *iterable* が空ならば)
   "True" を返します。以下のコードと等価です:

      def all(iterable):
          for element in iterable:
              if not element:
                  return False
          return True

awaitable anext(async_iterator[, default])

   待ち受け中に、与えられた非同期イテレータ (*asynchronous iterator*)
   を返します。イテレータが枯渇した場合、 *default* が与えられていれば
   *default* を返します。

   これは組み込みの "next()" 関数の非同期版であり、同じように動作しま
   す。

   これは *async_iterator* の "__anext__()" メソッドを呼び出し、待ち受
   け可能オブジェクト (*awaitable*) を返します。待ち受けることによりイ
   テレータの次の値を返します。 *default* が与えられた場合、イテレータ
   が枯渇したときにその値が返されます。 *default* が与えられない場合は
   "StopAsyncIteration" が送出されます。

   バージョン 3.10 で追加.

any(iterable)

   *iterable* のいずれかの要素が真ならば "True" を返します。*iterable*
   が空なら "False" を返します。以下のコードと等価です:

      def any(iterable):
          for element in iterable:
              if element:
                  return True
          return False

ascii(object)

   "repr()" と同様、オブジェクトの印字可能な表現を含む文字列を返します
   が、"repr()" によって返された文字列中の非 ASCII 文字は "\x" 、 "\u"
   、 "\U" エスケープを使ってエスケープされます。これは Python 2 の
   "repr()" によって返されるのと同じ文字列を作ります。

bin(x)

   整数を先頭に "0b" が付いた 2 進文字列に変換します。 結果は Python
   の式としても使える形式になります。 *x* が Python の "int" オブジェ
   クトでない場合、整数を返す "__index__()" メソッドが定義されていなけ
   ればなりません。 いくつかの例を示します:

   >>> bin(3)
   '0b11'
   >>> bin(-10)
   '-0b1010'

   先頭に "0b" が付いて欲しい、もしくは付いて欲しくない場合には、次の
   方法のどちらでも使えます。

   >>> format(14, '#b'), format(14, 'b')
   ('0b1110', '1110')
   >>> f'{14:#b}', f'{14:b}'
   ('0b1110', '1110')

   より詳しいことは "format()" も参照してください。

class bool([x])

   真偽値、すなわち "True" か "False" のいずれかを返します。 *x* は標
   準の 真偽値判定手続き を用いて変換されます。 *x* が偽かまたは省略さ
   れた場合、この関数は "False" を返します。それ以外の場合は "True" を
   返します。 "bool" クラスは "int" クラスの派生クラスです (数値型
   int, float, complex を参照してください)。このクラスからさらに派生す
   ることはできません。このクラスのインスタンスは "False" と "True" の
   身です (ブール値 を参照してください)。

   バージョン 3.7 で変更: *x* は位置専用引数になりました。

breakpoint(*args, **kws)

   この関数は、呼び出された箇所から処理をデバッガに移行します。より具
   体的には、この関数は "sys.breakpointhook()" を "args" と "kws" をそ
   のまま渡して呼び出します。デフォルトでは、 "sys.breakpointhook()"
   は引数なしで "pdb.set_trace()" を呼び出すだけです。そのような場合、
   この関数は "pdb" を明示的にインポートしたり、デバッガに処理を移行す
   るためのコードを書いたりしなくても済むようにするだけの、ただの便利
   な関数です。しかし "sys.breakpointhook()" を別の関数に設定して
   "breakpoint()" が自動的に呼び出させるようにすると、自分好みのデバッ
   ガに処理を移行させることができます。 "sys.breakpointhook()" にアク
   セスできない場合、この関数は "RuntimeError" を送出します。

   引数 "breakpointhook" 付きで 監査イベント "builtins.breakpoint" を
   送出します。

   バージョン 3.7 で追加.

class bytearray([source[, encoding[, errors]]])

   新しいバイト配列を返します。"bytearray" クラスは0 <= x < 256の範囲
   の整数からなる変更可能な配列です。ミュータブルなシーケンス型 に記述
   されている変更可能な配列に対する普通のメソッドの大半を備えています
   。また、"bytes" 型が持つメソッドの大半も備えています（see bytes と
   bytearray の操作)。

   オプションの *source* 引数は、配列を異なる方法で初期化するのに使わ
   れます:

   * *文字列* の場合、 *encoding* (と、オプションの *errors*) 引数も与
     えなければなりません。このとき "bytearray()" は文字列を
     "str.encode()" でバイトに変換して返します。

   * *整数* の場合、配列はそのサイズになり、null バイトで初期化されま
     す。

   * バッファインターフェース に適合するオブジェクトの場合、そのオブジ
     ェクトの読み出し専用バッファがバイト配列の初期化に使われます。

   * *イテラブル* の場合、範囲 "0 <= x < 256" 内の整数のイテラブルでな
     ければならず、それらが配列の初期の内容として使われます。

   引数がなければ、長さ 0 の配列が生成されます。

   バイナリシーケンス型 --- bytes, bytearray, memoryview と bytearray
   オブジェクト も参照してください。

class bytes([source[, encoding[, errors]]])

   範囲 "0 <= x < 256" の整数のイミュータブルなシーケンスである
   "bytes" オブジェクトを返します。 "bytes" は "bytearray" のイミュー
   タブル版であり、オブジェクトを変化させないメソッドや、インデックス
   指定、オブジェクトのスライスについてのふるまいは同じです。

   従って、コンストラクタ引数は "bytearray()" のものと同様に解釈されま
   す。

   バイト列オブジェクトはリテラルでも生成できます。 文字列およびバイト
   列リテラル を参照してください。

   バイナリシーケンス型 --- bytes, bytearray, memoryview, バイトオブジ
   ェクト, bytes と bytearray の操作 も参照してください。

callable(object)

   *object* 引数が呼び出し可能オブジェクトであれば "True" を、そうでな
   ければ "False" を返します。この関数が "True" を返しても、呼び出しは
   失敗する可能性がありますが、"False" であれば、 *object* の呼び出し
   は決して成功しません。なお、クラスは呼び出し可能 (クラスを呼び出す
   と新しいインスタンスを返します) です。また、インスタンスはクラスが
   "__call__()" メソッドを持つなら呼び出し可能です。

   バージョン 3.2 で追加: この関数は Python 3.0 で一度取り除かれました
   が、Python 3.2 で復活しました。

chr(i)

   Unicode コードポイントが整数 *i* である文字を表す文字列を返します。
   例えば "chr(97)" は文字列 "'a'" を、 "chr(8364)" は文字列 "'€'" を
   返します。 "ord()" の逆です。

   引数の有効な範囲は 0 から 1,114,111 (16 進数で 0x10FFFF) です。 *i*
   が範囲外の場合 "ValueError" が送出されます。

@classmethod

   メソッドをクラスメソッドへ変換します。

   クラスメソッドは、インスタンスメソッドが暗黙の第一引数としてインス
   タンスをとるように、第一引数としてクラスをとります。クラスメソッド
   を宣言するには、以下のイディオムを使います:

      class C:
          @classmethod
          def f(cls, arg1, arg2): ...

   "@classmethod" 形式は関数 *デコレータ* です。詳しくは 関数定義 を参
   照してください。

   クラスメソッドは、("C.f()" のように) クラスから呼び出すことも、
   ("C().f()" のように) インスタンスから呼び出すこともできます。 イン
   スタンスはそのクラスが何であるかを除いて無視されます。 クラスメソッ
   ドが派生クラスから呼び出される場合は、その派生クラスオブジェクトが
   暗黙の第一引数として渡されます。

   クラスメソッドは C++ や Java の静的メソッドとは異なります。静的メソ
   ッドは、この節の "staticmethod()" を参照してください。クラスメソッ
   ドについてより詳しいことは  標準型の階層 を参照してください。

   バージョン 3.9 で変更: クラスメソッドは "property()" など、他の *デ
   スクリプタ* をラップすることができるようになりました。

   バージョン 3.10 で変更: クラスメソッドはメソッド属性 ("__module__",
   "__name__", "__qualname__", "__doc__" や "__annotations__") を引き
   継ぐようになりました。また、新たに "__wrapped__" 属性を持つようにな
   りました。

compile(source, filename, mode, flags=0, dont_inherit=False, optimize=- 1)

   *source* をコードオブジェクト、もしくは、 AST オブジェクトにコンパ
   イルします。 コードオブジェクトは "exec()" 文で実行したり、
   "eval()" 呼び出しで評価できます。 *source* は通常の文字列、 バイト
   列、 AST オブジェクトのいずれでもかまいません。 AST オブジェクトへ
   の、また、 AST オブジェクトからのコンパイルの方法は、 "ast" モジュ
   ールのドキュメントを参照してください。

   *filename* 引数には、コードの読み出し元のファイルを与えなければなり
   ません; ファイルから読み出されるのでなければ、認識可能な値を渡して
   下さい ("'<string>'" が一般的に使われます)。

   *mode* 引数は、コンパイルされるコードの種類を指定します; *source*
   が一連の文から成るなら "'exec'" 、単一の式から成るなら "'eval'" 、
   単一の対話的文の場合 "'single'" です。(後者の場合、評価が "None" 以
   外である式文が印字されます)。

   オプション引数 *flags* と *dont_inherit* は、どの コンパイラオプシ
   ョン を有効化するか、 将来の機能 のどれを許可するかを制御します。ど
   ちらの引数も存在しない (またはどちらもゼロである) 場合は、
   "compile()" の呼び出し元のコードに作用したものと同じフラグでコンパ
   イルされます。 *flags* 引数が与えられて *dont_inherit* が与えられな
   い (またはゼロ) の場合、上記に加えて *flags* 引数で与えられたコンパ
   イラオプションと future 文が使われます。 *dont_inherit* がゼロでな
   い整数の場合、 *flags* 引数で指定されたオプションだけが有効です --
   呼び出し元コードに適用されたフラグ (将来の機能とコンパイラオプショ
   ン) は無視されます。

   有効化するコンパイラオプションと future 文はビットフィールドで指定
   可能で、ビット単位の OR をとることで複数のオプションを一緒に指定す
   ることができます。特定の future 機能を指定するために必要なビットフ
   ィールドの情報は、 "__future__" モジュールにおける "_Feature" イン
   スタンスの "compiler_flag" 属性で得ることができます。 コンパイラフ
   ラグ の情報は "ast" モジュールの "PyCF_" で始まるフラグで得ることが
   できます。

   引数 *optimize* は、コンパイラの最適化レベルを指定します; デフォル
   トの値 "-1" は、インタプリタの "-O" オプションで与えられるのと同じ
   最適化レベルを選びます。明示的なレベルは、 "0" (最適化なし、
   "__debug__" は真)、 "1" (assert は取り除かれ、 "__debug__" は偽)、
   "2" (docstring も取り除かれる) です。

   この関数は、コンパイルされたソースが不正である場合 "SyntaxError" を
   、ソースがヌルバイトを含む場合 "ValueError" を送出します。

   Python コードをパースしてその AST 表現を得たいのであれば、
   "ast.parse()" を参照してください。

   引数 "source", "filename" を指定して 監査イベント "compile" を送出
   します。

   注釈:

     複数行に渡るコードの文字列を "'single'" や "'eval'" モードでコン
     パイルするとき、入力は一つ以上の改行文字で終端されなければなりま
     せん。これは、 "code" モジュールで不完全な文と完全な文を検知しや
     すくするためです。

   警告:

     AST オブジェクトにコンパイルしているときに、十分に大きい文字列や
     複雑な文字列によって Python の抽象構文木コンパイラのスタックが深
     さの限界を越えることで、 Python インタプリタをクラッシュさせられ
     ます。

   バージョン 3.2 で変更: Windows や Mac の改行も受け付けます。また
   "'exec'" モードでの入力が改行で終わっている必要もありません。
   *optimize* 引数が追加されました。

   バージョン 3.5 で変更: 以前は *source* にヌルバイトがあったときに
   "TypeError" を送出していました。

   バージョン 3.8 で追加: "ast.PyCF_ALLOW_TOP_LEVEL_AWAIT" フラグを渡
   してトップレベルの "await", "async for", および "async with" のサポ
   ートを有効化することができるようになりました。

class complex([real[, imag]])

   値 *real* + *imag**1j の複素数を返すか、文字列や数を複素数に変換し
   ます。第一引数が文字列なら、それが複素数と解釈され、この関数は第二
   引数無しで呼び出されなければなりません。第二引数は文字列であっては
   なりません。それぞれの引数は (複素数を含む) 任意の数値型です。
   *imag* が省略された場合、標準の値はゼロで、このコンストラクタは
   "int" や "float" のような数値変換としてはたらきます。両方の引数が省
   略された場合、 "0j" を返します。

   一般的な Python オブジェクト "x" に対して、 "complex(x)" は
   "x.__complex__()" に処理を委譲します。 "__complex__()" が定義されて
   いない場合は "__float__()" にフォールバックします。 "__float__()"
   も定義されていない場合は "__index__()" にフォールバックします。

   注釈:

     文字列から変換するとき、その文字列は中央の "+" や "-" 演算子の周
     りに空白を含んではなりません。例えば、"complex('1+2j')" はいいで
     すが、"complex('1 + 2j')" は "ValueError" を送出します。

   複素数型については 数値型 int, float, complex に説明があります。

   バージョン 3.6 で変更: コードリテラル中で桁をグループ化するのにアン
   ダースコアを利用できます。

   バージョン 3.8 で変更: "__complex__()" と "__float__()" が定義され
   ていない場合、"__index__()" へフォールバックします。

delattr(object, name)

   "setattr()" の親戚です。引数はオブジェクトと文字列です。文字列はオ
   ブジェクトの属性名のいずれかでなければなりません。対象のオブジェク
   トが許可する場合に限り、この関数は指定された名前の属性を削除します
   。たとえば、 "delattr(x, 'foobar')" は "del x.foobar" と等価です。
   *name* は Python の識別子である必要はありません ("setattr()" を参照
   してください)。

class dict(**kwarg)
class dict(mapping, **kwarg)
class dict(iterable, **kwarg)

   新しい辞書を作成します。 "dict" オブジェクトは辞書クラスです。この
   クラスに関するドキュメンテーションは "dict" と マッピング型 ---
   dict を参照してください。

   他のコンテナについては、 ビルトインの "list", "set", "tuple" クラス
   および "collections" モジュールを参照してください。

dir([object])

   引数がない場合、現在のローカルスコープにある名前のリストを返します
   。引数がある場合、そのオブジェクトの有効な属性のリストを返そうと試
   みます。

   オブジェクトが "__dir__()" という名のメソッドを持つなら、そのメソッ
   ドが呼び出され、属性のリストを返さなければなりません。これにより、
   カスタムの "__getattr__()" や "__getattribute__()" 関数を実装するオ
   ブジェクトは、"dir()" が属性を報告するやり方をカスタマイズできます
   。

   オブジェクトが "__dir__()" を提供しない場合、その型オブジェクトと、
   定義されていればオブジェクトの "__dict__" 属性から、できるだけ情報
   を集めようとします。結果のリストは必ずしも完全ではなく、カスタムの
   "__getattr__()" を持つ場合は不正確かもしれません。

   デフォルトの "dir()" メカニズムは、完全というより最重要な情報を作成
   しようとするため、異なる型のオブジェクトでは異なって振る舞います:

   * オブジェクトがモジュールオブジェクトの場合、リストにはモジュール
     の属性の名前が含まれます。

   * オブジェクトが型オブジェクトやクラスオブジェクトの場合、リストに
     はその属性の名前と、再帰的にたどったその基底クラスの属性が含まれ
     ます。

   * それ以外の場合には、リストにはオブジェクトの属性名、クラス属性名
     、再帰的にたどった基底クラスの属性名が含まれます。

   返されるリストはアルファベット順に並べられています。例えば:

   >>> import struct
   >>> dir()   # show the names in the module namespace  
   ['__builtins__', '__name__', 'struct']
   >>> dir(struct)   # show the names in the struct module 
   ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__',
    '__initializing__', '__loader__', '__name__', '__package__',
    '_clearcache', 'calcsize', 'error', 'pack', 'pack_into',
    'unpack', 'unpack_from']
   >>> class Shape:
   ...     def __dir__(self):
   ...         return ['area', 'perimeter', 'location']
   >>> s = Shape()
   >>> dir(s)
   ['area', 'location', 'perimeter']

   注釈:

     "dir()" は主に対話プロンプトでの使用に便利なように提供されている
     ので、厳密性や一貫性を重視して定義された名前のセットというよりも
     、むしろ興味を引くような名前のセットを返そうとします。また、この
     関数の細かい動作はリリース間で変わる可能性があります。例えば、引
     数がクラスであるとき、メタクラス属性は結果のリストに含まれません
     。

divmod(a, b)

   2つの (複素数でない) 数を引数としてとり、整数の除法を行ったときの商
   と剰余からなる2つの数のペアを返します。被演算子の型が混ざっている場
   合、二項算術演算子での規則が適用されます。整数に対する結果は "(a //
   b, a % b)" と同じです。浮動小数点数では、結果は "(q, a % b)" とあら
   わされます。ただし *q* は通常 "math.floor(a / b)" で、それより 1 だ
   け小さくなることもあります。いずれにせよ "q * b + a % b" は *a* に
   非常に近い値になります。もし "a % b" がゼロでないときは、その符号は
   *b* と同じであり、かつ "0 <= abs(a % b) < abs(b)" を満たします。

enumerate(iterable, start=0)

   enumerate オブジェクトを返します。 *iterable* は、シーケンスか
   *iterator* か、あるいはイテレーションをサポートするその他のオブジェ
   クトでなければなりません。 "enumerate()" によって返されたイテレータ
   の "__next__()" メソッドは、 (デフォルトでは 0 となる *start* から
   の) カウントと、 *iterable* 上のイテレーションによって得られた値を
   含むタプルを返します。

   >>> seasons = ['Spring', 'Summer', 'Fall', 'Winter']
   >>> list(enumerate(seasons))
   [(0, 'Spring'), (1, 'Summer'), (2, 'Fall'), (3, 'Winter')]
   >>> list(enumerate(seasons, start=1))
   [(1, 'Spring'), (2, 'Summer'), (3, 'Fall'), (4, 'Winter')]

   次と等価です:

      def enumerate(sequence, start=0):
          n = start
          for elem in sequence:
              yield n, elem
              n += 1

eval(expression[, globals[, locals]])

   文字列とオプションの引数 *globals*、*locals* をとります。*globals*
   を与える場合は辞書でなくてはなりません。*locals* を与える場合は任意
   のマッピングオブジェクトにできます。

   *globals* と *locals* の2つの辞書をそれぞれグローバルとローカルの名
   前空間とし、*expression* 引数が Python 式 (技術的な言葉では条件のリ
   スト) として評価されます。 *globals* 辞書が存在し、 "__builtins__"
   をキーとして持たない場合は、そのキーの値として 組み込みモジュール
   "builtins" の辞書への参照が、*expression* が解析される前に挿入され
   ます。これにより、 "eval()" に渡す前の *globals* に自身で定義した
   "__builtins__" を定義することで、実行されるコードで利用可能な組み込
   み関数を制御することができます。 *locals* 辞書が省略された場合、
   *globals* 辞書がデフォルトとして使われます。どちらの辞書も省略され
   た場合、 "eval()" が呼び出された環境における *globals* と *locals*
   のもとで式が評価されます。 *eval()* は、その実行環境において、 *ネ
   ストされたスコープ* (ローカルでないオブジェクト) へのアクセスを持た
   ないことに注意してください。

   返される値は、式が評価された結果になります。構文エラーは例外として
   報告されます。例:

   >>> x = 1
   >>> eval('x+1')
   2

   この関数は ("compile()" で生成されるような) 任意のコードオブジェク
   トを実行するのにも利用できます。この場合、文字列の代わりにコードオ
   ブジェクトを渡してください。このコードオブジェクトが、引数 *mode*
   を "'exec'" としてコンパイルされている場合、 "eval()" の戻り値は
   "None" になります。

   ヒント: "exec()" 関数により文の動的な実行がサポートされています。
   "globals()" および "locals()" 関数は、それぞれ現在のグローバルおよ
   びローカルな辞書を返すので、それらを "eval()" や "exec()" に渡して
   使うことができます。

   ソースコードとして文字列が与えられた場合、先頭と末尾の空白文字およ
   びタブは取り去られます。

   リテラルだけを含む式の文字列を安全に評価できる関数、
   "ast.literal_eval()" も参照してください。

   引数 "code_object" を指定して 監査イベント "exec" を送出します。

exec(object[, globals[, locals]])

   この関数は Python コードの動的な実行をサポートします。 *object* は
   文字列かコードオブジェクトでなければなりません。文字列の場合、その
   文字列は一連の Python 文として解析され、そして (構文エラーにならな
   い限り) 実行されます。 [1] コードオブジェクトの場合は、単純に実行さ
   れます。どの場合でも、実行されるコードはファイル入力形式として有効
   であることが期待されます (リファレンスマニュアルの ファイル入力 節
   を参照してください)。  "nonlocal", "yield",  および "return" 文は、
   "exec()" 関数に渡されたコードの文脈中でさえ、関数定義の外側で使うこ
   とはできません。戻り値は "None" です。

   どの場合でも、オプションの部分が省略されると、コードは現在のスコー
   プ内で実行されます。 *globals* だけが与えられた場合、その値は辞書で
   なければならず (かつ辞書のサブクラスであってはならず)、グローバル変
   数とローカル変数の両方に使われます。 *globals* と *locals* の両方が
   与えられた場合、それぞれグローバル変数とローカル変数に使われます。
   *locals* を指定する場合、その値はマップ型オブジェクトでなければなり
   ません。モジュールレベルでは globals と locals は同じ辞書であること
   に留意してください。もし exec が *globals* と *locals* に異なる2つ
   のオブジェクトを受け取った場合、コードはクラス定義に埋め込まれたか
   のように実行されます。

   *globals* 辞書がキー "__builtins__" に対する値を含まなければ、その
   キーに対して、組み込みモジュール "builtins" の辞書への参照が挿入さ
   れます。ですから、実行されるコードを "exec()" に渡す前に、
   *globals* に自作の "__builtins__" 辞書を挿入することで、コードがど
   の組み込みを利用できるか制御できます。

   引数 "code_object" を指定して 監査イベント "exec" を送出します。

   注釈:

     組み込み関数 "globals()" および "locals()" は、それぞれ現在のグロ
     ーバルおよびローカルの辞書を返すので、それらを "exec()" の第二、
     第三引数にそのまま渡して使うと便利なことがあります。

   注釈:

     標準では *locals* は後に述べる関数 "locals()" のように動作します:
     標準の *locals* 辞書に対する変更を試みてはいけません。 "exec()"
     の呼び出しが返る時にコードが *locals* に与える影響を知りたいなら
     、明示的に *locals* 辞書を渡してください。

filter(function, iterable)

   *iterable* の要素のうち *function* が真を返すものでイテレータを構築
   します。*iterable* はシーケンスか、反復をサポートするコンテナか、イ
   テレータです。*function* が "None" なら、恒等関数を仮定します。すな
   わち、*iterable* の偽である要素がすべて除去されます。

   なお、"filter(function, iterable)" は、関数が "None" でなければジェ
   ネレータ式 "(item for item in iterable if function(item))" と同等で
   、関数が "None" なら "(item for item in iterable if item)" と同等で
   す。

   *function* が偽を返すような *iterable* の各要素を返す補完的関数は、
   "itertools.filterfalse()" を参照してください。

class float([x])

   数または文字列 *x* から生成された浮動小数点数を返します。

   引数が文字列の場合、10進数でなければなりません。先頭に符号または空
   白を含んでもかまいません。符号は "'+'" か "'-'" のいずれかです。正
   符号 "'+'" は生成される値に対して何の効果もありません。引数は NaN
   (not-a-number) や正または負の無限大をあらわす文字列でもかまいません
   。より正確にいうと、入力は先頭と末尾の空白文字を除き、以下に示す
   "floatvalue" の生成規則に従う必要があります:

      sign        ::= "+" | "-"
      infinity    ::= "Infinity" | "inf"
      nan         ::= "nan"
      digitpart   ::= digit (["_"] digit)*
      number      ::= [digitpart] "." digitpart | digitpart ["."]
      exponent    ::= ("e" | "E") ["+" | "-"] digitpart
      floatnumber ::= number [exponent]
      floatvalue  ::= [sign] (floatnumber | infinity | nan)

   ここで "digit" は、ユニコードでの10進数の数字 (ユニコードの一般カテ
   ゴリ "Nd" に含まれる文字) です。大文字と小文字の区別はありません。
   したがって、例えば "inf", "Inf", "INFINITY", そして "iNfINity" は全
   て正の無限大として有効な書き方です。

   一方で、引数が整数または浮動小数点数なら、(Python の浮動小数点数の
   精度で) 同じ値の浮動小数点数が返されます。引数が Python の浮動小数
   点数の範囲外なら、 "OverflowError" が送出されます。

   一般の Python オブジェクト "x" に対して、"float(x)" は
   "x.__float__()" に委譲します。 "__float__()" が定義されていない場合
   、"__index__()" へフォールバックします。

   引数が与えられなければ、"0.0" が返されます。

   例:

      >>> float('+1.23')
      1.23
      >>> float('   -12345\n')
      -12345.0
      >>> float('1e-003')
      0.001
      >>> float('+1E6')
      1000000.0
      >>> float('-Infinity')
      -inf

   浮動小数点数型については、 数値型 int, float, complex も参照してく
   ださい。

   バージョン 3.6 で変更: コードリテラル中で桁をグループ化するのにアン
   ダースコアを利用できます。

   バージョン 3.7 で変更: *x* は位置専用引数になりました。

   バージョン 3.8 で変更: "__float__()" が定義されていない場合、
   "__index__()" へフォールバックします。

format(value[, format_spec])

   *value* を *format_spec* で指示された通りに "整形" した文字列表現に
   変換します。 *format_spec* の解釈は *value* 引数の型に依存しますが
   、ほとんどの組み込み型で使われる標準的な構文が存在します: 書式指定
   ミニ言語仕様。

   デフォルトの *format_spec* は空の文字列です。それは通常
   "str(value)" の呼び出しと同じ結果になります。

   "format(value, format_spec)" の呼び出しは、
   "type(value).__format__(value, format_spec)" に翻訳され、これは
   value の "__format__()" メソッドの検索をするとき、インスタンス辞書
   を回避します。このメソッドの探索が "object" に到達しても
   *format_spec* が空にならなかったり、 *format_spec* や返り値が文字列
   でなかったりした場合、 "TypeError" が送出されます。

   バージョン 3.4 で変更: *format_spec* が空の文字列でない場合
   "object().__format__(format_spec)" は "TypeError" を送出します。

class frozenset([iterable])

   新しい "frozenset" オブジェクトを返します。オプションで *iterable*
   から得られた要素を含みます。 "frozenset" はビルトインクラスです。こ
   のクラスに関するドキュメントは "frozenset" と set（集合）型 ---
   set, frozenset を参照してください。

   他のコンテナについては、ビルトインクラス "set", "list", "tuple",
   "dict" や "collections" モジュールを見てください。

getattr(object, name[, default])

   *object* の指定された属性の値を返します。 *name* は文字列でなければ
   なりません。与えられた文字列がオブジェクトの属性名のうちいずれかに
   一致すれば、戻り値はその属性の値になります。たとえば、 "getattr(x,
   'foobar')" は "x.foobar" と等価です。もし指定された属性が存在しない
   場合、 *default* が指定されていればその値が返されます。そうでない場
   合は "AttributeError" が送出されます。 *name* は Python 識別子であ
   る必要はありません ("setattr()" を参照してください)。

   注釈:

     プライベートな名前のマングリング はコンパイル時に行われます。その
     ため、プライベートな属性 (先頭に2つのアンダースコアを伴う名前を持
     つ属性) の値を "getattr()" で取り出すためには、属性名を手動でマン
     グリングする必要があります。

globals()

   現在のモジュールの名前空間を実装した辞書を返します。関数内のコード
   に対しては、関数が定義されるときに辞書が設定され、その関数がどこか
   ら呼ばれたかにかかわらず同じ内容になります。

hasattr(object, name)

   引数はオブジェクトと文字列です。文字列がオブジェクトの属性名の一つ
   であった場合 "True" を、そうでない場合 "False" を返します。 (この関
   数は、 "getattr(object, name)" を呼び出して "AttributeError" を送出
   するかどうかを見ることで実装されています。)

hash(object)

   オブジェクトのハッシュ値を (存在すれば) 返します。ハッシュ値は整数
   です。これらは辞書を検索する際に辞書のキーを高速に比較するために使
   われます。等しい値となる数値は等しいハッシュ値を持ちます (1 と 1.0
   のように型が異なっていてもです)。

   注釈:

     独自の "__hash__()" メソッドを実装したオブジェクトを使う場合、
     "hash()" が実行するマシンのビット幅に合わせて戻り値を切り捨てるこ
     とに注意してください。詳しくは "__hash__()" を参照してください。

help([object])

   組み込みヘルプシステムを起動します。(この関数は対話的な使用のための
   ものです。) 引数が与えられていない場合、対話的ヘルプシステムはイン
   タプリタコンソール上で起動します。引数が文字列の場合、文字列はモジ
   ュール、関数、クラス、メソッド、キーワード、またはドキュメントの項
   目名として検索され、ヘルプページがコンソール上に印字されます。引数
   がその他のオブジェクトの場合、そのオブジェクトに関するヘルプページ
   が生成されます。

   "help()" を呼び出したときに関数の引数リストにスラッシュ (/) が現れ
   た場合は、スラッシュより前の引数が位置専用引数だという意味であるこ
   とに注意してください。より詳しい情報は、 位置専用引数についての FAQ
   の項目 を参照してください。

   この関数は、 "site" モジュールから、組み込みの名前空間に移されまし
   た。

   バージョン 3.4 で変更: "pydoc" と "inspect" への変更により、呼び出
   し可能オブジェクトの報告されたシグニチャがより包括的で一貫性のある
   ものになりました。

hex(x)

   整数を先頭に "0x" が付いた小文字の 16 進文字列に変換します。 *x* が
   Python の "int" オブジェクトでない場合、整数を返す "__index__()" メ
   ソッドが定義されていなければなりません。 いくつかの例を示します:

   >>> hex(255)
   '0xff'
   >>> hex(-42)
   '-0x2a'

   整数を大文字の 16 進文字列や小文字の 16 進文字列、先頭の "0x" 付き
   や "0x" 無しに変換したい場合は、次に挙げる方法が使えます:

   >>> '%#x' % 255, '%x' % 255, '%X' % 255
   ('0xff', 'ff', 'FF')
   >>> format(255, '#x'), format(255, 'x'), format(255, 'X')
   ('0xff', 'ff', 'FF')
   >>> f'{255:#x}', f'{255:x}', f'{255:X}'
   ('0xff', 'ff', 'FF')

   より詳しいことは "format()" も参照してください。

   16を底として16進数文字列を整数に変換するには "int()" も参照してくだ
   さい。

   注釈:

     浮動小数点数の16進文字列表記を得たい場合には、 "float.hex()" メソ
     ッドを使って下さい。

id(object)

   オブジェクトの "識別値" を返します。この値は整数で、このオブジェク
   トの有効期間中は一意かつ定数であることが保証されています。有効期間
   が重ならない 2 つのオブジェクトは同じ "id()" 値を持つかもしれません
   。

   **CPython 実装の詳細:** これはオブジェクトのメモリアドレスです。

   引数 "id" を指定して 監査イベント "builtins.id" を送出します。

input([prompt])

   引数 *prompt* が存在すれば、それが末尾の改行を除いて標準出力に書き
   出されます。次に、この関数は入力から 1 行を読み込み、文字列に変換し
   て (末尾の改行を除いて) 返します。 EOF が読み込まれたとき、
   "EOFError" が送出されます。例:

      >>> s = input('--> ')  
      --> Monty Python's Flying Circus
      >>> s  
      "Monty Python's Flying Circus"

   "readline" モジュールが読み込まれていれば、 "input()" はそれを使っ
   て精緻な行編集やヒストリ機能を提供します。

   引数 "prompt" 付きで 監査イベント "builtins.input" を送出します。

   引数 "result" 付きで 監査イベント "builtins.input/result" を送出し
   ます。

class int([x])
class int(x, base=10)

   数値または文字列 *x* から作成された整数オブジェクトを返します。引数
   が与えられない場合には "0" を返します。 *x* に "__int__()" が定義さ
   れている場合は、 "int(x)" は "x.__int__()" を返します。 *x* に
   "__index__()" が定義されている場合は、 "x.__index__()" を返します。
   *x* に "__trunc__()" が定義されている場合は、 "x.__trunc__()" を返
   します。 浮動小数点数については、これは 0 に近い側へ切り捨てます。

   If *x* is not a number or if *base* is given, then *x* must be a
   string, "bytes", or "bytearray" instance representing an integer in
   radix *base*.  Optionally, the string can be preceded by "+" or "-"
   (with no space in between), have leading zeros, be surrounded by
   whitespace, and have single underscores interspersed between
   digits.

   A base-n integer string contains digits, each representing a value
   from 0 to n-1. The values 0--9 can be represented by any Unicode
   decimal digit. The values 10--35 can be represented by "a" to "z"
   (or "A" to "Z"). The default *base* is 10. The allowed bases are 0
   and 2--36. Base-2, -8, and -16 strings can be optionally prefixed
   with "0b"/"0B", "0o"/"0O", or "0x"/"0X", as with integer literals
   in code.  For base 0, the string is interpreted in a similar way to
   an integer literal in code, in that the actual base is 2, 8, 10, or
   16 as determined by the prefix. Base 0 also disallows leading
   zeros: "int('010', 0)" is not legal, while "int('010')" and
   "int('010', 8)" are.

   整数型については、 数値型 int, float, complex も参照してください。

   バージョン 3.4 で変更: *base* が "int" のインスタンスでなく、*base*
   オブジェクトが "base.__index__" メソッドを持っている場合、そのメソ
   ッドを呼んで底に対する整数を得ることができます。以前のバージョンで
   は "base.__index__" ではなく "base.__int__" を使用していました。

   バージョン 3.6 で変更: コードリテラル中で桁をグループ化するのにアン
   ダースコアを利用できます。

   バージョン 3.7 で変更: *x* は位置専用引数になりました。

   バージョン 3.8 で変更: "__int__()" が定義されていない場合、
   "__index__()" へフォールバックします。

   バージョン 3.10.7 で変更: "int" への文字列入力やその文字列表現は、
   サービス拒否攻撃 (DoS 攻撃) を避けるために制限されることがあります
   。文字列 *x* を "int" に変換したり "int" を文字列に変換したりする際
   にその制限を超えた場合、 "ValueError" が送出されます。詳しくは 整数
   文字列の変換における長さ制限 を参照してください。

isinstance(object, classinfo)

   Return "True" if the *object* argument is an instance of the
   *classinfo* argument, or of a (direct, indirect, or *virtual*)
   subclass thereof.  If *object* is not an object of the given type,
   the function always returns "False". If *classinfo* is a tuple of
   type objects (or recursively, other such tuples) or a Union Type of
   multiple types, return "True" if *object* is an instance of any of
   the types. If *classinfo* is not a type or tuple of types and such
   tuples, a "TypeError" exception is raised.

   バージョン 3.10 で変更: *classinfo* に Union Type を指定できるよう
   になりました。

issubclass(class, classinfo)

   *class* が *classinfo* の (直接、間接、または *仮想* の) サブクラス
   である場合に "True" を返します。クラスは自身のサブクラスとみなされ
   ます。 *classinfo* はクラスオブジェクトのタプル (または再帰的にその
   ようなタプルを含むタプル) やクラスオブジェクトの Union Type でもよ
   く、この場合は *class* が *classinfo* のいずれかのクラスのサブクラ
   スであれば "True" を返します。上記以外の値が指定された場合、
   "TypeError" 例外が送出されます。

   バージョン 3.10 で変更: *classinfo* に Union Type を指定できるよう
   になりました。

iter(object[, sentinel])

   *iterator* オブジェクトを返します。第二引数があるかどうかによって第
   一引数の解釈は大きく異なります。第二引数がない場合、 *object* は
   *iterable* プロトコル ("__iter__()" メソッド) をサポートするコレク
   ションオブジェクトか、またはシーケンスプロトコル ("0" から始まる整
   数を引数にとる "__getitem__()" メソッド) をサポートするオブジェクト
   でなければなりません。第一引数がどちらのプロトコルもサポートしない
   場合は "TypeError" 例外が送出されます。第二引数 *sentinel* が与えら
   れた場合、 *object* は呼び出し可能オブジェクトでなければなりません
   。この場合に生成されるイテレータは "__next__()" メソッドを呼び出す
   ごとに引数なしで *object* を呼び出します; 戻り値が *sentinel* と等
   しければ、 "StopIteration" が送出されます。それ以外の場合は戻り値が
   そのまま返されます。

   イテレータ型 も見てください。

   2引数形式の "iter()" の便利な利用方法の1つは、ブロックリーダーの構
   築です。 例えば、バイナリのデータベースファイルから固定幅のブロック
   をファイルの終端に到達するまで読み出すには次のようにします:

      from functools import partial
      with open('mydata.db', 'rb') as f:
          for block in iter(partial(f.read, 64), b''):
              process_block(block)

len(s)

   オブジェクトの長さ (要素の数) を返します。引数はシーケンス (文字列
   、バイト列、タプル、リスト、range 等) かコレクション (辞書、集合、
   凍結集合等) です。

   **CPython 実装の詳細:** "len" は、例えば "range(2 ** 100)" のような
   、 "sys.maxsize" を超える長さに対して "OverflowError" を送出します
   。

class list([iterable])

   "list" は、実際には関数ではなくミュータブルなシーケンス型で、 リス
   ト型 (list) と シーケンス型 --- list, tuple, range にドキュメント化
   されています。

locals()

   現在のローカルシンボルテーブルを表す辞書を更新して返します。 関数ブ
   ロックで "locals()" を呼び出したときは自由変数が返されますが、クラ
   スブロックでは返されません。 モジュールレベルでは、 "locals()" と
   "globals()" は同じ辞書であることに注意してください。

   注釈:

     この辞書の内容は変更してはいけません; 変更しても、インタプリタが
     使うローカル変数や自由変数の値には影響しません。

map(function, iterable, ...)

   *function* を、結果を返しながら *iterable* の全ての要素に適用するイ
   テレータを返します。追加の *iterable* 引数が渡されたなら、
   *function* はその数だけの引数を取らなければならず、全てのイテラブル
   から並行して取られた要素に適用されます。複数のイテラブルが与えられ
   たら、このイテレータはその中の最短のイテラブルが尽きた時点で止まり
   ます。関数の入力がすでに引数タプルに配置されている場合は、
   "itertools.starmap()" を参照してください。

max(iterable, *[, key, default])
max(arg1, arg2, *args[, key])

   iterable の中で最大の要素、または2つ以上の引数の中で最大のものを返
   します。

   位置引数が1つだけ与えられた場合、それは空でない *iterable* でなくて
   はいけません。その iterable の最大の要素が返されます。2 つ以上のキ
   ーワード無しの位置引数が与えられた場合、その位置引数の中で最大のも
   のが返されます。

   任意のキーワード専用引数が 2 つあります。 *key* 引数は引数を 1 つ取
   る順序関数 ("list.sort()" のもののように) を指定します。 *default*
   引数は与えられたイテラブルが空の場合に返すオブジェクトを指定します
   。 イテラブルが空で *default* が与えられていない場合 "ValueError"
   が送出されます。

   最大の要素が複数あるとき、この関数はそのうち最初に現れたものを返し
   ます。これは、"sorted(iterable, key=keyfunc, reverse=True)[0]" や
   "heapq.nlargest(1, iterable, key=keyfunc)" のような、他のソート安定
   性を維持するツールと両立します。

   バージョン 3.4 で追加: *default* キーワード専用引数。

   バージョン 3.8 で変更: *key* 引数が "None" であることを許容します。

class memoryview(object)

   与えられたオブジェクトから作られた "メモリビュー" オブジェクトを返
   します。詳しくは メモリビュー を参照してください。

min(iterable, *[, key, default])
min(arg1, arg2, *args[, key])

   iterable の中で最小の要素、または2つ以上の引数の中で最小のものを返
   します。

   位置引数が1つだけ与えられた場合、それは空でない *iterable* でなくて
   はいけません。その iterable の最小の要素が返されます。2 つ以上のキ
   ーワード無しの位置引数が与えられた場合、その位置引数の中で最小のも
   のが返されます。

   任意のキーワード専用引数が 2 つあります。 *key* 引数は引数を 1 つ取
   る順序関数 ("list.sort()" のもののように) を指定します。 *default*
   引数は与えられたイテラブルが空の場合に返すオブジェクトを指定します
   。 イテラブルが空で *default* が与えられていない場合 "ValueError"
   が送出されます。

   最小の要素が複数あるとき、この関数はそのうち最初に現れたものを返し
   ます。これは、"sorted(iterable, key=keyfunc)[0]" や
   "heapq.nsmallest(1, iterable, key=keyfunc)" のような、他のソート安
   定性を維持するツールと両立します。

   バージョン 3.4 で追加: *default* キーワード専用引数。

   バージョン 3.8 で変更: *key* 引数が "None" であることを許容します。

next(iterator[, default])

   *iterator* の "__next__()" メソッドを呼び出すことにより、次の要素を
   取得します。イテレータが使い尽くされた場合、 *default* が与えられて
   いればその値が返されます。そうでない場合は "StopIteration" が送出さ
   れます。

class object

   何の機能も持たない新しいオブジェクトを返します。 "object" は全ての
   クラスの基底クラスです。これは、全ての Python クラスのインスタンス
   に共通のメソッド群を持ちます。この関数はいかなる引数も受け付けませ
   ん。

   注釈:

     "object" は "__dict__" を *持たない* ので、 "object"  クラスのイ
     ンスタンスに任意の属性を代入することはできません。

oct(x)

   整数を先頭に "0o" が付いた 8 進文字列に変換します。 結果は Python
   の式としても使える形式になります。 *x* が Python の "int" オブジェ
   クトでない場合、整数を返す "__index__()" メソッドが定義されていなけ
   ればなりません。 例えば、次のようになります:

   >>> oct(8)
   '0o10'
   >>> oct(-56)
   '-0o70'

   整数を接頭辞 "0o" 付きや "0o" 無しの 8 進文字列に変換したい場合は、
   次に挙げる方法のいずれかを使ってください。

   >>> '%#o' % 10, '%o' % 10
   ('0o12', '12')
   >>> format(10, '#o'), format(10, 'o')
   ('0o12', '12')
   >>> f'{10:#o}', f'{10:o}'
   ('0o12', '12')

   より詳しいことは "format()" も参照してください。

open(file, mode='r', buffering=- 1, encoding=None, errors=None, newline=None, closefd=True, opener=None)

   *file* を開き、対応する *ファイルオブジェクト* を返します。ファイル
   を開くことができなければ、"OSError" が送出されます。 この関数の利用
   例について、 ファイルを読み書きする を参照してください。

   *file* は *path-like object* で、開くファイルのパス名 (絶対パスまた
   は現在の作業ディレクトリからの相対パス) あるいはラップするファイル
   の整数のファイルデスクリプタを与えます。 (ファイルデスクリプタが与
   えられた場合、 *closefd* が "False" に設定されていないかぎり、この
   関数が返す I/O オブジェクトがクローズされるときにファイルデスクリプ
   タもクローズされます。)

   *mode* is an optional string that specifies the mode in which the
   file is opened.  It defaults to "'r'" which means open for reading
   in text mode. Other common values are "'w'" for writing (truncating
   the file if it already exists), "'x'" for exclusive creation, and
   "'a'" for appending (which on *some* Unix systems, means that *all*
   writes append to the end of the file regardless of the current seek
   position).  In text mode, if *encoding* is not specified the
   encoding used is platform-dependent:
   "locale.getpreferredencoding(False)" is called to get the current
   locale encoding. (For reading and writing raw bytes use binary mode
   and leave *encoding* unspecified.)  The available modes are:

   +-----------+-----------------------------------------------------------------+
   | 文字      | 意味                                                            |
   |===========|=================================================================|
   | "'r'"     | 読み込み用に開く (デフォルト)                                   |
   +-----------+-----------------------------------------------------------------+
   | "'w'"     | 書き込み用に開き、まずファイルを切り詰める                      |
   +-----------+-----------------------------------------------------------------+
   | "'x'"     | 排他的な生成に開き、ファイルが存在する場合は失敗する            |
   +-----------+-----------------------------------------------------------------+
   | "'a'"     | 書き込み用に開き、ファイルが存在する場合には末尾に追記する      |
   +-----------+-----------------------------------------------------------------+
   | "'b'"     | バイナリモード                                                  |
   +-----------+-----------------------------------------------------------------+
   | "'t'"     | テキストモード (デフォルト)                                     |
   +-----------+-----------------------------------------------------------------+
   | "'+'"     | 更新用に開く (読み込み・書き込み用)                             |
   +-----------+-----------------------------------------------------------------+

   デフォルトのモードは "'r'" (テキストの読み込み用に開く、 "'rt'" と
   同義) です。 "'w+'" と "'w+b'" はファイルを開いて上書きします。
   "'r+'" と "'r+b'" はファイルを上書きせずに開きます。

   概要 で触れられているように、Python はバイナリとテキストの I/O を区
   別します。(*mode* 引数に "'b'" を含めて) バイナリモードで開かれたフ
   ァイルは、内容をいかなるデコーディングもせずに "bytes"  オブジェク
   トとして返します。(デフォルトや、 *mode* 引数に "'t'" が含まれたと
   きの) テキストモードでは、ファイルの内容は "str" として返され、バイ
   ト列はまず、プラットフォーム依存のエンコーディングか、*encoding* が
   指定された場合は指定されたエンコーディングを使ってデコードされます
   。

   There is an additional mode character permitted, "'U'", which no
   longer has any effect, and is considered deprecated. It previously
   enabled *universal newlines* in text mode, which became the default
   behavior in Python 3.0. Refer to the documentation of the newline
   parameter for further details.

   注釈:

     Python は、下層のオペレーティングシステムがテキストファイルをどう
     認識するかには依存しません; すべての処理は Python 自身で行われ、
     よってプラットフォーム非依存です。

   *buffering* はオプションの整数で、バッファリングのポリシーを設定す
   るために使われます。  バッファリングを無効化するためには0を渡してく
   ださい (バイナリモードでのみ設定可能です)。また行単位でのバッファリ
   ングには1を設定してください (テキストモードでのみ有効です)。固定サ
   イズのチャンクバッファに対するサイズをバイト単位で指定したい場合は
   、1より大きい整数を渡してください。この形式でバッファサイズを指定し
   た場合、バイナリ形式でバッファリングをサポートする I/O (buffered
   I/O) にはそのまま適用されますが、 "TextIOWrapper" (すなわち
   "mode='r+'" のモードでオープンされたファイル) では別のバッファリン
   グを行うかもしれません。 "TextIOWrapper" でバッファリングを無効化す
   るには、 "io.TextIOWrapper.reconfigure()" で "write_through" フラグ
   を使うことを検討してください。 *buffering* 引数が与えられなかった場
   合、デフォルトのバッファリングポリシーは以下のように動作します:

   * バイナリファイルは固定サイズのチャンクでバッファリングされます。
     バッファサイズは、下層のデバイスの「ブロックサイズ」を決定するヒ
     ューリスティックを用いて選択され、それが不可能な場合は代わりに
     "io.DEFAULT_BUFFER_SIZE" が使われます。多くのシステムでは、典型的
     なバッファサイズは 4096 か 8192 バイト長になるでしょう。

   * 「対話的な」テキストファイル ("isatty()" が "True" を返すファイル
     ) は行バッファリングを使用します。 その他のテキストファイルは、上
     で説明したバイナリファイル用の方針を使用します。

   *encoding* はファイルのエンコードやデコードに使われる *text
   encoding* の名前です。このオプションはテキストモードでのみ使用して
   ください。デフォルトエンコーディングはプラットフォーム依存
   ("locale.getpreferredencoding()" が返すもの) ですが、Pythonでサポー
   トされているエンコーディングはどれでも使えます。詳しくは "codecs"
   モジュール内のサポートしているエンコーディングのリストを参照してく
   ださい。

   *errors* はオプションの文字列で、エンコードやデコードでのエラーをど
   のように扱うかを指定するものです。バイナリモードでは使用できません
   。様々な標準のエラーハンドラが使用可能です (エラーハンドラ に列記さ
   れています) が、 "codecs.register_error()" に登録されているエラー処
   理の名前も使用可能です。標準のエラーハンドラの名前には、以下のよう
   なものがあります:

   * "'strict'" はエンコーディングエラーがあると例外 "ValueError" を発
     生させます。デフォルト値である "None" も同じ効果です。

   * "'ignore'" はエラーを無視します。エンコーディングエラーを無視する
     ことで、データが失われる可能性があることに注意してください。

   * "'replace'" は、不正な形式のデータが存在した場所に("'?'" のような
     ) 置換マーカーを挿入します。

   * "'surrogateescape'" は正しくないバイト列をユニコードの下位サロゲ
     ート領域のうち U+DC80 から U+DCFF の範囲のコードユニットであらわ
     します。データの書き込み時に "surrogateescape" エラーハンドラが使
     われると、これらのサロゲートコードユニットは元と同じバイト列に変
     換されます。これはエンコーディングが不明なファイルを処理するのに
     便利です。

   * "'xmlcharrefreplace'" はファイルへの書き込み時のみサポートされま
     す。そのエンコーディングでサポートされない文字は、"&#nnn;" 形式の
     適切な XML 文字参照で置換されます。

   * "'backslashreplace'" は不正なデータを Python のバックスラッシュ付
     きのエスケープシーケンスで置換します。

   * "'namereplace'" (書き込み時のみサポートされています) はサポートさ
     れていない文字を "\N{...}" エスケープシーケンスで置換します。

   *newline* はストリームから受け取った改行文字をどのようにパースする
   かを決定します。 "None", "''", "'\n'", "'\r'", または "'\r\n'" のい
   ずれかを指定できます。これは以下のように動作します:

   * ストリームからの入力の読み込み時、*newline* が "None" の場合、ユ
     ニバーサル改行モードが有効になります。入力中の行は "'\n'",
     "'\r'", または "'\r\n'" で終わり、呼び出し元に返される前に "'\n'"
     に変換されます。 "''" の場合、ユニバーサル改行モードは有効になり
     ますが、行末は変換されずに呼び出し元に返されます。その他の正当な
     値の場合、入力行は与えられた文字列でのみ終わり、行末は変換されず
     に呼び出し元に返されます。

   * ストリームへの出力の書き込み時、*newline* が "None" の場合、全て
     の "'\n'" 文字はシステムのデフォルトの行セパレータ "os.linesep"
     に変換されます。 *newline* が "''" または "'\n'" の場合は変換され
     ません。*newline* がその他の正当な値の場合、全ての "'\n'" 文字は
     与えられた文字列に変換されます。

   *closefd* が "False" で、ファイル名ではなくてファイル記述子が与えら
   れた場合、下層のファイル記述子はファイルが閉じられた後も開いたまま
   となります。 ファイル名が与えられた場合、*closefd* は "True" (デフ
   ォルト値) でなければなりません。 そうでない場合エラーが送出されます
   。

   呼び出し可能オブジェクトを *opener* として与えることで、カスタムの
   オープナーが使えます。そしてファイルオブジェクトの下層のファイル記
   述子は、*opener* を (*file*, *flags*) で呼び出して得られます。
   *opener* は開いたファイル記述子を返さなければなりません。
   ("os.open" を *opener* として渡すと、"None" を渡したのと同様の機能
   になります)。

   新たに作成されたファイルは 継承不可  です。

   次の例は "os.open()" 関数の dir_fd 引数を使い、与えられたディレクト
   リからの相対パスで指定されたファイルを開きます:

      >>> import os
      >>> dir_fd = os.open('somedir', os.O_RDONLY)
      >>> def opener(path, flags):
      ...     return os.open(path, flags, dir_fd=dir_fd)
      ...
      >>> with open('spamspam.txt', 'w', opener=opener) as f:
      ...     print('This will be written to somedir/spamspam.txt', file=f)
      ...
      >>> os.close(dir_fd)  # don't leak a file descriptor

   "open()" 関数が返す *file object* の型はモードに依存します。
   "open()" をファイルをテキストモード ("'w'", "'r'", "'wt'", "'rt'",
   など) で開くのに使ったときは "io.TextIOBase" (特に
   "io.TextIOWrapper") のサブクラスを返します。 ファイルをバッファリン
   グ付きのバイナリモードで開くのに使ったときは "io.BufferedIOBase" の
   サブクラスを返します。 実際のクラスは様々です。 読み込みバイナリモ
   ードでは "io.BufferedReader" を返します。 書き込みバイナリモードや
   追記バイナリモードでは "io.BufferedWriter" を返します。 読み書きモ
   ードでは "io.BufferedRandom" を返します。 バッファリングが無効なと
   きはrawストリーム、すなわち "io.RawIOBase" のサブクラスである
   "io.FileIO" を返します。

   "fileinput" 、("open()" が宣言された場所である) "io" 、 "os" 、
   "os.path" 、 "tempfile" 、 "shutil" などの、ファイル操作モジュール
   も参照してください。

   引数 "file", "mode", "flags" を指定して 監査イベント "open" を送出
   します。

   "mode" と "flags" の2つの引数は呼び出し時の値から修正されたり、推量
   により設定されたりする可能性があります。

      バージョン 3.3 で変更:

      * *opener* 引数を追加しました。

      * "'x'" モードを追加しました。

      * 以前は "IOError" が送出されました; それは現在 "OSError" のエイ
        リアスです。

      * 既存のファイルを 排他的生成モード("'x'")で開いた場合、
        "FileExistsError" を送出するようになりました。

      バージョン 3.4 で変更:

      * ファイルが継承不可になりました。

   バージョン 3.4 で非推奨、バージョン 3.10 で削除: "'U'" モード。

      バージョン 3.5 で変更:

      * システムコールが中断されシグナルハンドラが例外を送出しなかった
        場合、この関数は "InterruptedError" 例外を送出する代わりにシス
        テムコールを再試行するようになりました (論拠については **PEP
        475** を参照してください)。

      * "'namereplace'" エラーハンドラが追加されました。

      バージョン 3.6 で変更:

      * "os.PathLike" を実装したオブジェクトを受け入れるようになりまし
        た。

      * Windowsでは、コンソールバッファのオープンは、"io.FileIO" では
        なく、"io.RawIOBase" のサブクラスを返すでしょう。

ord(c)

   1 文字の Unicode 文字を表す文字列に対し、その文字の Unicode コード
   ポイントを表す整数を返します。例えば、 "ord('a')" は整数 "97" を返
   し、 "ord('€')" (ユーロ記号) は "8364" を返します。これは "chr()"
   の逆です。

pow(base, exp[, mod])

   *base* の *exp* 乗を返します; *mod* があれば、*base* の *exp* 乗に
   対する *mod* の剰余を返します ("pow(base, exp) % mod" より効率よく
   計算されます)。二引数の形式 "pow(base, exp)" は、冪乗演算子を使った
   "base**exp" と等価です。

   引数は数値型でなければなりません。型混合の場合、二項算術演算におけ
   る型強制規則が適用されます。 "int" オペランドの場合、第2引数が負で
   ない限り、結果は (型強制後の) オペランドと同じ型になります; 第2引数
   が負の場合、全ての引数は浮動小数点数に変換され、浮動小数点数の結果
   が返されます。例えば、 "pow(10, 2)" は "100" を返しますが、
   "pow(10, -2)" は "0.01" を返します。底が "int" 型または "float" 型
   で負の値であり、かつ指数が整数でない場合、複素数の結果が返されます
   。例えば、 "pow(-9, 0.5)" は "3j" に近い値を返します。

   *base* と *exp* が "int" オペランドで *mod* が存在するとき、 *mod*
   もまた整数型でなければならず、かつゼロであってはいけません。 *mod*
   が存在して *exp* が負の整数の場合、 *base* は *mod* と互いに素 (最
   大公約数が1) でなければなりません。この場合、 *inv_base* を *base*
   に対する *mod* を法とするモジュラ逆数 (*base* と *inv_base* の積を
   *mod* で割った余りが1になるような数) として、 "pow(inv_base, -exp,
   mod)" が返されます。

   以下は "97" を法とする "38" のモジュラ逆数の計算例です:

      >>> pow(38, -1, mod=97)
      23
      >>> 23 * 38 % 97 == 1
      True

   バージョン 3.8 で変更: "int" オペランドに対して、三引数形式の "pow"
   で第二引数に負の値を取ることができるようになりました。これによりモ
   ジュラ逆数の計算が可能になります。

   バージョン 3.8 で変更: キーワード引数を取ることができるようになりま
   した。以前は位置引数だけがサポートされていました。

print(*objects, sep=' ', end='\n', file=None, flush=False)

   *objects* を *sep* で区切りながらテキストストリーム *file* に表示し
   、最後に *end* を表示します。*sep* 、 *end* 、 *file* 、 *flush* を
   与える場合、キーワード引数として与える必要があります。

   キーワードなしの引数はすべて、 "str()" がするように文字列に変換され
   、 *sep* で区切られながらストリームに書き出され、最後に *end* が続
   きます。 *sep* と *end* の両方とも、文字列でなければなりません。こ
   れらを "None" にすると、デフォルトの値が使われます。 *objects* が与
   えられなければ、 "print()" は *end* だけを書き出します。

   *file* 引数は、 "write(string)" メソッドを持つオブジェクトでなけれ
   ばなりません。指定されないか、 "None" である場合、 "sys.stdout" が
   使われます。表示される引数は全てテキスト文字列に変換されますから、
   "print()" はバイナリモードファイルオブジェクトには使用できません。
   代わりに "file.write(...)" を使ってください。

   Output buffering is usually determined by *file*. However, if
   *flush* is true, the stream is forcibly flushed.

   バージョン 3.3 で変更: キーワード引数 *flush* が追加されました。

class property(fget=None, fset=None, fdel=None, doc=None)

   property 属性を返します。

   *fget* は属性値を取得するための関数です。*fset* は属性値を設定する
   ための関数です。*fdel* は属性値を削除するための関数です。*doc* は属
   性の docstring を作成します。

   典型的な使用法は、属性 "x" の処理の定義です:

      class C:
          def __init__(self):
              self._x = None

          def getx(self):
              return self._x

          def setx(self, value):
              self._x = value

          def delx(self):
              del self._x

          x = property(getx, setx, delx, "I'm the 'x' property.")

   *c* が *C* のインスタンスならば、"c.x" は getter を呼び出し、"c.x =
   value" は setter を、"del c.x" は deleter を呼び出します。

   *doc* は、与えられれば property 属性のドキュメント文字列になります
   。 与えられなければ、 property は *fget* のドキュメント文字列 (もし
   あれば) をコピーします。 そのため "property()" を *デコレータ* とし
   て使えば、読み出し専用 property を作るのは容易です:

      class Parrot:
          def __init__(self):
              self._voltage = 100000

          @property
          def voltage(self):
              """Get the current voltage."""
              return self._voltage

   "@property" デコレータは "voltage()" を同じ名前のまま 読み出し専用
   属性の "getter" にし、*voltage* のドキュメント文字列を "Get the
   current voltage." に設定します。

   property オブジェクトは "getter", "setter", "deleter" メソッドを持
   っています。これらのメソッドをデコレータとして使うと、対応するアク
   セサ関数がデコレートされた関数に設定された、 property のコピーを作
   成できます。これを一番分かりやすく説明する例があります:

      class C:
          def __init__(self):
              self._x = None

          @property
          def x(self):
              """I'm the 'x' property."""
              return self._x

          @x.setter
          def x(self, value):
              self._x = value

          @x.deleter
          def x(self):
              del self._x

   このコードは最初の例と等価です。追加の関数には、必ず元の property
   と同じ名前 (この例では "x") を与えて下さい。

   返される property オブジェクトも、コンストラクタの引数に対応した
   "fget", "fset", および "fdel" 属性を持ちます。

   バージョン 3.5 で変更: 属性オブジェクトのドックストリングが書き込み
   可能になりました。

class range(stop)
class range(start, stop[, step])

   "range" は、実際には関数ではなくイミュータブルなシーケンス型で、
   range と シーケンス型 --- list, tuple, range にドキュメント化されて
   います。

repr(object)

   オブジェクトの印字可能な表現を含む文字列を返します。この関数は多く
   の型について、 "eval()" に渡されたときと同じ値を持つようなオブジェ
   クトを表す文字列を生成しようとします。そうでない場合は、山括弧に囲
   まれたオブジェクトの型の名前と追加の情報 (大抵の場合はオブジェクト
   の名前とアドレスを含みます) を返します。クラスは、 "__repr__()" メ
   ソッドを定義することで、この関数によりそのクラスのインスタンスが返
   すものを制御することができます。"sys.displayhook()" にアクセスでき
   ない場合、この関数は "RuntimeError" を送出します。

reversed(seq)

   要素を逆順に取り出すイテレータ (reverse *iterator*) を返します。
   *seq* は "__reversed__()" メソッドを持つか、シーケンス型プロトコル
   ("__len__()" メソッド、および、 "0" 以上の整数を引数とする
   "__getitem__()" メソッド) をサポートするオブジェクトでなければなり
   ません。

round(number[, ndigits])

   *number* を小数点以下 *ndigits* 桁の精度で丸めた値を返します。
   *ndigits* が省略されたり、"None" だった場合、入力値に最も近い整数を
   返します。

   "round()" をサポートする組み込み型では、値は 10 のマイナス
   *ndigits* 乗の倍数の中で最も近いものに丸められます; 二つの倍数が同
   じだけ近いなら、偶数を選ぶ方に (そのため、例えば "round(0.5)" と
   "round(-0.5)" は両方とも "0" に、 "round(1.5)" は "2" に) 丸められ
   ます。 *ndigits* には任意の整数値が有効となります (正の整数、ゼロ、
   負の整数)。 返り値は *ndigits* が指定されていないか "None" の場合は
   整数、そうでなければ返り値は *number* と同じ型です。

   一般的な Python オブジェクト "number" に対して、"round" は処理を
   *number.__round__* に移譲します。

   注釈:

     浮動小数点数に対する "round()" の振る舞いは意外なものかもしれませ
     ん: 例えば、 "round(2.675, 2)" は予想通りの "2.68" ではなく
     "2.67" を与えます。これはバグではありません: これはほとんどの小数
     が浮動小数点数で正確に表せないことの結果です。詳しくは 浮動小数点
     演算、その問題と制限 を参照してください。

class set([iterable])

   オプションで *iterable* の要素を持つ、新しい "set" オブジェクトを返
   します。 "set" は組み込みクラスです。このクラスについて詳しい情報は
   "set" や set（集合）型 --- set, frozenset を参照してください。

   他のコンテナについては "collections" モジュールや組み込みの
   "frozenset" 、 "list" 、 "tuple" 、 "dict" クラスを参照してください
   。

setattr(object, name, value)

   "getattr()" の相方です。引数はオブジェクト、文字列、それから任意の
   値です。文字列は既存の属性または新たな属性の名前にできます。この関
   数は指定したオブジェクトが許せば、値を属性に関連付けます。例えば、
   "setattr(x, 'foobar', 123)" は "x.foobar = 123" と等価です。

   "__getattribute__()" のカスタマイズや "__slots__" を通じてオブジェ
   クトが強制していない限り、 *name* は 識別子 (identifier) およびキー
   ワード (keyword) で定義されている Python 識別子である必要はありませ
   ん。属性名が識別子でない場合、ドットを使った属性へのアクセスはでき
   ませんが、 "getattr()" などを通じてアクセス可能です。

   注釈:

     プライベートな名前のマングリング はコンパイル時に行われます。その
     ため、プライベートな属性 (先頭に2つのアンダースコアを伴う名前を持
     つ属性) の値を "setattr()" でセットするためには、属性名を手動でマ
     ングリングする必要があります。

class slice(stop)
class slice(start, stop[, step])

   "range(start, stop, step)" で指定されるインデクスの集合を表す、 *ス
   ライス* オブジェクトを返します。引数 *start* および *step* はデフォ
   ルトでは "None" です。スライスオブジェクトは読み出し専用の属性
   "start"、"stop" および "step" を持ち、これらは単に引数で使われた 値
   (またはデフォルト値) を返します。これらの値には、その他のはっきりと
   した機能はありません。しかしながら、これらの値は NumPy および、その
   他のサードパーティ製パッケージで利用されています。スライスオブジェ
   クトは拡張されたインデクス指定構文が使われる際にも生成されます。例
   えば "a[start:stop:step]" や "a[start:stop, i]" です。この関数の代
   替となるイテレータを返す関数、"itertools.islice()" も参照してくださ
   い。

sorted(iterable, /, *, key=None, reverse=False)

   *iterable* の要素を並べ替えた新たなリストを返します。

   2 つのオプション引数があり、これらはキーワード引数として指定されな
   ければなりません。

   *key* には 1 引数関数を指定します。これは *iterable* の各要素から比
   較キーを展開するのに使われます (例えば、 "key=str.lower" のように指
   定します)。 デフォルト値は "None" です (要素を直接比較します)。

   *reverse* は真偽値です。 "True" がセットされた場合、リストの要素は
   個々の比較が反転したものとして並び替えられます。

   旧式の *cmp* 関数を *key* 関数に変換するには
   "functools.cmp_to_key()" を使用してください。

   組み込みの "sorted()" 関数は安定なことが保証されています。同等な要
   素の相対順序を変更しないことが保証されていれば、ソートは安定です。
   これは複数のパスでソートを行なうのに役立ちます（例えば部署でソート
   してから給与の等級でソートする場合）。

   ソートアルゴリズムは、要素間の比較に "<" 演算子だけを使います。した
   がってソートのためには "__lt__()" メソッドを定義すれば十分なはずで
   すが、 **PEP 8** は6つの 比較演算子 を全て実装することを推奨してい
   ます。これにより、異なるメソッドを必要とする "max()" のような他のソ
   ートツールを、同じデータに対して適用することによって起こりうるバグ
   を避ける助けになります。6つの比較演算子を全て実装することは、リフレ
   クションによって "__gt__()" メソッドを呼び出す可能性のある型混合の
   比較での混乱を避けることにも役立ちます。

   ソートの例と簡単なチュートリアルは ソート HOW TO を参照して下さい。

@staticmethod

   メソッドを静的メソッドへ変換します。

   静的メソッドは暗黙の第一引数を受け取りません。静的メソッドを宣言す
   るには、このイディオムを使ってください:

      class C:
          @staticmethod
          def f(arg1, arg2, ...): ...

   "@staticmethod" 形式は関数 *デコレータ* です。詳しくは 関数定義 を
   参照してください。

   静的メソッドは ("C.f()" のように) クラスに対して呼び出すことも、
   ("C().f()" のように) インスタンスに対して呼び出すこともできます。さ
   らに、 ("f()" のように) 普通の関数として呼び出すこともできます。

   Python における静的メソッドは Java や C++ における静的メソッドと類
   似しています。クラスコンストラクタの代替を生成するのに役立つ変種、
   "classmethod()" も参照してください。

   あらゆるデコレータと同じく、 "staticmethod" は普通の関数のように呼
   べ、その返り値で処理が行えます。 この機能は、クラス本体から関数を参
   照する必要があり、かつ、インスタンスメソッドに自動変換されるのを避
   けたいケースで必要になります。 そのようなケースでは、このイディオム
   が使えます:

      def regular_function():
          ...

      class C:
          method = staticmethod(regular_function)

   静的メソッドについて詳しい情報は 標準型の階層 を参照してください。

   バージョン 3.10 で変更: 静的メソッドはメソッド属性 ("__module__",
   "__name__", "__qualname__", "__doc__" そして "__annotations__") を
   継承するようになり、また新たに "__wrapped__" 属性を持つようになりま
   した。さらに、静的メソッドを通常の関数として呼び出すことができるよ
   うになりました。

class str(object='')
class str(object=b'', encoding='utf-8', errors='strict')

   *object* の "str" 版を返します。詳細は "str()" を参照してください。

   "str" は組み込みの文字列 *クラス* です。文字列に関する一般的な情報
   は、テキストシーケンス型 --- str を参照してください。

sum(iterable, /, start=0)

   *start* と *iterable* の要素を左から右へ合計し、総和を返します。
   *iterable* の要素は通常は数値で、start の値は文字列であってはなりま
   せん。

   使う場面によっては、 "sum()" よりもいい選択肢があります。文字列から
   なるシーケンスを結合する高速かつ望ましい方法は "''.join(sequence)"
   を呼ぶことです。浮動小数点数値を拡張された精度で加算するには、
   "math.fsum()" を参照してください。一連のイテラブルを連結するには、
   "itertools.chain()" の使用を考えてください。

   バージョン 3.8 で変更: *start* パラメータをキーワード引数として指定
   することができるようになりました。

class super([type[, object-or-type]])

   メソッドの呼び出しを *type* の親または兄弟クラスに委譲するプロキシ
   オブジェクトを返します。これはクラスの中でオーバーライドされた継承
   メソッドにアクセスするのに便利です。

   The *object-or-type* determines the *method resolution order* to be
   searched.  The search starts from the class right after the *type*.

   For example, if "__mro__" of *object-or-type* is "D -> B -> C -> A
   -> object" and the value of *type* is "B", then "super()" searches
   "C -> A -> object".

   *object-or-type* の "__mro__" 属性は、 "getattr()" と "super()" の
   両方で使われる、メソッド解決の探索順序を列記します。 この属性は動的
   で、継承の階層構造が更新されれば、随時変化します。

   第 2 引数が省かれたなら、返されるスーパーオブジェクトは束縛されませ
   ん。第 2 引数がオブジェクトであれば、 "isinstance(obj, type)" は真
   でなければなりません。第 2 引数が型であれば、 "issubclass(type2,
   type)" は真でなければなりません (これはクラスメソッドに役に立つでし
   ょう)。

   *super* の典型的な用途は 2 つあります。第一に、単継承のクラス階層構
   造で *super* は名前を明示することなく親クラスを参照するのに使え、そ
   れゆえコードをメンテナンスしやすくなります。この用途は他のプログラ
   ミング言語で見られる *super* の用途によく似ています。

   2つ目の用途は動的な実行環境において協調的 (cooperative) な多重継承
   をサポートすることです。これは Python に特有の用途で、静的にコンパ
   イルされる言語や、単継承のみをサポートする言語には見られないもので
   す。この機能により、同じ名前のメソッドを実装する複数の基底クラスを
   使った "ダイヤモンド型* の継承構造を実装することができます。良い設
   計は、そのような実装において、どのような場合でも同じ呼び出しシグネ
   チャを持つように強制します。 (理由は呼び出しの順序が実行時に決定さ
   れること、呼び出し順序はクラス階層構造の変化に順応すること、そして
   呼び出し順序が実行時まで未知の兄弟クラスが含まれる場合があることで
   す)。

   両方の用途において、典型的なスーパークラスの呼び出しは次のようにな
   ります:

      class C(B):
          def method(self, arg):
              super().method(arg)    # This does the same thing as:
                                     # super(C, self).method(arg)

   メソッドのルックアップに加えて、 "super()" は属性のルックアップに対
   しても同様に動作します。考えうる用途のひとつは親クラスや兄弟クラス
   の *descriptors* (デスクリプタ) を呼び出すことです。

   なお、"super()" は "super().__getitem__(name)" のような明示的なドッ
   ト表記属性探索の束縛処理の一部として実装されています。これは、
   "__getattribute__()" メソッドを予測可能な順序でクラスを検索するよう
   に実装し、協調的な多重継承をサポートすることで実現されています。従
   って、 "super()" は文や "super()[name]" のような演算子を使った暗黙
   の探索向けには定義されていません。

   また、 "super()" の使用は引数無しの形式を除きメソッド内部に限定され
   ないことにも注目して下さい。2引数の形式は、必要な要素を正確に指定す
   るので、適当な参照を作ることができます。クラス定義中における引数無
   しの形式は、定義されているクラスを取り出すのに必要な詳細を、通常の
   方法で現在のインスタンスにアクセスするようにコンパイラが埋めるので
   はたらきます。

   "super()" を用いて協調的なクラスを設計する方法の実践的な提案は、
   guide to using super() を参照してください。

class tuple([iterable])

   "tuple" は、実際は関数ではなくイミュータブルなシーケンス型で、タプ
   ル型 (tuple) と シーケンス型 --- list, tuple, range にドキュメント
   化されています。

class type(object)
class type(name, bases, dict, **kwds)

   引数が1つだけの場合、*object* の型を返します。返り値は型オブジェク
   トで、一般に "object.__class__" によって返されるのと同じオブジェク
   トです。

   オブジェクトの型の判定には、 "isinstance()" 組み込み関数を使うこと
   が推奨されます。これはサブクラスを考慮するからです。

   引数が3つの場合、新しい型オブジェクトを返します。これは本質的には
   "class" 文の動的な書式です。 *name* 文字列はクラス名で、 "__name__"
   属性になります。 *bases* 基底クラスのタプルで、 "__bases__" 属性に
   なります; 空の場合は全てのクラスの基底クラスである "object" が追加
   されます。 *dict* は、クラス本体の属性とメソッドの定義を含む辞書で
   す; 辞書は "__dict__" 属性になる前にコピーされたり、ラップされるこ
   とがあります。以下の2つの文は同じ "type" オブジェクトを生成します:

   >>> class X:
   ...     a = 1
   ...
   >>> X = type('X', (), dict(a=1))

   型オブジェクト も参照してください。

   三引数形式の呼び出しに与えられたキーワード引数は、(*metaclass* を除
   く) クラス定義におけるキーワード引数と同様に、適切なメタクラスの機
   構 (通常は "__init_subclass__()") に渡されます。

   クラス生成をカスタマイズする も参照してください。

   バージョン 3.6 で変更: "type.__new__" をオーバーライドしていない
   "type" のサブクラスは、オブジェクトの型を得るのに１引数形式を利用す
   ることができません。

vars([object])

   モジュール、クラス、インスタンス、あるいはそれ以外の "__dict__" 属
   性を持つオブジェクトの、 "__dict__" 属性を返します。

   モジュールやインスタンスのようなオブジェクトは、更新可能な
   "__dict__" 属性を持っています。ただし、それ以外のオブジェクトでは
   "__dict__" 属性への書き込みが制限されている場合があります。書き込み
   に制限がある例としては、辞書を直接更新されることを防ぐために
   "types.MappingProxyType" を使っているクラスがあります。

   引数がなければ、"vars()" は "locals()" のように振る舞います。ただし
   、辞書 locals への更新は無視されるため、辞書 locals は読み出し時の
   み有用であることに注意してください。

   指定されたオブジェクトに "__dict__" 属性がない場合 (たとえばそのク
   ラスが "__slots__" 属性を定義している場合)、 "TypeError" 例外が送出
   されます。

zip(*iterables, strict=False)

   複数のイテラブルを並行に反復処理し、各イテラブルの要素からなるタプ
   ルを生成します。

   以下はプログラム例です:

      >>> for item in zip([1, 2, 3], ['sugar', 'spice', 'everything nice']):
      ...     print(item)
      ...
      (1, 'sugar')
      (2, 'spice')
      (3, 'everything nice')

   より正式な定義: "zip()" は、 *i* 番目のタプルが 引数に与えた各イテ
   ラブルの *i* 番目の要素を含むような、タプルのイテレータを返します。

   "zip()" に対する別の考え方は、この関数は行を列に、また列を行に変換
   するということです。これは 行列の転置 とよく似ています。

   "zip()" は遅延評価です: イテラブルが "for" ループに渡されたり、
   "list" でラップされたりするなどして反復処理されるまで、要素が実際に
   処理されることはありません。

   ここで考慮すべきことは、 "zip()" に渡されるイテラブルが異なる長さを
   持つことがあるという点です; ときには意図的な場合もあり、またときに
   はイテラブルを準備するコードにおけるバグのこともあるでしょう。
   Python はこの問題に対して3つの異なるアプローチを提供します:

   * デフォルトでは、 "zip()" は最も短いイテラブルが消費しきった時点で
     停止します。より繰り返し数の長いイテラブルの残りの要素は無視して
     、結果を最も短いイテラブルの長さに切り詰めます:

        >>> list(zip(range(3), ['fee', 'fi', 'fo', 'fum']))
        [(0, 'fee'), (1, 'fi'), (2, 'fo')]

   * "zip()" は、しばしば受け取ったイテラブルが全て同じ長さであるとい
     う想定の下で使われます。そのような場合、 "strict=True" オプション
     の利用が推奨されます。その出力は通常の "zip()" と同じです:

        >>> list(zip(('a', 'b', 'c'), (1, 2, 3), strict=True))
        [('a', 1), ('b', 2), ('c', 3)]

     しかし、デフォルトの動作と異なり、あるイテラブルが他のイテラブル
     よりも先に消費しきった場合に "ValueError" 例外を送出します:

     >>> for item in zip(range(3), ['fee', 'fi', 'fo', 'fum'], strict=True):  
     ...     print(item)
     ...
     (0, 'fee')
     (1, 'fi')
     (2, 'fo')
     Traceback (most recent call last):
       ...
     ValueError: zip() argument 2 is longer than argument 1

     "strict=True" 引数なしの場合、長さの異なるイテラブルを生じる原因
     となるいかなるバグも、この時点では問題なく処理されます。そして代
     わりにプログラムの別の場所で、原因を特定しにくいバグとして検出さ
     れることになるでしょう。

   * 短いイテラブルを一定の値でパディングして全てのイテラブルが同じ長
     さになるようにすることもできます。この機能は
     "itertools.zip_longest()" で提供されます。

   エッジケース: 引数としてイテラブルをひとつだけ渡した場合、 "zip()"
   は 1 タプルのイテレータを返します。引数なしの場合は空のイテレータを
   返します。

   ヒントとコツ:

   * イテラブルの左から右への評価順序は保証されています。そのため
     "zip(*[iter(s)]*n, strict=True)" を使ってデータ系列を長さ n のグ
     ループにクラスタリングするイディオムが使えます。これは、各出力タ
     プルがイテレータを "n" 回呼び出した結果となるよう、 *同じ* イテレ
     ータを "n" 回繰り返します。これは入力を長さ n のチャンクに分割す
     る効果があります。

   * "zip()" に続けて "*" 演算子を使うと、zip したリストを元に戻せます
     :

        >>> x = [1, 2, 3]
        >>> y = [4, 5, 6]
        >>> list(zip(x, y))
        [(1, 4), (2, 5), (3, 6)]
        >>> x2, y2 = zip(*zip(x, y))
        >>> x == list(x2) and y == list(y2)
        True

   バージョン 3.10 で変更: "strict" 引数が追加されました。

__import__(name, globals=None, locals=None, fromlist=(), level=0)

   注釈:

     これは "importlib.import_module()" とは違い、日常の Python プログ
     ラミングでは必要ない高等な関数です。

   この関数は "import" 文により呼び出されます。 ("builtins" モジュール
   をインポートして "builtins.__import__" に代入することで) この関数を
   置き換えて "import" 文のセマンティクスを変更することができますが、
   同様のことをするのに通常はインポートフック (**PEP 302** 参照) を利
   用する方が簡単で、かつデフォルトのインポート実装が使用されているこ
   とを仮定するコードとの間で問題が起きないので、このやり方は *強く*
   推奨されません。 "__import__()" を直接使用することも推奨されず、
   "importlib.import_module()" の方が好まれます。

   この関数は、モジュール *name* をインポートし、 *globals* と
   *locals* が与えられれば、パッケージのコンテキストで名前をどう解釈す
   るか決定するのに使います。 *fromlist* は *name* で与えられるモジュ
   ールからインポートされるべきオブジェクトまたはサブモジュールの名前
   を与ます。標準の実装では *locals* 引数はまったく使われず、
   *globals* は "import" 文のパッケージコンテキストを決定するためにの
   み使われます。

   *level* は絶対と相対どちらのインポートを使うかを指定します。 "0" (
   デフォルト) は絶対インポートのみ実行します。正の *level* の値は、
   "__import__()" を呼び出したディレクトリから検索対象となる親ディレク
   トリの数を示します (詳細は **PEP 328** を参照してください)。

   *name* 変数が "package.module" 形式であるとき、通常は、*name* で指
   名されたモジュール *ではなく*、最上位のパッケージ (最初のドットまで
   の名前) が返されます。しかしながら、空でない *fromlist* 引数が与え
   られると、 *name* で指名されたモジュールが返されます。

   例えば、文 "import spam" は、以下のコードのようなバイトコードに帰結
   します:

      spam = __import__('spam', globals(), locals(), [], 0)

   文 "import spam.ham" は、この呼び出しになります:

      spam = __import__('spam.ham', globals(), locals(), [], 0)

   ここで "__import__()" がどのように最上位モジュールを返しているかに
   注意して下さい。 "import" 文により名前が束縛されたオブジェクトにな
   っています。

   一方で、文 "from spam.ham import eggs, sausage as saus" は、以下と
   なります

      _temp = __import__('spam.ham', globals(), locals(), ['eggs', 'sausage'], 0)
      eggs = _temp.eggs
      saus = _temp.sausage

   ここで、"__import__()" から "spam.ham" モジュールが返されます。この
   オブジェクトから、インポートされる名前が取り出され、それぞれの名前
   として代入されます。

   単純に名前からモジュール (パッケージの範囲内であるかも知れません)
   をインポートしたいなら、 "importlib.import_module()" を使ってくださ
   い。

   バージョン 3.3 で変更: 負の *level* の値はサポートされなくなりまし
   た (デフォルト値の 0 に変更されます)。

   バージョン 3.9 で変更: コマンドラインオプション "-E" or "-I" が指定
   された場合、環境変数 "PYTHONCASEOK" は無視されるようになりました。

-[ 脚注 ]-

[1] なお、パーサは Unix スタイルの行末の記法しか受け付けません。コード
    をファイルから読んでいるなら、必ず、改行変換モードで Windows や
    Mac スタイルの改行を変換してください。
