Python 2.4 クイックリファレンス

目次

• この文書について
• 起動オプション
• 環境変数
• 字句エレメント : キーワード, 識別子, 文字リテラル, ブール定数, 数値, シーケンス, 辞書, 演算子
• 基本的な型とその演算: None, ブール型, 数値型, シーケンス型, リスト, 辞書, 文字列, ファイル, set, 日付と時刻
• その他の型
• 文: 代入, 制御文, 例外, 名前空間, 関数定義, クラス定義
• イテレータ; ジェネレータ; ディスクリプタ; デコレータ
• 組み込み関数
• 組み込み例外
• ユーザ定義クラスでの 標準メソッドと演算子の再定義
• 型の情報状態を示す 特殊属性
• 主要な モジュール : sys, os, posix, posixpath, shutil, time, string, re, math, getopt
• ディストリビューションに含まれる モジュール一覧
• Workspace exploration and idiom hints
• Python mode for Emacs

この文書について

バージョン 2.4
新しいバージョンができた際は こちら に掲載されます。
間違いや不明確な点、その他意見がありましたら、ぜひ 連絡 してください。 Richard Gruet (pqr at rgruet.net).
〔翻訳上のご意見は翻訳者までお願いします。〕

Last modified on May 19, 2006

17 Feb 2005,

upgraded by Richard Gruet for Python 2.4

03 Oct 2003,

upgraded by Richard Gruet for Python 2.3

11 May 2003, rev 4

upgraded by Richard Gruet for Python 2.2 (restyled by Andrei)

7 Aug 2001

upgraded by Simon Brunning for Python 2.1

16 May 2001

upgraded by Richard Gruet and Simon Brunning for Python 2.0

18 Jun 2000

upgraded by Richard Gruet for Python 1.5.2

30 Oct 1995

created by Chris Hoffmann for Python 1.3

2.3 から 2.4 にかけて追加された機能
2.2 から 2.3 にかけて追加された機能
2.1 から 2.2 にかけて追加された機能

• Python Bestiary, Ken Manheimer 著
• Python manuals, Guido van Rossum, Fred Drake 著
• python-mode.el, Tim Peters 著
• comp.lang.python

日本語訳（現在鋭意翻訳中）：

$Date: 2006-08-19 00:31:00 +0900 (土, 19 8 2006) $

セトヤマ ハルキ <haruki at planewave dot org>

サイトウ テツヤ <t2psyto at gmail dot com>

• Python の巣: http://www.python.org
• 〔日本Pythonユーザ会： http://www.python.jp 〕
• 公式ドキュメント: http://www.python.org/doc/   [Module index; Language Reference]
• 〔Pythonドキュメント翻訳プロジェクトによる日本語版： http://www.python.jp/doc/ 〕
• 他のドキュメントや書籍: FAQs, Faqts, Dive into Python, Python Cookbook, Thinking in Python, Text processing in Python
• 入門: Official site, 7mn to Hello World (windows)
• Topics: Databases, Web programming, XML, Web Services, Parsers, Scientific Computing, GUI programming, Distributing
• パッケージを探すには: Easy Install, Python Package Index (PyPI), Vaults of Parnassus, SourceForge (search "python"), Python Eggs, O'Reilly Python DevCenter, Starship Python
• Wiki: moinmoin
• ニュースグループ: comp.lang.python と comp.lang.python.announce
• その他: Daily Python URL, Kevin Altis' WebLog, PEAK
• Python の開発元: http://python.sourceforge.net/
• Jython (Java による Python の実装): http://www.jython.org/
• ActivePython: http://www.ActiveState.com/ASPN/Python/
• ヘルプデスク: help@python.org
• 最高の Python リファレンスブック: Python テクニカルリファレンス デビッド・ビーズリー 著、そして Pythonクィックリファレンス アレックス マーテリ 著 (オライリージャパン)
• Python 2.4 Reference Card (cheatsheet) Laurent Pointal 著、 プリントアウト用にデザインされている（15 ページ）
• Online Python 2.2 Quick Reference 、New Mexico Tech Computer Center による

Tip: Python インタプリタに help, help(object) または help("name") と入力するとヘルプが表示される

起動オプション

