dbm.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
# arman mohebali <armanmohebali@outlook.com>, 2026
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-10-01 14:41+0330\n"
"PO-Revision-Date: 2026-09-14 09:10+0330\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/python/python-docs-fa/)\n"
"Language: fa\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
"X-Generator: Poedit 3.6\n"

msgid ":mod:`!dbm` --- Interfaces to Unix \"databases\""
msgstr ":mod:`!dbm` --- رابط‌هایی برای «پایگاه‌های داده»ی یونیکس"

msgid "**Source code:** :source:`Lib/dbm/__init__.py`"
msgstr "**کد منبع:** :source:`Lib/dbm/__init__.py`"

msgid ":mod:`!dbm` is a generic interface to variants of the DBM database:"
msgstr ":mod:`!dbm` یک رابط عام برای انواع پایگاه داده DBM است:"

msgid ":mod:`dbm.sqlite3`"
msgstr ":mod:`dbm.sqlite3`"

msgid ":mod:`dbm.gnu`"
msgstr ":mod:`dbm.gnu`"

msgid ":mod:`dbm.ndbm`"
msgstr ":mod:`dbm.ndbm`"

msgid "If none of these modules are installed, the slow-but-simple implementation in module :mod:`dbm.dumb` will be used. There is a `third party interface <https://www.jcea.es/programacion/pybsddb.htm>`_ to the Oracle Berkeley DB."
msgstr "اگر هیچ‌یک از این ماژول‌ها نصب نشده باشند، پیاده‌سازی کند-اما-ساده در ماژول :mod:`dbm.dumb` استفاده خواهد شد. یک `رابط شخص ثالث <https://www.jcea.es/programacion/pybsddb.htm>`_ برای پایگاه داده‌ی اوراکل برکلی (Oracle Berkeley DB) وجود دارد."

msgid "None of the underlying modules will automatically shrink the disk space used by the database file. However, :mod:`dbm.sqlite3`, :mod:`dbm.gnu` and :mod:`dbm.dumb` provide a :meth:`!reorganize` method that can be used for this purpose."
msgstr "هیچ‌یک از ماژول‌های زیرین فضای دیسک استفاده‌شده توسط پرونده‌ی پایگاه‌داده را به‌طور خودکار کوچک نمی‌کنند. بااین‌حال، :mod:`dbm.sqlite3`، :mod:`dbm.gnu` و :mod:`dbm.dumb` متدی به نام :meth:`!reorganize` ارائه می‌دهند که می‌توان از آن برای این منظور استفاده کرد."

msgid "A tuple containing the exceptions that can be raised by each of the supported modules, with a unique exception also named :exc:`dbm.error` as the first item --- the latter is used when :exc:`dbm.error` is raised."
msgstr "تاپلی شامل استثناهایی که هر یک از ماژول‌های پشتیبانی‌شده می‌توانند پرتاب کنند، با یک استثنای یکتا که آن نیز :exc:`dbm.error` نام دارد به‌عنوان اولین آیتم --- این استثنا زمانی استفاده می‌شود که :exc:`dbm.error` پرتاب شود."

msgid "This function attempts to guess which of the several simple database modules available --- :mod:`dbm.sqlite3`, :mod:`dbm.gnu`, :mod:`dbm.ndbm`, or :mod:`dbm.dumb` --- should be used to open a given file."
msgstr "این تابع تلاش می‌کند حدس بزند که کدام‌یک از چندین ماژول ساده پایگاه داده موجود --- :mod:`dbm.sqlite3`، :mod:`dbm.gnu`، :mod:`dbm.ndbm`، یا :mod:`dbm.dumb` --- باید برای باز کردن یک پرونده مشخص استفاده شود."

msgid "Return one of the following values:"
msgstr "یکی از مقادیر زیر را برمی‌گرداند:"

msgid "``None`` if the file can't be opened because it's unreadable or doesn't exist"
msgstr "``None`` اگر پرونده به دلیل غیرقابل‌خواندن بودن یا وجود نداشتن نتواند باز شود"

msgid "the empty string (``''``) if the file's format can't be guessed"
msgstr "رشته خالی (``''``) اگر نتوان قالب پرونده را حدس زد"

msgid "a string containing the required module name, such as ``'dbm.ndbm'`` or ``'dbm.gnu'``"
msgstr "رشته‌ای شامل نام ماژول مورد نیاز، مانند ``'dbm.ndbm'`` یا ``'dbm.gnu'``"

msgid "*filename* accepts a :term:`path-like object`."
msgstr "*filename* یک :term:`شیء شبه‌مسیر (path-like object) <path-like object>` را می‌پذیرد."

msgid "Open a database and return the corresponding database object."
msgstr "یک پایگاه داده را باز می‌کند و شیء پایگاه داده‌ی متناظر را برمی‌گرداند."

