dbm — Простой интерфейс «базы данных»

Модуль dbm предоставляет интерфейс к библиотеке Unix “(n)dbm”. Объекты dbm ведут себя как отображения (словари), за исключением того, что ключи и значения всегда являются строками. Вывод объекта dbm не выводит ключи и значения, и методы items() и values() не поддерживаются.

Этот модуль может использоваться с интерфейсом «классического» ndbm, интерфейсом совместимости с BSD DB или интерфейсом совместимости с GNU GDBM. В Unix скрипт configure попытается найти соответствующий заголовочный файл, чтобы упростить сборку этого модуля.

Модуль определяет следующее:

exception dbm.error

Вызывается при ошибках, специфичных для dbm, таких как ошибки ввода-вывода. KeyError генерируется при общих ошибках отображения, таких как указание неправильного ключа.

dbm.library

Имя библиотеки реализации ndbm.

dbm.open(filename[, flag[, mode]])

Открывает базу данных dbm и возвращает объект dbm. Аргумент filename — имя файла базы данных (без расширений .dir или .pag; обратите внимание, что реализация интерфейса BSD DB добавит расширение .db и создаст только один файл).

Необязательный аргумент flag должен иметь одно из этих значений:

Значение	Значение
'r'	Открыть существующую базу данных только для чтения (по умолчанию)
'w'	Открыть существующую базу данных для чтения и записи
'c'	Открыть базу данных для чтения и записи, создав её, если она не существует
'n'	Всегда создать новую пустую базу данных, открыть для чтения и записи

Необязательный аргумент mode — режим Unix файла, используемый только при необходимости создания базы данных. По умолчанию он равен восьмеричному 0666 (и будет изменён текущей маской umask).

В дополнение к методам, подобным методам словаря, объекты dbm предоставляют следующий метод:

dbm.close()

Закрыть базу данных dbm.