python-docs-fa/c-api/set.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
123
124
125
126
127
128
129
# 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
# khosro azimi, 2025
# Rafael Fontenelle <rffontenelle@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:50+0000\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/python/python-docs-fa/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 "Set Objects"
msgstr "اشیاء مجموعه"

msgid "This section details the public API for :class:`set` and :class:`frozenset` objects.  Any functionality not listed below is best accessed using either the abstract object protocol (including :c:func:`PyObject_CallMethod`, :c:func:`PyObject_RichCompareBool`, :c:func:`PyObject_Hash`, :c:func:`PyObject_Repr`, :c:func:`PyObject_IsTrue`, :c:func:`PyObject_Print`, and :c:func:`PyObject_GetIter`) or the abstract number protocol (including :c:func:`PyNumber_And`, :c:func:`PyNumber_Subtract`, :c:func:`PyNumber_Or`, :c:func:`PyNumber_Xor`, :c:func:`PyNumber_InPlaceAnd`, :c:func:`PyNumber_InPlaceSubtract`, :c:func:`PyNumber_InPlaceOr`, and :c:func:`PyNumber_InPlaceXor`)."
msgstr "این بخش API عمومی اشیاء :class:`set` و :class:`frozenset` را با جزئیات شرح می‌دهد. بهترین راه دسترسی به هر قابلیتی که در ادامه فهرست نشده است، استفاده از پروتکل انتزاعی شیء (شامل :c:func:`PyObject_CallMethod`، :c:func:`PyObject_RichCompareBool`، :c:func:`PyObject_Hash`، :c:func:`PyObject_Repr`، :c:func:`PyObject_IsTrue`، :c:func:`PyObject_Print` و :c:func:`PyObject_GetIter`) یا پروتکل انتزاعی عدد (شامل :c:func:`PyNumber_And`، :c:func:`PyNumber_Subtract`، :c:func:`PyNumber_Or`، :c:func:`PyNumber_Xor`، :c:func:`PyNumber_InPlaceAnd`، :c:func:`PyNumber_InPlaceSubtract`، :c:func:`PyNumber_InPlaceOr` و :c:func:`PyNumber_InPlaceXor`) است."

msgid "This subtype of :c:type:`PyObject` is used to hold the internal data for both :class:`set` and :class:`frozenset` objects.  It is like a :c:type:`PyDictObject` in that it is a fixed size for small sets (much like tuple storage) and will point to a separate, variable sized block of memory for medium and large sized sets (much like list storage). None of the fields of this structure should be considered public and all are subject to change.  All access should be done through the documented API rather than by manipulating the values in the structure."
msgstr "این زیرنوع از :c:type:`PyObject` برای نگه‌داشتن داده‌های داخلی هر دو نوع شیء :class:`set` و :class:`frozenset` استفاده می‌شود. این زیرنوع مانند :c:type:`PyDictObject` است از این جهت که برای مجموعه‌های کوچک اندازه‌ای ثابت دارد (بسیار شبیه ذخیره‌سازی تاپل) و برای مجموعه‌های متوسط و بزرگ به یک بلوک حافظه‌ی جداگانه با اندازه متغیر اشاره می‌کند (بسیار شبیه ذخیره‌سازی فهرست). هیچ‌یک از فیلدهای این ساختار نباید عمومی در نظر گرفته شود و همه آن‌ها ممکن است تغییر کنند. تمام دسترسی‌ها باید از طریق API مستندشده انجام شود، نه با دستکاری مقادیر درون ساختار."

msgid "This is an instance of :c:type:`PyTypeObject` representing the Python :class:`set` type."
msgstr "این یک نمونه از :c:type:`PyTypeObject` است که نوع :class:`set` پایتون را نشان می‌دهد."

msgid "This is an instance of :c:type:`PyTypeObject` representing the Python :class:`frozenset` type."
msgstr "این یک نمونه از :c:type:`PyTypeObject` است که نوع :class:`frozenset` پایتون را نشان می‌دهد."

msgid "The following type check macros work on pointers to any Python object. Likewise, the constructor functions work with any iterable Python object."
msgstr "ماکروهای بررسی نوع زیر روی اشاره‌گر به هر شیء پایتونی کار می‌کنند. به همین ترتیب، توابع سازنده با هر شیء پیمایش‌پذیر پایتونی کار می‌کنند."