python[w] [-dEhimOQStuUvVWxX?] [-c command | scriptFile | - ] [args]
    (pythonw は、ターミナル/コンソールを開かない。 python だと開く)

• 標準ディストリビューションに含まれる IDE: IDLE (tkinter based, portable), Pythonwin (Windows)。 他のフリーの IDE: IPython (enhanced interactive Python shell), ERIC, SPE, BOA constructor.
• python の標準的な モジュールヘッダ :

  #!/usr/bin/env python
# -*- coding: latin1 -*-

  2.3 以降、Python のソースファイルの 文字エンコーディング を はじめの 2 行の内に宣言する必要がある（デフォルトは 7 ビット ASCII） [PEP-0263]。 フォーマットは次のとおり。
  

  # -*- coding: encoding -*-

  標準エンコーディング は ここ で定義されており、 ISO-8859-1 (aka latin1), iso-8859-15 (latin9), UTF-8 等がある。 すべてのエンコーディングがサポートされている訳ではない。 たとえば、UTF-16 等は未サポートである。
  
• 環境設定: sitecustomize.py ファイルが、パス中 (通常 ${PYTHONHOME}/lib/site-packages/ 中) にあれば、自動的に読み込まれる。
• Tip: Windows での Python スクリプトの起動
  

  <pythonHome>\python myScript.py args ... を
  <pythonHome> が PATH 環境変数にあれば、myScript.py args ... とできる。
  .py;.pyw;.pyc;.pyo が PATHEXT 環境変数に加えてあれば、myScript args ... ともできる。

環境変数

主要な字句エレメント

キーワード

        and       del       for       is        raise
        assert    elif      from      lambda    return
        break     else      global    not       try
        class     except    if        or        while
        continue  exec      import    pass      yield
        def       finally   in        print

• (キーワードの一覧を得るには標準モジュール keyword を使う)
• トークンとして使えない文字 (文字列中でのみ使用可): $ ? (2.4 より前では @ も)
• 文は一行で書く。複数行に分ける時は、C プリプロセッサと同様に、"\" を使う。
  ただし、(), [], {} または3重引用符で括ると、複数行に渡って書ける。
• セミコロン (";") で区切ると複数の文を一行に書ける。
• コメントは、"#" で始まり、行の最後まで。

識別子

(letter | "_") (letter | digit | "_")*

• Python の識別子 (identifier) であるキーワードや属性などは、大小文字が 区別 される。
• 特殊形式: _ident ('from module import *' によりインポートされない)。 __ident__ (システム定義名)。 __ident (クラスプライベートな名前)。

文字リテラル

• 文字列が次の行まで続くときは、\ を行末に使う。
• 連続する文字列は連結される。例、'Monty ' 'Python' は 'Monty Python' と同じ。
• u'hello' + ' world'  --> u'hello world'   (unicode に強制変換される)

• NUL バイト (\000) は、文字列終端のマーカでは ない。文字列中に NUL を含められる。
• 文字列 (と タプル) は 変更不能 (immutable) である。

ブール定数 (2.2.1 以降)

• True
• False

2.2.1 では、True と False は、それぞれ整数の 1 と 0 である。 2.3 以降は、bool という新しい型である。

数値

• 10進数: 1234, 1234567890546378940L (or l)
• 8進数 integer: 0177, 0177777777777777777L (begin with a 0)
• 16進数 integer: 0xFF, 0XFFFFffffFFFFFFFFFFL (begin with 0x or 0X)
• 長 整数 (精度制限なし): 1234567890123456L (L または l で終える) または long(1234)
• 浮動小数点数 (倍精度): 3.14e-10, .001, 10., 1E3
• 複素数: 1J, 2+3J, 4+5j (J または j で終える。+ で、(浮動小数点数の) 実部と虚部を区切る)

整数と長整数は、2.2 以降、区別 されない (L 接尾辞は不要)。

シーケンス

• 文字列 (str と unicode 型)。長さが 0, 1, 2 の例、(上記 参照)
    '', '1', "12", 'hello\n'
• タプル (tuple 型) 。長さが 0, 1, 2 の例、
    () (1,) (1,2) # 長さが 0より大きい時は、カッコはオプション
• リスト (list 型) 。長さが 0, 1, 2 の例、
    [] [1] [1,2]

