# 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
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-09-16 12:56+0000\n"
"PO-Revision-Date: 2021-06-28 00:49+0000\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"

msgid "Mapping Protocol"
msgstr "پروتکل نگاشت"

msgid "See also :c:func:`PyObject_GetItem`, :c:func:`PyObject_SetItem` and :c:func:`PyObject_DelItem`."
msgstr "همچنین :c:func:`PyObject_GetItem`، :c:func:`PyObject_SetItem` و :c:func:`PyObject_DelItem` را ببینید."

msgid "Return ``1`` if the object provides the mapping protocol or supports slicing, and ``0`` otherwise.  Note that it returns ``1`` for Python classes with a :meth:`~object.__getitem__` method, since in general it is impossible to determine what type of keys the class supports. This function always succeeds."
msgstr "اگر شیء پروتکل نگاشت را فراهم کند یا از اسلایس‌کردن پشتیبانی کند، ``1`` را برمی‌گرداند و در غیر این صورت ``0``. توجه داشته باشید که برای کلاس‌های پایتون دارای متد :meth:`~object.__getitem__` مقدار ``1`` را برمی‌گرداند، زیرا به‌طور کلی تشخیص اینکه کلاس از چه نوع کلیدهایی پشتیبانی می‌کند امکان‌پذیر نیست. این تابع همیشه با موفقیت انجام می‌شود."

msgid "Returns the number of keys in object *o* on success, and ``-1`` on failure. This is equivalent to the Python expression ``len(o)``."
msgstr "در صورت موفقیت، تعداد کلیدهای شیء *o* را برمی‌گرداند و در صورت شکست ``-1``. این معادل عبارت پایتونی ``len(o)`` است."

msgid "This is the same as :c:func:`PyObject_GetItem`, but *key* is specified as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:`PyObject*`."
msgstr "این همان :c:func:`PyObject_GetItem` است، اما *کلید* به‌جای :c:expr:`PyObject*`، به‌صورت یک رشته‌ی بایتِ کدگذاری‌شده با UTF-8 از نوع :c:expr:`const char*` مشخص می‌شود."

msgid "Variant of :c:func:`PyObject_GetItem` which doesn't raise :exc:`KeyError` if the key is not found."
msgstr "گونه‌ای از :c:func:`PyObject_GetItem` که اگر کلید پیدا نشود، استثنای :exc:`KeyError` را ایجاد نمی‌کند."

msgid "If the key is found, return ``1`` and set *\\*result* to a new :term:`strong reference` to the corresponding value. If the key is not found, return ``0`` and set *\\*result* to ``NULL``; the :exc:`KeyError` is silenced. If an error other than :exc:`KeyError` is raised, return ``-1`` and set *\\*result* to ``NULL``."
msgstr "اگر کلید یافت شود، ``1`` را برمی‌گرداند و *\\*result* را روی یک :term:`ارجاع قوی <strong reference>` جدید به مقدار متناظر تنظیم می‌کند. اگر کلید یافت نشود، ``0`` را برمی‌گرداند و *\\*result* را روی ``NULL`` تنظیم می‌کند؛ استثنای :exc:`KeyError` سرکوب می‌شود. اگر خطایی غیر از :exc:`KeyError` رخ دهد، ``-1`` را برمی‌گرداند و *\\*result* را روی ``NULL`` تنظیم می‌کند."

msgid "This is the same as :c:func:`PyMapping_GetOptionalItem`, but *key* is specified as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:`PyObject*`."
msgstr "این همان :c:func:`PyMapping_GetOptionalItem` است، اما *key* به‌صورت یک رشته بایتی کدگذاری‌شده با UTF-8 از نوع :c:expr:`const char*` مشخص می‌شود، نه یک :c:expr:`PyObject*`."

msgid "This is the same as :c:func:`PyObject_SetItem`, but *key* is specified as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:`PyObject*`."
msgstr "این همان :c:func:`PyObject_SetItem` است، اما *key* به‌جای :c:expr:`PyObject*` به‌صورت یک رشته‌ی بایتِ کدگذاری‌شده با UTF-8 از نوع :c:expr:`const char*` مشخص می‌شود."

msgid "This is an alias of :c:func:`PyObject_DelItem`."
msgstr "این یک نام مستعار برای :c:func:`PyObject_DelItem` است."

msgid "This is the same as :c:func:`PyObject_DelItem`, but *key* is specified as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:`PyObject*`."
msgstr "این همان :c:func:`PyObject_DelItem` است، اما *key* به‌صورت یک رشته‌ی بایت‌های کدگذاری‌شده با UTF-8 از نوع :c:expr:`const char*` مشخص می‌شود، نه به‌صورت :c:expr:`PyObject*`."