msgid "Return true if *p* is a :class:`set` object or an instance of a subtype. This function always succeeds."
msgstr "اگر *p* یک شیء :class:`set` یا نمونه‌ای از یک زیرنوع باشد، مقدار true را برمی‌گرداند. این تابع همیشه با موفقیت اجرا می‌شود."

msgid "Return true if *p* is a :class:`frozenset` object or an instance of a subtype.  This function always succeeds."
msgstr "اگر *p* یک شیء :class:`frozenset` یا نمونه‌ای از یک زیرنوع باشد، مقدار true را برمی‌گرداند. این تابع همیشه با موفقیت اجرا می‌شود."

msgid "Return true if *p* is a :class:`set` object, a :class:`frozenset` object, or an instance of a subtype.  This function always succeeds."
msgstr "اگر *p* یک شیء :class:`set`، یک شیء :class:`frozenset` یا نمونه‌ای از یک زیرنوع باشد، مقدار true را برمی‌گرداند. این تابع همیشه موفق می‌شود."

msgid "Return true if *p* is a :class:`set` object but not an instance of a subtype.  This function always succeeds."
msgstr "اگر *p* یک شیء :class:`set` باشد اما نمونه‌ای از یک زیرنوع نباشد، مقدار درست را برمی‌گرداند. این تابع همیشه با موفقیت اجرا می‌شود."

msgid "Return true if *p* is a :class:`set` object or a :class:`frozenset` object but not an instance of a subtype.  This function always succeeds."
msgstr "اگر *p* یک شیء :class:`set` یا یک شیء :class:`frozenset` باشد اما نمونه‌ای از یک زیرنوع نباشد، مقدار true را برمی‌گرداند.  این تابع همیشه با موفقیت اجرا می‌شود."

msgid "Return true if *p* is a :class:`frozenset` object but not an instance of a subtype.  This function always succeeds."
msgstr "اگر *p* یک شیء :class:`frozenset` باشد اما نمونه‌ای از یک زیرنوع نباشد، مقدار درست را برمی‌گرداند. این تابع همیشه با موفقیت اجرا می‌شود."

msgid "Return a new :class:`set` containing objects returned by the *iterable*.  The *iterable* may be ``NULL`` to create a new empty set.  Return the new set on success or ``NULL`` on failure.  Raise :exc:`TypeError` if *iterable* is not actually iterable.  The constructor is also useful for copying a set (``c=set(s)``)."
msgstr "یک :class:`set` جدید شامل اشیاء بازگردانده‌شده توسط *iterable* برمی‌گرداند. *iterable* می‌تواند ``NULL`` باشد تا یک مجموعه‌ی خالی جدید ایجاد شود. در صورت موفقیت مجموعه‌ی جدید و در صورت شکست ``NULL`` برمی‌گرداند. اگر *iterable* در واقع پیمایش‌پذیر نباشد، استثنای :exc:`TypeError` ایجاد می‌شود. این سازنده برای کپی‌کردن یک مجموعه نیز مفید است (``c=set(s)``)."

msgid "The operation is atomic on :term:`free threading <free-threaded build>` when *iterable* is a :class:`set`, :class:`frozenset` or :class:`dict`."
msgstr "این عملیات در :term:`نخ‌بندی آزاد <free-threaded build>` زمانی اتمی است که *iterable* یک :class:`set`، :class:`frozenset` یا :class:`dict` باشد."

msgid "Return a new :class:`frozenset` containing objects returned by the *iterable*. The *iterable* may be ``NULL`` to create a new empty frozenset.  Return the new set on success or ``NULL`` on failure.  Raise :exc:`TypeError` if *iterable* is not actually iterable."
msgstr "یک :class:`frozenset` جدید شامل اشیایی که توسط *iterable* برگردانده می‌شوند را برمی‌گرداند. *iterable* می‌تواند ``NULL`` باشد تا یک frozenset خالی جدید ایجاد شود. در صورت موفقیت، مجموعه جدید و در صورت شکست، ``NULL`` برگردانده می‌شود. اگر *iterable* در واقع پیمایش‌پذیر نباشد، :exc:`TypeError` ایجاد می‌شود."

