ローカルスコープ

ローカルスコープには、実行中のブロックが含まれます。ある名前を探す際、まず最初に調べられます。

def add1(x):
    a = x + 1 # 名前 a を add1 関数のブロック内で代入

    return a  # a は同一ブロック内で代入されているのが
              # 見つかるのでこちらが用いられる

a = 3 # 参照されない

add1 関数の外のモジュールブロックと add1 関数ブロック双方に a という名前が導入されていますが、 return a 文が実行された際に参照される a とは add1 関数内のものとなります。

外側の関数のスコープ(Enclosing function's scope)

関数ブロックがネストした際、外の関数ブロックらが含まれることとなるスコープです。関数ブロックがネストしていなければ存在しません。名前を探したがローカルスコープで見つからなかった時、このスコープが存在すれば、ここが調べられます。

def repeat(n):
    temp = n

    def _repeat():
        return temp # temp は _repeat 関数ブロックでは見つからないので
                    # 外の repeat 関数ブロックを探す。

  return _repeat

_repeat 関数が実行され temp という名前を参照したとき、この名前まず _repeat 関数ブロックで探されます。しかし見つからないので、次に外の repeat 関数ブロックで探されます。ここには temp という名前が導入されているのでこれが参照されることとなります。

なお、クラス文にてメソッドを定義するコードは、関数のネストに見た目が似ていますが異なるものです。

class Spam(object):
    a = 1

    def __init__(self):
        self.x = a # a を見つけることはできず、 NameError となる

__init__ メソッドが実行された際、 a の探される箇所は __init__ ブロックと次に紹介するグローバルスコープ、ビルトインスコープです。 Spam クラスのブロックが探されることはありません。

グローバルスコープ

実行中のブロックを含むモジュールブロックが含まれるスコープです。ローカル、外側の関数のスコープを探したが名前が見つからなかった時、このスコープが調べられます。

ONE = 1

def add1(x):
    return x + ONE # ONE は add1 関数ブロックでは見つからないので
                   # モジュールのブロックを探す。

グローバルスコープとローカルスコープが同一のものとなることがあります。実行中のブロックがモジュールブロックそのものであるときです。

x = 1
print x + 1 # この文の実行中、
            # x はローカルスコープの名前兼、グローバルスコープの名前

ビルトインスコープ

組み込み関数、組み込み定数、組み込み例外などが含まれる特殊なスコープです。名前を探す際、一番最後に調べられます。

def read_textfile(filename):
    try:
        f = open(filename, 'r') # open が導入された様子は
                                # このソースからは読み取れないが
                                # ビルトインスコープに確かに存在する
        text = f.read()
    finally:
        f.close()

    return text

グローバル変数へ代入する

代入などの名前の導入処理がとあるブロックでおこなわれると、その名前は通常ブロック自身に属することとなります。しかし、関数ブロックなどからモジュールのブロックへ代入を行いたい場合も、まれにあります。

次のコードは呼ばれた回数をグローバル変数 counter に保持しつつ、表示する関数 count を定義しようとしています。

counter = 0

def count():
    counter = counter + 1
    print count

この関数は正常動作しません。 Python インタプリタは func 内で count の代入が存在することを検知して、 count は func 関数ブロック内に存在するものと認識します。しかし count + 1 が実行される時点ではまだ count が関数ブロック内で束縛されていないため UnboundLocalError? 例外が送出されます。

この問題は counter が count 関数ブロックではなくモジュールブロックの counter を示したいことをインタプリタに伝えられれば解決します。そのための道具として global 文が存在します。次のようにコードを修正すると意図した動作となります。

counter = 0

def count():
    global counter
    counter = counter + 1
    print counter

外側の関数の変数へ代入する

ネストした関数ブロックの内側から外へ代入も通常できません。外のブロックのものを示したいことをインタプリタに伝えるため Python 3 では nunlocal 文が追加されました。

# Python 3 以降でのみ動作する
def count():
    counter = 0

    def _():
        nonlocal counter
        counter += 1
        return counter

    return _

c = count()
print(c()) # 1 を表示
print(c()) # 2 を表示
print(c()) # 3 を表示