• インデックスは 0 から始まる。負値を指定すると（通常）シーケンスの最後からカウントされる。
• シーケンスのスライス [開始インデックス : 終了インデックス [ : ステップ]] 。 デフォルトは、開始が 0、終了が len(指定したシーケンス)、ステップは 1。

    a = (0,1,2,3,4,5,6,7)
    a[3] == 3
    a[-1] == 7
    a[2:4] == (2, 3)
    a[1:] == (1, 2, 3, 4, 5, 6, 7)
    a[:3] == (0, 1, 2)
    a[:] == (0,1,2,3,4,5,6,7) # シーケンスの コピー を生成する
    a[::2] == (0, 2, 4, 6) # 偶数のみ 
    a[::-1] = (7, 6, 5, 4, 3 , 2, 1, 0) # 逆順
  

辞書 (マップ)

長さが 0, 1, 2 の 辞書 (dict 型) の例、 {} {1 : 'first'} {1 : 'first', 'two': 2, key:value}

演算子とその優先順位

• 代替名が operator モジュールに定義されている (例、+ に対し __add__ と add)
• ほとんどの演算子は オーバーライド可能

基本的な型とその演算子

比較 (すべての 型に対して)

• 比較の動作は、クラスに特殊メソッド __cmp__ を 定義してオーバーライドできる。
• (1) C 言語と異なり、X < Y < Z < W という書き方ができる。
• (2) オブジェクトのアイデンティティ (すなわち id(object))を比較する。オブジェクトの値を比べるのではない。

None

• None は、関数の返り値のデフォルト値である。 組み込みオブジェクト NoneType 型。将来、キーワードとなるかもしれない。
• None と評価されるような入力は、Python を対話的に動作させている時には表示されない。
• None は、現在のところ 定数 である。 "None" という名の値を作成しようとすると文法エラーとなる。

ブール型 (bool)

• ブール演算の動作は、特殊メソッド __nonzero__ を定義してオーバーライドできる。
• (1) 第 2 引数は、結果を求めるのに必要な時だけ評価される

数値型

浮動小数点数、整数、長整数、10進数

• 浮動小数点数 (float 型) は C 言語の double として解釈される。
• 整数 (int 型) は C 言語の long (符号付 32 ビット、 最大値は sys.maxint) として解釈される。
• 長整数 (long 型) は、サイズ制限はない (ただし、システムリソースには制限される)。
• 2.2 より、整数と長整数とは 区別されない (L 接尾辞は不要)。 int() は、 long 整数を返す。 OverflowError を送出することはない。. オーバーフローしそうな演算、たとえば 2<<32 などでも、 FutureWarning は送出されず、長整数が返される。
• 2.4以降、 Decimal という新しい型が導入され (モジュール decimal 参照)、 分数計算などで起きる浮動小数点演算上の制限を回避できる。 浮動小数点数と異なり、10 進数は正確な表現ができ、計算時の正確性が保たれる。 精度は、Context 型を使ってユーザ設定できる [PEP 327]。

数値型に対する演算子

• (1) ただし、from __future__ import division として有効化しないと、/ も切り捨て除算を行う。
• これらの演算子を再定義するには、クラスの __truediv__ と __floordiv__ メソッドをオーバーライドする。

整数・長整数に対するビット演算子

複素数

• complex 型により、マシンレベルの倍精度浮動小数点数の組として表現される。
• 複素数 z の実部と虚部はそれぞれ z.real , z.imag で得られる。

数値に関する例外

TypeError

非数値に対して数値演算を行った

OverflowError

数値の限界を超えた

ZeroDivisionError

割算・剰余演算で 0 で割った

シーケンス (リスト・タプル・文字列) の演算

• (1) i や j が負のとき、インデックスは文字列の最後から勘定される。 つまり len(s)+i や len(s)+j の値が使われる。ただし、-0 は 0 のまま。
• (2) s の i から j までのスライスとは、インデックス k が i<= k < j である要素のシーケンスと定義される。
  i や j が len(s) より大きいときは、len(s) が使われる。 j を省略すると len(s) が使われる。i が j 以上だと、スライスの結果は空となる。
• (3) 2.3 以前では、文字列に対しては、x が 1 つの文字でなければならない。 2.3 以降は、x in s は、x が s の 部分文字列 であるとき真になる。