msgid "Parameters"
msgstr "پارامترها"

msgid "The database file to open.  If the database file already exists, the :func:`whichdb` function is used to determine its type and the appropriate module is used; if it does not exist, the first submodule listed above that can be imported is used."
msgstr "پرونده پایگاه داده برای باز کردن. اگر پرونده پایگاه داده از قبل وجود داشته باشد، از تابع :func:`whichdb` برای تعیین نوع آن استفاده می‌شود و ماژول مناسب به کار می‌رود؛ اگر وجود نداشته باشد، از اولین زیرماژول فهرست‌شده در بالا که قابل ایمپورت باشد استفاده می‌شود."

msgid "The database file to open."
msgstr "پرونده پایگاه داده‌ای که باید باز شود."

msgid "If the database file already exists, the :func:`whichdb` function is used to determine its type and the appropriate module is used; if it does not exist, the first submodule listed above that can be imported is used."
msgstr "اگر پرونده پایگاه داده از قبل وجود داشته باشد، برای تعیین نوع آن از تابع :func:`whichdb` استفاده می‌شود و ماژول مناسب به کار می‌رود؛ اگر وجود نداشته باشد، اولین زیرماژول فهرست‌شده در بالا که بتوان آن را ایمپورت کرد، استفاده می‌شود."

msgid "* ``'r'`` (default): |flag_r| * ``'w'``: |flag_w| * ``'c'``: |flag_c| * ``'n'``: |flag_n|"
msgstr "* ``'r'`` (پیش‌فرض): |flag_r| * ``'w'``: |flag_w| * ``'c'``: |flag_c| * ``'n'``: |flag_n|"

msgid "``'r'`` (default): |flag_r|"
msgstr "``'r'`` (پیش‌فرض): |flag_r|"

msgid "``'w'``: |flag_w|"
msgstr "``'w'``: |flag_w|"

msgid "``'c'``: |flag_c|"
msgstr "``'c'``: |flag_c|"

msgid "``'n'``: |flag_n|"
msgstr "``'n'``: |flag_n|"

msgid "|mode_param_doc|"
msgstr "|mode_param_doc|"

msgid "*file* accepts a :term:`path-like object`."
msgstr "*file* یک :term:`path-like object` را می‌پذیرد."

msgid "The object returned by :func:`~dbm.open` supports the basic functionality of mutable :term:`mappings <mapping>`; keys and their corresponding values can be stored, retrieved, and deleted, and iteration, the :keyword:`in` operator and methods :meth:`!keys`, :meth:`!get`, :meth:`!setdefault` and :meth:`!clear` are available. The :meth:`!keys` method returns a list instead of a view object. The :meth:`!setdefault` method requires two arguments."
msgstr "شیء برگردانده‌شده توسط :func:`~dbm.open`، از کارکرد پایه‌ی :term:`نگاشت‌های تغییرپذیر <mapping>` پشتیبانی می‌کند؛ کلیدها و مقدارهای متناظرشان می‌توانند ذخیره، بازیابی و حذف شوند و پیمایش، عملگر :keyword:`in` و متدهای :meth:`!keys`، :meth:`!get`، :meth:`!setdefault` و :meth:`!clear` در دسترس هستند. متد :meth:`!keys` به‌جای یک شیء نما، یک فهرست برمی‌گرداند. متد :meth:`!setdefault` به دو آرگومان نیاز دارد."

msgid "Key and values are always stored as :class:`bytes`. This means that when strings are used they are implicitly converted to the default encoding before being stored."
msgstr "کلید و مقادیر همیشه به‌صورت :class:`bytes` ذخیره می‌شوند. این بدان معناست که وقتی از رشته‌ها استفاده می‌شود، آن‌ها پیش از ذخیره شدن به‌طور ضمنی به کدگذاری پیش‌فرض تبدیل می‌شوند."

msgid "These objects also support being used in a :keyword:`with` statement, which will automatically close them when done."
msgstr "این اشیاء همچنین از استفاده در دستور :keyword:`with` پشتیبانی می‌کنند، که به‌طور خودکار آن‌ها را پس از اتمام کار می‌بندد."

msgid ":meth:`!get` and :meth:`!setdefault` methods are now available for all :mod:`!dbm` backends."
msgstr "متدهای :meth:`!get` و :meth:`!setdefault` اکنون برای تمام بک‌اندهای (backends) :mod:`!dbm` در دسترس هستند."

msgid "Added native support for the context management protocol to the objects returned by :func:`~dbm.open`."
msgstr "پشتیبانی ذاتی از پروتکل مدیریت زمینه به اشیای برگردانده‌شده از :func:`~dbm.open` افزوده شد."

