13.4.2 使用例

インタフェースは以下のコードに集約されています (key は文字列で、 data は任意のオブジェクトです):

import shelve

d = shelve.open(filename) # open -- file may get suffix added by low-level
                          # library

d[key] = data   # store data at key (overwrites old data if
                # using an existing key)
data = d[key]   # retrieve a COPY of data at key (raise KeyError if no
                # such key)
del d[key]      # delete data stored at key (raises KeyError
                # if no such key)
flag = d.has_key(key)   # true if the key exists
klist = d.keys() # a list of all existing keys (slow!)

# as d was opened WITHOUT writeback=True, beware:
d['xx'] = range(4)  # this works as expected, but...
d['xx'].append(5)   # *this doesn't!* -- d['xx'] is STILL range(4)!!!

# having opened d without writeback=True, you need to code carefully:
temp = d['xx']      # extracts the copy
temp.append(5)      # mutates the copy
d['xx'] = temp      # stores the copy right back, to persist it

# or, d=shelve.open(filename,writeback=True) would let you just code
# d['xx'].append(5) and have it work as expected, BUT it would also
# consume more memory and make the d.close() operation slower.

d.close()       # close it

参考:

anydbm:モジュール
dbm スタイルのデータベースに対する汎用インタフェース。.
bsddb:モジュール
BSD db データベースインタフェース。.
dbhash:モジュール
bsddb をラップする薄いレイヤで、他のデータベースモジュールのように関数 open を提供しています。.
dbm:モジュール
標準の Unix データベースインタフェース。.
dumbdbm:モジュール
dbm インタフェースの移植性のある実装。.
gdbm:モジュール
dbm インタフェースに基づいた GNU データベースインタフェース。.
pickle:モジュール
shelve によって使われるオブジェクト整列化機構。.
cPickle:モジュール
pickle の高速版。.
ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。