変更可能なシーケンス (list 型) の演算

• (1) x が s 中に見つからなければ、ValueError 例外が送出される。
• (2) sort() メソッドは、オプションの引数 cmp に比較関数を指定できる。この関数は 引数を 2 つ取り、 第 1 引数が第 2 引数に比べ、小さいとき -1、等しいとき 0、大きいとき 1 を返す。 比較関数を指定すると、ソートがとても遅くなるので注意すること。 2.4 以降、cmp はキーワード引数として指定できる。 さらに、2 つのキーワードが追加された。 key は、リストの要素を受けて、比較に使うキーを返す関数である (cmp より 速い )。 reverse は、True を指定すると比較の意味を逆転させる。
  Python 2.3 (?) 以降、 ソートの 「安定」 が保障されている。つまり、2 つの要素の比較キーが同じならば、 入力時と同じ順で返される。たとえば、まず人のリストを名前でソートしてから年齢でソートしたとする。 その結果は、同じ年齢の人については名前でソートされた状態となる。
• (3) sort() と reverse() メソッドは、リストを インプレース で 変更 し、 ソートされたリストは返されない。大きなリストを扱うときのリソース節約のためである。この副作用に注意すること。
• (4) pop() メソッドは、リスト以外の変更可能なシーケンスには適用できない。 i 引数のデフォルト値は -1で、最後の要素が削除され、返される。
• (5) x がリストオブジェクトでなければ TypeError が送出される。

辞書／マップ (dict 型) の演算

• キーにアクセス不能のときは TypeError が送出される。
• (1) キー k がマップに無い場合は KeyError が送出される。
• (2) キーと値は、ランダムな順で並ぶ。
• (3) キー k がマップに無くとも例外は送出されず、defaultval が返される。 defaultval はオプションで、これが指定されずかつ k がマップに無いときは None が返される。
• (4) キー k がマップに無くとも例外は送出されず、defaultval が返され、 キー k が値を defaultVal として追加される。defaultval はオプションで、 これが指定されずかつ k がマップに無いときは None が返され、マップに追加される。

文字列 (str 型・unicode 型) の演算

• (1) パディングは、スペースまたは指定した文字を使って行われる。
• (2) オプション引数 start を指定すると、s[start:] が処理される。オプション引数 start と end の双方を指定すると、 s[start:end] が処理される。
• (3) デフォルトのエンコーディングは、 sys.getdefaultencoding()で、 sys.setdefaultencoding() により変更できる。オプション引数 errors を指定して、 別のエラー処理スキームを設定できる。errors 引数のデフォルトは 'strict'で、 エンコーディング関連エラーはにより ValueError が送出される。他に、'ignore' または 'replace' を指定できる。モジュール codecs を見よ。
• (4) オプション引数 tabsize を指定しないと、タブ幅は 8 文字が設定される。
• (5) s が文字を1つ以上含んでいないと、False が返される。
• (6) s が対象とする文字を1つ以上含んでいないと、False が返される。
• (7) タイトルケースな文字列とは、大文字は非英字の後だけにあり、小文字は英字の後だけにあるという文字列のこと。
• (8) width が len(s) より小さいと s が返される。
• (9) オプション引数 maxCount を指定すると、先頭から maxCount 個だけが置換される。
• (10) separator を指定しない None を指定すると、すべての空白文字がセパレータとなる。 maxsplit を指定すると、分解が最大 maxsplit 回まで行われる。
• (11) keepends に真と評価されうる値を指定しない限り、返される結果には改行文字は含まれない。
• (12) table は、長さ 256 の文字列とする。オプション引数 deletechars に指定した文字は、変換に先立って削除される。

% 演算子による文字列のフォーマット

formatString % args --> 文字列を返す

• formatString〔フォーマット文字列〕は、通常のテキストに C 言語の printf の 型指定子 を埋め込んだもの。

  %[flag][width][.precision] formatCode

  ここで formatCode は c, s, i, d, u, o, x, X, e, E, f, g, G, r, % のどれか (下記参照)。