msgid "Deleting a key from a read-only database raises a database module specific exception instead of :exc:`KeyError`."
msgstr "حذف یک کلید از پایگاه داده‌ی فقط‌خواندنی، به‌جای :exc:`KeyError`، یک استثنای مخصوص ماژول پایگاه داده را پرتاب می‌کند."

msgid ":meth:`!clear` methods are now available for all :mod:`!dbm` backends."
msgstr "متدهای :meth:`!clear` اکنون برای تمام بک‌اندهای :mod:`!dbm` در دسترس هستند."

msgid "The following example records some hostnames and a corresponding title,  and then prints out the contents of the database::"
msgstr "مثال زیر چند نام میزبان و یک عنوان متناظر را ثبت می‌کند، و سپس محتویات پایگاه داده را چاپ می‌کند::"

msgid ""
"import dbm\n"
"\n"
"# Open database, creating it if necessary.\n"
"with dbm.open('cache', 'c') as db:\n"
"\n"
"    # Record some values\n"
"    db[b'hello'] = b'there'\n"
"    db['www.python.org'] = 'Python Website'\n"
"    db['www.cnn.com'] = 'Cable News Network'\n"
"\n"
"    # Note that the keys are considered bytes now.\n"
"    assert db[b'www.python.org'] == b'Python Website'\n"
"    # Notice how the value is now in bytes.\n"
"    assert db['www.cnn.com'] == b'Cable News Network'\n"
"\n"
"    # Often-used methods of the dict interface work too.\n"
"    print(db.get('python.org', b'not present'))\n"
"\n"
"    # Storing a non-string key or value will raise an exception (most\n"
"    # likely a TypeError).\n"
"    db['www.yahoo.com'] = 4\n"
"\n"
"# db is automatically closed when leaving the with statement."
msgstr ""
"import dbm\n"
"\n"
"# Open database, creating it if necessary.\n"
"with dbm.open('cache', 'c') as db:\n"
"\n"
"    # Record some values\n"
"    db[b'hello'] = b'there'\n"
"    db['www.python.org'] = 'Python Website'\n"
"    db['www.cnn.com'] = 'Cable News Network'\n"
"\n"
"    # Note that the keys are considered bytes now.\n"
"    assert db[b'www.python.org'] == b'Python Website'\n"
"    # Notice how the value is now in bytes.\n"
"    assert db['www.cnn.com'] == b'Cable News Network'\n"
"\n"
"    # Often-used methods of the dict interface work too.\n"
"    print(db.get('python.org', b'not present'))\n"
"\n"
"    # Storing a non-string key or value will raise an exception (most\n"
"    # likely a TypeError).\n"
"    db['www.yahoo.com'] = 4\n"
"\n"
"# db is automatically closed when leaving the with statement."

msgid "Module :mod:`shelve`"
msgstr "ماژول :mod:`shelve`"

msgid "Persistence module which stores non-string data."
msgstr "ماژول ماندگاری که داده‌های غیررشته‌ای را ذخیره می‌کند."

msgid "The individual submodules are described in the following sections."
msgstr "هر یک از زیرماژول‌ها در بخش‌های زیر شرح داده شده‌اند."

msgid ":mod:`!dbm.sqlite3` --- SQLite backend for dbm"
msgstr ":mod:`!dbm.sqlite3` --- بک‌اند SQLite برای dbm"

msgid "**Source code:** :source:`Lib/dbm/sqlite3.py`"
msgstr "**کد منبع:** :source:`Lib/dbm/sqlite3.py`"

msgid "This module uses the standard library :mod:`sqlite3` module to provide an SQLite backend for the :mod:`!dbm` module. The files created by :mod:`!dbm.sqlite3` can thus be opened by :mod:`sqlite3`, or any other SQLite browser, including the SQLite CLI."
msgstr "این ماژول از ماژول :mod:`sqlite3` در کتابخانه استاندارد استفاده می‌کند تا یک بک‌اند SQLite برای ماژول :mod:`!dbm` فراهم کند. در نتیجه، پرونده‌های ایجادشده توسط :mod:`!dbm.sqlite3` را می‌توان با :mod:`sqlite3` یا هر مرورگر SQLite دیگری، از جمله SQLite CLI، باز کرد."

msgid "Availability"
msgstr "دسترس‌پذیری"

msgid "This module does not work or is not available on WebAssembly. See :ref:`wasm-availability` for more information."
msgstr "این ماژول روی WebAssembly کار نمی‌کند یا در دسترس نیست. برای اطلاعات بیشتر :ref:`wasm-availability` را ببینید."

msgid "Open an SQLite database."
msgstr "باز کردن یک پایگاه داده SQLite."

msgid "The path to the database to be opened."
msgstr "مسیر پایگاه داده‌ای که باید باز شود."