msgid "Return ``1`` if the mapping object has the key *key* and ``0`` otherwise. This is equivalent to the Python expression ``key in o``. On failure, return ``-1``."
msgstr "اگر شیء نگاشت کلید *key* را داشته باشد ``1`` و در غیر این صورت ``0`` برمی‌گرداند. این معادل عبارت پایتونی ``key in o`` است. در صورت شکست، ``-1`` برمی‌گرداند."

msgid "This is the same as :c:func:`PyMapping_HasKeyWithError`, but *key* is specified as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:`PyObject*`."
msgstr "این همان :c:func:`PyMapping_HasKeyWithError` است، اما *key* به‌عنوان یک رشته‌ی بایتی کدگذاری‌شده با UTF-8 از نوع :c:expr:`const char*` مشخص می‌شود، نه به‌صورت :c:expr:`PyObject*`."

msgid "Return ``1`` if the mapping object has the key *key* and ``0`` otherwise. This is equivalent to the Python expression ``key in o``. This function always succeeds."
msgstr "اگر شیء نگاشت دارای کلید *کلید* باشد، ``1`` و در غیر این صورت ``0`` برمی‌گرداند. این معادل عبارت پایتونی ``key in o`` است. این تابع همیشه با موفقیت اجرا می‌شود."

msgid "Exceptions which occur when this calls the :meth:`~object.__getitem__` method are silently ignored. For proper error handling, use :c:func:`PyMapping_HasKeyWithError`, :c:func:`PyMapping_GetOptionalItem` or :c:func:`PyObject_GetItem()` instead."
msgstr "استثناهایی که هنگام فراخوانی متد :meth:`~object.__getitem__` توسط این تابع رخ می‌دهند، بی‌صدا نادیده گرفته می‌شوند. برای مدیریت صحیح خطاها، به جای آن از :c:func:`PyMapping_HasKeyWithError`، :c:func:`PyMapping_GetOptionalItem` یا :c:func:`PyObject_GetItem()` استفاده کنید."

msgid "This is the same as :c:func:`PyMapping_HasKey`, but *key* is specified as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:`PyObject*`."
msgstr "این همان :c:func:`PyMapping_HasKey` است، با این تفاوت که *key* به‌عنوان یک رشته‌ی بایتی کدگذاری‌شده با UTF-8 از نوع :c:expr:`const char*` مشخص می‌شود، نه یک :c:expr:`PyObject*`."

msgid "Exceptions that occur when this calls the :meth:`~object.__getitem__` method or while creating the temporary :class:`str` object are silently ignored. For proper error handling, use :c:func:`PyMapping_HasKeyStringWithError`, :c:func:`PyMapping_GetOptionalItemString` or :c:func:`PyMapping_GetItemString` instead."
msgstr "استثناهایی که هنگام فراخوانی متد :meth:`~object.__getitem__` یا هنگام ایجاد شیء موقت :class:`str` رخ می‌دهند، بی‌صدا نادیده گرفته می‌شوند. برای مدیریت صحیح خطا، به جای آن از :c:func:`PyMapping_HasKeyStringWithError`، :c:func:`PyMapping_GetOptionalItemString` یا :c:func:`PyMapping_GetItemString` استفاده کنید."

msgid "On success, return a list of the keys in object *o*.  On failure, return ``NULL``."
msgstr "در صورت موفقیت، فهرستی از کلیدهای شیء *o* را برمی‌گرداند. در صورت شکست، ``NULL`` را برمی‌گرداند."

msgid "Previously, the function returned a list or a tuple."
msgstr "پیش‌تر، این تابع یک فهرست یا یک تاپل را برمی‌گرداند."

msgid "On success, return a list of the values in object *o*.  On failure, return ``NULL``."
msgstr "در صورت موفقیت، فهرستی از مقادیر موجود در شیء *o* را برمی‌گرداند.  در صورت شکست، ``NULL`` را برمی‌گرداند."

msgid "On success, return a list of the items in object *o*, where each item is a tuple containing a key-value pair.  On failure, return ``NULL``."
msgstr "در صورت موفقیت، فهرستی از آیتم‌های شیء *o* را برمی‌گرداند که هر آیتم آن، تاپلی حاوی یک جفت کلید-مقدار است. در صورت شکست، ``NULL`` را برمی‌گرداند."

msgid "built-in function"
msgstr "تابع توکار"

msgid "len"
msgstr "len"