• flag 文字は -, +, blank, # と 0 (下記参照
• width や precision を * とすると、幅値や精度値は args から 設定される。例を示す。
  

  例

  フォーマット文字列	結果
  '%3d' % 2	' 2'
  '%*d' % (3, 2)	' 2'
  '%-3d' % 2	'2 '
  '%03d' % 2	'002'
  '% d' % 2	' 2'
  '%+d' % 2	'+2'
  '%+3d' % -2	' -2'
  '%- 5d' % 2	' 2 '
  '%.4f' % 2	'2.0000'
  '%.*f' % (4, 2)	'2.0000'
  '%0*.*f' % (10, 4, 2)	'00002.0000'
  '%10.4f' % 2	' 2.0000'
  '%010.4f' % 2	'00002.0000'

• %s は、すべての型の引数を文字列に変換する (str() 関数が使われる) 。
• args には、タプルも指定できる。

  '%s has %03d quote types.' % ('Python', 2)  == 'Python has 002 quote types.'

• % の右側には マップ を指定できる。

  a = '%(lang)s has %(c)03d quote types.' % {'c':2, 'lang':'Python'}

  (右側に vars() 関数を使うのも便利である)

テンプレート文字列

ファイルオブジェクト

ファイルオブジェクトの演算

ファイル関連の例外

EOFError

読み込み中に End-of-file にヒットした (多数回送出されうる。たとえば f が tty のとき)

IOError

他の I/O 操作に失敗した

set（集合）型

日付と時刻

• time: 時刻の取得と変換
• datetime: date, time, datetime, timedelta および tzinfo クラス

その他の型

• Module オブジェクト
• Class オブジェクト
• Class instance オブジェクト
• Type オブジェクト (see module: types)
• File オブジェクト (上記参照)
• Slice オブジェクト
• Ellipsis オブジェクト, used by extended slice notation (unique, named Ellipsis)
• Null オブジェクト (unique, named None)
• XRange オブジェクト
• コール可能な 型
  • ユーザ定義 (Python で記述)
    • User-defined Function オブジェクト
    • User-defined Method オブジェクト
  • 組み込み (C で記述)
    • 組み込み Function オブジェクト
    • 組み込み Method オブジェクト
• 内部 型
  • Code オブジェクト (byte-compile executable Python code: bytecode)
  • Frame オブジェクト (execution frames)
  • Traceback オブジェクト (stack trace of an exception)

文

代入演算

• (1) タプルやリスト・文字列を分解できる。
  

  first, second = l[0:2]    # first=l[0]; second=l[1] と同じ
[f, s] = range(2)    # f=0; s=1 と同じ
c1,c2,c3 = 'abc'    # c1='a'; c2='b'; c3='c' と同じ
(a, b), c, (d, e, f) = ['ab', 'c', 'def']    # a='a'; b='b'; c='c'; d='d'; e='e'; f='f' と同じ


  Tip: x,y = y,x は、 x と y を入れ替える
• (2) 複数の代入ができる。
  

  a = b = c = 0
list1 = list2 = [1, 2, 3]    # list1 と list2 は 同じ リストになる


• (3) 完全に同じではない。 a は一度だけ評価される。また、可能であれば、 演算はインプレイスで行われる。つまり a は、置き換えられるのではなく、自ら変更することになる。

制御文

例外文

• 例外は 例外クラス の インスタンス である (2.0 以前では通常の 文字列 とできる)
• 例外は、定義済みのクラス Exception を継承しなければならない。例、

  class TextException(Exception): pass
  try:
      if bad:
          raise TextException()
  except Exception:
      print 'Oops'  # This will be printed because TextException is a subclass of Exception
  

• 処理がなされない例外についてはエラーメッセージが出力される。まず、クラス名が出力され、 コロン・スペースと続き、組み込み関数 str() で例外のインスタンスを文字列に変換したものが出力される
• すべての組み込み例外は（Exception を継承した）StandardError を継承している。
  

名前空間文

import sys; print sys.argv
import package1.subpackage.module
package1.subpackage.module.foo()

from sys import argv; print argv
from package1 import module; module.foo()
from package1.module import foo; foo()

from sys import *; print argv
from package.module import *; print x

関数定義

def funcName ([paramList]):
    suite

関数オブジェクトを生成し、名前 funcName に代入する。

paramList ::= [param [, param]*]
param ::= value | id=value | *id | **id