msgid "The Unix file access mode of the file (default: octal ``0o666``), used only when the database has to be created."
msgstr "حالت دسترسی یونیکسی پرونده (پیش‌فرض: ``0o666`` در مبنای هشت)، که تنها زمانی استفاده می‌شود که پایگاه داده باید ایجاد شود."

msgid "The returned database object behaves similar to a mutable :term:`mapping`, but the :meth:`!keys` method returns a list, and the :meth:`!setdefault` method requires two arguments. It also supports a \"closing\" context manager via the :keyword:`with` keyword."
msgstr "شیء پایگاه داده‌ی برگردانده‌شده رفتاری مشابه یک :term:`mapping` تغییرپذیر دارد، اما متد :meth:`!keys` یک فهرست برمی‌گرداند و متد :meth:`!setdefault` به دو آرگومان نیاز دارد. همچنین از یک مدیر زمینه‌ی «بستن» از طریق کلیدواژه :keyword:`with` پشتیبانی می‌کند."

msgid "The following methods are also provided:"
msgstr "متدهای زیر نیز ارائه شده‌اند:"

msgid "Close the SQLite database."
msgstr "پایگاه داده‌ی SQLite را ببندید."

msgid "If you have carried out a lot of deletions and would like to shrink the space used on disk, this method will reorganize the database; otherwise, deleted file space will be kept and reused as new (key, value) pairs are added."
msgstr "اگر حذف‌های زیادی انجام داده‌اید و می‌خواهید فضای استفاده‌شده روی دیسک را کاهش دهید، این متد پایگاه داده را سازمان‌دهی مجدد خواهد کرد؛ در غیر این صورت، فضای پرونده‌ی حذف‌شده حفظ می‌شود و با اضافه شدن جفت‌های (کلید، مقدار) جدید دوباره مورد استفاده قرار می‌گیرد."

msgid "While reorganizing, as much as two times the size of the original database is required in free disk space. However, be aware that this factor changes for each :mod:`!dbm` submodule."
msgstr "هنگام بازسازمان‌دهی، فضایی آزاد روی دیسک به اندازه‌ی حداکثر دو برابر اندازه‌ی پایگاه‌داده‌ی اصلی مورد نیاز است. بااین‌حال، آگاه باشید که این ضریب برای هر زیرماژول :mod:`!dbm` تغییر می‌کند."

msgid ":mod:`!dbm.gnu` --- GNU database manager"
msgstr ":mod:`!dbm.gnu` --- مدیر پایگاه‌داده GNU"

msgid "**Source code:** :source:`Lib/dbm/gnu.py`"
msgstr "**کد منبع:** :source:`Lib/dbm/gnu.py`"

msgid "The :mod:`!dbm.gnu` module provides an interface to the :abbr:`GDBM (GNU dbm)` library, similar to the :mod:`dbm.ndbm` module, but with additional functionality like crash tolerance."
msgstr "ماژول :mod:`!dbm.gnu` رابطی برای کتابخانه‌ی :abbr:`GDBM (GNU dbm)` فراهم می‌کند، مشابه ماژول :mod:`dbm.ndbm`، اما با قابلیت‌های اضافی مانند تحمل خرابی (crash tolerance)."

msgid "The file formats created by :mod:`!dbm.gnu` and :mod:`dbm.ndbm` are incompatible and can not be used interchangeably."
msgstr "قالب‌های پرونده ایجادشده توسط :mod:`!dbm.gnu` و :mod:`dbm.ndbm` ناسازگار هستند و نمی‌توانند به‌جای یکدیگر استفاده شوند."

msgid "This module is not supported on :ref:`mobile platforms <mobile-availability>` or :ref:`WebAssembly platforms <wasm-availability>`."
msgstr "این ماژول در :ref:`پلتفرم‌های موبایل <mobile-availability>` یا :ref:`پلتفرم‌های WebAssembly <wasm-availability>` پشتیبانی نمی‌شود."

msgid "Raised on :mod:`!dbm.gnu`-specific errors, such as I/O errors. :exc:`KeyError` is raised for general mapping errors like specifying an incorrect key."
msgstr "در صورت بروز خطاهای خاص :mod:`!dbm.gnu`، مانند خطاهای I/O، پرتاب می‌شود. :exc:`KeyError` برای خطاهای عمومی نگاشت، مانند مشخص کردن یک کلید نادرست، پرتاب می‌شود."

msgid "A string of characters the *flag* parameter of :meth:`~dbm.gnu.open` supports."
msgstr "رشته‌ای از نویسه‌ها که پارامتر *flag* در :meth:`~dbm.gnu.open` از آن‌ها پشتیبانی می‌کند."

msgid "Open a GDBM database and return a :class:`!gdbm` object."
msgstr "یک پایگاه داده GDBM را باز می‌کند و یک شیء :class:`!gdbm` را برمی‌گرداند."

