python-docs-fa/c-api/sequence.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
# 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: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 "Sequence Protocol"
msgstr "پروتکل دنباله"

msgid "Return ``1`` if the object provides the sequence protocol, and ``0`` otherwise. Note that it returns ``1`` for Python classes with a :meth:`~object.__getitem__` method, unless they are :class:`dict` subclasses, 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`` برمی‌گرداند، مگر آنکه زیرکلاس‌های :class:`dict` باشند، زیرا به‌طور کلی غیرممکن است تعیین کرد که کلاس از چه نوع کلیدهایی پشتیبانی می‌کند.  این تابع همیشه موفق می‌شود."

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

msgid "Return the concatenation of *o1* and *o2* on success, and ``NULL`` on failure. This is the equivalent of the Python expression ``o1 + o2``."
msgstr "در صورت موفقیت، الحاق *o1* و *o2* و در صورت شکست ``NULL`` را برمی‌گرداند. این معادل عبارت پایتونی ``o1 + o2`` است."

msgid "Return the result of repeating sequence object *o* *count* times, or ``NULL`` on failure.  This is the equivalent of the Python expression ``o * count``."
msgstr "نتیجه‌ی تکرار شیء دنباله‌ی *o* به تعداد *count* بار را برمی‌گرداند، یا در صورت شکست ``NULL`` برمی‌گرداند. این معادل عبارت پایتونی ``o * count`` است."

msgid "Return the concatenation of *o1* and *o2* on success, and ``NULL`` on failure. The operation is done *in-place* when *o1* supports it.  This is the equivalent of the Python expression ``o1 += o2``."
msgstr "در صورت موفقیت، الحاق *o1* و *o2* و در صورت شکست ``NULL`` را برمی‌گرداند. این عملیات زمانی که *o1* از آن پشتیبانی کند، به‌صورت *درجا* (in-place) انجام می‌شود. این معادل عبارت پایتونی ``o1 += o2`` است."

msgid "Return the result of repeating sequence object *o* *count* times, or ``NULL`` on failure.  The operation is done *in-place* when *o* supports it.  This is the equivalent of the Python expression ``o *= count``."
msgstr "نتیجه‌ی تکرار شیء دنباله *o* به تعداد *count* بار را برمی‌گرداند، یا در صورت شکست ``NULL``. این عملیات هنگامی که *o* از آن پشتیبانی کند، به‌صورت *درجا* (in-place) انجام می‌شود. این معادل عبارت پایتونی ``o *= count`` است."

msgid "Return the *i*\\ th element of *o*, or ``NULL`` on failure. This is the equivalent of the Python expression ``o[i]``."
msgstr "عنصر *i*\\ اُم از *o* را برمی‌گرداند، یا در صورت شکست ``NULL``. این معادل عبارت پایتونی ``o[i]`` است."

msgid "Return the slice of sequence object *o* between *i1* and *i2*, or ``NULL`` on failure. This is the equivalent of the Python expression ``o[i1:i2]``."
msgstr "اسلایس شیء دنباله *o* بین *i1* و *i2* را برمی‌گرداند، یا در صورت شکست ``NULL``. این معادل عبارت پایتونی ``o[i1:i2]`` است."

msgid "Assign object *v* to the *i*\\ th element of *o*.  Raise an exception and return ``-1`` on failure; return ``0`` on success.  This is the equivalent of the Python statement ``o[i] = v``.  This function *does not* \":term:`steal`\" a reference to *v*."
msgstr "شیء *v* را به عنصر *i*\\ ام از *o* اختصاص می‌دهد.  در صورت شکست، یک استثنا مطرح می‌کند و ``-1`` را برمی‌گرداند؛ در صورت موفقیت ``0`` را برمی‌گرداند.  این معادل دستور پایتونی ``o[i] = v`` است.  این تابع ارجاعی به *v* را \":term:`steal`\" *نمی‌کند*."

msgid "If *v* is ``NULL``, the element is deleted, but this feature is deprecated in favour of using :c:func:`PySequence_DelItem`."
msgstr "اگر *v* برابر ``NULL`` باشد، المان حذف می‌شود، اما این قابلیت منسوخ شده و به‌جای آن استفاده از :c:func:`PySequence_DelItem` توصیه می‌شود."

