python-docs-fa/c-api/list.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
130
131
132
133
134
135
136
# 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 "List Objects"
msgstr "اشیاء فهرست"

msgid "This subtype of :c:type:`PyObject` represents a Python list object."
msgstr "این زیرنوع از :c:type:`PyObject` نمایانگر یک شیء فهرست پایتون است."

msgid "This instance of :c:type:`PyTypeObject` represents the Python list type. This is the same object as :class:`list` in the Python layer."
msgstr "این نمونه از :c:type:`PyTypeObject` نمایانگر نوع فهرست پایتون است. این همان شیء :class:`list` در لایه‌ی پایتون است."

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

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

msgid "Return a new list of length *len* on success, or ``NULL`` on failure."
msgstr "در صورت موفقیت، فهرست جدیدی به طول *len* برمی‌گرداند، یا در صورت شکست ``NULL``."

msgid "If *len* is greater than zero, the returned list object's items are set to ``NULL``. Thus you cannot use abstract API functions such as :c:func:`PySequence_SetItem` or expose the object to Python code before setting all items to a real object with :c:func:`PyList_SetItem` or :c:func:`PyList_SET_ITEM()`. The following APIs are safe APIs before the list is fully initialized: :c:func:`PyList_SetItem()` and :c:func:`PyList_SET_ITEM()`."
msgstr "اگر *len* بزرگ‌تر از صفر باشد، آیتم‌های شیء فهرست بازگردانده‌شده روی ``NULL`` تنظیم می‌شوند. بنابراین پیش از آنکه تمام آیتم‌ها را با :c:func:`PyList_SetItem` یا :c:func:`PyList_SET_ITEM()` روی یک شیء واقعی تنظیم کنید، نمی‌توانید از توابع API انتزاعی مانند :c:func:`PySequence_SetItem` استفاده کنید یا شیء را در دسترس کد پایتون قرار دهید. APIهای زیر پیش از آنکه فهرست به‌طور کامل مقداردهی اولیه شود، امن هستند: :c:func:`PyList_SetItem()` و :c:func:`PyList_SET_ITEM()`."

msgid "Return the length of the list object in *list*; this is equivalent to ``len(list)`` on a list object."
msgstr "طول شیء فهرست در *list* را برمی‌گرداند؛ این معادل ``len(list)`` روی یک شیء فهرست است."

msgid "Similar to :c:func:`PyList_Size`, but without error checking."
msgstr "مشابه :c:func:`PyList_Size`، اما بدون بررسی خطا."

msgid "Return the object at position *index* in the list pointed to by *list*.  The position must be non-negative; indexing from the end of the list is not supported.  If *index* is out of bounds (:code:`<0 or >=len(list)`), return ``NULL`` and set an :exc:`IndexError` exception."
msgstr "شیء موجود در موقعیت *index* در فهرستی که *list* به آن اشاره می‌کند را برمی‌گرداند. موقعیت باید نامنفی باشد؛ اندیس‌دهی از انتهای فهرست پشتیبانی نمی‌شود. اگر *index* خارج از محدوده باشد (:code:`<0 or >=len(list)`)، ``NULL`` را برمی‌گرداند و استثنای :exc:`IndexError` را تنظیم می‌کند."

msgid "Like :c:func:`PyList_GetItemRef`, but returns a :term:`borrowed reference` instead of a :term:`strong reference`."
msgstr "مانند :c:func:`PyList_GetItemRef`، اما به‌جای :term:`ارجاع قوی <strong reference>`، یک :term:`ارجاع امانتی <borrowed reference>` برمی‌گرداند."

msgid "In the :term:`free-threaded build`, the returned :term:`borrowed reference` may become invalid if another thread modifies the list concurrently. Prefer :c:func:`PyList_GetItemRef`, which returns a :term:`strong reference`."
msgstr "در :term:`ساخت‌ نخ‌آزاد <free-threaded build>`، :term:`ارجاع امانتی <borrowed reference>` بازگردانده‌شده ممکن است در صورت تغییر هم‌زمان فهرست توسط نخ دیگر، نامعتبر شود. بهتر است از :c:func:`PyList_GetItemRef` استفاده کنید که یک :term:`ارجاع قوی <strong reference>` برمی‌گرداند."

msgid "Similar to :c:func:`PyList_GetItem`, but without error checking."
msgstr "مشابه :c:func:`PyList_GetItem`، اما بدون بررسی خطا."

msgid "Set the item at index *index* in list to *item*.  Return ``0`` on success. If *index* is out of bounds, return ``-1`` and set an :exc:`IndexError` exception."
msgstr "آیتم موجود در اندیس *index* در فهرست را به *item* تنظیم می‌کند. در صورت موفقیت ``0`` را برمی‌گرداند. اگر *index* خارج از محدوده باشد، ``-1`` را برمی‌گرداند و استثنای :exc:`IndexError` را برقرار می‌کند."