msgid "* ``'r'`` (default): |flag_r| * ``'w'``: |flag_w| * ``'c'``: |flag_c| * ``'n'``: |flag_n|  The following additional characters may be appended to control how the database is opened:  * ``'f'``: Open the database in fast mode.   Writes to the database will not be synchronized. * ``'s'``: Synchronized mode.   Changes to the database will be written immediately to the file. * ``'u'``: Do not lock database.  Not all flags are valid for all versions of GDBM. See the :data:`open_flags` member for a list of supported flag characters."
msgstr "* ``'r'`` (پیش‌فرض): |flag_r| * ``'w'``: |flag_w| * ``'c'``: |flag_c| * ``'n'``: |flag_n|  می‌توان نویسه‌های اضافی زیر را برای کنترل چگونگی باز شدن پایگاه داده افزود:  * ``'f'``: باز کردن پایگاه داده در حالت سریع.   نوشتن‌ها در پایگاه داده همگام‌سازی نخواهند شد. * ``'s'``: حالت همگام.   تغییرات پایگاه داده بلافاصله در پرونده نوشته خواهند شد. * ``'u'``: قفل نکردن پایگاه داده.  همه‌ی پرچم‌ها برای همه‌ی نسخه‌های GDBM معتبر نیستند. برای فهرستی از نویسه‌های پرچم پشتیبانی‌شده، عضو :data:`open_flags` را ببینید."

msgid "The following additional characters may be appended to control how the database is opened:"
msgstr "می‌توان نویسه‌های اضافی زیر را برای کنترل چگونگی باز شدن پایگاه داده اضافه کرد:"

msgid "``'f'``: Open the database in fast mode. Writes to the database will not be synchronized."
msgstr "``'f'``: پایگاه داده را در حالت سریع باز می‌کند. نوشتن‌ها در پایگاه داده همگام‌سازی نخواهند شد."

msgid "``'s'``: Synchronized mode. Changes to the database will be written immediately to the file."
msgstr "``'s'``: حالت همگام‌سازی‌شده. تغییرات پایگاه داده بلافاصله در پرونده نوشته می‌شوند."

msgid "``'u'``: Do not lock database."
msgstr "``'u'``: پایگاه داده را قفل نکنید."

msgid "Not all flags are valid for all versions of GDBM. See the :data:`open_flags` member for a list of supported flag characters."
msgstr "همه‌ی پرچم‌ها برای همه‌ی نسخه‌های GDBM معتبر نیستند. برای فهرستی از نویسه‌های پرچم پشتیبانی‌شده، عضو :data:`open_flags` را ببینید."

msgid "Raises"
msgstr "پرتاب می‌کند"

msgid "If an invalid *flag* argument is passed."
msgstr "اگر آرگومان *flag* نامعتبری ارسال شود."

msgid ":class:`!gdbm` objects behave similar to mutable :term:`mappings <mapping>`, but methods :meth:`!items`, :meth:`!values`, :meth:`!pop`, :meth:`!popitem`, and :meth:`!update` are not supported, the :meth:`!keys` method returns a list, and the :meth:`!setdefault` method requires two arguments. It also supports a \"closing\" context manager via the :keyword:`with` keyword."
msgstr "اشیای :class:`!gdbm` مانند :term:`نگاشت‌های تغییرپذیر <mapping>` رفتار می‌کنند، اما متدهای :meth:`!items`، :meth:`!values`، :meth:`!pop`، :meth:`!popitem` و :meth:`!update` پشتیبانی نمی‌شوند؛ متد :meth:`!keys` یک فهرست برمی‌گرداند و متد :meth:`!setdefault` به ۲ آرگومان نیاز دارد. همچنین از یک مدیر زمینه‌ی «بستن» از طریق کلیدواژه‌ی :keyword:`with` پشتیبانی می‌کند."

msgid "Added the :meth:`!get` and :meth:`!setdefault` methods."
msgstr "متدهای :meth:`!get` و :meth:`!setdefault` افزوده شدند."

msgid "Added the :meth:`!clear` method."
msgstr "متد :meth:`!clear` افزوده شد."

msgid "Close the GDBM database."
msgstr "پایگاه داده GDBM را ببندید."

msgid "It's possible to loop over every key in the database using this method  and the :meth:`nextkey` method.  The traversal is ordered by GDBM's internal hash values, and won't be sorted by the key values.  This method returns the starting key."
msgstr "می‌توان با استفاده از این متد و متد :meth:`nextkey`، روی تمام کلیدهای پایگاه داده حلقه زد. پیمایش به ترتیب مقادیر هش داخلی GDBM است و بر اساس مقادیر کلید مرتب نخواهد شد. این متد کلید شروع را برمی‌گرداند."

