python-docs-fa/c-api/iterator.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
# 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:
# 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 "Iterator Objects"
msgstr "اشیاء پیمایش‌گر"

msgid "Python provides two general-purpose iterator objects.  The first, a sequence iterator, works with an arbitrary sequence supporting the :meth:`~object.__getitem__` method.  The second works with a callable object and a sentinel value, calling the callable for each item in the sequence, and ending the iteration when the sentinel value is returned."
msgstr "پایتون دو شیء پیمایش‌گر همه‌منظوره فراهم می‌کند. اولی یک پیمایش‌گر دنباله است که با هر دنباله دلخواهی که از متد :meth:`~object.__getitem__` پشتیبانی می‌کند کار می‌کند. دومی با یک شیء فراخوانی‌پذیر و یک مقدار نشانگر کار می‌کند؛ فراخوانی‌پذیر برای هر آیتم در دنباله فراخوانی می‌شود و پیمایش هنگامی که مقدار نشانگر بازگردانده شود پایان می‌یابد."

msgid "Type object for iterator objects returned by :c:func:`PySeqIter_New` and the one-argument form of the :func:`iter` built-in function for built-in sequence types."
msgstr "شیء نوع برای اشیاء پیمایش‌گری که توسط :c:func:`PySeqIter_New` و شکل تک‌آرگومانی تابع توکار :func:`iter` برای نوع‌های دنباله توکار بازگردانده می‌شوند."

msgid "Return true if the type of *op* is :c:data:`PySeqIter_Type`.  This function always succeeds."
msgstr "اگر نوع *op* برابر :c:data:`PySeqIter_Type` باشد، مقدار true را برمی‌گرداند. این تابع همیشه با موفقیت انجام می‌شود."

msgid "Return an iterator that works with a general sequence object, *seq*.  The iteration ends when the sequence raises :exc:`IndexError` for the subscripting operation."
msgstr "یک پیمایش‌گر برمی‌گرداند که با شیء دنباله‌ی عمومی، *seq* کار می‌کند. پیمایش زمانی پایان می‌یابد که دنباله هنگام عملیات زیرنویسی، استثنای :exc:`IndexError` را ایجاد کند."

msgid "Type object for iterator objects returned by :c:func:`PyCallIter_New` and the two-argument form of the :func:`iter` built-in function."
msgstr "شیء نوع برای اشیاء پیمایش‌گری که توسط :c:func:`PyCallIter_New` و شکل دوآرگومانی تابع توکار :func:`iter` بازگردانده می‌شوند."

msgid "Return true if the type of *op* is :c:data:`PyCallIter_Type`.  This function always succeeds."
msgstr "اگر نوع *op* برابر با :c:data:`PyCallIter_Type` باشد، مقدار true را برمی‌گرداند. این تابع همیشه با موفقیت اجرا می‌شود."

msgid "Return a new iterator.  The first parameter, *callable*, can be any Python callable object that can be called with no parameters; each call to it should return the next item in the iteration.  When *callable* returns a value equal to *sentinel*, the iteration will be terminated."
msgstr "یک پیمایش‌گر جدید برگردانید. پارامتر اول، *callable*، می‌تواند هر شیء فراخوانی‌پذیر پایتونی باشد که بدون هیچ پارامتری می‌توان آن را فراخوانی کرد؛ هر فراخوانی آن باید آیتم بعدی در پیمایش را برگرداند. وقتی *callable* مقداری برابر با *sentinel* برگرداند، پیمایش خاتمه می‌یابد."

msgid "Range Objects"
msgstr "اشیاء بازه"

msgid "The type object for :class:`range` objects."
msgstr "شیء نوع برای اشیاء :class:`range`."

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

msgid "Builtin Iterator Types"
msgstr "نوع‌های پیمایش‌گر توکار"

msgid "These are built-in iteration types that are included in Python's C API, but provide no additional functions. They are here for completeness."
msgstr "این‌ها نوع‌های پیمایش توکار هستند که در API زبان C پایتون گنجانده شده‌اند، اما هیچ تابع اضافه‌ای ارائه نمی‌دهند. آن‌ها برای کامل بودن اینجا قرار دارند."

msgid "C type"
msgstr "نوع C"

msgid "Python type"
msgstr "نوع پایتونی"

msgid ":py:class:`enumerate`"
msgstr ":py:class:`enumerate`"

msgid ":py:class:`filter`"
msgstr ":py:class:`filter`"

msgid ":py:class:`map`"
msgstr ":py:class:`map`"

msgid ":py:class:`reversed`"
msgstr ":py:class:`reversed`"

msgid ":py:class:`zip`"
msgstr ":py:class:`zip`"

msgid "Other Iterator Objects"
msgstr "سایر اشیاء پیمایش‌گر"

msgid "Type objects for iterators of various built-in objects."
msgstr "شیءهای نوع برای پیمایش‌گرهای شیءهای توکار گوناگون."

msgid "Do not create instances of these directly; prefer calling :c:func:`PyObject_GetIter` instead."
msgstr "نمونه‌هایی از این‌ها را مستقیماً ایجاد نکنید؛ به جای آن، فراخوانی :c:func:`PyObject_GetIter` را ترجیح دهید."

msgid "Note that there is no guarantee that a given built-in type uses a given iterator type. For example, iterating over :class:`range` will use one of two iterator types depending on the size of the range. Other types may start using a similar scheme in the future, without warning."
msgstr "توجه داشته باشید که هیچ تضمینی وجود ندارد که یک نوع توکار مشخص از نوع پیمایش‌گر مشخصی استفاده کند. برای مثال، پیمایش روی :class:`range` بسته به اندازه‌ی بازه از یکی از دو نوع پیمایش‌گر استفاده می‌کند. نوع‌های دیگر ممکن است در آینده بدون هشدار شروع به استفاده از طرح‌واره‌ای مشابه کنند."