msgid "Delete the *i*\\ th element of object *o*.  Returns ``-1`` on failure.  This is the equivalent of the Python statement ``del o[i]``."
msgstr "عنصر *i*\\ اُم از شیء *o* را حذف می‌کند.  در صورت شکست ``-1`` برمی‌گرداند.  این معادل دستور پایتون ``del o[i]`` است."

msgid "Assign the sequence object *v* to the slice in sequence object *o* from *i1* to *i2*.  This is the equivalent of the Python statement ``o[i1:i2] = v``."
msgstr "شیء دنباله *v* را به اسلایس موجود در شیء دنباله *o* از *i1* تا *i2* منتسب کنید. این معادل دستور پایتونی ``o[i1:i2] = v`` است."

msgid "Delete the slice in sequence object *o* from *i1* to *i2*.  Returns ``-1`` on failure.  This is the equivalent of the Python statement ``del o[i1:i2]``."
msgstr "اسلایس موجود در شیء دنباله *o* را از *i1* تا *i2* حذف می‌کند. در صورت شکست، ``-1`` برمی‌گرداند. این معادل دستور پایتون ``del o[i1:i2]`` است."

msgid "Return the number of occurrences of *value* in *o*, that is, return the number of keys for which ``o[key] == value``.  On failure, return ``-1``.  This is equivalent to the Python expression ``o.count(value)``."
msgstr "تعداد رخدادهای *value* در *o* را بازمی‌گرداند؛ یعنی تعداد کلیدهایی که ``o[key] == value`` باشد را بازمی‌گرداند. در صورت شکست، ``-1`` بازمی‌گرداند. این معادل عبارت پایتونی ``o.count(value)`` است."

msgid "Determine if *o* contains *value*.  If an item in *o* is equal to *value*, return ``1``, otherwise return ``0``. On error, return ``-1``.  This is equivalent to the Python expression ``value in o``."
msgstr "بررسی می‌کند که آیا *o* شامل *value* است. اگر آیتمی در *o* برابر با *value* باشد، ``1`` و در غیر این صورت ``0`` برگردانده می‌شود. در صورت خطا، ``-1`` برگردانده می‌شود. این معادل عبارت پایتونی ``value in o`` است."

msgid "Alias for :c:func:`PySequence_Contains`."
msgstr "نام مستعاری برای :c:func:`PySequence_Contains`."

msgid "The function should no longer be used to write new code."
msgstr "این تابع نباید دیگر برای نوشتن کد جدید استفاده شود."

msgid "Return the first index *i* for which ``o[i] == value``.  On error, return ``-1``.    This is equivalent to the Python expression ``o.index(value)``."
msgstr "اولین اندیس *i* را که ``o[i] == value`` باشد برمی‌گرداند. در صورت خطا، ``-1`` را برمی‌گرداند. این معادل عبارت پایتونی ``o.index(value)`` است."

msgid "Return a list object with the same contents as the sequence or iterable *o*, or ``NULL`` on failure.  The returned list is guaranteed to be new.  This is equivalent to the Python expression ``list(o)``."
msgstr "یک شیء فهرست با همان محتویات دنباله یا پیمایش‌پذیر *o* برمی‌گرداند، یا در صورت شکست ``NULL``. تضمین می‌شود که فهرست بازگردانده‌شده جدید باشد. این معادل عبارت پایتونی ``list(o)`` است."

msgid "Return a tuple object with the same contents as the sequence or iterable *o*, or ``NULL`` on failure.  If *o* is a tuple, a new reference will be returned, otherwise a tuple will be constructed with the appropriate contents.  This is equivalent to the Python expression ``tuple(o)``."
msgstr "یک شیء تاپل با همان محتوای دنباله یا پیمایش‌پذیر *o* برمی‌گرداند، یا در صورت شکست ``NULL`` برمی‌گرداند. اگر *o* یک تاپل باشد، یک ارجاع جدید بازگردانده می‌شود؛ در غیر این صورت، تاپلی با محتوای مناسب ساخته می‌شود. این معادل عبارت پایتونی ``tuple(o)`` است."