msgid "Returns the key that follows *key* in the traversal.  The following code prints every key in the database ``db``, without having to create a list in memory that contains them all::"
msgstr "کلیدی را که در پیمایش پس از *key* می‌آید برمی‌گرداند. کد زیر همه‌ی کلیدهای پایگاه داده‌ی ``db`` را، بدون نیاز به ایجاد فهرستی حاوی همه‌ی آن‌ها در حافظه، چاپ می‌کند::"

msgid ""
"k = db.firstkey()\n"
"while k is not None:\n"
"    print(k)\n"
"    k = db.nextkey(k)"
msgstr ""
"k = db.firstkey()\n"
"while k is not None:\n"
"    print(k)\n"
"    k = db.nextkey(k)"

msgid "If you have carried out a lot of deletions and would like to shrink the space used by the GDBM file, this routine will reorganize the database.  :class:`!gdbm` objects will not shorten the length of a database file except by using this reorganization; otherwise, deleted file space will be kept and reused as new (key, value) pairs are added."
msgstr "اگر حذف‌های زیادی انجام داده‌اید و می‌خواهید فضای مصرفی پرونده GDBM را کاهش دهید، این روتین پایگاه داده را بازآرایی می‌کند. اشیای :class:`!gdbm` طول پرونده پایگاه داده را کوتاه نمی‌کنند، مگر با استفاده از این بازآرایی؛ در غیر این صورت، فضای حذف‌شده در پرونده نگه داشته شده و با افزودن جفت‌های جدید (کلید، مقدار) دوباره استفاده می‌شود."

msgid "While reorganizing, as much as one time the size of the original database is required in free disk space. However, be aware that this factor changes for each :mod:`!dbm` submodule."
msgstr "هنگام بازسازمان‌دهی، فضایی آزاد روی دیسک به اندازه‌ی حداکثر یک برابر اندازه‌ی پایگاه‌داده‌ی اصلی مورد نیاز است. بااین‌حال، آگاه باشید که این ضریب برای هر زیرماژول :mod:`!dbm` تغییر می‌کند."

msgid "When the database has been opened in fast mode, this method forces any unwritten data to be written to the disk."
msgstr "هنگامی که پایگاه داده در حالت سریع باز شده باشد، این متد باعث می‌شود هرگونه داده‌ی نوشته‌نشده روی دیسک نوشته شود."

msgid ":mod:`!dbm.ndbm` --- New Database Manager"
msgstr ":mod:`!dbm.ndbm` --- مدیر پایگاه داده جدید"

msgid "**Source code:** :source:`Lib/dbm/ndbm.py`"
msgstr "**کد منبع:** :source:`Lib/dbm/ndbm.py`"

msgid "The :mod:`!dbm.ndbm` module provides an interface to the :abbr:`NDBM (New Database Manager)` library. This module can be used with the \"classic\" NDBM interface or the :abbr:`GDBM (GNU dbm)` compatibility interface."
msgstr "ماژول :mod:`!dbm.ndbm` رابطی به کتابخانه‌ی :abbr:`NDBM (New Database Manager)` فراهم می‌کند. این ماژول را می‌توان با رابط «کلاسیک» NDBM یا رابط سازگاری :abbr:`GDBM (GNU dbm)` استفاده کرد."

msgid "The file formats created by :mod:`dbm.gnu` and :mod:`!dbm.ndbm` are incompatible and can not be used interchangeably."
msgstr "قالب‌های پرونده‌ای که :mod:`dbm.gnu` و :mod:`!dbm.ndbm` ایجاد می‌کنند ناسازگار هستند و نمی‌توان از آن‌ها به‌جای یکدیگر استفاده کرد."

msgid "The NDBM library shipped as part of macOS has an undocumented limitation on the size of values, which can result in corrupted database files when storing values larger than this limit. Reading such corrupted files can result in a hard crash (segmentation fault)."
msgstr "کتابخانه NDBM که به‌عنوان بخشی از macOS عرضه می‌شود، محدودیت مستندنشده‌ای در اندازه‌ی مقادیر دارد که می‌تواند هنگام ذخیره مقادیر بزرگ‌تر از این حد، منجر به فروپاشی پرونده‌های پایگاه داده شود. خواندن چنین پرونده‌های خرابی می‌تواند منجر به فروپاشی سخت (segmentation fault) شود."

msgid "Raised on :mod:`!dbm.ndbm`-specific errors, such as I/O errors. :exc:`KeyError` is raised for general mapping errors like specifying an incorrect key."
msgstr "در صورت بروز خطاهای خاص :mod:`!dbm.ndbm`، مانند خطاهای ورودی/خروجی، پرتاب می‌شود. :exc:`KeyError` برای خطاهای عمومی نگاشت، مانند تعیین یک کلید نادرست، پرتاب می‌شود."

