python-docs-fa/c-api/descriptor.po at 3.14 · python/python-docs-fa · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
# 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:
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
# 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:48+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 "Descriptor Objects"
msgstr "شیءهای توصیف‌گر"

msgid "\"Descriptors\" are objects that describe some attribute of an object. They are found in the dictionary of type objects."
msgstr "«توصیف‌گرها» اشیایی هستند که ویژگی‌ای از یک شیء را توصیف می‌کنند. آن‌ها در دیکشنری اشیاء نوع یافت می‌شوند."

msgid "The type object for the built-in descriptor types."
msgstr "شیء نوع برای نوع‌های توصیف‌گر توکار."

msgid "Create a new get-set descriptor for extension type *type* from the :c:type:`PyGetSetDef` structure *getset*."
msgstr "یک توصیف‌گر دریافت-تنظیم (get-set) جدید برای نوع توسعه‌ای *type* از ساختار :c:type:`PyGetSetDef` با نام *getset* می‌سازد."

msgid "Get-set descriptors expose attributes implemented by C getter and setter functions rather than stored directly in the instance. This is the same kind of descriptor created for entries in :c:member:`~PyTypeObject.tp_getset`, and it appears in Python as a :class:`types.GetSetDescriptorType` object."
msgstr "توصیف‌گرهای دریافت-تنظیم (get-set) ویژگی‌هایی را در دسترس قرار می‌دهند که به‌جای ذخیره‌شدن مستقیم در نمونه، توسط توابع getter و setter  زبان C پیاده‌سازی شده‌اند. این همان نوع توصیف‌گری است که برای ورودی‌های :c:member:`~PyTypeObject.tp_getset` ایجاد می‌شود و در پایتون به‌صورت یک شیء :class:`types.GetSetDescriptorType` ظاهر می‌شود."

msgid "On success, return a :term:`strong reference` to the descriptor. Return ``NULL`` with an exception set on failure."
msgstr "در صورت موفقیت، یک :term:`ارجاع قوی <strong reference>` به توصیف‌گر برمی‌گرداند. در صورت شکست، ``NULL`` همراه با یک استثنای تنظیم‌شده برمی‌گرداند."

msgid "Create a new member descriptor for extension type *type* from the :c:type:`PyMemberDef` structure *member*."
msgstr "یک توصیف‌گر عضو جدید برای نوع توسعه‌ای *type* از ساختار :c:type:`PyMemberDef` به نام *member* ایجاد می‌کند."

msgid "Member descriptors expose fields in the type's C struct as Python attributes. This is the same kind of descriptor created for entries in :c:member:`~PyTypeObject.tp_members`, and it appears in Python as a :class:`types.MemberDescriptorType` object."
msgstr "توصیف‌گرهای عضو، فیلدهای موجود در ساختار C نوع را به‌عنوان ویژگی‌های پایتون در دسترس قرار می‌دهند. این همان نوع توصیف‌گری است که برای ورودی‌های :c:member:`~PyTypeObject.tp_members` ایجاد می‌شود و در پایتون به‌صورت شیء :class:`types.MemberDescriptorType` ظاهر می‌شود."

msgid "The type object for member descriptor objects created from :c:type:`PyMemberDef` structures. These descriptors expose fields of a C struct as attributes on a type, and correspond to :class:`types.MemberDescriptorType` objects in Python."
msgstr "شیء نوع برای اشیاء توصیف‌گر عضو که از ساختارهای :c:type:`PyMemberDef` ایجاد می‌شوند. این توصیف‌گرها فیلدهای یک ساختار C را به‌عنوان ویژگی‌هایی روی یک نوع در دسترس قرار می‌دهند و متناظر با اشیاء :class:`types.MemberDescriptorType` در پایتون هستند."

msgid "The type object for get/set descriptor objects created from :c:type:`PyGetSetDef` structures. These descriptors implement attributes whose value is computed by C getter and setter functions, and are used for many built-in type attributes. They correspond to :class:`types.GetSetDescriptorType` objects in Python."
msgstr "شیء نوع برای اشیای توصیف‌گر get/set که از ساختارهای :c:type:`PyGetSetDef` ایجاد می‌شوند. این توصیف‌گرها ویژگی‌هایی را پیاده‌سازی می‌کنند که مقدار آن‌ها توسط توابع getter و setter زبان C محاسبه می‌شود و برای بسیاری از ویژگی‌های انواع توکار به کار می‌روند. آن‌ها معادل اشیای :class:`types.GetSetDescriptorType` در پایتون هستند."

msgid "Create a new method descriptor for extension type *type* from the :c:type:`PyMethodDef` structure *meth*."
msgstr "یک توصیف‌گر متد جدید برای نوع توسعه‌ای *type* از ساختار :c:type:`PyMethodDef` به نام *meth* ایجاد کنید."