msgid "This function \":term:`steals <steal>`\" a reference to *item*, even on error. On success, it discards a reference to an item already in the list at the affected position (unless it was ``NULL``)."
msgstr "این تابع ارجاعی به *item* را «:term:`می‌دزدد <steal>`»، حتی در صورت وقوع خطا. در صورت موفقیت، این تابع ارجاعی به آیتمی را که از قبل در موقعیت متأثر در فهرست بوده است، رها می‌کند (مگر آنکه ``NULL`` بوده باشد)."

msgid "Macro form of :c:func:`PyList_SetItem` without error checking. This is normally only used to fill in new lists where there is no previous content."
msgstr "فرم ماکرویِ :c:func:`PyList_SetItem` بدون بررسی خطا. این معمولاً فقط برای پر کردن فهرست‌های جدیدی که محتوای قبلی ندارند، استفاده می‌شود."

msgid "Bounds checking is performed as an assertion if Python is built in :ref:`debug mode <debug-build>` or :option:`with assertions <--with-assertions>`."
msgstr "اگر پایتون در :ref:`حالت اشکال‌زدایی <debug-build>` یا :option:`با ادعاها <--with-assertions>` ساخته شده باشد، بررسی کران‌ها به‌صورت یک ادعا انجام می‌شود."

msgid "This macro \":term:`steals <steal>`\" a reference to *item*, and, unlike :c:func:`PyList_SetItem`, does *not* discard a reference to any item that is being replaced; any reference in *list* at position *i* will be leaked."
msgstr "این ماکرو ارجاعی به *item* را «:term:`می‌دزدد <steal>`» و برخلاف :c:func:`PyList_SetItem`، ارجاع به هیچ آیتمی که جایگزین می‌شود را دور *نمی‌اندازد*؛ هر ارجاعی که در جایگاه *i* از *list* باشد، نشت خواهد کرد."

msgid "In the :term:`free-threaded build`, this macro has no internal synchronization. It is normally only used to fill in new lists where no other thread has a reference to the list. If the list may be shared, use :c:func:`PyList_SetItem` instead, which uses a :term:`per-object lock`."
msgstr "در :term:`ساخت‌ نخ‌آزاد <free-threaded build>`، این ماکرو هیچ همگام‌سازی داخلی ندارد. معمولاً تنها برای پر کردن فهرست‌های جدیدی استفاده می‌شود که هیچ نخ دیگری ارجاعی به آن فهرست ندارد. اگر ممکن است فهرست مشترک باشد، به‌جای آن از :c:func:`PyList_SetItem` استفاده کنید که از :term:`قفل به ازای هر شیء <per-object lock>` استفاده می‌کند."

msgid "Insert the item *item* into list *list* in front of index *index*.  Return ``0`` if successful; return ``-1`` and set an exception if unsuccessful. Analogous to ``list.insert(index, item)``."
msgstr "آیتم *item* را در جلوی اندیس *index* در فهرست *list* درج می‌کند. در صورت موفقیت ``0`` را برمی‌گرداند؛ در صورت عدم موفقیت ``-1`` را برمی‌گرداند و یک استثنا تنظیم می‌کند. مشابه ``list.insert(index, item)`` است."

msgid "Append the object *item* at the end of list *list*. Return ``0`` if successful; return ``-1`` and set an exception if unsuccessful.  Analogous to ``list.append(item)``."
msgstr "شیء *item* را به انتهای فهرست *list* می‌افزاید. در صورت موفقیت ``0`` را برمی‌گرداند؛ در صورت ناموفق بودن، ``-1`` را برمی‌گرداند و یک استثنا تنظیم می‌کند. مشابه ``list.append(item)`` است."

msgid "Return a list of the objects in *list* containing the objects *between* *low* and *high*.  Return ``NULL`` and set an exception if unsuccessful.  Analogous to ``list[low:high]``.  Indexing from the end of the list is not supported."
msgstr "فهرستی از اشیاء موجود در *list* را برمی‌گرداند که اشیاء *بین* *low* و *high* را در بر می‌گیرد.  در صورت شکست، ``NULL`` برمی‌گرداند و یک استثنا تنظیم می‌کند.  مشابه ``list[low:high]`` است.  اندیس‌گذاری از انتهای فهرست پشتیبانی نمی‌شود."

msgid "Set the slice of *list* between *low* and *high* to the contents of *itemlist*.  Analogous to ``list[low:high] = itemlist``. The *itemlist* may be ``NULL``, indicating the assignment of an empty list (slice deletion). Return ``0`` on success, ``-1`` on failure.  Indexing from the end of the list is not supported."
msgstr "اسلایس *list* بین *low* و *high* را برابر محتویات *itemlist* قرار می‌دهد. مشابه ``list[low:high] = itemlist`` است. *itemlist* می‌تواند ``NULL`` باشد که نشان‌دهنده‌ی انتساب یک فهرست خالی است (حذف اسلایس). در صورت موفقیت ``0`` و در صورت شکست ``-1`` را برمی‌گرداند. اندیس‌گذاری از انتهای فهرست پشتیبانی نمی‌شود."