msgid "Name of the NDBM implementation library used."
msgstr "نام کتابخانه پیاده‌سازی NDBM استفاده‌شده."

msgid "Open an NDBM database and return an :class:`!ndbm` object."
msgstr "یک پایگاه داده NDBM را باز می‌کند و یک شیء :class:`!ndbm` را برمی‌گرداند."

msgid "The basename of the database file (without the :file:`.dir` or :file:`.pag` extensions)."
msgstr "نام پایه‌ی پرونده پایگاه داده (بدون پسوندهای :file:`.dir` یا :file:`.pag`)."

msgid "Accepts :term:`path-like object` for filename."
msgstr ":term:`path-like object` را برای نام پرونده می‌پذیرد."

msgid ":class:`!ndbm` objects behave similar to mutable :term:`mappings <mapping>`, but methods :meth:`!items`, :meth:`!values`, :meth:`!pop`, :meth:`!popitem`, and :meth:`!update` are not supported, the :meth:`!keys` method returns a list, and the :meth:`!setdefault` method requires two arguments. It also supports a \"closing\" context manager via the :keyword:`with` keyword."
msgstr "اشیای :class:`!ndbm` رفتاری مشابه :term:`نگاشت‌های <mapping>` تغییرپذیر دارند، اما متدهای :meth:`!items`، :meth:`!values`، :meth:`!pop`، :meth:`!popitem` و :meth:`!update` پشتیبانی نمی‌شوند؛ متد :meth:`!keys` یک فهرست برمی‌گرداند و متد :meth:`!setdefault` به دو آرگومان نیاز دارد. همچنین از یک مدیر زمینه «بستن» از طریق کلیدواژه :keyword:`with` پشتیبانی می‌کند."

msgid "The following method is also provided:"
msgstr "متد زیر نیز ارائه شده است:"

msgid "Close the NDBM database."
msgstr "پایگاه داده NDBM را ببندید."

msgid ":mod:`!dbm.dumb` --- Portable DBM implementation"
msgstr ":mod:`!dbm.dumb` --- پیاده‌سازی قابل‌حمل DBM"

msgid "**Source code:** :source:`Lib/dbm/dumb.py`"
msgstr "**کد منبع:** :source:`Lib/dbm/dumb.py`"

msgid "The :mod:`!dbm.dumb` module is intended as a last resort fallback for the :mod:`!dbm` module when a more robust module is not available. The :mod:`!dbm.dumb` module is not written for speed and is not nearly as heavily used as the other database modules."
msgstr "ماژول :mod:`!dbm.dumb` به‌عنوان آخرین راه‌حل جایگزین برای ماژول :mod:`!dbm` در نظر گرفته شده است، برای زمانی که ماژول قوی‌تری در دسترس نباشد. ماژول :mod:`!dbm.dumb` برای سرعت نوشته نشده است و تقریباً به اندازه‌ی سایر ماژول‌های پایگاه داده پرکاربرد نیست."

msgid "The :mod:`!dbm.dumb` module provides a persistent :class:`dict`-like interface which is written entirely in Python. Unlike other :mod:`!dbm` backends, such as :mod:`dbm.gnu`, no external library is required."
msgstr "ماژول :mod:`!dbm.dumb` رابطی پایا شبیه به :class:`dict` فراهم می‌کند که به‌طور کامل به زبان پایتون نوشته شده است. برخلاف سایر بک‌اندهای :mod:`!dbm`، مانند :mod:`dbm.gnu`، نیازی به کتابخانه‌ی خارجی نیست."

msgid "The :mod:`!dbm.dumb` module defines the following:"
msgstr "ماژول :mod:`!dbm.dumb` موارد زیر را تعریف می‌کند:"

msgid "Raised on :mod:`!dbm.dumb`-specific errors, such as I/O errors.  :exc:`KeyError` is raised for general mapping errors like specifying an incorrect key."
msgstr "در صورت بروز خطاهای مختص :mod:`!dbm.dumb`، مانند خطاهای ورودی/خروجی، پرتاب می‌شود. :exc:`KeyError` برای خطاهای عمومی نگاشت، مانند مشخص کردن کلید نادرست، پرتاب می‌شود."

msgid "Open a :mod:`!dbm.dumb` database."
msgstr "یک پایگاه داده‌ی :mod:`!dbm.dumb` را باز کنید."

msgid "The basename of the database file (without extensions). A new database creates the following files:  - :file:`{filename}.dat` - :file:`{filename}.dir`"
msgstr "نام پایه پرونده پایگاه داده (بدون پسوندها). یک پایگاه داده جدید پرونده‌های زیر را ایجاد می‌کند:  - :file:`{filename}.dat` - :file:`{filename}.dir`"