msgid "Return the sequence or iterable *o* as an object usable by the other ``PySequence_Fast*`` family of functions. If the object is not a sequence or iterable, raises :exc:`TypeError` with *m* as the message text. Returns ``NULL`` on failure."
msgstr "دنباله یا پیمایش‌پذیر *o* را به‌صورت شیئی قابل استفاده توسط سایر توابع خانواده ``PySequence_Fast*`` برمی‌گرداند. اگر شیء یک دنباله یا پیمایش‌پذیر نباشد، استثنای :exc:`TypeError` را با *m* به‌عنوان متن پیام ایجاد می‌کند. در صورت شکست، ``NULL`` برمی‌گرداند."

msgid "The ``PySequence_Fast*`` functions are thus named because they assume *o* is a :c:type:`PyTupleObject` or a :c:type:`PyListObject` and access the data fields of *o* directly."
msgstr "توابع ``PySequence_Fast*`` به این دلیل چنین نام‌گذاری شده‌اند که فرض می‌کنند *o* یک :c:type:`PyTupleObject` یا :c:type:`PyListObject` است و مستقیماً به فیلدهای داده‌ی *o* دسترسی دارند."

msgid "As a CPython implementation detail, if *o* is already a sequence or list, it will be returned."
msgstr "به عنوان یک جزئیات از پیاده‌سازی سی‌پایتون، اگر *o* از قبل یک دنباله یا فهرست باشد، همان بازگردانده خواهد شد."

msgid "Returns the length of *o*, assuming that *o* was returned by :c:func:`PySequence_Fast` and that *o* is not ``NULL``.  The size can also be retrieved by calling :c:func:`PySequence_Size` on *o*, but :c:func:`PySequence_Fast_GET_SIZE` is faster because it can assume *o* is a list or tuple."
msgstr "طول *o* را برمی‌گرداند، با این فرض که *o* توسط :c:func:`PySequence_Fast` برگردانده‌شده و *o* برابر ``NULL`` نیست. اندازه را می‌توان با فراخوانی :c:func:`PySequence_Size` روی *o* نیز بازیابی کرد، اما :c:func:`PySequence_Fast_GET_SIZE` سریع‌تر است زیرا می‌تواند فرض کند *o* یک فهرست یا تاپل است."

msgid "Return the *i*\\ th element of *o*, assuming that *o* was returned by :c:func:`PySequence_Fast`, *o* is not ``NULL``, and that *i* is within bounds."
msgstr "بازگرداندن عنصر *i*\\ ام از *o*، با این فرض که *o* توسط :c:func:`PySequence_Fast` بازگردانده شده باشد، *o* برابر ``NULL`` نباشد و *i* در محدوده باشد."

msgid "Return the underlying array of PyObject pointers.  Assumes that *o* was returned by :c:func:`PySequence_Fast` and *o* is not ``NULL``."
msgstr "آرایه‌ی زیربنایی اشاره‌گرهای PyObject را برمی‌گرداند. فرض می‌کند که *o* توسط :c:func:`PySequence_Fast` برگردانده شده باشد و *o* برابر ``NULL`` نباشد."

msgid "Note, if a list gets resized, the reallocation may relocate the items array. So, only use the underlying array pointer in contexts where the sequence cannot change."
msgstr "توجه داشته باشید که اگر اندازه‌ی یک فهرست تغییر کند، تخصیص مجدد ممکن است آرایه‌ی آیتم‌ها را جابه‌جا کند. بنابراین، اشاره‌گر آرایه‌ی زیرین را تنها در زمینه‌هایی استفاده کنید که دنباله در آن‌ها نمی‌تواند تغییر کند."

msgid "Return the *i*\\ th element of *o* or ``NULL`` on failure. Faster form of :c:func:`PySequence_GetItem` but without checking that :c:func:`PySequence_Check` on *o* is true and without adjustment for negative indices."
msgstr "عنصر *i*\\ -ام از *o* یا در صورت شکست ``NULL`` را برمی‌گرداند. شکل سریع‌تری از :c:func:`PySequence_GetItem` است، اما بدون بررسی اینکه :c:func:`PySequence_Check` روی *o* درست باشد و بدون تعدیل اندیس‌های منفی."

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

msgid "len"
msgstr "len"

msgid "tuple"
msgstr "تاپل"