msgid "The following functions and macros are available for instances of :class:`set` or :class:`frozenset` or instances of their subtypes."
msgstr "توابع و ماکروهای زیر برای نمونه‌های :class:`set` یا :class:`frozenset` یا نمونه‌های زیرنوع‌های آن‌ها در دسترس هستند."

msgid "Return the length of a :class:`set` or :class:`frozenset` object. Equivalent to ``len(anyset)``.  Raises a :exc:`SystemError` if *anyset* is not a :class:`set`, :class:`frozenset`, or an instance of a subtype."
msgstr "طول یک شیء :class:`set` یا :class:`frozenset` را برمی‌گرداند. معادل ``len(anyset)`` است. اگر *anyset* یک :class:`set`، :class:`frozenset` یا نمونه‌ای از یک زیرنوع نباشد، استثنای :exc:`SystemError` ایجاد می‌کند."

msgid "Macro form of :c:func:`PySet_Size` without error checking."
msgstr "شکل ماکروی :c:func:`PySet_Size` بدون بررسی خطا."

msgid "Return ``1`` if found, ``0`` if not found, and ``-1`` if an error is encountered.  Unlike the Python :meth:`~object.__contains__` method, this function does not automatically convert unhashable sets into temporary frozensets.  Raise a :exc:`TypeError` if the *key* is unhashable. Raise :exc:`SystemError` if *anyset* is not a :class:`set`, :class:`frozenset`, or an instance of a subtype."
msgstr "مقدار ``1`` را در صورت یافت‌شدن، ``0`` را در صورت یافت‌نشدن و ``-1`` را در صورت بروز خطا برمی‌گرداند. برخلاف متد :meth:`~object.__contains__` پایتون، این تابع مجموعه‌های هش‌ناپذیر را به‌طور خودکار به frozenset‌های موقت تبدیل نمی‌کند. اگر *key* هش‌ناپذیر باشد، یک :exc:`TypeError` ایجاد می‌کند. اگر *anyset* یک :class:`set`، :class:`frozenset` یا نمونه‌ای از یک زیرنوع نباشد، :exc:`SystemError` ایجاد می‌کند."

msgid "The operation is atomic on :term:`free threading <free-threaded build>` when *key* is :class:`str`, :class:`int`, :class:`float`, :class:`bool` or :class:`bytes`."
msgstr "این عملیات در :term:`نخ‌بندی آزاد <free-threaded build>` زمانی که *key* از نوع :class:`str`، :class:`int`، :class:`float`، :class:`bool` یا :class:`bytes` باشد، اتمیک است."

msgid "Add *key* to a :class:`set` instance.  Also works with :class:`frozenset` instances (like :c:func:`PyTuple_SetItem` it can be used to fill in the values of brand new frozensets before they are exposed to other code).  Return ``0`` on success or ``-1`` on failure. Raise a :exc:`TypeError` if the *key* is unhashable. Raise a :exc:`MemoryError` if there is no room to grow.  Raise a :exc:`SystemError` if *set* is not an instance of :class:`set` or its subtype."
msgstr "*key* را به یک نمونه از :class:`set` اضافه می‌کند. همچنین با نمونه‌های :class:`frozenset` کار می‌کند (مانند :c:func:`PyTuple_SetItem`، می‌توان از آن برای پر کردن مقادیر frozenset‌های تازه‌ساخته پیش از آنکه در معرض کد دیگر قرار گیرند استفاده کرد). در صورت موفقیت ``0`` یا در صورت شکست ``-1`` را برمی‌گرداند. اگر *key* هش‌ناپذیر باشد، :exc:`TypeError` ایجاد می‌شود. اگر فضایی برای رشد وجود نداشته باشد، :exc:`MemoryError` ایجاد می‌شود. اگر *set* نمونه‌ای از :class:`set` یا زیرنوع آن نباشد، :exc:`SystemError` ایجاد می‌شود."

msgid "The following functions are available for instances of :class:`set` or its subtypes but not for instances of :class:`frozenset` or its subtypes."
msgstr "توابع زیر برای نمونه‌های :class:`set` یا زیرنوع‌های آن در دسترس هستند، اما برای نمونه‌های :class:`frozenset` یا زیرنوع‌های آن در دسترس نیستند."