msgid "The basename of the database file (without extensions). A new database creates the following files:"
msgstr "نام پایه‌ی پرونده پایگاه داده (بدون پسوندها). یک پایگاه داده‌ی جدید پرونده‌های زیر را ایجاد می‌کند:"

msgid ":file:`{filename}.dat`"
msgstr ":file:`{filename}.dat`"

msgid ":file:`{filename}.dir`"
msgstr ":file:`{filename}.dir`"

msgid "* ``'r'``: |flag_r| * ``'w'``: |flag_w| * ``'c'`` (default): |flag_c| * ``'n'``: |flag_n|"
msgstr "* ``'r'``: |flag_r| * ``'w'``: |flag_w| * ``'c'`` (پیش‌فرض): |flag_c| * ``'n'``: |flag_n|"

msgid "``'r'``: |flag_r|"
msgstr "``'r'``: |flag_r|"

msgid "``'c'`` (default): |flag_c|"
msgstr "``'c'`` (پیش‌فرض): |flag_c|"

msgid "It is possible to crash the Python interpreter when loading a database with a sufficiently large/complex entry due to stack depth limitations in Python's AST compiler."
msgstr "ممکن است بارگذاری پایگاه داده‌ای با یک ورودی به‌اندازه کافی بزرگ/پیچیده، به دلیل محدودیت‌های عمق پشته در کامپایلر AST پایتون، باعث از کار افتادن مفسر پایتون شود."

msgid ":mod:`!dbm.dumb` does not support concurrent read/write access. (Multiple simultaneous read accesses are safe.) When a program has the database open for writing, no other program should have it open for reading or writing."
msgstr "ماژول :mod:`!dbm.dumb` از دسترسی هم‌زمان خواندن/نوشتن پشتیبانی نمی‌کند. (چندین دسترسی خواندن هم‌زمان امن هستند.) هنگامی که یک برنامه پایگاه‌داده را برای نوشتن باز کرده است، هیچ برنامه‌ی دیگری نباید آن را برای خواندن یا نوشتن باز کرده باشد."

msgid ":func:`~dbm.dumb.open` always creates a new database when *flag* is ``'n'``."
msgstr ":func:`~dbm.dumb.open` همیشه وقتی *flag* برابر ``'n'`` باشد، یک پایگاه داده جدید ایجاد می‌کند."

msgid "A database opened read-only if *flag* is ``'r'``. A database is not created if it does not exist if *flag* is ``'r'`` or ``'w'``."
msgstr "اگر *flag* برابر ``'r'`` باشد، پایگاه داده به‌صورت فقط‌خواندنی باز می‌شود. اگر *flag* برابر ``'r'`` یا ``'w'`` باشد، در صورتی که پایگاه داده وجود نداشته باشد، ایجاد نمی‌شود."

msgid "The returned database object behaves similar to a mutable :term:`mapping`, but the :meth:`!keys` and :meth:`!items` methods return lists, and the :meth:`!setdefault` method requires two arguments. It also supports a \"closing\" context manager via the :keyword:`with` keyword."
msgstr "شیء پایگاه داده‌ی برگردانده‌شده مانند یک :term:`نگاشت <mapping>` تغییرپذیر رفتار می‌کند، اما متدهای :meth:`!keys` و :meth:`!items` فهرست‌ها را برمی‌گردانند و متد :meth:`!setdefault` به دو آرگومان نیاز دارد. همچنین از یک مدیر زمینه‌ی «بستن» از طریق کلیدواژه‌ی :keyword:`with` پشتیبانی می‌کند."

msgid "Close the database."
msgstr "پایگاه داده را ببندید."

msgid "If you have carried out a lot of deletions and would like to shrink the space used on disk, this method will reorganize the database; otherwise, deleted file space will not be reused."
msgstr "اگر حذف‌های زیادی انجام داده‌اید و می‌خواهید فضای استفاده‌شده روی دیسک را کاهش دهید، این متد پایگاه داده را سازمان‌دهی مجدد خواهد کرد؛ در غیر این صورت، فضای پرونده‌ی حذف‌شده دوباره مورد استفاده قرار نخواهد گرفت."

msgid "While reorganizing, no additional free disk space is required. However, be aware that this factor changes for each :mod:`!dbm` submodule."
msgstr "هنگام بازسازمان‌دهی، هیچ فضای آزاد اضافه‌ای روی دیسک مورد نیاز نیست. بااین‌حال، آگاه باشید که این ضریب برای هر زیرماژول :mod:`!dbm` تغییر می‌کند."

msgid "Synchronize the on-disk directory and data files.  This method is called by the :meth:`shelve.Shelf.sync` method."
msgstr "پوشه و پرونده‌های داده روی دیسک را همگام‌سازی می‌کند. این متد توسط متد :meth:`shelve.Shelf.sync` فراخوانی می‌شود."

msgid "databases"
msgstr "پایگاه‌های داده"