• 値が 〔仮〕引数に渡される。よって、変更可能な オブジェクトについてのみ、 〔実〕引数の値を〔関数内から〕変更できる（つまり、入出力変数（inout parameters）とできる）。
• return を使うと、関数から戻れる（この場合、None を返す）。 return value とすると value を返して戻る。 複数の値を返すには、return 1,2,3 のように タプル を使う。
• キーワード 引数 arg=value を使って デフォルト値 を定義できる(デフォルト値は、関数定義時に評価される) 。foo(x, y=1, s='') のように 変数リストの後ろに記述する。
• 任意引数 *args は、記述位置以降の非キーワード引数のタプルをとる。 例、def foo(x, *args): ... を foo(1, 2, 3) とコールすると args は (2,3) となる。
• 任意引数 **kwargs は、余分なキーワード引数と対応する辞書をとる。 例、def foo(x, **kwargs): ... を foo(1, y=2, z=3) とコールすると、 kwargs は {'y':2, 'z':3} となる。def foo(x, *args, **kwargs): ... を foo(1, 2, 3, y=4, z=5) をコールすると、args は (2, 3) となり kwargs は {'y':4, 'z':5} となる。
• args と kwargs は、この名前とすることが慣習であるが、他の名前とすることもできる。
• *args や **kwargs を（個別に、または同時に）「転送する」こともできる。
  def f1(x, *args, **kwargs):
  f2(*args, **kwargs)
• 無名関数 (lambdas) も見よ。

クラス定義

class className [(super_class1[, super_class2]*)]:
  suite

関数オブジェクトを生成し className という名前に代入する。
suite には、ローカルのクラスメソッドの定義と、クラス属性への代入を記述できる。

class MyClass (class1, class2): ...
class1 と class2 とを継承したクラスオブジェクトを生成する。 その新しいクラスオブジェクトを名前 MyClass に代入する。

class MyClass: ...
基底 クラスオブジェクト (何も継承しないクラス) を生成する。 その新しいクラスオブジェクトを名前 MyClass に代入する。

class MyClass (object): ...
新形式 クラス （object を継承するクラスは 新形式 クラスとなる。2.2 以降で利用できる） を生成する。その新しいクラスオブジェクトを名前 MyClass に代入する。

• クラス インスタンス メソッドの第 1 引数は、そのメソッドでの操作対象となるインスタンスオブジェクトとする。 'self' とするのが慣習である。
• インスタンスの生成時に、特殊静的メソッド __new__(cls[,...]) がコールされる。 第 1 引数はクラスで、他の引数は __init__() と同じである。詳細は こちら 。
• 特殊メソッド __init__() が、インスタンスの生成時にコールされる。
• 特殊メソッド __del__() が、オブジェクトへの参照がなくなったときにコールされる。
• インスタンスの生成は、クラスオブジェクトを 「コールする」ことで行う。引数指定もできる (つまり instance=apply(aClassObject, args...) とするとインスタンスが生成される) 。
• 2.2 以前では、リストや辞書などの組み込みのクラスのサブクラスを直接作ることはできない （UserDict や UserList モジュールを使って「ラップする」ことが必要）。2.2 以降は 直接サブクラスを作れる (Types/Classes unification を見よ)。

class c (c_parent):
    def __init__(self, name): 
        self.name = name
    def print_name(self): 
        print "I'm", self.name
    def call_parent(self): 
        c_parent.print_name(self)
        
instance = c('tom')
print instance.name
'tom'
instance.print_name()
"I'm tom"

型とクラスの統一

x = int(2) # 組み込みのキャスト関数は、基本的型のコンストラクタである
y = 3  # <=> int(3) (リテラルは新しい基本的型のインスタンスである)
print type(x), type(y) # int, int
assert isinstance(x, int) # replaces isinstance(x, types.IntType)
assert issubclass(int, object) # base types derive from base class 'object'.
s = "hello" # <=> str("hello")
assert isinstance(s, str)
f = 2.3  # <=> float(2.3)
class MyInt(int): pass    # may subclass base types
x,y = MyInt(1), MyInt("2")
print x, y, x+y # => 1,2,3
class MyList(list): pass
l = MyList("hello")
print l # ['h', 'e', 'l', 'l', 'o']

ドキュメンテーション文字列