msgid "Return ``1`` if found and removed, ``0`` if not found (no action taken), and ``-1`` if an error is encountered.  Does not raise :exc:`KeyError` for missing keys.  Raise a :exc:`TypeError` if the *key* is unhashable.  Unlike the Python :meth:`~set.discard` method, this function does not automatically convert unhashable sets into temporary frozensets. Raise :exc:`SystemError` if *set* is not an instance of :class:`set` or its subtype."
msgstr "اگر یافته و حذف شود، ``1``؛ اگر یافت نشود (هیچ عملی انجام نمی‌شود)، ``0``؛ و اگر با خطایی مواجه شود، ``-1`` برمی‌گرداند. استثنای :exc:`KeyError` را برای کلیدهای مفقود ایجاد نمی‌کند. اگر *key* هش‌ناپذیر باشد، استثنای :exc:`TypeError` ایجاد می‌کند. برخلاف متد :meth:`~set.discard` در پایتون، این تابع مجموعه‌های هش‌ناپذیر را به‌طور خودکار به frozenset‌های موقت تبدیل نمی‌کند. اگر *set* نمونه‌ای از :class:`set` یا زیرنوع آن نباشد، استثنای :exc:`SystemError` ایجاد می‌کند."

msgid "Return a new reference to an arbitrary object in the *set*, and removes the object from the *set*.  Return ``NULL`` on failure.  Raise :exc:`KeyError` if the set is empty. Raise a :exc:`SystemError` if *set* is not an instance of :class:`set` or its subtype."
msgstr "یک ارجاع جدید به یک شیء دلخواه در *set* برمی‌گرداند و آن شیء را از *set* حذف می‌کند. در صورت شکست ``NULL`` را برمی‌گرداند. اگر مجموعه خالی باشد، استثنای :exc:`KeyError` ایجاد می‌شود. اگر *set* نمونه‌ای از :class:`set` یا زیرنوع آن نباشد، استثنای :exc:`SystemError` ایجاد می‌شود."

msgid "Empty an existing set of all elements. Return ``0`` on success. Return ``-1`` and raise :exc:`SystemError` if *set* is not an instance of :class:`set` or its subtype."
msgstr "یک مجموعه‌ی موجود را از تمام عناصرش خالی می‌کند. در صورت موفقیت ``0`` را برمی‌گرداند. اگر *set* نمونه‌ای از :class:`set` یا زیرنوع آن نباشد، ``-1`` را برمی‌گرداند و استثنای :exc:`SystemError` را ایجاد می‌کند."

msgid "In the :term:`free-threaded build`, the set is emptied before its entries are cleared, so other threads will observe an empty set rather than intermediate states."
msgstr "در :term:`free-threaded build`، مجموعه پیش از پاک شدن ورودی‌هایش خالی می‌شود، بنابراین نخ‌های دیگر به‌جای وضعیت‌های میانی، مجموعه‌ای خالی را مشاهده خواهند کرد."

msgid "Deprecated API"
msgstr "API منسوخ"

msgid "A constant representing the size of an internal preallocated table inside :c:type:`PySetObject` instances."
msgstr "ثابتی که نشان‌دهنده‌ی اندازه‌ی جدول داخلی پیش‌تخصیص‌شده درون نمونه‌های :c:type:`PySetObject` است."

msgid "This is documented solely for completeness, as there are no guarantees that a given version of CPython uses preallocated tables with a fixed size. In code that does not deal with unstable set internals, :c:macro:`!PySet_MINSIZE` can be replaced with a small constant like ``8``."
msgstr "این مورد صرفاً برای کامل بودن مستند شده است، زیرا هیچ تضمینی وجود ندارد که نسخه‌ی خاصی از سی‌پایتون از جدول‌های پیش‌تخصیص‌شده با اندازه‌ی ثابت استفاده کند. در کدی که با جزئیات داخلی ناپایدار مجموعه سروکار ندارد، می‌توان :c:macro:`!PySet_MINSIZE` را با یک ثابت کوچک مانند ``8`` جایگزین کرد."

msgid "If looking for the size of a set, use :c:func:`PySet_Size` instead."
msgstr "اگر به دنبال اندازه‌ی یک مجموعه هستید، به‌جای آن از :c:func:`PySet_Size` استفاده کنید."

msgid "object"
msgstr "شیء"

msgid "set"
msgstr "مجموعه"

msgid "frozenset"
msgstr "frozenset"

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

msgid "len"
msgstr "len"