"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"
"X-Generator: Poedit 3.6\n"
msgid"Data Structures"
msgstr"ساختمان دادهها"
msgid"This chapter describes some things you've learned about already in more detail, and adds some new things as well."
msgstr"این فصل برخی از مواردی را که تاکنون یاد گرفتهاید با جزئیات بیشتری توضیح میدهد و همچنین چند مورد جدید نیز اضافه میکند."
msgid"More on Lists"
msgstr"بیشتر دربارهی فهرستها"
msgid"The :ref:`list <typesseq-list>` data type has some more methods. Here are all of the methods of list objects:"
msgstr"نوع دادهی :ref:`list <typesseq-list>` چند متد دیگر نیز دارد. در اینجا تمام متدهای اشیای list آمدهاند:"
msgid"Add an item to the end of the list. Similar to ``a[len(a):] = [x]``."
msgstr"یک آیتم را به انتهای فهرست اضافه میکند. مشابه ``a[len(a):] = [x]`` است."
msgid"Extend the list by appending all the items from the iterable. Similar to ``a[len(a):] = iterable``."
msgstr"فهرست را با افزودن تمام آیتمهای شیء پیمایشپذیر گسترش میدهد. مشابه ``a[len(a):] = iterable`` است."
msgid"Insert an item at a given position. The first argument is the index of the element before which to insert, so ``a.insert(0, x)`` inserts at the front of the list, and ``a.insert(len(a), x)`` is equivalent to ``a.append(x)``."
msgstr"یک آیتم را در موقعیت مشخصی درج میکند. اولین آرگومان، اندیس عنصری است که آیتم باید پیش از آن درج شود؛ بنابراین ``a.insert(0, x)`` آیتم را در ابتدای فهرست درج میکند و ``a.insert(len(a), x)`` معادل ``a.append(x)`` است."
msgid"Remove the first item from the list whose value is equal to *value*. It raises a :exc:`ValueError` if there is no such item."
msgstr"اولین آیتم از فهرست را که مقدار آن برابر با *value* است حذف میکند. اگر چنین آیتمی وجود نداشته باشد، یک :exc:`ValueError` پرتاب میکند."
msgid"Remove the item at the given position in the list, and return it. If no index is specified, ``a.pop()`` removes and returns the last item in the list. It raises an :exc:`IndexError` if the list is empty or the index is outside the list range."
msgstr"آیتم موجود در موقعیت مشخصشده از فهرست را حذف میکند و آن را برمیگرداند. اگر هیچ اندیسی مشخص نشده باشد، ``a.pop()`` آخرین آیتم فهرست را حذف کرده و برمیگرداند. اگر فهرست خالی باشد یا اندیس خارج از محدودهی فهرست باشد، یک :exc:`IndexError` پرتاب میکند."
msgid"Remove all items from the list. Similar to ``del a[:]``."
msgstr"تمام آیتمهای فهرست را حذف میکند. مشابه ``del a[:]`` است."
msgid"Return zero-based index of the first occurrence of *value* in the list. Raises a :exc:`ValueError` if there is no such item."
msgstr"اندیس مبتنی بر صفرِ اولین رخداد *value* در فهرست را برمیگرداند. اگر چنین آیتمی وجود نداشته باشد، یک :exc:`ValueError` پرتاب میکند."
msgid"The optional arguments *start* and *end* are interpreted as in the slice notation and are used to limit the search to a particular subsequence of the list. The returned index is computed relative to the beginning of the full sequence rather than the *start* argument."
msgstr"آرگومانهای اختیاری *start* و *end* مانند نمادگذاری اسلایس تفسیر میشوند و برای محدود کردن جستوجو به یک زیردنبالهی مشخص از فهرست استفاده میشوند. اندیس بازگرداندهشده نسبت به ابتدای دنبالهی کامل محاسبه میشود، نه نسبت به آرگومان *start*."
msgid"Return the number of times *value* appears in the list."
msgstr"تعداد دفعاتی که *value* در فهرست ظاهر میشود را برمیگرداند."
msgid"Sort the items of the list in place (the arguments can be used for sort customization, see :func:`sorted` for their explanation)."
msgstr"آیتمهای فهرست را در جای خود مرتب میکند (آرگومانها میتوانند برای سفارشیسازی مرتبسازی استفاده شوند؛ برای توضیح آنها به :func:`sorted` مراجعه کنید)."
msgid"Reverse the elements of the list in place."
msgstr"عناصر فهرست را در جای خود معکوس میکند."
msgid"Return a shallow copy of the list. Similar to ``a[:]``."
msgstr"یک کپی سطحی از فهرست را برمیگرداند. مشابه ``a[:]`` است."
msgid"An example that uses most of the list methods::"
msgstr"مثالی که از بیشتر متدهای فهرست استفاده میکند::"
msgid"You might have noticed that methods like ``insert``, ``remove`` or ``sort`` that only modify the list have no return value printed -- they return the default ``None``. [#]_ This is a design principle for all mutable data structures in Python."
msgstr"ممکن است متوجه شده باشید که متدهایی مانند ``insert``، ``remove`` یا ``sort`` که فقط فهرست را تغییر میدهند، هیچ مقدار بازگشتی چاپشدهای ندارند -- آنها مقدار پیشفرض ``None`` را برمیگردانند. [#]_ این یک اصل طراحی برای تمام ساختارهای دادهی تغییرپذیر در پایتون است."
msgid"Another thing you might notice is that not all data can be sorted or compared. For instance, ``[None, 'hello', 10]`` doesn't sort because integers can't be compared to strings and ``None`` can't be compared to other types. Also, there are some types that don't have a defined ordering relation. For example, ``3+4j < 5+7j`` isn't a valid comparison."
msgstr"چیز دیگری که ممکن است متوجه شوید این است که همهی دادهها قابل مرتبسازی یا مقایسه نیستند. برای مثال، ``[None, 'hello', 10]`` مرتب نمیشود، زیرا اعداد صحیح را نمیتوان با رشتهها مقایسه کرد و ``None`` نیز با نوعهای دیگر قابل مقایسه نیست. همچنین برخی نوعها وجود دارند که رابطهی ترتیب تعریفشدهای ندارند. برای مثال، مقایسهی ``3+4j < 5+7j`` معتبر نیست."
msgid"Using Lists as Stacks"
msgstr"استفاده از فهرستها بهعنوان پشتهها"
msgid"The list methods make it very easy to use a list as a stack, where the last element added is the first element retrieved (\"last-in, first-out\"). To add an item to the top of the stack, use :meth:`~list.append`. To retrieve an item from the top of the stack, use :meth:`~list.pop` without an explicit index. For example::"
msgstr"متدهای فهرست استفاده از یک فهرست بهعنوان پشته را بسیار آسان میکنند؛ جایی که آخرین عنصری که اضافه میشود، اولین عنصری است که دریافت میشود («آخرین ورودی، اولین خروجی»). برای افزودن یک آیتم به بالای پشته، از :meth:`~list.append` استفاده کنید. برای دریافت یک آیتم از بالای پشته، از :meth:`~list.pop` بدون یک اندیس صریح استفاده کنید. برای مثال::"
msgid""
">>> stack = [3, 4, 5]\n"
">>> stack.append(6)\n"
">>> stack.append(7)\n"
">>> stack\n"
"[3, 4, 5, 6, 7]\n"
">>> stack.pop()\n"
"7\n"
">>> stack\n"
"[3, 4, 5, 6]\n"
">>> stack.pop()\n"
"6\n"
">>> stack.pop()\n"
"5\n"
">>> stack\n"
"[3, 4]"
msgstr""
">>> stack = [3, 4, 5]\n"
">>> stack.append(6)\n"
">>> stack.append(7)\n"
">>> stack\n"
"[3, 4, 5, 6, 7]\n"
">>> stack.pop()\n"
"7\n"
">>> stack\n"
"[3, 4, 5, 6]\n"
">>> stack.pop()\n"
"6\n"
">>> stack.pop()\n"
"5\n"
">>> stack\n"
"[3, 4]"
msgid"Using Lists as Queues"
msgstr"استفاده از فهرستها بهعنوان صف"
msgid"It is also possible to use a list as a queue, where the first element added is the first element retrieved (\"first-in, first-out\"); however, lists are not efficient for this purpose. While appends and pops from the end of list are fast, doing inserts or pops from the beginning of a list is slow (because all of the other elements have to be shifted by one). See :ref:`time-complexity` for more information."
msgstr"استفاده از یک فهرست به عنوان یک صف نیز ممکن است، جایی که اولین المان اضافه شده، اولین المان بازیابی شده است (\"first-in, first-out\"); با این حال، فهرستها برای این منظور کارآمد نیستند. در حالی که الحاق و حذف از انتهای فهرست سریع است، انجام درج یا حذف از ابتدای یک فهرست کند است (چون تمام المانهای دیگر باید به اندازهی ۱ جابجا شوند). برای اطلاعات بیشتر به :ref:`time-complexity` مراجعه کنید."
msgid"To implement a queue, use :class:`collections.deque` which was designed to have fast appends and pops from both ends. For example::"
msgstr"برای پیادهسازی صف، از :class:`collections.deque` استفاده کنید که برای داشتن افزودن و حذف سریع از هر دو انتها طراحی شده است. برای مثال::"
">>> queue.popleft() # The first to arrive now leaves\n"
"'Eric'\n"
">>> queue.popleft() # The second to arrive now leaves\n"
"'John'\n"
">>> queue # Remaining queue in order of arrival\n"
"deque(['Michael', 'Terry', 'Graham'])"
msgid"List Comprehensions"
msgstr"درکهای فهرستی"
msgid"List comprehensions provide a concise way to create lists. Common applications are to make new lists where each element is the result of some operations applied to each member of another sequence or iterable, or to create a subsequence of those elements that satisfy a certain condition."
msgstr"درکهای فهرستی روشی کوتاه و مختصر برای ایجاد فهرستها فراهم میکنند. کاربردهای رایج آنها ایجاد فهرستهای جدیدی است که در آنها هر عنصر، نتیجهی انجام برخی عملیات روی هر عضو از یک دنباله یا شیء پیمایشپذیر دیگر است، یا ایجاد یک زیردنباله از عناصری که یک شرط مشخص را برآورده میکنند."
msgid"For example, assume we want to create a list of squares, like::"
msgstr"برای مثال، فرض کنید میخواهیم فهرستی از مربعها ایجاد کنیم، مانند::"
msgid""
">>> squares = []\n"
">>> for x in range(10):\n"
"... squares.append(x**2)\n"
"...\n"
">>> squares\n"
"[0, 1, 4, 9, 16, 25, 36, 49, 64, 81]"
msgstr""
">>> squares = []\n"
">>> for x in range(10):\n"
"... squares.append(x**2)\n"
"...\n"
">>> squares\n"
"[0, 1, 4, 9, 16, 25, 36, 49, 64, 81]"
msgid"Note that this creates (or overwrites) a variable named ``x`` that still exists after the loop completes. We can calculate the list of squares without any side effects using::"
msgstr"توجه کنید که این کار یک متغیر با نام ``x`` ایجاد میکند (یا مقدار آن را بازنویسی میکند) که پس از پایان حلقه نیز همچنان وجود دارد. میتوانیم فهرست مربعها را بدون هیچ اثر جانبی با استفاده از روش زیر محاسبه کنیم::"
msgid"A list comprehension consists of brackets containing an expression followed by a :keyword:`!for` clause, then zero or more :keyword:`!for` or :keyword:`!if` clauses. The result will be a new list resulting from evaluating the expression in the context of the :keyword:`!for` and :keyword:`!if` clauses which follow it. For example, this listcomp combines the elements of two lists if they are not equal::"
msgstr"یک درک فهرستی شامل کروشههایی است که یک عبارت را در خود دارند و پس از آن یک بند :keyword:`!for` و سپس صفر یا چند بند :keyword:`!for` یا :keyword:`!if` قرار میگیرد. نتیجه، یک فهرست جدید خواهد بود که از ارزیابی عبارت در زمینهی بندهای :keyword:`!for` و :keyword:`!if` پس از آن بهدست میآید. برای مثال، این درک فهرستی عناصر دو فهرست را در صورتی که برابر نباشند با یکدیگر ترکیب میکند::"
msgid""
">>> [(x, y) for x in [1,2,3] for y in [3,1,4] if x != y]\n"
">>> # the tuple must be parenthesized, otherwise an error is raised\n"
">>> [x, x**2 for x in range(6)]\n"
" File \"<stdin>\", line 1\n"
" [x, x**2 for x in range(6)]\n"
" ^^^^^^^\n"
"SyntaxError: did you forget parentheses around the comprehension target?\n"
">>> # flatten a list using a listcomp with two 'for'\n"
">>> vec = [[1,2,3], [4,5,6], [7,8,9]]\n"
">>> [num for elem in vec for num in elem]\n"
"[1, 2, 3, 4, 5, 6, 7, 8, 9]"
msgid"List comprehensions can contain complex expressions and nested functions::"
msgstr"درکهای فهرستی میتوانند شامل عبارتهای پیچیده و توابع تودرتو باشند::"
msgid""
">>> from math import pi\n"
">>> [str(round(pi, i)) for i in range(1, 6)]\n"
"['3.1', '3.14', '3.142', '3.1416', '3.14159']"
msgstr""
">>> from math import pi\n"
">>> [str(round(pi, i)) for i in range(1, 6)]\n"
"['3.1', '3.14', '3.142', '3.1416', '3.14159']"
msgid"Nested List Comprehensions"
msgstr"درکهای فهرستی تودرتو"
msgid"The initial expression in a list comprehension can be any arbitrary expression, including another list comprehension."
msgstr"عبارت اولیه در یک درک فهرستی میتواند هر عبارت دلخواهی باشد، از جمله یک درک فهرستی دیگر."
msgid"Consider the following example of a 3x4 matrix implemented as a list of 3 lists of length 4::"
msgstr"مثال زیر را در نظر بگیرید که یک ماتریس 3x4 را بهصورت یک فهرست شامل 3 فهرست با طول 4 پیادهسازی میکند::"
msgid""
">>> matrix = [\n"
"... [1, 2, 3, 4],\n"
"... [5, 6, 7, 8],\n"
"... [9, 10, 11, 12],\n"
"... ]"
msgstr""
">>> matrix = [\n"
"... [1, 2, 3, 4],\n"
"... [5, 6, 7, 8],\n"
"... [9, 10, 11, 12],\n"
"... ]"
msgid"The following list comprehension will transpose rows and columns::"
msgstr"درک فهرستی زیر ردیفها و ستونها را جابهجا میکند::"
msgid""
">>> [[row[i] for row in matrix] for i in range(4)]\n"
"[[1, 5, 9], [2, 6, 10], [3, 7, 11], [4, 8, 12]]"
msgstr""
">>> [[row[i] for row in matrix] for i in range(4)]\n"
"[[1, 5, 9], [2, 6, 10], [3, 7, 11], [4, 8, 12]]"
msgid"As we saw in the previous section, the inner list comprehension is evaluated in the context of the :keyword:`for` that follows it, so this example is equivalent to::"
msgstr"همانطور که در بخش قبل دیدیم، درک فهرستی داخلی در زمینهی :keyword:`for` که پس از آن قرار گرفته است ارزیابی میشود؛ بنابراین این مثال معادل است با::"
msgid""
">>> transposed = []\n"
">>> for i in range(4):\n"
"... transposed.append([row[i] for row in matrix])\n"
"...\n"
">>> transposed\n"
"[[1, 5, 9], [2, 6, 10], [3, 7, 11], [4, 8, 12]]"
msgstr""
">>> transposed = []\n"
">>> for i in range(4):\n"
"... transposed.append([row[i] for row in matrix])\n"
"...\n"
">>> transposed\n"
"[[1, 5, 9], [2, 6, 10], [3, 7, 11], [4, 8, 12]]"
msgid"which, in turn, is the same as::"
msgstr"که به نوبهی خود، همانند این است::"
msgid""
">>> transposed = []\n"
">>> for i in range(4):\n"
"... # the following 3 lines implement the nested listcomp\n"
"... transposed_row = []\n"
"... for row in matrix:\n"
"... transposed_row.append(row[i])\n"
"... transposed.append(transposed_row)\n"
"...\n"
">>> transposed\n"
"[[1, 5, 9], [2, 6, 10], [3, 7, 11], [4, 8, 12]]"
msgstr""
">>> transposed = []\n"
">>> for i in range(4):\n"
"... # the following 3 lines implement the nested listcomp\n"
"... transposed_row = []\n"
"... for row in matrix:\n"
"... transposed_row.append(row[i])\n"
"... transposed.append(transposed_row)\n"
"...\n"
">>> transposed\n"
"[[1, 5, 9], [2, 6, 10], [3, 7, 11], [4, 8, 12]]"
msgid"In the real world, you should prefer built-in functions to complex flow statements. The :func:`zip` function would do a great job for this use case::"
msgstr"در دنیای واقعی، بهتر است از توابع توکار بهجای دستورهای جریان کنترل پیچیده استفاده کنید. تابع :func:`zip` برای این مورد کاربرد بسیار خوبی دارد::"
msgid""
">>> list(zip(*matrix))\n"
"[(1, 5, 9), (2, 6, 10), (3, 7, 11), (4, 8, 12)]"
msgstr""
">>> list(zip(*matrix))\n"
"[(1, 5, 9), (2, 6, 10), (3, 7, 11), (4, 8, 12)]"
msgid"See :ref:`tut-unpacking-arguments` for details on the asterisk in this line."
msgstr"برای جزئیات دربارهی ستاره در این خط، به :ref:`tut-unpacking-arguments` مراجعه کنید."
msgid"Unpacking in Lists and List Comprehensions"
msgstr"بازکردن بسته در فهرستها و درکهای فهرستی"
msgid"The section on :ref:`tut-unpacking-arguments` describes the use of ``*`` to \"unpack\" the elements of an iterable object, providing each one separately as an argument to a function. Unpacking can also be used in other contexts, for example, when creating lists. When specifying elements of a list, prefixing an expression by a ``*`` will unpack the result of that expression, adding each of its elements to the list we're creating::"
msgstr"بخش :ref:`tut-unpacking-arguments` استفاده از ``*`` را برای «بازکردن بسته» اجزای یک شیء پیمایشپذیر توصیف میکند و هر یک را بهطور جداگانه به عنوان آرگومان به یک تابع میفرستد. بازکردن بسته را میتوان در زمینههای دیگر نیز استفاده کرد، برای مثال، هنگام ایجاد فهرستها. هنگام مشخص کردن اجزای یک فهرست، قرار دادن پیشوند ``*`` پیش از یک عبارت، نتیجهی آن عبارت را باز میکند و هر یک از عناصر آن را به فهرستی که در حال ساخت آن هستیم اضافه میکند::"
msgid""
">>> x = [1, 2, 3]\n"
">>> [0, *x, 4, 5, 6]\n"
"[0, 1, 2, 3, 4, 5, 6]"
msgstr""
">>> x = [1, 2, 3]\n"
">>> [0, *x, 4, 5, 6]\n"
"[0, 1, 2, 3, 4, 5, 6]"
msgid"This only works if the expression following the ``*`` evaluates to an iterable object; trying to unpack a non-iterable object will raise an exception::"
msgstr"این کار تنها زمانی کار میکند که عبارت پس از ``*`` به یک شیء پیمایشپذیر ارزیابی شود؛ تلاش برای بازکردن بستهی یک شیء غیرپیمایشپذیر یک استثنا ایجاد خواهد کرد::"
msgid""
">>> x = 1\n"
">>> [0, *x, 2, 3, 4]\n"
"Traceback (most recent call last):\n"
" File \"<python-input-1>\", line 1, in <module>\n"
" [0, *x, 2, 3, 4]\n"
"TypeError: Value after * must be an iterable, not int"
msgstr""
">>> x = 1\n"
">>> [0, *x, 2, 3, 4]\n"
"Traceback (most recent call last):\n"
" File \"<python-input-1>\", line 1, in <module>\n"
" [0, *x, 2, 3, 4]\n"
"TypeError: Value after * must be an iterable, not int"
msgid"Unpacking can also be used in list comprehensions, as a way to build a new list representing the concatenation of an arbitrary number of iterables::"
msgstr"بازکردن بسته را همچنین میتوان در درک فهرستیها، به عنوان روشی برای ساخت یک فهرست جدید که نشاندهندهی اتصال تعداد دلخواهی از اشیاء پیمایشپذیر است، استفاده کرد::"
msgid"Note that the effect is that each element from ``x`` is unpacked. This works for arbitrary iterable objects, not just lists::"
msgstr"توجه داشته باشید که اثر این کار باز شدن بستهی هر عنصر از ``x`` است. این کار برای اشیاء پیمایشپذیر دلخواه، و نه فقط فهرستها، کار میکند::"
msgid""
">>> x = [[1, 2, 3], 'cat', {'spam': 'eggs'}]\n"
">>> [*element for element in x]\n"
"[1, 2, 3, 'c', 'a', 't', 'spam']"
msgstr""
">>> x = [[1, 2, 3], 'cat', {'spam': 'eggs'}]\n"
">>> [*element for element in x]\n"
"[1, 2, 3, 'c', 'a', 't', 'spam']"
msgid"But if the objects in ``x`` are not iterable, this expression would again raise an exception."
msgstr"اما اگر اشیاء موجود در ``x`` پیمایشپذیر نباشند، این عبارت دوباره یک استثنا ایجاد خواهد کرد."
msgid"The :keyword:`!del` statement"
msgstr"دستور :keyword:`!del`"
msgid"There is a way to remove an item from a list given its index instead of its value: the :keyword:`del` statement. This differs from the :meth:`~list.pop` method which returns a value. The :keyword:`!del` statement can also be used to remove slices from a list or clear the entire list (which we did earlier by assignment of an empty list to the slice). For example::"
msgstr"روشی برای حذف یک آیتم از فهرست با استفاده از اندیس آن بهجای مقدار آن وجود دارد: دستور :keyword:`del`. این دستور با متد :meth:`~list.pop` که یک مقدار برمیگرداند تفاوت دارد. دستور :keyword:`!del` همچنین میتواند برای حذف اسلایسهایی از یک فهرست یا خالی کردن کامل فهرست استفاده شود (که پیشتر با انتساب یک فهرست خالی به اسلایس انجام دادیم). برای مثال::"
msgid""
">>> a = [-1, 1, 66.25, 333, 333, 1234.5]\n"
">>> del a[0]\n"
">>> a\n"
"[1, 66.25, 333, 333, 1234.5]\n"
">>> del a[2:4]\n"
">>> a\n"
"[1, 66.25, 1234.5]\n"
">>> del a[:]\n"
">>> a\n"
"[]"
msgstr""
">>> a = [-1, 1, 66.25, 333, 333, 1234.5]\n"
">>> del a[0]\n"
">>> a\n"
"[1, 66.25, 333, 333, 1234.5]\n"
">>> del a[2:4]\n"
">>> a\n"
"[1, 66.25, 1234.5]\n"
">>> del a[:]\n"
">>> a\n"
"[]"
msgid":keyword:`del` can also be used to delete entire variables::"
msgstr":keyword:`del` همچنین میتواند برای حذف کامل متغیرها استفاده شود::"
msgid">>> del a"
msgstr">>> del a"
msgid"Referencing the name ``a`` hereafter is an error (at least until another value is assigned to it). We'll find other uses for :keyword:`del` later."
msgstr"ارجاع دادن به نام ``a`` پس از این نقطه یک خطا است (حداقل تا زمانی که مقدار دیگری به آن اختصاص داده شود). بعداً کاربردهای دیگری برای :keyword:`del` خواهیم یافت."
msgid"Tuples and Sequences"
msgstr"تاپلها و دنبالهها"
msgid"We saw that lists and strings have many common properties, such as indexing and slicing operations. They are two examples of *sequence* data types (see :ref:`typesseq`). Since Python is an evolving language, other sequence data types may be added. There is also another standard sequence data type: the *tuple*."
msgstr"دیدیم که فهرستها و رشتهها ویژگیهای مشترک بسیاری مانند عملیات اندیسگذاری و اسلایس دارند. آنها دو نمونه از نوعهای دادهی *دنبالهای* (به :ref:`typesseq` مراجعه کنید) هستند. از آنجا که پایتون زبانی در حال تکامل است، ممکن است نوعهای دادهی دنبالهای دیگری نیز به آن افزوده شوند. همچنین یک نوع دادهی دنبالهای استاندارد دیگر وجود دارد: *تاپل*."
msgid"A tuple consists of a number of values separated by commas, for instance::"
msgstr"یک تاپل از تعدادی مقدار تشکیل شده است که با ویرگول از هم جدا شدهاند، برای مثال::"
msgid""
">>> t = 12345, 54321, 'hello!'\n"
">>> t[0]\n"
"12345\n"
">>> t\n"
"(12345, 54321, 'hello!')\n"
">>> # Tuples may be nested:\n"
">>> u = t, (1, 2, 3, 4, 5)\n"
">>> u\n"
"((12345, 54321, 'hello!'), (1, 2, 3, 4, 5))\n"
">>> # Tuples are immutable:\n"
">>> t[0] = 88888\n"
"Traceback (most recent call last):\n"
" File \"<stdin>\", line 1, in <module>\n"
"TypeError: 'tuple' object does not support item assignment\n"
">>> # but they can contain mutable objects:\n"
">>> v = ([1, 2, 3], [3, 2, 1])\n"
">>> v\n"
"([1, 2, 3], [3, 2, 1])\n"
">>> # they support unpacking just like lists:\n"
">>> x = [1, 2, 3]\n"
">>> 0, *x, 4\n"
"(0, 1, 2, 3, 4)"
msgstr""
">>> t = 12345, 54321, 'hello!'\n"
">>> t[0]\n"
"12345\n"
">>> t\n"
"(12345, 54321, 'hello!')\n"
">>> # Tuples may be nested:\n"
">>> u = t, (1, 2, 3, 4, 5)\n"
">>> u\n"
"((12345, 54321, 'hello!'), (1, 2, 3, 4, 5))\n"
">>> # Tuples are immutable:\n"
">>> t[0] = 88888\n"
"Traceback (most recent call last):\n"
" File \"<stdin>\", line 1, in <module>\n"
"TypeError: 'tuple' object does not support item assignment\n"
">>> # but they can contain mutable objects:\n"
">>> v = ([1, 2, 3], [3, 2, 1])\n"
">>> v\n"
"([1, 2, 3], [3, 2, 1])\n"
">>> # they support unpacking just like lists:\n"
">>> x = [1, 2, 3]\n"
">>> 0, *x, 4\n"
"(0, 1, 2, 3, 4)"
msgid"As you see, on output tuples are always enclosed in parentheses, so that nested tuples are interpreted correctly; they may be input with or without surrounding parentheses, although often parentheses are necessary anyway (if the tuple is part of a larger expression). It is not possible to assign to the individual items of a tuple, however it is possible to create tuples which contain mutable objects, such as lists."
msgstr"همانطور که میبینید، در خروجی تاپلها همیشه درون پرانتز قرار میگیرند تا تاپلهای تودرتو بهدرستی تفسیر شوند؛ آنها میتوانند با یا بدون پرانتزهای اطرافشان وارد شوند، اگرچه اغلب پرانتزها به هر حال لازم هستند (اگر تاپل بخشی از یک عبارت بزرگتر باشد). امکان انتساب به آیتمهای جداگانهی یک تاپل وجود ندارد، بااینحال میتوان تاپلهایی ایجاد کرد که شامل اشیای تغییرپذیر، مانند فهرستها، باشند."
msgid"Though tuples may seem similar to lists, they are often used in different situations and for different purposes. Tuples are :term:`immutable`, and usually contain a heterogeneous sequence of elements that are accessed via unpacking (see later in this section) or indexing (or even by attribute in the case of :func:`namedtuples <collections.namedtuple>`). Lists are :term:`mutable`, and their elements are usually homogeneous and are accessed by iterating over the list."
msgstr"اگرچه تاپلها ممکن است شبیه فهرستها به نظر برسند، اغلب در موقعیتها و برای اهداف متفاوتی استفاده میشوند. تاپلها :term:`تغییرناپذیر <immutable>` هستند و معمولاً شامل یک دنبالهی ناهمگن از عناصر هستند که از طریق واگشایی (در ادامهی این بخش توضیح داده میشود) یا اندیسگذاری (یا حتی از طریق ویژگیها در مورد :func:`namedtuples <collections.namedtuple>`) به آنها دسترسی پیدا میشود. فهرستها :term:`تغییرپذیر <mutable>` هستند و عناصر آنها معمولاً همگن هستند و با پیمایش روی فهرست به آنها دسترسی پیدا میشود."
msgid"A special problem is the construction of tuples containing 0 or 1 items: the syntax has some extra quirks to accommodate these. Empty tuples are constructed by an empty pair of parentheses; a tuple with one item is constructed by following a value with a comma (it is not sufficient to enclose a single value in parentheses). Ugly, but effective. For example::"
msgstr"یک مسئلهی ویژه، ساخت تاپلهایی است که شامل 0 یا 1 آیتم هستند: سینتکس زبان برای سازگاری با این موارد چند نکتهی خاص دارد. تاپلهای خالی با یک جفت پرانتز خالی ساخته میشوند؛ یک تاپل با یک آیتم با قرار دادن یک ویرگول پس از یک مقدار ساخته میشود (قرار دادن یک مقدار تنها درون پرانتز کافی نیست). زشت، اما مؤثر. برای مثال::"
msgid"The statement ``t = 12345, 54321, 'hello!'`` is an example of *tuple packing*: the values ``12345``, ``54321`` and ``'hello!'`` are packed together in a tuple. The reverse operation is also possible::"
msgstr"دستور ``t = 12345, 54321, 'hello!'`` نمونهای از *بستهبندی تاپل* (*tuple packing*) است: مقدارهای ``12345``، ``54321`` و ``'hello!'`` در یک تاپل بستهبندی میشوند. عملیات معکوس نیز امکانپذیر است::"
msgid">>> x, y, z = t"
msgstr">>> x, y, z = t"
msgid"This is called, appropriately enough, *sequence unpacking* and works for any sequence on the right-hand side. Sequence unpacking requires that there are as many variables on the left side of the equals sign as there are elements in the sequence. Note that multiple assignment is really just a combination of tuple packing and sequence unpacking."
msgstr"این عملیات، بهدرستی، *واگشایی دنباله* (*sequence unpacking*) نامیده میشود و برای هر دنبالهای در سمت راست کار میکند. واگشایی دنباله نیاز دارد که در سمت چپ علامت مساوی به همان تعداد عناصر موجود در دنباله، متغیر وجود داشته باشد. توجه کنید که انتساب چندگانه در واقع ترکیبی از بستهبندی تاپل و واگشایی دنباله است."
msgid"Sets"
msgstr"مجموعهها"
msgid"Python also includes a data type for :ref:`sets <types-set>`. A set is an unordered collection with no duplicate elements. Basic uses include membership testing and eliminating duplicate entries. Set objects also support mathematical operations like union, intersection, difference, and symmetric difference."
msgstr"پایتون همچنین یک نوع داده برای :ref:`مجموعهها <types-set>` دارد. یک مجموعه، مجموعهای نامرتب از عناصر بدون مقدارهای تکراری است. کاربردهای پایهی آن شامل بررسی عضویت و حذف ورودیهای تکراری است. اشیای مجموعه همچنین از عملیات ریاضی مانند اجتماع، اشتراک، تفاضل و تفاضل متقارن پشتیبانی میکنند."
msgid"Curly braces or the :func:`set` function can be used to create sets. Note: to create an empty set you have to use ``set()``, not ``{}``; the latter creates an empty dictionary, a data structure that we discuss in the next section."
msgstr"از آکولادها یا تابع :func:`set` میتوان برای ایجاد مجموعهها استفاده کرد. توجه: برای ایجاد یک مجموعهی خالی باید از ``set()`` استفاده کنید، نه ``{}``؛ مورد دوم یک دیکشنری خالی ایجاد میکند، که یک ساختار داده است و در بخش بعدی دربارهی آن صحبت میکنیم."
msgid"Because sets are unordered, iterating over them or printing them can produce the elements in a different order than you expect."
msgstr"از آنجا که مجموعهها نامرتب هستند، پیمایش روی آنها یا چاپ کردنشان ممکن است عناصر را با ترتیبی متفاوت از چیزی که انتظار دارید تولید کند."
msgid"Another useful data type built into Python is the *dictionary* (see :ref:`typesmapping`). Dictionaries are sometimes found in other languages as \"associative memories\" or \"associative arrays\". Unlike sequences, which are indexed by a range of numbers, dictionaries are indexed by *keys*, which can be any immutable type; strings and numbers can always be keys. Tuples can be used as keys if they contain only strings, numbers, or tuples; if a tuple contains any mutable object either directly or indirectly, it cannot be used as a key. You can't use lists as keys, since lists can be modified in place using index assignments, slice assignments, or methods like :meth:`~list.append` and :meth:`~list.extend`."
msgstr "یک نوع دادهی مفید دیگر که بهصورت توکار در پایتون وجود دارد، *دیکشنری* است (به :ref:`typesmapping` مراجعه کنید). دیکشنریها در برخی زبانهای دیگر با نام «حافظههای انجمنی» یا «آرایههای انجمنی» شناخته میشوند. برخلاف دنبالهها که با یک بازه از اعداد اندیسگذاری میشوند، دیکشنریها با *کلیدها* اندیسگذاری میشوند؛ کلیدها میتوانند هر نوع تغییرناپذیری باشند؛ رشتهها و اعداد همیشه میتوانند کلید باشند. تاپلها نیز میتوانند بهعنوان کلید استفاده شوند، اگر فقط شامل رشتهها، اعداد یا تاپلها باشند؛ اگر یک تاپل بهصورت مستقیم یا غیرمستقیم شامل یک شیء تغییرپذیر باشد، نمیتوان از آن بهعنوان کلید استفاده کرد. نمیتوانید از فهرستها بهعنوان کلید استفاده کنید، زیرا فهرستها را میتوان با استفاده از انتساب اندیسی، انتساب اسلایس، یا متدهایی مانند :meth:`~list.append` و :meth:`~list.extend` در محل تغییر داد."
msgid"It is best to think of a dictionary as a set of *key: value* pairs, with the requirement that the keys are unique (within one dictionary). A pair of braces creates an empty dictionary: ``{}``. Placing a comma-separated list of key:value pairs within the braces adds initial key:value pairs to the dictionary; this is also the way dictionaries are written on output."
msgstr"بهترین روش این است که یک دیکشنری را بهعنوان مجموعهای از جفتهای *کلید: مقدار* در نظر بگیرید، با این شرط که کلیدها (درون یک دیکشنری) یکتا باشند. یک جفت آکولاد یک دیکشنری خالی ایجاد میکند: ``{}``. قرار دادن یک فهرست جداشده با ویرگول از جفتهای کلید:مقدار درون آکولاد، جفتهای اولیهی کلید:مقدار را به دیکشنری اضافه میکند؛ این همان روشی است که دیکشنریها در خروجی نوشته میشوند."
msgid"The main operations on a dictionary are storing a value with some key and extracting the value given the key. It is also possible to delete a key:value pair with ``del``. If you store using a key that is already in use, the old value associated with that key is forgotten."
msgstr"عملیات اصلی روی یک دیکشنری، ذخیره کردن یک مقدار با یک کلید مشخص و استخراج مقدار با استفاده از کلید است. همچنین امکان حذف یک جفت کلید:مقدار با استفاده از ``del`` وجود دارد. اگر مقداری را با کلیدی ذخیره کنید که از قبل استفاده شده است، مقدار قدیمی مرتبط با آن کلید فراموش میشود."
msgid"Extracting a value for a non-existent key by subscripting (``d[key]``) raises a :exc:`KeyError`. To avoid getting this error when trying to access a possibly non-existent key, use the :meth:`~dict.get` method instead, which returns ``None`` (or a specified default value) if the key is not in the dictionary."
msgstr"استخراج مقدار برای کلیدی که وجود ندارد با استفاده از زیرنویسی (``d[key]``) باعث رخ دادن :exc:`KeyError` میشود. برای جلوگیری از دریافت این خطا هنگام تلاش برای دسترسی به کلیدی که ممکن است وجود نداشته باشد، بهجای آن از متد :meth:`~dict.get` استفاده کنید؛ این متد اگر کلید در دیکشنری وجود نداشته باشد، ``None`` (یا یک مقدار پیشفرض مشخصشده) را برمیگرداند."
msgid"Performing ``list(d)`` on a dictionary returns a list of all the keys used in the dictionary, in insertion order (if you want it sorted, just use ``sorted(d)`` instead). To check whether a single key is in the dictionary, use the :keyword:`in` keyword."
msgstr"اجرای ``list(d)`` روی یک دیکشنری، فهرستی از تمام کلیدهای استفادهشده در دیکشنری را با ترتیب درج آنها برمیگرداند (اگر میخواهید مرتب شده باشد، فقط از ``sorted(d)`` استفاده کنید). برای بررسی اینکه یک کلید مشخص در دیکشنری وجود دارد یا نه، از کلیدواژهای :keyword:`in` استفاده کنید."
msgid"Here is a small example using a dictionary::"
msgstr"در اینجا یک مثال کوچک با استفاده از یک دیکشنری آورده شده است::"
msgid""
">>> tel = {'jack': 4098, 'sape': 4139}\n"
">>> tel['guido'] = 4127\n"
">>> tel\n"
"{'jack': 4098, 'sape': 4139, 'guido': 4127}\n"
">>> tel['jack']\n"
"4098\n"
">>> tel['irv']\n"
"Traceback (most recent call last):\n"
" File \"<stdin>\", line 1, in <module>\n"
"KeyError: 'irv'\n"
">>> print(tel.get('irv'))\n"
"None\n"
">>> del tel['sape']\n"
">>> tel['irv'] = 4127\n"
">>> tel\n"
"{'jack': 4098, 'guido': 4127, 'irv': 4127}\n"
">>> list(tel)\n"
"['jack', 'guido', 'irv']\n"
">>> sorted(tel)\n"
"['guido', 'irv', 'jack']\n"
">>> 'guido' in tel\n"
"True\n"
">>> 'jack' not in tel\n"
"False"
msgstr""
">>> tel = {'jack': 4098, 'sape': 4139}\n"
">>> tel['guido'] = 4127\n"
">>> tel\n"
"{'jack': 4098, 'sape': 4139, 'guido': 4127}\n"
">>> tel['jack']\n"
"4098\n"
">>> tel['irv']\n"
"Traceback (most recent call last):\n"
" File \"<stdin>\", line 1, in <module>\n"
"KeyError: 'irv'\n"
">>> print(tel.get('irv'))\n"
"None\n"
">>> del tel['sape']\n"
">>> tel['irv'] = 4127\n"
">>> tel\n"
"{'jack': 4098, 'guido': 4127, 'irv': 4127}\n"
">>> list(tel)\n"
"['jack', 'guido', 'irv']\n"
">>> sorted(tel)\n"
"['guido', 'irv', 'jack']\n"
">>> 'guido' in tel\n"
"True\n"
">>> 'jack' not in tel\n"
"False"
msgid"The :func:`dict` constructor builds dictionaries directly from sequences of key-value pairs::"
msgstr"سازندهی :func:`dict` دیکشنریها را مستقیماً از دنبالههایی از جفتهای کلید-مقدار ایجاد میکند::"
msgid"In addition, dict comprehensions can be used to create dictionaries from arbitrary key and value expressions::"
msgstr"علاوه بر این، درکهای دیکشنری میتوانند برای ایجاد دیکشنریها از عبارتهای دلخواه کلید و مقدار استفاده شوند::"
msgid""
">>> {x: x**2 for x in (2, 4, 6)}\n"
"{2: 4, 4: 16, 6: 36}"
msgstr""
">>> {x: x**2 for x in (2, 4, 6)}\n"
"{2: 4, 4: 16, 6: 36}"
msgid"And dictionary unpacking (via ``**``) can be used to merge multiple dictionaries::"
msgstr"و بازکردن بستهی دیکشنری (از طریق ``**``) را میتوان برای ادغام چندین دیکشنری استفاده کرد::"
msgid""
">>> odds = {i: i**2 for i in (1, 3, 5)}\n"
">>> evens = {i: i**2 for i in (2, 4, 6)}\n"
">>> {**odds, **evens}\n"
"{1: 1, 3: 9, 5: 25, 2: 4, 4: 16, 6: 36}\n"
"\n"
">>> all_values = [odds, evens, {0: 0}]\n"
">>> {**i for i in all_values}\n"
"{1: 1, 3: 9, 5: 25, 2: 4, 4: 16, 6: 36, 0: 0}"
msgstr""
">>> odds = {i: i**2 for i in (1, 3, 5)}\n"
">>> evens = {i: i**2 for i in (2, 4, 6)}\n"
">>> {**odds, **evens}\n"
"{1: 1, 3: 9, 5: 25, 2: 4, 4: 16, 6: 36}\n"
"\n"
">>> all_values = [odds, evens, {0: 0}]\n"
">>> {**i for i in all_values}\n"
"{1: 1, 3: 9, 5: 25, 2: 4, 4: 16, 6: 36, 0: 0}"
msgid"When the keys are simple strings, it is sometimes easier to specify pairs using keyword arguments::"
msgstr"هنگامی که کلیدها رشتههای ساده هستند، گاهی مشخص کردن جفتها با استفاده از آرگومانهای کلیدواژهای آسانتر است::"
msgid""
">>> dict(sape=4139, guido=4127, jack=4098)\n"
"{'sape': 4139, 'guido': 4127, 'jack': 4098}"
msgstr""
">>> dict(sape=4139, guido=4127, jack=4098)\n"
"{'sape': 4139, 'guido': 4127, 'jack': 4098}"
msgid"Looping Techniques"
msgstr"تکنیکهای حلقهزنی"
msgid"When looping through dictionaries, the key and corresponding value can be retrieved at the same time using the :meth:`~dict.items` method. ::"
msgstr"هنگام پیمایش روی دیکشنریها، کلید و مقدار متناظر آن را میتوان بهطور همزمان با استفاده از متد :meth:`~dict.items` دریافت کرد. ::"
msgid""
">>> knights = {'gallahad': 'the pure', 'robin': 'the brave'}\n"
">>> for k, v in knights.items():\n"
"... print(k, v)\n"
"...\n"
"gallahad the pure\n"
"robin the brave"
msgstr""
">>> knights = {'gallahad': 'the pure', 'robin': 'the brave'}\n"
">>> for k, v in knights.items():\n"
"... print(k, v)\n"
"...\n"
"gallahad the pure\n"
"robin the brave"
msgid"When looping through a sequence, the position index and corresponding value can be retrieved at the same time using the :func:`enumerate` function. ::"
msgstr"هنگام پیمایش روی یک دنباله، اندیس موقعیت و مقدار متناظر آن را میتوان بهطور همزمان با استفاده از تابع :func:`enumerate` دریافت کرد. ::"
msgid""
">>> for i, v in enumerate(['tic', 'tac', 'toe']):\n"
"... print(i, v)\n"
"...\n"
"0 tic\n"
"1 tac\n"
"2 toe"
msgstr""
">>> for i, v in enumerate(['tic', 'tac', 'toe']):\n"
"... print(i, v)\n"
"...\n"
"0 tic\n"
"1 tac\n"
"2 toe"
msgid"To loop over two or more sequences at the same time, the entries can be paired with the :func:`zip` function. ::"
msgstr"برای پیمایش روی دو یا چند دنباله بهطور همزمان، میتوان ورودیهای آنها را با استفاده از تابع :func:`zip` جفت کرد. ::"
">>> answers = ['lancelot', 'the holy grail', 'blue']\n"
">>> for q, a in zip(questions, answers):\n"
"... print('What is your {0}? It is {1}.'.format(q, a))\n"
"...\n"
"What is your name? It is lancelot.\n"
"What is your quest? It is the holy grail.\n"
"What is your favorite color? It is blue."
msgid"To loop over a sequence in reverse, first specify the sequence in a forward direction and then call the :func:`reversed` function. ::"
msgstr"برای پیمایش روی یک دنباله بهصورت معکوس، ابتدا دنباله را در جهت عادی مشخص کنید و سپس تابع :func:`reversed` را فراخوانی کنید. ::"
msgid""
">>> for i in reversed(range(1, 10, 2)):\n"
"... print(i)\n"
"...\n"
"9\n"
"7\n"
"5\n"
"3\n"
"1"
msgstr""
">>> for i in reversed(range(1, 10, 2)):\n"
"... print(i)\n"
"...\n"
"9\n"
"7\n"
"5\n"
"3\n"
"1"
msgid"To loop over a sequence in sorted order, use the :func:`sorted` function which returns a new sorted list while leaving the source unaltered. ::"
msgstr"برای پیمایش روی یک دنباله با ترتیب مرتبشده، از تابع :func:`sorted` استفاده کنید که یک فهرست مرتبشدهی جدید برمیگرداند، بدون اینکه دنبالهی اصلی را تغییر دهد. ::"
msgid"Using :func:`set` on a sequence eliminates duplicate elements. The use of :func:`sorted` in combination with :func:`set` over a sequence is an idiomatic way to loop over unique elements of the sequence in sorted order. ::"
msgstr"استفاده از :func:`set` روی یک دنباله، عناصر تکراری را حذف میکند. استفاده از :func:`sorted` همراه با :func:`set` روی یک دنباله، روشی رایج در پایتون برای پیمایش روی عناصر یکتای دنباله با ترتیب مرتبشده است. ::"
msgid"It is sometimes tempting to change a list while you are looping over it; however, it is often simpler and safer to create a new list instead. ::"
msgstr"گاهی هنگام پیمایش روی یک فهرست وسوسه میشویم که آن را تغییر دهیم؛ بااینحال، اغلب سادهتر و امنتر است که بهجای آن یک فهرست جدید ایجاد کنیم. ::"
msgid"The conditions used in ``while`` and ``if`` statements can contain any operators, not just comparisons."
msgstr"شرطهایی که در دستورهای ``while`` و ``if`` استفاده میشوند، میتوانند شامل هر عملگری باشند، نه فقط عملگرهای مقایسهای."
msgid"The comparison operators ``in`` and ``not in`` are membership tests that determine whether a value is in (or not in) a container. The operators ``is`` and ``is not`` compare whether two objects are really the same object. All comparison operators have the same priority, which is lower than that of all numerical operators."
msgstr"عملگرهای مقایسهای ``in`` و ``not in`` آزمونهای عضویت هستند که مشخص میکنند آیا یک مقدار درون یک ظرف (یا خارج از آن) قرار دارد یا نه. عملگرهای ``is`` و ``is not`` بررسی میکنند که آیا دو شیء واقعاً همان شیء یکسان هستند یا خیر. تمام عملگرهای مقایسهای اولویت یکسانی دارند که از اولویت تمام عملگرهای عددی پایینتر است."
msgid"Comparisons can be chained. For example, ``a < b == c`` tests whether ``a`` is less than ``b`` and moreover ``b`` equals ``c``."
msgstr"مقایسهها میتوانند زنجیرهای باشند. برای مثال، ``a < b == c`` بررسی میکند که آیا ``a`` کوچکتر از ``b`` است و علاوه بر آن ``b`` با ``c`` برابر است."
msgid"Comparisons may be combined using the Boolean operators ``and`` and ``or``, and the outcome of a comparison (or of any other Boolean expression) may be negated with ``not``. These have lower priorities than comparison operators; between them, ``not`` has the highest priority and ``or`` the lowest, so that ``A and not B or C`` is equivalent to ``(A and (not B)) or C``. As always, parentheses can be used to express the desired composition."
msgstr"مقایسهها را میتوان با استفاده از عملگرهای بولی ``and`` و ``or`` ترکیب کرد و نتیجهی یک مقایسه (یا هر عبارت بولی دیگر) را میتوان با ``not`` نقیض کرد. این عملگرها اولویت پایینتری نسبت به عملگرهای مقایسهای دارند؛ در میان آنها، ``not`` بالاترین اولویت و ``or`` پایینترین اولویت را دارد، بنابراین ``A and not B or C`` معادل ``(A and (not B)) or C`` است. همانند همیشه، میتوان از پرانتزها برای بیان ترکیب موردنظر استفاده کرد."
msgid"The Boolean operators ``and`` and ``or`` are so-called *short-circuit* operators: their arguments are evaluated from left to right, and evaluation stops as soon as the outcome is determined. For example, if ``A`` and ``C`` are true but ``B`` is false, ``A and B and C`` does not evaluate the expression ``C``. When used as a general value and not as a Boolean, the return value of a short-circuit operator is the last evaluated argument."
msgstr"عملگرهای بولی ``and`` و ``or`` بهاصطلاح عملگرهای *کوتاهمدار* هستند: آرگومانهای آنها از چپ به راست ارزیابی میشوند و ارزیابی بهمحض مشخص شدن نتیجه متوقف میشود. برای مثال، اگر ``A`` و ``C`` درست باشند اما ``B`` نادرست باشد، عبارت ``A and B and C`` عبارت ``C`` را ارزیابی نمیکند. هنگامی که یک عملگر کوتاهمدار بهعنوان یک مقدار عمومی و نه بهعنوان یک مقدار بولی استفاده میشود، مقدار بازگشتی آن آخرین آرگومان ارزیابیشده است."