class C:
    "A description of C"
        def __init__(self):
            "A description of the constructor"
            # etc.
            
c.__doc__ == "A description of C".
c.__init__.__doc__ == "A description of the constructor"

イテレータ

• イテレータ は、オブジェクトの 1 種で、 ある 集合 の要素を列挙するものである。メソッドは、next() という 1 つだけで、 次の要素を返す、または StopIteration を送出する。
• あるオブジェクト obj のイテレータは、組み込み関数 iter(obj) で取得できる。この関数は、obj.__class__.__iter__() をコールする。
• 各集合は、__iter__() と next() とを実装した 独自の イテレータを持っている。
• 組み込みの集合 (リスト・タプル・文字列・辞書) は、 __iter__() を実装している。辞書型（マップ型）は、そのキーを列挙する。 ファイル型は、その各行を列挙する。
• イテレータから リスト または タプル を生成できる。例、 list(anIterator)
• ループ が行われるとき、イテレータが暗黙的に使われる。
  • for elt in collection:
  • if elt in collection:
  • タプルの代入: x,y,z= collection

ジェネレータ

• ジェネレータ (generator) は、関数の1種で、複数回のコールに渡って状態を維持し コールのたびに 新たな 値を生成する。yield キーワードを使って コール毎に（1つづつ）値を返す。return または StopIteration() 送出により、値の列挙の終了を通知する。
• 典型的な使用目的は、IDや名前一覧・シリアル番号などの生成である。 Fancier applications like nanothreads are also possible.
• ジェネレータの使用方法: ジェネレータ関数 をコールして ジェネレータ・オブジェクトを取得する。ついで〔そのジェネレータオブジェクトを〕 generator.next() とコールすると次の値が得られる。StopIteration が送出されるまで繰り返しコールする。
• 2.4 で ジェネレータ表現 (generator expressions) が導入された [PEP 289]。ジェネレータ表現は リスト内包表記 (list comprehensions) に似ているが、 ジェネレータはコールのたびに要素を1つ1つ生成する点が異なる。 ジェネレータは長い順列などに適している。
    linkGenerator = (link for link in get_all_links() if not link.followed)
  for link in linkGenerator:
    ...process link...
  ジェネレータ表現は必ず 括弧() で囲まなければならない。
• 2.2では, 次の文でジェネレータを 有効にする 必要がある。 from __future__ import generators (2.3 以降では不要)

def genID(initialValue=0):
  v = initialValue
  while v < initialValue + 1000:
    yield "ID_%05d" % v
    v += 1
  return    # または: raise StopIteration()

generator = genID() # ジェネレータの生成
for i in range(10): # 10 個の値を生成
  print generator.next()

ディスクリプタ / 属性アクセス

関数・メソッドのデコレータ

その他

lambda [param_list]: returnedExpr

無名関数 (anonymous function) を生成する。
returnedExpr は 式(expression) でなければならない。文 (statement) とはできない (例えば、 "if xx:...", "print xxx", などは不可) 。さらに、改行も入れてはならない。 lambda は filter(), map(), reduce() 関数や、 GUI コールバック のために使用することが多い。

リスト内包表記 (List comprehensions)

result = [expression for item1 in sequence1  [if condition1]
             [for item2 in sequence2 ... for itemN in sequenceN]
         ]

上記は次の記述と同じ。

result = []
for item1 in sequence1:
    for item2 in sequence2:
        ...
        for itemN in sequenceN:
            if (condition1) and further conditions:
               result.append(expression)

スコープのネスト
2.2より、スコープのネストを from __future__ import nested_scopes のように明示的に有効にする必要が無くなった。スコープのネストは常に使用可能である。

組み込み関数

x = 1; assert eval('x + 1') == 2

組み込み例外クラス