msgid "Method descriptors expose C functions as methods on a type. This is the same kind of descriptor created for entries in :c:member:`~PyTypeObject.tp_methods`, and it appears in Python as a :class:`types.MethodDescriptorType` object."
msgstr "توصیف‌گرهای متد، توابع C را به‌صورت متدهایی روی یک نوع در دسترس قرار می‌دهند. این همان نوع توصیف‌گری است که برای ورودی‌های :c:member:`~PyTypeObject.tp_methods` ایجاد می‌شود و در پایتون به‌صورت شیء :class:`types.MethodDescriptorType` ظاهر می‌شود."

msgid "The type object for method descriptor objects created from :c:type:`PyMethodDef` structures. These descriptors expose C functions as methods on a type, and correspond to :class:`types.MethodDescriptorType` objects in Python."
msgstr "شیء نوع برای اشیاء توصیف‌گر متد که از ساختارهای :c:type:`PyMethodDef` ایجاد شده‌اند. این توصیف‌گرها توابع C را به‌عنوان متدهایی روی یک نوع در دسترس قرار می‌دهند و معادل اشیاء :class:`types.MethodDescriptorType` در پایتون هستند."

msgid "Describes a slot wrapper used by :c:func:`PyDescr_NewWrapper`."
msgstr "یک دربرگیرنده‌ی جایگاه را توصیف می‌کند که توسط :c:func:`PyDescr_NewWrapper` استفاده می‌شود."

msgid "Each ``wrapperbase`` record stores the Python-visible name and metadata for a special method implemented by a type slot, together with the wrapper function used to adapt that slot to Python's calling convention."
msgstr "هر رکورد ``wrapperbase`` نام قابل‌مشاهده در پایتون و فراداده‌ی متد ویژه‌ای را که توسط یک جایگاه نوع پیاده‌سازی شده است، به همراه تابع پوششی‌ای که برای تطبیق آن جایگاه با قرارداد فراخوانی پایتون استفاده می‌شود، ذخیره می‌کند."

msgid "Create a new wrapper descriptor for extension type *type* from the :c:struct:`wrapperbase` structure *base* and the wrapped slot function pointer *wrapped*."
msgstr "یک توصیف‌گر پوششی جدید برای نوع توسعه‌ای *type* از ساختار :c:struct:`wrapperbase` به نام *base* و اشاره‌گر تابع جایگاه دربرگرفته‌شده به نام *wrapped* می‌سازد."

msgid "Wrapper descriptors expose special methods implemented by type slots. This is the same kind of descriptor that CPython creates for slot-based special methods such as ``__repr__`` or ``__add__``, and it appears in Python as a :class:`types.WrapperDescriptorType` object."
msgstr "توصیف‌گرهای پوششی، متدهای ویژه‌ای را که توسط جایگاه‌های نوع پیاده‌سازی شده‌اند، در دسترس قرار می‌دهند. این همان نوع توصیف‌گری است که سی‌پایتون برای متدهای ویژه‌ی مبتنی بر جایگاه مانند ``__repr__`` یا ``__add__`` ایجاد می‌کند و در پایتون به‌صورت یک شیء :class:`types.WrapperDescriptorType` ظاهر می‌شود."

msgid "The type object for wrapper descriptor objects created by :c:func:`PyDescr_NewWrapper` and :c:func:`PyWrapper_New`. Wrapper descriptors are used internally to expose special methods implemented via wrapper structures, and appear in Python as :class:`types.WrapperDescriptorType` objects."
msgstr "شیء نوع برای اشیاء توصیف‌گر پوششی که توسط :c:func:`PyDescr_NewWrapper` و :c:func:`PyWrapper_New` ایجاد می‌شوند. توصیف‌گرهای پوششی به‌طور داخلی برای در دسترس قرار دادن متدهای ویژه‌ای که از طریق ساختارهای پوششی پیاده‌سازی شده‌اند استفاده می‌شوند و در پایتون به‌صورت اشیاء :class:`types.WrapperDescriptorType` ظاهر می‌شوند."

msgid "Create a new class method descriptor for extension type *type* from the :c:type:`PyMethodDef` structure *method*."
msgstr "یک توصیف‌گر متد کلاس جدید برای نوع توسعه‌ای *type* از ساختار :c:type:`PyMethodDef` به نام *method* ایجاد می‌کند."

msgid "Class method descriptors expose C methods that receive the class rather than an instance when accessed. This is the same kind of descriptor created for ``METH_CLASS`` entries in :c:member:`~PyTypeObject.tp_methods`, and it appears in Python as a :class:`types.ClassMethodDescriptorType` object."
msgstr "توصیف‌گرهای متد کلاس، متدهای C را نمایان می‌کنند که هنگام دسترسی، کلاس را به جای نمونه دریافت می‌کنند. این همان نوع توصیف‌گری است که برای ورودی‌های ``METH_CLASS`` در :c:member:`~PyTypeObject.tp_methods` ایجاد می‌شود و در پایتون به صورت شیء :class:`types.ClassMethodDescriptorType` ظاهر می‌شود."