msgid "In the :term:`free-threaded build`, when *itemlist* is a :class:`list`, both *list* and *itemlist* are locked for the duration of the operation. For other iterables (or ``NULL``), only *list* is locked."
msgstr "در :term:`ساخت‌ نخ‌آزاد <free-threaded build>`، وقتی *itemlist* یک :class:`list` باشد، هر دو *list* و *itemlist* در طول عملیات قفل می‌شوند. برای سایر پیمایش‌پذیرها (یا ``NULL``)، تنها *list* قفل می‌شود."

msgid "Extend *list* with the contents of *iterable*.  This is the same as ``PyList_SetSlice(list, PY_SSIZE_T_MAX, PY_SSIZE_T_MAX, iterable)`` and analogous to ``list.extend(iterable)`` or ``list += iterable``."
msgstr "*list* را با محتویات *iterable* گسترش می‌دهد.  این همان ``PyList_SetSlice(list, PY_SSIZE_T_MAX, PY_SSIZE_T_MAX, iterable)`` است و مشابه ``list.extend(iterable)`` یا ``list += iterable`` است."

msgid "Raise an exception and return ``-1`` if *list* is not a :class:`list` object. Return 0 on success."
msgstr "اگر *list* یک شیء :class:`list` نباشد، استثنا ایجاد می‌کند و ``-1`` را برمی‌گرداند. در صورت موفقیت ۰ را برمی‌گرداند."

msgid "In the :term:`free-threaded build`, when *iterable* is a :class:`list`, :class:`set`, :class:`dict`, or dict view, both *list* and *iterable* (or its underlying dict) are locked for the duration of the operation. For other iterables, only *list* is locked; *iterable* may be concurrently modified by another thread."
msgstr "در :term:`free-threaded build`، وقتی *iterable* یک :class:`list`، :class:`set`، :class:`dict` یا نمای دیکشنری باشد، هم *list* و هم *iterable* (یا دیکشنری زیربنایی آن) برای مدت‌زمان عملیات قفل می‌شوند. برای سایر پیمایش‌پذیرها، تنها *list* قفل می‌شود؛ *iterable* ممکن است به‌طور هم‌زمان توسط نخ دیگری تغییر داده شود."

msgid "Remove all items from *list*.  This is the same as ``PyList_SetSlice(list, 0, PY_SSIZE_T_MAX, NULL)`` and analogous to ``list.clear()`` or ``del list[:]``."
msgstr "تمام آیتم‌ها را از *list* حذف می‌کند. این همان ``PyList_SetSlice(list, 0, PY_SSIZE_T_MAX, NULL)`` است و مشابه ``list.clear()`` یا ``del list[:]`` است."

msgid "Raise an exception and return ``-1`` if *list* is not a :class:`list` object.  Return 0 on success."
msgstr "اگر *list* یک شیء :class:`list` نباشد، استثنا برمی‌انگیزد و ``-1`` را برمی‌گرداند. در صورت موفقیت 0 را برمی‌گرداند."

msgid "Sort the items of *list* in place.  Return ``0`` on success, ``-1`` on failure.  This is equivalent to ``list.sort()``."
msgstr "آیتم‌های *list* را درجا مرتب می‌کند. در صورت موفقیت ``0`` و در صورت شکست ``-1`` را برمی‌گرداند. این معادل ``list.sort()`` است."

msgid "In the :term:`free-threaded build`, element comparison via :meth:`~object.__lt__` can execute arbitrary Python code, during which the :term:`per-object lock` may be temporarily released. For built-in types (:class:`str`, :class:`int`, :class:`float`), the lock is not released during comparison."
msgstr "در :term:`نسخه‌ی نخ‌آزاد <free-threaded build>`، مقایسه‌ی عناصر از طریق :meth:`~object.__lt__` می‌تواند کد پایتون دلخواهی اجرا کند که در این مدت :term:`قفل به‌ازای هر شیء <per-object lock>` ممکن است به‌طور موقت آزاد شود. برای نوع‌های توکار (:class:`str`، :class:`int`، :class:`float`)، قفل در حین مقایسه آزاد نمی‌شود."

msgid "Reverse the items of *list* in place.  Return ``0`` on success, ``-1`` on failure.  This is the equivalent of ``list.reverse()``."
msgstr "آیتم‌های *list* را به‌صورت درجا معکوس می‌کند. در صورت موفقیت ``0`` و در صورت شکست ``-1`` برمی‌گرداند. این معادل ``list.reverse()`` است."

msgid "Return a new tuple object containing the contents of *list*; equivalent to ``tuple(list)``."
msgstr "یک شیء تاپل جدید حاوی محتوای *list* برمی‌گرداند؛ معادل ``tuple(list)`` است."

msgid "object"
msgstr "شیء"

msgid "list"
msgstr "فهرست"

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

msgid "len"
msgstr "len"

msgid "tuple"
msgstr "تاپل"