"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"Object Protocol"
msgstr"پروتکل شیء"
msgid"Get a :term:`strong reference` to a constant."
msgstr"گرفتن یک :term:`strong reference` به یک ثابت."
msgid"Set an exception and return ``NULL`` if *constant_id* is invalid."
msgstr"اگر *constant_id* نامعتبر باشد، یک استثنا تنظیم شده و ``NULL`` برگردانده می‌شود."
msgid"*constant_id* must be one of these constant identifiers:"
msgstr"*constant_id* باید یکی از این شناسه‌های ثابت باشد:"
msgid"Constant Identifier"
msgstr"شناسه‌ی ثابت"
msgid"Value"
msgstr"مقدار"
msgid"Returned object"
msgstr"شیء بازگردانده‌شده"
msgid"``0``"
msgstr"``0``"
msgid":py:data:`None`"
msgstr":py:data:`None`"
msgid"``1``"
msgstr"``1``"
msgid":py:data:`False`"
msgstr":py:data:`False`"
msgid"``2``"
msgstr"``2``"
msgid":py:data:`True`"
msgstr":py:data:`True`"
msgid"``3``"
msgstr"``3``"
msgid":py:data:`Ellipsis`"
msgstr":py:data:`Ellipsis`"
msgid"``4``"
msgstr"``4``"
msgid":py:data:`NotImplemented`"
msgstr":py:data:`NotImplemented`"
msgid"``5``"
msgstr"``5``"
msgid"``6``"
msgstr"``6``"
msgid"``7``"
msgstr"``7``"
msgid"``''``"
msgstr"``''``"
msgid"``8``"
msgstr"``8``"
msgid"``b''``"
msgstr"``b''``"
msgid"``9``"
msgstr"``9``"
msgid"``()``"
msgstr"``()``"
msgid"Numeric values are only given for projects which cannot use the constant identifiers."
msgstr"مقادیر عددی فقط برای پروژه‌هایی ارائه شده‌اند که نمی‌توانند از شناسه‌های ثابت استفاده کنند."
msgid"In CPython, all of these constants are :term:`immortal`."
msgstr"در سی‌پایتون، همه‌ی این ثابت‌ها :term:`نامیرا <immortal>` هستند."
msgid"Similar to :c:func:`Py_GetConstant`, but return a :term:`borrowed reference`."
msgstr"مشابه :c:func:`Py_GetConstant`، اما یک :term:`ارجاع امانتی <borrowed reference>` برمی‌گرداند."
msgid"This function is primarily intended for backwards compatibility: using :c:func:`Py_GetConstant` is recommended for new code."
msgstr"این تابع عمدتاً برای سازگاری با نسخه‌های قبلی در نظر گرفته شده است: استفاده از :c:func:`Py_GetConstant` برای کد جدید توصیه می‌شود."
msgid"The reference is borrowed from the interpreter, and is valid until the interpreter finalization."
msgstr"این ارجاع از مفسر امانت گرفته شده است و تا زمان نهایی‌سازی مفسر معتبر است."
msgid"The ``NotImplemented`` singleton, used to signal that an operation is not implemented for the given type combination."
msgstr"تک‌نمونه‌ی ``NotImplemented``، که برای اعلام اینکه عملیاتی برای ترکیب مشخصی از نوع‌ها پیاده‌سازی نشده است، استفاده می‌شود."
msgid"Properly handle returning :c:data:`Py_NotImplemented` from within a C function (that is, create a new :term:`strong reference` to :const:`NotImplemented` and return it)."
msgstr"بازگرداندن :c:data:`Py_NotImplemented` از درون یک تابع C را به‌درستی مدیریت کنید (یعنی، یک :term:`strong reference` جدید به :const:`NotImplemented` ایجاد کنید و آن را بازگردانید)."
msgid"Flag to be used with multiple functions that print the object (like :c:func:`PyObject_Print` and :c:func:`PyFile_WriteObject`). If passed, these functions use the :func:`str` of the object instead of the :func:`repr`."
msgstr"پرچمی که همراه چندین تابعِ چاپ‌کننده‌ی شیء استفاده می‌شود (مانند :c:func:`PyObject_Print` و :c:func:`PyFile_WriteObject`). اگر پاس داده شود، این توابع به جای :func:`repr` از :func:`str` شیء استفاده می‌کنند."
msgid"Print an object *o*, on file *fp*. Returns ``-1`` on error. The flags argument is used to enable certain printing options. The only option currently supported is :c:macro:`Py_PRINT_RAW`; if given, the :func:`str` of the object is written instead of the :func:`repr`."
msgstr"شیء *o* را در پرونده *fp* چاپ می‌کند. در صورت خطا ``-1`` را برمی‌گرداند. از آرگومان پرچم‌ها برای فعال‌سازی برخی گزینه‌های چاپ استفاده می‌شود. تنها گزینه‌ای که در حال حاضر پشتیبانی می‌شود :c:macro:`Py_PRINT_RAW` است؛ در صورت ارائه این گزینه، :func:`str` شیء به‌جای :func:`repr` آن نوشته می‌شود."
msgid"Dump an object *op* to ``stderr``. This should only be used for debugging."
msgstr"برون‌ریزی یک شیء *op* در ``stderr``. این مورد فقط باید برای اشکال‌زدایی استفاده شود."
msgid"The output is intended to try dumping objects even after memory corruption:"
msgstr"خروجی به گونه‌ای طراحی شده است که حتی پس از خرابی حافظه نیز سعی در برون‌ریزی اشیاء داشته باشد:"
msgid"Information is written starting with fields that are the least likely to crash when accessed."
msgstr"اطلاعات با فیلدهایی نوشته می‌شوند که هنگام دسترسی، کمتر از همه احتمال دارد دچار فروپاشی شوند."
msgid"This function can be called without an :term:`attached thread state`, but it's not recommended to do so: it can cause deadlocks."
msgstr"این تابع را می‌توان بدون :term:`وضعیت نخ متصل <attached thread state>` فراخوانی کرد، اما انجام این کار توصیه نمی‌شود: می‌تواند باعث ایجاد بن‌بست شود."
msgid"An object that does not belong to the current interpreter may be dumped, but this may also cause crashes or unintended behavior."
msgstr"ممکن است شیء‌ای که متعلق به مفسر فعلی نیست برون‌ریزی شود، اما این کار همچنین ممکن است باعث فروپاشی یا رفتارهای ناخواسته‌ای شود."
msgid"Implement a heuristic to detect if the object memory has been freed. Don't display the object contents in this case, only its memory address."
msgstr"پیاده‌سازی یک روش اکتشافی برای تشخیص اینکه آیا حافظه‌ی شیء آزاد شده است یا خیر. در این صورت محتویات شیء را نمایش ندهید، بلکه فقط آدرس حافظه‌ی آن را نشان دهید."
msgid"The output format may change at any time."
msgstr"قالب خروجی ممکن است در هر زمانی تغییر کند."
msgid"Example of output:"
msgstr"نمونه‌ای از خروجی:"
msgid""
"object address : 0x7f80124702c0\n"
"object refcount : 2\n"
"object type : 0x9902e0\n"
"object type name: str\n"
"object repr : 'abcdef'"
msgstr""
"object address : 0x7f80124702c0\n"
"object refcount : 2\n"
"object type : 0x9902e0\n"
"object type name: str\n"
"object repr : 'abcdef'"
msgid"Returns ``1`` if *o* has the attribute *attr_name*, and ``0`` otherwise. This is equivalent to the Python expression ``hasattr(o, attr_name)``. On failure, return ``-1``."
msgstr"اگر *o* ویژگی *attr_name* را داشته باشد، ``1`` و در غیر این صورت ``0`` برمی‌گرداند. این معادل عبارت پایتونی ``hasattr(o, attr_name)`` است. در صورت شکست، ``-1`` برمی‌گرداند."
msgid"This is the same as :c:func:`PyObject_HasAttrWithError`, but *attr_name* is specified as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:`PyObject*`."
msgstr"این همان :c:func:`PyObject_HasAttrWithError` است، اما *attr_name* به‌جای :c:expr:`PyObject*` به‌صورت یک رشته‌ی بایتی کدگذاری‌شده با UTF-8 از نوع :c:expr:`const char*` مشخص می‌شود."
msgid"Returns ``1`` if *o* has the attribute *attr_name*, and ``0`` otherwise. This function always succeeds."
msgstr"اگر *o* ویژگی *attr_name* را داشته باشد، ``1`` و در غیر این صورت ``0`` برمی‌گرداند. این تابع همیشه با موفقیت انجام می‌شود."
msgid"Exceptions that occur when this calls :meth:`~object.__getattr__` and :meth:`~object.__getattribute__` methods aren't propagated, but instead given to :func:`sys.unraisablehook`. For proper error handling, use :c:func:`PyObject_HasAttrWithError`, :c:func:`PyObject_GetOptionalAttr` or :c:func:`PyObject_GetAttr` instead."
msgstr"استثناهایی که هنگام فراخوانی متدهای :meth:`~object.__getattr__` و :meth:`~object.__getattribute__` توسط این تابع رخ می‌دهند، منتشر نمی‌شوند، بلکه به :func:`sys.unraisablehook` داده می‌شوند. برای مدیریت صحیح خطا، به جای آن از :c:func:`PyObject_HasAttrWithError`، :c:func:`PyObject_GetOptionalAttr` یا :c:func:`PyObject_GetAttr` استفاده کنید."
msgid"This is the same as :c:func:`PyObject_HasAttr`, but *attr_name* is specified as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:`PyObject*`."
msgstr"این همان :c:func:`PyObject_HasAttr` است، اما *attr_name* به‌صورت یک رشته‌ی بایت کدگذاری‌شده با UTF-8 از نوع :c:expr:`const char*` مشخص می‌شود، نه یک :c:expr:`PyObject*`."
msgid"Exceptions that occur when this calls :meth:`~object.__getattr__` and :meth:`~object.__getattribute__` methods or while creating the temporary :class:`str` object are silently ignored. For proper error handling, use :c:func:`PyObject_HasAttrStringWithError`, :c:func:`PyObject_GetOptionalAttrString` or :c:func:`PyObject_GetAttrString` instead."
msgstr"استثناهایی که هنگام فراخوانی متدهای :meth:`~object.__getattr__` و :meth:`~object.__getattribute__` توسط این تابع، یا هنگام ایجاد شیء موقت :class:`str` رخ می‌دهند، به‌صورت بی‌صدا نادیده گرفته می‌شوند. برای مدیریت صحیح خطاها، به‌جای آن از :c:func:`PyObject_HasAttrStringWithError`، :c:func:`PyObject_GetOptionalAttrString` یا :c:func:`PyObject_GetAttrString` استفاده کنید."
msgid"Retrieve an attribute named *attr_name* from object *o*. Returns the attribute value on success, or ``NULL`` on failure. This is the equivalent of the Python expression ``o.attr_name``."
msgstr"یک ویژگی با نام *attr_name* را از شیء *o* بازیابی می‌کند. در صورت موفقیت، مقدار ویژگی و در صورت شکست، ``NULL`` را برمی‌گرداند. این معادل عبارت پایتونی ``o.attr_name`` است."
msgid"If the missing attribute should not be treated as a failure, you can use :c:func:`PyObject_GetOptionalAttr` instead."
msgstr"اگر نبود ویژگی نباید به‌عنوان شکست تلقی شود، می‌توانید به‌جای آن از :c:func:`PyObject_GetOptionalAttr` استفاده کنید."
msgid"This is the same as :c:func:`PyObject_GetAttr`, but *attr_name* is specified as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:`PyObject*`."
msgstr"این همان :c:func:`PyObject_GetAttr` است، اما *attr_name* به‌جای :c:expr:`PyObject*` به‌صورت یک رشته‌ی بایتِ کدگذاری‌شده با UTF-8 از نوع :c:expr:`const char*` مشخص می‌شود."
msgid"If the missing attribute should not be treated as a failure, you can use :c:func:`PyObject_GetOptionalAttrString` instead."
msgstr"اگر ویژگی مفقود نباید به‌عنوان شکست در نظر گرفته شود، می‌توانید به جای آن از :c:func:`PyObject_GetOptionalAttrString` استفاده کنید."
msgid"Variant of :c:func:`PyObject_GetAttr` which doesn't raise :exc:`AttributeError` if the attribute is not found."
msgstr"گونه‌ای از :c:func:`PyObject_GetAttr` که اگر ویژگی پیدا نشود، استثنای :exc:`AttributeError` را ایجاد نمی‌کند."
msgid"If the attribute is found, return ``1`` and set *\\*result* to a new :term:`strong reference` to the attribute. If the attribute is not found, return ``0`` and set *\\*result* to ``NULL``; the :exc:`AttributeError` is silenced. If an error other than :exc:`AttributeError` is raised, return ``-1`` and set *\\*result* to ``NULL``."
msgstr"اگر ویژگی یافت شود، ``1`` برگردانده می‌شود و *\\*result* روی یک :term:`ارجاع قوی <strong reference>` جدید به ویژگی تنظیم می‌شود. اگر ویژگی یافت نشود، ``0`` برگردانده می‌شود و *\\*result* روی ``NULL`` تنظیم می‌شود؛ استثنای :exc:`AttributeError` سرکوب می‌شود. اگر خطایی غیر از :exc:`AttributeError` مطرح شود، ``-1`` برگردانده می‌شود و *\\*result* روی ``NULL`` تنظیم می‌شود."
msgid"This is the same as :c:func:`PyObject_GetOptionalAttr`, but *attr_name* is specified as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:`PyObject*`."
msgstr"این همان :c:func:`PyObject_GetOptionalAttr` است، اما *attr_name* به‌عنوان یک رشته‌ی بایتی کدگذاری‌شده با UTF-8 از نوع :c:expr:`const char*` مشخص می‌شود، نه یک :c:expr:`PyObject*`."
msgid"Generic attribute getter function that is meant to be put into a type object's ``tp_getattro`` slot. It looks for a descriptor in the dictionary of classes in the object's MRO as well as an attribute in the object's :attr:`~object.__dict__` (if present). As outlined in :ref:`descriptors`, data descriptors take preference over instance attributes, while non-data descriptors don't. Otherwise, an :exc:`AttributeError` is raised."
msgstr"تابع عمومیِ getter ویژگی که قرار است در جایگاه ``tp_getattro`` شیء نوع قرار گیرد. این تابع به‌دنبال یک توصیف‌گر در فرهنگ‌لغت کلاس‌های موجود در MRO شیء، و همچنین یک ویژگی در :attr:`~object.__dict__` شیء (در صورت وجود) می‌گردد. همان‌طور که در :ref:`descriptors` توضیح داده شده است، توصیف‌گرهای داده‌ای نسبت به ویژگی‌های نمونه اولویت دارند، در حالی که توصیف‌گرهای غیر داده‌ای چنین اولویتی ندارند. در غیر این صورت، یک :exc:`AttributeError` ایجاد می‌شود."
msgid"Set the value of the attribute named *attr_name*, for object *o*, to the value *v*. Raise an exception and return ``-1`` on failure; return ``0`` on success. This is the equivalent of the Python statement ``o.attr_name = v``."
msgstr"مقدار ویژگی‌ای با نام *attr_name* را برای شیء *o* به مقدار *v* تنظیم می‌کند. در صورت شکست، یک استثنا ایجاد می‌کند و ``-1`` را برمی‌گرداند؛ در صورت موفقیت ``0`` را برمی‌گرداند. این معادل دستور ``o.attr_name = v`` در پایتون است."
msgid"If *v* is ``NULL``, the attribute is deleted. This behaviour is deprecated in favour of using :c:func:`PyObject_DelAttr`, but there are currently no plans to remove it."
msgstr"اگر *v* برابر ``NULL`` باشد، ویژگی حذف می‌شود. این رفتار به نفع استفاده از :c:func:`PyObject_DelAttr` منسوخ شده است، اما در حال حاضر هیچ برنامه‌ای برای حذف آن وجود ندارد."
msgid"The function must not be called with a ``NULL`` *v* and an exception set. This case can arise from forgetting ``NULL`` checks and would delete the attribute."
msgstr"این تابع نباید با یک ``NULL`` *v* و در حالی که استثنایی تنظیم شده است، فراخوانی شود. این حالت می‌تواند ناشی از فراموش کردن بررسی‌های ``NULL`` باشد و باعث حذف ویژگی می‌شود."
msgid"Must not be called with NULL value if an exception is set."
msgstr"اگر استثنایی تنظیم شده باشد، نباید با مقدار NULL فراخوانی شود."
msgid"This is the same as :c:func:`PyObject_SetAttr`, but *attr_name* is specified as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:`PyObject*`."
msgstr"این همان :c:func:`PyObject_SetAttr` است، اما *attr_name* به‌صورت یک رشته‌ی بایتِ کدگذاری‌شده با UTF-8 از نوع :c:expr:`const char*` مشخص می‌شود، نه :c:expr:`PyObject*`."
msgid"If *v* is ``NULL``, the attribute is deleted, but this feature is deprecated in favour of using :c:func:`PyObject_DelAttrString`."
msgstr"اگر *v* برابر ``NULL`` باشد، ویژگی حذف می‌شود، اما این قابلیت به نفع استفاده از :c:func:`PyObject_DelAttrString` منسوخ شده است."
msgid"The number of different attribute names passed to this function should be kept small, usually by using a statically allocated string as *attr_name*. For attribute names that aren't known at compile time, prefer calling :c:func:`PyUnicode_FromString` and :c:func:`PyObject_SetAttr` directly. For more details, see :c:func:`PyUnicode_InternFromString`, which may be used internally to create a key object."
msgstr"تعداد نام‌های ویژگی متفاوتی که به این تابع ارسال می‌شوند باید کم نگه داشته شود؛ این کار معمولاً با استفاده از یک رشته با تخصیص ایستا به‌عنوان *attr_name* انجام می‌شود. برای نام‌های ویژگی که در زمان کامپایل مشخص نیستند، ترجیح دهید :c:func:`PyUnicode_FromString` و :c:func:`PyObject_SetAttr` را مستقیماً فراخوانی کنید. برای جزئیات بیشتر، :c:func:`PyUnicode_InternFromString` را ببینید که ممکن است به‌صورت داخلی برای ایجاد یک شیء کلید استفاده شود."
msgid"Generic attribute setter and deleter function that is meant to be put into a type object's :c:member:`~PyTypeObject.tp_setattro` slot. It looks for a data descriptor in the dictionary of classes in the object's MRO, and if found it takes preference over setting or deleting the attribute in the instance dictionary. Otherwise, the attribute is set or deleted in the object's :attr:`~object.__dict__` (if present). On success, ``0`` is returned, otherwise an :exc:`AttributeError` is raised and ``-1`` is returned."
msgstr"تابع عمومی setter و deleter ویژگی که برای قرار گرفتن در جایگاه :c:member:`~PyTypeObject.tp_setattro` از یک شیء نوع در نظر گرفته شده است. این تابع به دنبال یک توصیف‌گر داده در دیکشنری کلاس‌های موجود در MRO شیء می‌گردد و در صورت یافته شدن، آن نسبت به تنظیم یا حذف ویژگی در دیکشنری نمونه اولویت دارد. در غیر این صورت، ویژگی در :attr:`~object.__dict__` شیء (در صورت وجود) تنظیم یا حذف می‌شود. در صورت موفقیت، ``0`` برگردانده می‌شود؛ در غیر این صورت، :exc:`AttributeError` مطرح می‌شود و ``-1`` برگردانده می‌شود."
msgid"Delete attribute named *attr_name*, for object *o*. Returns ``-1`` on failure. This is the equivalent of the Python statement ``del o.attr_name``."
msgstr"ویژگی به نام *attr_name* را از شیء *o* حذف می‌کند. در صورت شکست ``-1`` برمی‌گرداند. این معادل دستور ``del o.attr_name`` در پایتون است."
msgid"This is the same as :c:func:`PyObject_DelAttr`, but *attr_name* is specified as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:`PyObject*`."
msgstr"این همان :c:func:`PyObject_DelAttr` است، اما *attr_name* به‌صورت یک رشته بایتی کدگذاری‌شده با UTF-8 از نوع :c:expr:`const char*` مشخص می‌شود، نه به‌صورت یک :c:expr:`PyObject*`."
msgid"The number of different attribute names passed to this function should be kept small, usually by using a statically allocated string as *attr_name*. For attribute names that aren't known at compile time, prefer calling :c:func:`PyUnicode_FromString` and :c:func:`PyObject_DelAttr` directly. For more details, see :c:func:`PyUnicode_InternFromString`, which may be used internally to create a key object for lookup."
msgstr"تعداد نام‌های ویژگی متفاوتی که به این تابع پاس داده می‌شوند باید کم نگه داشته شود؛ این کار معمولاً با استفاده از یک رشته تخصیص‌یافته به‌صورت ایستا به‌عنوان *attr_name* انجام می‌شود. برای نام‌های ویژگی که در زمان کامپایل شناخته نمی‌شوند، ترجیح دهید :c:func:`PyUnicode_FromString` و :c:func:`PyObject_DelAttr` را مستقیماً فراخوانی کنید. برای جزئیات بیشتر، :c:func:`PyUnicode_InternFromString` را ببینید که ممکن است به‌صورت داخلی برای ایجاد یک شیء کلید جهت جستجو استفاده شود."
msgid"A generic implementation for the getter of a ``__dict__`` descriptor. It creates the dictionary if necessary."
msgstr"پیاده‌سازی عام برای getter توصیف‌گر ``__dict__``. در صورت نیاز، دیکشنری را ایجاد می‌کند."
msgid"This function may also be called to get the :py:attr:`~object.__dict__` of the object *o*. Pass ``NULL`` for *context* when calling it. Since this function may need to allocate memory for the dictionary, it may be more efficient to call :c:func:`PyObject_GetAttr` when accessing an attribute on the object."
msgstr"برای گرفتن :py:attr:`~object.__dict__` شیء *o* نیز می‌توان این تابع را فراخوانی کرد. هنگام فراخوانی آن، مقدار ``NULL`` را برای *context* ارسال کنید. از آنجا که این تابع ممکن است برای دیکشنری به تخصیص حافظه نیاز داشته باشد، هنگام دسترسی به یک ویژگی بر روی شیء، ممکن است فراخوانی :c:func:`PyObject_GetAttr` کارآمدتر باشد."
msgid"On failure, returns ``NULL`` with an exception set."
msgstr"در صورت شکست، ``NULL`` را همراه با یک استثنای تنظیم‌شده برمی‌گرداند."
msgid"A generic implementation for the setter of a ``__dict__`` descriptor. This implementation does not allow the dictionary to be deleted."
msgstr"پیاده‌سازی عام برای setter یک توصیف‌گر ``__dict__``. این پیاده‌سازی اجازه حذف دیکشنری را نمی‌دهد."
msgid"Return a pointer to :py:attr:`~object.__dict__` of the object *obj*. If there is no ``__dict__``, return ``NULL`` without setting an exception."
msgstr"اشاره‌گر به :py:attr:`~object.__dict__` شیء *obj* را بازمی‌گرداند. اگر ``__dict__`` وجود نداشته باشد، ``NULL`` را بدون تنظیم استثنا بازمی‌گرداند."
msgid"This function may need to allocate memory for the dictionary, so it may be more efficient to call :c:func:`PyObject_GetAttr` when accessing an attribute on the object."
msgstr"این تابع ممکن است نیاز به تخصیص حافظه برای دیکشنری داشته باشد، بنابراین ممکن است هنگام دسترسی به یک ویژگی بر روی شیء، فراخوانی :c:func:`PyObject_GetAttr` کارآمدتر باشد."
msgid"Compare the values of *o1* and *o2* using the operation specified by *opid*, which must be one of :c:macro:`Py_LT`, :c:macro:`Py_LE`, :c:macro:`Py_EQ`, :c:macro:`Py_NE`, :c:macro:`Py_GT`, or :c:macro:`Py_GE`, corresponding to ``<``, ``<=``, ``==``, ``!=``, ``>``, or ``>=`` respectively. This is the equivalent of the Python expression ``o1 op o2``, where ``op`` is the operator corresponding to *opid*. Returns the value of the comparison on success, or ``NULL`` on failure."
msgstr"مقادیر *o1* و *o2* را با استفاده از عملیات مشخص‌شده توسط *opid* مقایسه می‌کند، که باید یکی از :c:macro:`Py_LT`، :c:macro:`Py_LE`، :c:macro:`Py_EQ`، :c:macro:`Py_NE`، :c:macro:`Py_GT` یا :c:macro:`Py_GE` باشد که به‌ترتیب متناظر با ``<``، ``<=``، ``==``، ``!=``، ``>`` یا ``>=`` هستند. این معادل عبارت پایتونی ``o1 op o2`` است، که در آن ``op`` عملگر متناظر با *opid* است. در صورت موفقیت مقدار مقایسه و در صورت شکست ``NULL`` را برمی‌گرداند."
msgid"Compare the values of *o1* and *o2* using the operation specified by *opid*, like :c:func:`PyObject_RichCompare`, but returns ``-1`` on error, ``0`` if the result is false, ``1`` otherwise."
msgstr"مقادیر *o1* و *o2* را با استفاده از عملیات مشخص‌شده توسط *opid* مقایسه می‌کند، مانند :c:func:`PyObject_RichCompare`، اما در صورت خطا ``-1``، اگر نتیجه نادرست باشد ``0`` و در غیر این صورت ``1`` برمی‌گرداند."
msgid"If *o1* and *o2* are the same object, :c:func:`PyObject_RichCompareBool` will always return ``1`` for :c:macro:`Py_EQ` and ``0`` for :c:macro:`Py_NE`."
msgstr"اگر *o1* و *o2* یک شیء واحد باشند، :c:func:`PyObject_RichCompareBool` همیشه برای :c:macro:`Py_EQ` مقدار ``1`` و برای :c:macro:`Py_NE` مقدار ``0`` را برمی‌گرداند."
msgid"Format *obj* using *format_spec*. This is equivalent to the Python expression ``format(obj, format_spec)``."
msgstr"*obj* را با استفاده از *format_spec* قالب‌بندی می‌کند. این معادل عبارت پایتونی ``format(obj, format_spec)`` است."
msgid"*format_spec* may be ``NULL``. In this case the call is equivalent to ``format(obj)``. Returns the formatted string on success, ``NULL`` on failure."
msgstr"*format_spec* ممکن است ``NULL`` باشد. در این حالت، این فراخوانی معادل ``format(obj)`` است. در صورت موفقیت، رشته قالب‌بندی‌شده و در صورت شکست ``NULL`` را برمی‌گرداند."
msgid"Compute a string representation of object *o*. Returns the string representation on success, ``NULL`` on failure. This is the equivalent of the Python expression ``repr(o)``. Called by the :func:`repr` built-in function."
msgstr"نمایش رشته‌ای شیء *o* را محاسبه می‌کند. در صورت موفقیت نمایش رشته‌ای و در صورت شکست ``NULL`` برمی‌گرداند. این معادل عبارت پایتونی ``repr(o)`` است. توسط تابع توکار :func:`repr` فراخوانی می‌شود."
msgid"If argument is ``NULL``, return the string ``'<NULL>'``."
msgstr"اگر آرگومان ``NULL`` باشد، رشته‌ی ``'<NULL>'`` را برمی‌گرداند."
msgid"This function now includes a debug assertion to help ensure that it does not silently discard an active exception."
msgstr"این تابع اکنون شامل یک ادعای اشکال‌زدایی است تا کمک کند اطمینان حاصل شود که استثنای فعال به‌صورت بی‌صدا دور انداخته نمی‌شود."
msgid"As :c:func:`PyObject_Repr`, compute a string representation of object *o*, but escape the non-ASCII characters in the string returned by :c:func:`PyObject_Repr` with ``\\x``, ``\\u`` or ``\\U`` escapes. This generates a string similar to that returned by :c:func:`PyObject_Repr` in Python 2. Called by the :func:`ascii` built-in function."
msgstr"مانند :c:func:`PyObject_Repr`، بازنمایی رشته‌ای از شیء *o* را محاسبه می‌کند، اما نویسه‌های غیراسکی در رشته‌ای که :c:func:`PyObject_Repr` برمی‌گرداند را با گریزهای ``\\x``، ``\\u`` یا ``\\U`` خنثی می‌کند. این کار رشته‌ای مشابه آنچه :c:func:`PyObject_Repr` در پایتون 2 برمی‌گرداند تولید می‌کند. توسط تابع توکار :func:`ascii` فراخوانی می‌شود."
msgid"Compute a string representation of object *o*. Returns the string representation on success, ``NULL`` on failure. This is the equivalent of the Python expression ``str(o)``. Called by the :func:`str` built-in function and, therefore, by the :func:`print` function."
msgstr"نمایش رشته‌ای شیء *o* را محاسبه می‌کند. در صورت موفقیت، نمایش رشته‌ای را برمی‌گرداند و در صورت شکست، ``NULL`` را. این معادل عبارت پایتونی ``str(o)`` است. این تابع توسط تابع توکار :func:`str` و در نتیجه توسط تابع :func:`print` فراخوانی می‌شود."
msgid"Compute a bytes representation of object *o*. ``NULL`` is returned on failure and a bytes object on success. This is equivalent to the Python expression ``bytes(o)``, when *o* is not an integer. Unlike ``bytes(o)``, a TypeError is raised when *o* is an integer instead of a zero-initialized bytes object."
msgstr"یک نمایش بایتی از شیء *o* را محاسبه می‌کند. در صورت شکست ``NULL`` و در صورت موفقیت یک شیء بایت بازگردانده می‌شود. این کار معادل عبارت پایتونی ``bytes(o)`` است، هنگامی که *o* عدد صحیح نباشد. برخلاف ``bytes(o)``، هنگامی که *o* عدد صحیح باشد، به‌جای یک شیء بایتِ مقداردهی‌شده با صفر، استثنای TypeError ایجاد می‌شود."
msgid"If argument is ``NULL``, return the :class:`bytes` object ``b'<NULL>'``."
msgstr"اگر آرگومان ``NULL`` باشد، شیء :class:`bytes` یعنی ``b'<NULL>'`` را بازمی‌گرداند."
msgid"Return ``1`` if the class *derived* is identical to or derived from the class *cls*, otherwise return ``0``. In case of an error, return ``-1``."
msgstr"اگر کلاس *derived* با کلاس *cls* یکسان باشد یا از آن مشتق‌شده باشد، ``1`` را برمی‌گرداند؛ در غیر این صورت ``0`` را برمی‌گرداند. در صورت خطا، ``-1`` را برمی‌گرداند."
msgid"If *cls* is a tuple, the check will be done against every entry in *cls*. The result will be ``1`` when at least one of the checks returns ``1``, otherwise it will be ``0``."
msgstr"اگر *cls* یک تاپل باشد، بررسی نسبت به هر یک از ورودی‌های *cls* انجام می‌شود. نتیجه ``1`` خواهد بود اگر حداقل یکی از بررسی‌ها ``1`` برگرداند، در غیر این صورت ``0`` خواهد بود."
msgid"If *cls* has a :meth:`~type.__subclasscheck__` method, it will be called to determine the subclass status as described in :pep:`3119`. Otherwise, *derived* is a subclass of *cls* if it is a direct or indirect subclass, i.e. contained in :attr:`cls.__mro__ <type.__mro__>`."
msgstr"اگر *cls* دارای متد :meth:`~type.__subclasscheck__` باشد، این متد برای تعیین وضعیت زیرکلاس بودن، همان‌گونه که در :pep:`3119` توصیف شده است، فراخوانی می‌شود. در غیر این صورت، *derived* در صورتی زیرکلاس *cls* است که زیرکلاس مستقیم یا غیرمستقیم آن باشد؛ یعنی در :attr:`cls.__mro__ <type.__mro__>` قرار داشته باشد."
msgid"Normally only class objects, i.e. instances of :class:`type` or a derived class, are considered classes. However, objects can override this by having a :attr:`~type.__bases__` attribute (which must be a tuple of base classes)."
msgstr"معمولاً فقط اشیاء کلاس، یعنی نمونه‌های :class:`type` یا یک کلاس مشتق‌شده، به عنوان کلاس در نظر گرفته می‌شوند. اما اشیاء می‌توانند با داشتن ویژگی :attr:`~type.__bases__` (که باید تاپلی از کلاس‌های پایه باشد) این موضوع را لغو کنند."
msgid"Return ``1`` if *inst* is an instance of the class *cls* or a subclass of *cls*, or ``0`` if not. On error, returns ``-1`` and sets an exception."
msgstr"اگر *inst* نمونه‌ای از کلاس *cls* یا زیرکلاسی از *cls* باشد، ``1`` را برمی‌گرداند و در غیر این صورت ``0`` را برمی‌گرداند. در صورت خطا، ``-1`` را برمی‌گرداند و یک استثنا تنظیم می‌کند."
msgid"If *cls* has a :meth:`~type.__instancecheck__` method, it will be called to determine the subclass status as described in :pep:`3119`. Otherwise, *inst* is an instance of *cls* if its class is a subclass of *cls*."
msgstr"اگر *cls* متد :meth:`~type.__instancecheck__` را داشته باشد، این متد برای تعیین وضعیت زیرکلاس بودن، همان‌طور که در :pep:`3119` توضیح داده شده است، فراخوانی می‌شود. در غیر این صورت، *inst* در صورتی نمونه‌ای از *cls* است که کلاس آن زیرکلاسی از *cls* باشد."
msgid"An instance *inst* can override what is considered its class by having a :attr:`~object.__class__` attribute."
msgstr"یک نمونه *inst* می‌تواند با داشتن ویژگی :attr:`~object.__class__`، آنچه را که به‌عنوان کلاس آن در نظر گرفته می‌شود بازنویسی کند."
msgid"An object *cls* can override if it is considered a class, and what its base classes are, by having a :attr:`~type.__bases__` attribute (which must be a tuple of base classes)."
msgstr"یک شیء *cls* می‌تواند با داشتن ویژگی :attr:`~type.__bases__` (که باید تاپلی از کلاس‌های پایه باشد) بازنویسی کند که آیا به‌عنوان کلاس در نظر گرفته می‌شود، و کلاس‌های پایه‌اش چه هستند."
msgid"Compute and return the hash value of an object *o*. On failure, return ``-1``. This is the equivalent of the Python expression ``hash(o)``."
msgstr"مقدار هش یک شیء *o* را محاسبه کرده و برمی‌گرداند. در صورت شکست، ``-1`` برمی‌گرداند. این معادل عبارت پایتونی ``hash(o)`` است."
msgid"The return type is now Py_hash_t. This is a signed integer the same size as :c:type:`Py_ssize_t`."
msgstr"نوع بازگشتی اکنون Py_hash_t است. این یک عدد صحیح علامت‌دار هم‌اندازه با :c:type:`Py_ssize_t` است."
msgid"Set a :exc:`TypeError` indicating that ``type(o)`` is not :term:`hashable` and return ``-1``. This function receives special treatment when stored in a ``tp_hash`` slot, allowing a type to explicitly indicate to the interpreter that it is not hashable."
msgstr"یک :exc:`TypeError` تنظیم می‌کند که نشان می‌دهد ``type(o)`` :term:`hashable` نیست و ``-1`` را برمی‌گرداند. این تابع هنگامی که در جایگاه ``tp_hash`` ذخیره شود، مورد رفتار ویژه‌ای قرار می‌گیرد و به یک نوع اجازه می‌دهد به‌طور صریح به مفسر نشان دهد که هش‌پذیر نیست."
msgid"Returns ``1`` if the object *o* is considered to be true, and ``0`` otherwise. This is equivalent to the Python expression ``not not o``. On failure, return ``-1``."
msgstr"اگر شیء *o* درست در نظر گرفته شود، ``1`` و در غیر این صورت ``0`` را برمی‌گرداند. این معادل عبارت ``not not o`` در پایتون است. در صورت شکست، ``-1`` را برمی‌گرداند."
msgid"Returns ``0`` if the object *o* is considered to be true, and ``1`` otherwise. This is equivalent to the Python expression ``not o``. On failure, return ``-1``."
msgstr"اگر شیء *o* درست در نظر گرفته شود، ``0`` و در غیر این صورت ``1`` را برمی‌گرداند. این معادل عبارت پایتونی ``not o`` است. در صورت شکست، ``-1`` برمی‌گرداند."
msgid"When *o* is non-``NULL``, returns a type object corresponding to the object type of object *o*. On failure, raises :exc:`SystemError` and returns ``NULL``. This is equivalent to the Python expression ``type(o)``. This function creates a new :term:`strong reference` to the return value. There's really no reason to use this function instead of the :c:func:`Py_TYPE()` function, which returns a pointer of type :c:expr:`PyTypeObject*`, except when a new :term:`strong reference` is needed."
msgstr"وقتی *o* برابر ``NULL`` نباشد، شیء نوعی متناظر با نوع شیءِ *o* برمی‌گرداند. در صورت شکست، استثنای :exc:`SystemError` را ایجاد می‌کند و ``NULL`` را برمی‌گرداند. این معادل عبارت پایتونی ``type(o)`` است. این تابع یک :term:`ارجاع قوی <strong reference>` جدید به مقدار بازگشتی ایجاد می‌کند. واقعاً هیچ دلیلی برای استفاده از این تابع به‌جای تابع :c:func:`Py_TYPE()` که اشاره‌گری از نوع :c:expr:`PyTypeObject*` برمی‌گرداند وجود ندارد، مگر زمانی که به یک :term:`ارجاع قوی <strong reference>` جدید نیاز باشد."
msgid"Return non-zero if the object *o* is of type *type* or a subtype of *type*, and ``0`` otherwise. Both parameters must be non-``NULL``."
msgstr"اگر شیء *o* از نوع *type* یا زیرنوعی از *type* باشد، مقدار ناصفر و در غیر این صورت ``0`` برمی‌گرداند. هر دو پارامتر باید غیر ``NULL`` باشند."
msgid"Return the length of object *o*. If the object *o* provides either the sequence and mapping protocols, the sequence length is returned. On error, ``-1`` is returned. This is the equivalent to the Python expression ``len(o)``."
msgstr"طول شیء *o* را برمی‌گرداند. اگر شیء *o* هر یک از پروتکل‌های دنباله و نگاشت را فراهم کند، طول دنباله برگردانده می‌شود. در صورت خطا، ``-1`` برگردانده می‌شود. این معادل عبارت پایتونی ``len(o)`` است."
msgid"Return an estimated length for the object *o*. First try to return its actual length, then an estimate using :meth:`~object.__length_hint__`, and finally return the default value. On error return ``-1``. This is the equivalent to the Python expression ``operator.length_hint(o, defaultvalue)``."
msgstr"طول تخمینی شیء *o* را برمی‌گرداند. ابتدا تلاش می‌کند طول واقعی آن را برگرداند، سپس تخمینی با استفاده از :meth:`~object.__length_hint__` و در نهایت مقدار پیش‌فرض را برمی‌گرداند. در صورت خطا ``-1`` را برمی‌گرداند. این معادل عبارت پایتون ``operator.length_hint(o, defaultvalue)`` است."
msgid"Return element of *o* corresponding to the object *key* or ``NULL`` on failure. This is the equivalent of the Python expression ``o[key]``."
msgstr"عنصر *o* متناظر با شیء *key* را برمی‌گرداند، یا در صورت شکست ``NULL`` برمی‌گرداند. این معادل عبارت پایتون ``o[key]`` است."
msgid"Map the object *key* to the value *v*. Raise an exception and return ``-1`` on failure; return ``0`` on success. This is the equivalent of the Python statement ``o[key] = v``. This function *does not* steal a reference to *v*."
msgstr"شیء *key* را به مقدار *v* نگاشت می‌کند. در صورت شکست، یک استثنا ایجاد می‌کند و ``-1`` را برمی‌گرداند؛ در صورت موفقیت ``0`` را برمی‌گرداند. این کار معادل دستور پایتونی ``o[key] = v`` است. این تابع ارجاعی به *v* را *نمی‌دزدد*."
msgid"Remove the mapping for the object *key* from the object *o*. Return ``-1`` on failure. This is equivalent to the Python statement ``del o[key]``."
msgstr"نگاشت مربوط به شیء *key* را از شیء *o* حذف می‌کند. در صورت شکست ``-1`` برمی‌گرداند. این کار معادل دستور ``del o[key]`` در پایتون است."
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* به‌جای یک :c:expr:`PyObject*`، به‌صورت یک رشته بایتی کدگذاری‌شده با UTF-8 از نوع :c:expr:`const char*` مشخص می‌شود."
msgid"This is equivalent to the Python expression ``dir(o)``, returning a (possibly empty) list of strings appropriate for the object argument, or ``NULL`` if there was an error. If the argument is ``NULL``, this is like the Python ``dir()``, returning the names of the current locals; in this case, if no execution frame is active then ``NULL`` is returned but :c:func:`PyErr_Occurred` will return false."
msgstr"این معادل عبارت پایتونی ``dir(o)`` است که فهرستی (احتمالاً خالی) از رشته‌های مناسب برای آرگومان شیء برمی‌گرداند، یا اگر خطایی رخ داده باشد، ``NULL`` برمی‌گرداند. اگر آرگومان ``NULL`` باشد، این مانند ``dir()`` پایتون عمل می‌کند و نام‌های متغیرهای محلی فعلی را برمی‌گرداند؛ در این حالت، اگر هیچ فریم اجرا (execution frame) فعالی وجود نداشته باشد، ``NULL`` برگردانده می‌شود، اما :c:func:`PyErr_Occurred` مقدار false را برمی‌گرداند."
msgid"This is equivalent to the Python expression ``iter(o)``. It returns a new iterator for the object argument, or the object itself if the object is already an iterator. Raises :exc:`TypeError` and returns ``NULL`` if the object cannot be iterated."
msgstr"این معادل عبارت پایتونی ``iter(o)`` است. یک پیمایش‌گر جدید برای آرگومان شیء برمی‌گرداند، یا اگر شیء از قبل یک پیمایش‌گر باشد، خودِ شیء را برمی‌گرداند. اگر شیء پیمایش‌پذیر نباشد، استثنای :exc:`TypeError` را مطرح می‌کند و ``NULL`` برمی‌گرداند."
msgid"This is equivalent to the Python ``__iter__(self): return self`` method. It is intended for :term:`iterator` types, to be used in the :c:member:`PyTypeObject.tp_iter` slot."
msgstr"این معادل متد ``__iter__(self): return self`` در پایتون است. این برای نوع‌های :term:`iterator` در نظر گرفته شده است تا در جایگاه :c:member:`PyTypeObject.tp_iter` استفاده شود."
msgid"This is the equivalent to the Python expression ``aiter(o)``. Takes an :class:`AsyncIterable` object and returns an :class:`AsyncIterator` for it. This is typically a new iterator but if the argument is an :class:`AsyncIterator`, this returns itself. Raises :exc:`TypeError` and returns ``NULL`` if the object cannot be iterated."
msgstr"این معادل عبارت پایتونی ``aiter(o)`` است. یک شیء :class:`AsyncIterable` می‌گیرد و یک :class:`AsyncIterator` برای آن برمی‌گرداند. این معمولاً یک پیمایش‌گر جدید است، اما اگر آرگومان یک :class:`AsyncIterator` باشد، خودِ آن بازگردانده می‌شود. اگر شیء قابل پیمایش نباشد، خطای :exc:`TypeError` ایجاد می‌کند و ``NULL`` را برمی‌گرداند."
msgid"Get a pointer to subclass-specific data reserved for *cls*."
msgstr"یک اشاره‌گر به داده‌های اختصاصی زیرکلاس که برای *cls* رزرو شده‌اند را دریافت کنید."
msgid"The object *o* must be an instance of *cls*, and *cls* must have been created using negative :c:member:`PyType_Spec.basicsize`. Python does not check this."
msgstr"شیء *o* باید نمونه‌ای از *cls* باشد و *cls* باید با استفاده از :c:member:`PyType_Spec.basicsize` منفی ایجاد شده باشد. پایتون این موضوع را بررسی نمی‌کند."
msgid"On error, set an exception and return ``NULL``."
msgstr"در صورت خطا، یک استثنا تنظیم کنید و ``NULL`` را برگردانید."
msgid"Return the size of the instance memory space reserved for *cls*, i.e. the size of the memory :c:func:`PyObject_GetTypeData` returns."
msgstr"اندازه‌ی فضای حافظه‌ی نمونه‌ی رزرو‌شده برای *cls* را بازمی‌گرداند، یعنی اندازه‌ی حافظه‌ای که :c:func:`PyObject_GetTypeData` بازمی‌گرداند."
msgid"This may be larger than requested using :c:member:`-PyType_Spec.basicsize <PyType_Spec.basicsize>`; it is safe to use this larger size (e.g. with :c:func:`!memset`)."
msgstr"این اندازه ممکن است بزرگ‌تر از مقدار درخواست‌شده با استفاده از :c:member:`-PyType_Spec.basicsize <PyType_Spec.basicsize>` باشد؛ استفاده از این اندازه‌ی بزرگ‌تر ایمن است (مثلاً با :c:func:`!memset`)."
msgid"The type *cls* **must** have been created using negative :c:member:`PyType_Spec.basicsize`. Python does not check this."
msgstr"نوع *cls* **باید** با استفاده از :c:member:`PyType_Spec.basicsize` منفی ایجاد شده باشد. پایتون این را بررسی نمی‌کند."
msgid"On error, set an exception and return a negative value."
msgstr"در صورت خطا، یک استثنا تنظیم و مقدار منفی برگردانده می‌شود."
msgid"Get a pointer to per-item data for a class with :c:macro:`Py_TPFLAGS_ITEMS_AT_END`."
msgstr"گرفتن اشاره‌گر به داده‌های هر آیتم برای کلاسی با :c:macro:`Py_TPFLAGS_ITEMS_AT_END`."
msgid"On error, set an exception and return ``NULL``. :py:exc:`TypeError` is raised if *o* does not have :c:macro:`Py_TPFLAGS_ITEMS_AT_END` set."
msgstr"در صورت خطا، یک استثنا تنظیم کرده و ``NULL`` را برگردانید. استثنای :py:exc:`TypeError` در صورتی ایجاد می‌شود که پرچم :c:macro:`Py_TPFLAGS_ITEMS_AT_END` روی *o* تنظیم نشده باشد."
msgid"Visit the managed dictionary of *obj*."
msgstr"دیکشنری مدیریت‌شده‌ی *obj* را بازدید می‌کند."
msgid"This function must only be called in a traverse function of the type which has the :c:macro:`Py_TPFLAGS_MANAGED_DICT` flag set."
msgstr"این تابع باید فقط در تابع پیمایش نوعی فراخوانی شود که پرچم :c:macro:`Py_TPFLAGS_MANAGED_DICT` روی آن تنظیم شده باشد."
msgid"Clear the managed dictionary of *obj*."
msgstr"دیکشنری مدیریت‌شده‌ی *obj* را پاک کنید."
msgid"This function must only be called in a clear function of the type which has the :c:macro:`Py_TPFLAGS_MANAGED_DICT` flag set."
msgstr"این تابع باید فقط در تابع پاک‌سازی (clear function) نوعی که پرچم :c:macro:`Py_TPFLAGS_MANAGED_DICT` روی آن تنظیم شده است، فراخوانی شود."
msgid"Enable `deferred reference counting <https://peps.python.org/pep-0703/#deferred-reference-counting>`_ on *obj*, if supported by the runtime. In the :term:`free-threaded <free threading>` build, this allows the interpreter to avoid reference count adjustments to *obj*, which may improve multi-threaded performance. The tradeoff is that *obj* will only be deallocated by the tracing garbage collector, and not when the interpreter no longer has any references to it."
msgstr"`شمارش ارجاعِ معوق <https://peps.python.org/pep-0703/#deferred-reference-counting>`_ را روی *obj* فعال می‌کند، اگر ران‌تایم از آن پشتیبانی کند. در ساخت‌ِ :term:`نخ‌آزاد <free threading>`، این به مفسر اجازه می‌دهد تا از تعدیل شمارش ارجاعِ *obj* اجتناب کند، که ممکن است کارایی چندنخی را بهبود بخشد. بهای آن این است که *obj* فقط توسط زباله‌روبِ ردیابی (tracing garbage collector) آزادسازی خواهد شد، و نه زمانی که مفسر دیگر هیچ ارجاعی به آن ندارد."
msgid"This function returns ``1`` if deferred reference counting is enabled on *obj*, and ``0`` if deferred reference counting is not supported or if the hint was ignored by the interpreter, such as when deferred reference counting is already enabled on *obj*. This function is thread-safe, and cannot fail."
msgstr"این تابع در صورتی که شمارش ارجاعِ معوق روی *obj* فعال باشد، مقدار ``1`` را برمی‌گرداند و در صورتی که شمارش ارجاعِ معوق پشتیبانی نشده باشد یا مفسر راهنما را نادیده گرفته باشد (مانند زمانی که شمارش ارجاعِ معوق از قبل روی *obj* فعال باشد)، مقدار ``0`` را برمی‌گرداند. این تابع نخ‌ایمن است و نمی‌تواند شکست بخورد."
msgid"This function does nothing on builds with the :term:`GIL` enabled, which do not support deferred reference counting. This also does nothing if *obj* is not an object tracked by the garbage collector (see :func:`gc.is_tracked` and :c:func:`PyObject_GC_IsTracked`)."
msgstr"این تابع در نسخه‌های ساخته‌شده‌ای که :term:`GIL` در آن‌ها فعال است و از شمارش ارجاعِ معوق پشتیبانی نمی‌کنند، هیچ کاری انجام نمی‌دهد. همچنین اگر *obj* شیء‌ای نباشد که توسط زباله‌روب پیگیری می‌شود، این تابع هیچ کاری انجام نمی‌دهد (به :func:`gc.is_tracked` و :c:func:`PyObject_GC_IsTracked` مراجعه کنید)."
msgid"This function is intended to be used soon after *obj* is created, by the code that creates it, such as in the object's :c:member:`~PyTypeObject.tp_new` slot."
msgstr"این تابع برای استفاده به‌زودی پس از ایجاد *obj*، توسط کدی که آن را ایجاد می‌کند، در نظر گرفته شده است؛ برای مثال در جایگاه :c:member:`~PyTypeObject.tp_new` شیء."
msgid"Check if *obj* is a unique temporary object. Returns ``1`` if *obj* is known to be a unique temporary object, and ``0`` otherwise. This function cannot fail, but the check is conservative, and may return ``0`` in some cases even if *obj* is a unique temporary object."
msgstr"بررسی می‌کند که آیا *obj* یک شیء موقت یکتا است یا نه. اگر مشخص باشد که *obj* یک شیء موقت یکتا است، ``1`` و در غیر این صورت ``0`` را برمی‌گرداند. این تابع نمی‌تواند شکست بخورد، اما بررسی محافظه‌کارانه است و ممکن است در برخی موارد حتی اگر *obj* یک شیء موقت یکتا باشد، ``0`` برگرداند."
msgid"If an object is a unique temporary, it is guaranteed that the current code has the only reference to the object. For arguments to C functions, this should be used instead of checking if the reference count is ``1``. Starting with Python 3.14, the interpreter internally avoids some reference count modifications when loading objects onto the operands stack by :term:`borrowing <borrowed reference>` references when possible, which means that a reference count of ``1`` by itself does not guarantee that a function argument uniquely referenced."
msgstr"اگر شیء‌ای موقتِ یکتا (unique temporary) باشد، تضمین می‌شود که کد فعلی تنها ارجاع به آن شیء را دارد. برای آرگومان‌های توابع C، باید از این به‌جای بررسی اینکه آیا شمارش ارجاع ``1`` است استفاده کرد. از پایتون 3.14 به بعد، مفسر به‌صورت داخلی هنگام بارگذاری اشیاء روی پشته عملوندها، در صورت امکان با :term:`امانت گرفتن <borrowed reference>` ارجاع‌ها، از برخی از تغییرات شمارش ارجاع اجتناب می‌کند؛ این بدان معناست که شمارش ارجاع ``1`` به‌تنهایی تضمین نمی‌کند که آرگومان تابع به‌طور یکتا ارجاع شده باشد."
msgid"In the example below, ``my_func`` is called with a unique temporary object as its argument::"
msgstr"در مثال زیر، ``my_func`` با یک شیء موقت یکتا به‌عنوان آرگومان خود فراخوانی می‌شود::"
msgid"my_func([1, 2, 3])"
msgstr"my_func([1, 2, 3])"
msgid"In the example below, ``my_func`` is **not** called with a unique temporary object as its argument, even if its refcount is ``1``::"
msgstr"در مثال زیر، ``my_func`` با یک شیء موقت یکتا به‌عنوان آرگومان خود فراخوانی **نمی‌شود**، حتی اگر شمارش ارجاع آن ``1`` باشد::"
msgid""
"my_list = [1, 2, 3]\n"
"my_func(my_list)"
msgstr""
"my_list = [1, 2, 3]\n"
"my_func(my_list)"
msgid"See also the function :c:func:`Py_REFCNT`."
msgstr"همچنین تابع :c:func:`Py_REFCNT` را ببینید."
msgid"This function returns non-zero if *obj* is :term:`immortal`, and zero otherwise. This function cannot fail."
msgstr"این تابع در صورتی که *obj* :term:`نامیرا <immortal>` باشد، مقدار غیرصفر و در غیر این صورت صفر را برمی‌گرداند. این تابع نمی‌تواند شکست بخورد."
msgid"Objects that are immortal in one CPython version are not guaranteed to be immortal in another."
msgstr"اشیایی که در یک نسخه از سی‌پایتون نامیرا هستند، تضمین نمی‌شود که در نسخه‌ای دیگر نیز نامیرا باشند."
msgid"Increments the reference count of *obj* if it is not zero. Returns ``1`` if the object's reference count was successfully incremented. Otherwise, this function returns ``0``."
msgstr"شمارش ارجاع *obj* را در صورتی که صفر نباشد افزایش می‌دهد. اگر شمارش ارجاع شیء با موفقیت افزایش یافته باشد، ``1`` را برمی‌گرداند. در غیر این صورت، این تابع ``0`` را برمی‌گرداند."
msgid":c:func:`PyUnstable_EnableTryIncRef` must have been called earlier on *obj* or this function may spuriously return ``0`` in the :term:`free-threaded build`."
msgstr":c:func:`PyUnstable_EnableTryIncRef` باید پیش‌تر روی *obj* فراخوانی شده باشد؛ در غیر این صورت، این تابع ممکن است در :term:`ساخت نخ‌آزاد <free-threaded build>` به‌طور کاذب ``0`` را برگرداند."
msgid"This function is logically equivalent to the following C code, except that it behaves atomically in the :term:`free-threaded build`::"
msgstr"این تابع از نظر منطقی معادل کد C زیر است، با این تفاوت که در :term:`free-threaded build` به‌صورت اتمیک رفتار می‌کند::"
msgid""
"if (Py_REFCNT(op) > 0) {\n"
" Py_INCREF(op);\n"
" return 1;\n"
"}\n"
"return 0;"
msgstr""
"if (Py_REFCNT(op) > 0) {\n"
" Py_INCREF(op);\n"
" return 1;\n"
"}\n"
"return 0;"
msgid"This is intended as a building block for managing weak references without the overhead of a Python :ref:`weak reference object <weakrefobjects>`."
msgstr"این به‌عنوان یک بلوک سازنده برای مدیریت ارجاع‌های ضعیف بدون سربار یک :ref:`شیء ارجاع ضعیف <weakrefobjects>` پایتون در نظر گرفته شده است."
msgid"Typically, correct use of this function requires support from *obj*'s deallocator (:c:member:`~PyTypeObject.tp_dealloc`). For example, the following sketch could be adapted to implement a \"weakmap\" that works like a :py:class:`~weakref.WeakValueDictionary` for a specific type:"
msgstr"معمولاً، استفاده‌ی صحیح از این تابع نیازمند پشتیبانی از سوی آزادساز حافظه مربوط به *obj* (:c:member:`~PyTypeObject.tp_dealloc`) است. برای مثال، می‌توان طرح زیر را برای پیاده‌سازی «weakmap»ای که مانند :py:class:`~weakref.WeakValueDictionary` برای یک نوع مشخص کار می‌کند، تطبیق داد:"
" // if we get here, `result` is starting to be garbage-collected,\n"
" // but has not been removed from the weakmap yet\n"
" PyMutex_Unlock(&mutex);\n"
" return NULL;\n"
"}\n"
"\n"
"// tp_dealloc function for weakmap values\n"
"void\n"
"value_dealloc(PyObject *value)\n"
"{\n"
" weakmap_type weakmap = ...;\n"
" PyMutex_Lock(&mutex);\n"
" weakmap_remove_value(weakmap, value);\n"
"\n"
" ...\n"
" PyMutex_Unlock(&mutex);\n"
"}"
msgid"Enables subsequent uses of :c:func:`PyUnstable_TryIncRef` on *obj*. The caller must hold a :term:`strong reference` to *obj* when calling this."
msgstr"امکان استفاده‌های بعدی از :c:func:`PyUnstable_TryIncRef` روی *obj* را فراهم می‌کند. فراخواننده باید هنگام فراخوانی این تابع، یک :term:`ارجاع قوی <strong reference>` به *obj* داشته باشد."
msgid"Determine if *op* only has one reference."
msgstr"تشخیص می‌دهد که آیا *op* فقط یک ارجاع دارد یا خیر."
msgid"On GIL-enabled builds, this function is equivalent to :c:expr:`Py_REFCNT(op) == 1`."
msgstr"در ساخت‌های دارای قفل مفسر سراسری، این تابع معادل :c:expr:`Py_REFCNT(op) == 1` است."
msgid"On a :term:`free-threaded build`, this checks if *op*'s :term:`reference count` is equal to one and additionally checks if *op* is only used by this thread. :c:expr:`Py_REFCNT(op) == 1` is **not** thread-safe on free-threaded builds; prefer this function."
msgstr"در :term:`ساخت نخ‌آزاد <free-threaded build>`، این تابع بررسی می‌کند که :term:`شمارش ارجاع <reference count>` *op* برابر با یک باشد و به‌علاوه بررسی می‌کند که *op* تنها توسط این نخ استفاده می‌شود. :c:expr:`Py_REFCNT(op) == 1` در ساخت‌های نخ‌آزاد نخ‌ایمن **نیست**؛ استفاده از این تابع را ترجیح دهید."
msgid"The caller must hold an :term:`attached thread state`, despite the fact that this function doesn't call into the Python interpreter. This function cannot fail."
msgstr"فراخوانی‌کننده باید یک :term:`attached thread state` را در اختیار داشته باشد، با وجود اینکه این تابع مفسر پایتون را فراخوانی نمی‌کند. این تابع نمی‌تواند شکست بخورد."
msgid"Marks the object *op* :term:`immortal`. The argument should be uniquely referenced by the calling thread. This is intended to be used for reducing reference counting contention in the :term:`free-threaded build` for objects which are shared across threads."
msgstr"شیء *op* را به عنوان :term:`نامیرا <immortal>` علامت‌گذاری می‌کند. آرگومان باید به طور منحصربه‌فرد توسط نِخ فراخواننده ارجاع داده شود. این قابلیت برای کاهش رقابت شمارش ارجاع در :term:`ساخت نخ‌آزاد <free-threaded build>` برای اشیایی که بین نخ‌ها به اشتراک گذاشته می‌شوند، در نظر گرفته شده است."
msgid"This is a one-way process: objects can only be made immortal; they cannot be made mortal once again. Immortal objects do not participate in reference counting and will never be garbage collected. If the object is GC-tracked, it is untracked."
msgstr"این یک فرایند یک‌طرفه است: اشیا را فقط می‌توان نامیرا کرد؛ و نمی‌توان آن‌ها را دوباره میرا ساخت. اشیای نامیرا در شمارش ارجاع شرکت نمی‌کنند و هرگز جمع‌آوری زباله نمی‌شوند. اگر شیء تحت نظارت GC باشد، نظارت بر آن متوقف می‌شود."
msgid"This function is intended to be used soon after *op* is created, by the code that creates it, such as in the object's :c:member:`~PyTypeObject.tp_new` slot. Returns 1 if the object was made immortal and returns 0 if it was not. This function cannot fail."
msgstr"این تابع در نظر گرفته شده است تا به زودی پس از ایجاد *op*، توسط کدی که آن را ایجاد می‌کند، مانند جایگاه :c:member:`~PyTypeObject.tp_new` شیء، استفاده شود. اگر شیء نامیرا شده باشد ۱ و اگر نشده باشد ۰ را برمی‌گرداند. این تابع نمی‌تواند با خطا مواجه شود."