msgid "Return non-zero if the descriptor object *descr* describes a data attribute, or ``0`` if it describes a method.  *descr* must be a descriptor object; there is no error checking."
msgstr "اگر شیء توصیف‌گر *descr* یک ویژگی داده‌ای را توصیف کند، مقدار نا‌صفر را برمی‌گرداند و اگر متدی را توصیف کند، ``0`` را برمی‌گرداند.  *descr* باید یک شیء توصیف‌گر باشد؛ هیچ بررسی خطایی انجام نمی‌شود."

msgid "Create a new bound wrapper object from the wrapper descriptor *d* and the instance *self*."
msgstr "یک شیء پوششی مقید جدید از توصیف‌گر پوششی *d* و نمونه *self* ایجاد کنید."

msgid "This is the bound form of a wrapper descriptor created by :c:func:`PyDescr_NewWrapper`. CPython creates these objects when a slot wrapper is accessed through an instance, and they appear in Python as :class:`types.MethodWrapperType` objects."
msgstr "این، شکل مقیدِ یک توصیف‌گر پوششی (wrapper descriptor) است که توسط :c:func:`PyDescr_NewWrapper` ایجاد شده است. سی‌پایتون این اشیاء را زمانی ایجاد می‌کند که از طریق یک نمونه به یک پوشش‌دهنده جایگاه (slot wrapper) دسترسی پیدا شود، و آن‌ها در پایتون به‌صورت اشیاء :class:`types.MethodWrapperType` ظاهر می‌شوند."

msgid "On success, return a :term:`strong reference` to the wrapper object. Return ``NULL`` with an exception set on failure."
msgstr "در صورت موفقیت، یک :term:`ارجاع قوی <strong reference>` به شیء پوششی برمی‌گرداند. در صورت شکل، ``NULL`` را همراه با یک استثنای تنظیم‌شده برمی‌گرداند."

msgid "Built-in descriptors"
msgstr "توصیف‌گرهای توکار"

msgid "The type object for super objects. This is the same object as :class:`super` in the Python layer."
msgstr "شیء نوع برای اشیای super. این همان شیء :class:`super` در لایه‌ی پایتون است."

msgid "The type of class method objects. This is the same object as :class:`classmethod` in the Python layer."
msgstr "نوع اشیای متد کلاس. این همان شیء :class:`classmethod` در لایه پایتون است."

msgid "The type object for C-level class method descriptor objects. This is the type of the descriptors created for :func:`classmethod` defined in C extension types, and corresponds to :class:`types.ClassMethodDescriptorType` objects in Python."
msgstr "شیء نوع برای اشیاء توصیف‌گر متد کلاس در سطح C. این همان نوع توصیف‌گرهایی است که برای :func:`classmethod` تعریف‌شده در نوع‌های توسعه‌ای C ایجاد می‌شوند و با اشیاء :class:`types.ClassMethodDescriptorType` در پایتون مطابقت دارد."

msgid "Create a new :class:`classmethod` object wrapping *callable*. *callable* must be a callable object and must not be ``NULL``."
msgstr "یک شیء جدید :class:`classmethod` می‌سازد که *callable* را در بر می‌گیرد. *callable* باید یک شیء فراخوانی‌پذیر باشد و نباید ``NULL`` باشد."

msgid "On success, this function returns a :term:`strong reference` to a new class method descriptor. On failure, this function returns ``NULL`` with an exception set."
msgstr "در صورت موفقیت، این تابع یک :term:`ارجاع قوی <strong reference>` به یک توصیف‌گر جدید متد کلاس برمی‌گرداند. در صورت شکست، این تابع ``NULL`` را همراه با یک استثنای تنظیم‌شده برمی‌گرداند."

msgid "The type of static method objects. This is the same object as :class:`staticmethod` in the Python layer."
msgstr "نوع اشیاء متد ایستا. این همان شیء :class:`staticmethod` در لایه‌ی پایتون است."

msgid "Create a new :class:`staticmethod` object wrapping *callable*. *callable* must be a callable object and must not be ``NULL``."
msgstr "یک شیء :class:`staticmethod` جدید ایجاد می‌کند که *callable* را دربر می‌گیرد. *callable* باید یک شیء فراخوانی‌پذیر باشد و نباید ``NULL`` باشد."

msgid "On success, this function returns a :term:`strong reference` to a new static method descriptor. On failure, this function returns ``NULL`` with an exception set."
msgstr "در صورت موفقیت، این تابع یک :term:`ارجاع قوی <strong reference>` به توصیف‌گر جدید متد ایستا برمی‌گرداند. در صورت شکست، این تابع ``NULL`` را همراه با یک استثنای تنظیم‌شده برمی‌گرداند."