• StandardError
  組み込み例外の基底クラス。Exception クラスを継承している。
  • ArithmeticError
    算術上のエラーの基底クラス。
    • FloatingPointError
      浮動小数点演算が失敗した。
    • OverflowError
      過大な算術演算を行った。
    • ZeroDivisionError
      除算や剰余演算での第 2 引数がゼロであった。
  • AssertionError
    assert 文が失敗した。
  • AttributeError
    属性の参照や代入が失敗した。
  • EnvironmentError [1.5.2 以降]
    Python の外部でエラーが発生した。args 属性は (errno, errMsg...) となる。
    • IOError [1.5.2 で変更]
      入出力関連の操作が失敗した。
    • OSError [1.5.2 以降]
      os モジュールの os.error 例外で使われる。
      • WindowsError
        Windows 特有のエラーが発生した。または、エラー番号が errno 値に対応しない。
  • EOFError
    input() や raw_input() で、データをまったく読まないうちにファイルの終端 (EOF) に達した。
  • ImportError
    モジュールや名前を見つけられず、import に失敗した。
  • KeyboardInterrupt
    ユーザが割り込みキー（通常は`CTRL-C'）を押した。
  • LookupError
    IndexError と KeyError の基底クラス。
    • IndexError
      シーケンスのインデクス指定が範囲を超えている。
    • KeyError
      参照したマップ（辞書）のキーが存在しない。
  • MemoryError
    メモリ不足が発生した。ただし、復旧可能性あり。
  • NameError
    ローカルまたは（非限定な (unqualified)）グローバルの名前が見つからない。
    • UnboundLocalError
      参照したローカル変数には値が未代入であった。
  • ReferenceError
    弱参照プロキシ (weak reference proxy) を使ってガーベジコレクション済のオブジェクトにアクセスしようとした。
  • RuntimeError
    旧版のその他のエラー。他のより適切なエラーを定義すること。
    • NotImplementedError [1.5.2 以降]
      メソッドが実装されていない。
  • SyntaxError
    パース時に文法エラーが見つかった。
    • IndentationError
      パース時にインデントに関する文法エラーが見つかった。
      • TabError
        スペース文字とタブ文字が不適切に混ぜて使われている。
  • SystemError
    軽微なインタープリタ内部のバグ。python 開発者への報告が望まれる。
  • TypeError
    組み込み演算または関数に不適切な型を渡した。
  • ValueError
    TypeError 以外の引数エラー。
    • UnicodeError
      エンコードまたはデコード時にユニコード関連のエラーが起きた。
      • UnicodeDecodeError
        ユニコードのデコードエラーが起きた。
      • UnicodeEncodeError
        ユニコードのエンコードエラーが起きた。
      • UnicodeTranslateError
        ユニコードの変換エラーが起きた。
• StopIteration
  イテレータの next() メソッドで、次の値が存在しない場合に送出される。
• SystemExit
  sys.exit() が行われた。
• Warning
  警告 (warning) の基底クラス（warning モジュールも見よ）。
  • DeprecationWarning
    撤廃された機能を使った。
  • FutureWarning
    将来的に意味構成が変わる予定な構文を使った。
  • OverflowWarning
    数値演算がオーバーフローした。この警告は、Python 2.5 で撤廃される。
  • PendingDeprecationWarning
    撤廃予定の機能を使用した。
  • RuntimeWarning
    ラインタイムがおかしい挙動をした。
  • SyntaxWarning
    構文が曖昧である。
  • UserWarning
    ユーザコードが生成する警告の基底クラス。

標準メソッドと演算子のユーザ定義クラスでの再定義

class C:
    def __init__(self, v): self.value = v
    def __add__(self, r): return self.value + r

a = C(3) # sort of like calling C.__init__(a, 3)
a + 4    # is equivalent to a.__add__(4)

演算子

operator モジュール内の一覧を見よ。 演算子に対応する関数名は、前後に '__' が付くものと付かないものと、 2 つの形式 がある （たとえば、 __add__ と add）。

• a + 3  calls __add__(a, 3)
• 3 + a  calls __radd__(a, 3)

型の情報状態を示す特殊属性

主要なモジュール

sys

os

posix

posixpath

shutil

time

string

re (sre)

正規表現オブジェクト

マッチオブジェクト

math

getopt

getopt(list, optstr)    -- C言語に類似. <optstr> は探索用のオプション文字列
                               引数を取るオプション文字の後には ':' を付ける。例、
    # "python test.py -c hi -a arg1 arg2" のように呼び出す
       opts, args =  getopt.getopt(sys.argv[1:], 'ab:c:')
    # opts は、
       [('-c', 'hi'), ('-a', '')]
    # args は、
       ['arg1', 'arg2']

List of modules and packages in base distribution