GitHub Viewer

# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001 Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: # Alireza Shabani (Revisto) , 2025 # Danial Behzadi , 2025 # Rafael Fontenelle , 2025 # Sepehr Rasouli , 2026 # arman mohebali , 2026 # msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2026-10-13 04:22+0000\n" "PO-Revision-Date: 2026-10-06 19:51+0330\n" "Last-Translator: Sepehr Rasouli , 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" "X-Generator: Poedit 3.6\n" msgid "Expressions" msgstr "عبارات" msgid "This chapter explains the meaning of the elements of expressions in Python." msgstr "این فصل معنای عناصر عبارت‌ها در پایتون را توضیح می‌دهد." msgid "**Syntax Notes:** In this and the following chapters, :ref:`grammar notation ` will be used to describe syntax, not lexical analysis." msgstr "**یادداشت‌های سینتکس:** در این فصل و فصل‌های پس از آن، از :ref:`نمادگذاری دستور زبان ` برای توصیف سینتکس استفاده خواهد شد، نه برای تحلیل واژگانی." msgid "When (one alternative of) a syntax rule has the form:" msgstr "هنگامی که (یکی از جایگزین‌های) یک قاعده‌ی سینتکس به شکل زیر باشد:" msgid "and no semantics are given, the semantics of this form of ``name`` are the same as for ``othername``." msgstr "و هیچ معنایی ارائه نشده است، معنای این شکل از ``name`` همان معنای ``othername`` است." msgid "Arithmetic conversions" msgstr "تبدیلات حسابی" msgid "When a description of an arithmetic operator below uses the phrase \"the numeric arguments are converted to a common real type\", this means that the operator implementation for built-in numeric types works as described in the :ref:`Numeric Types ` section of the standard library documentation." msgstr "هرگاه در توضیح یک عملگر حسابی در زیر از عبارت «آرگومان‌های عددی به یک نوع حقیقی مشترک تبدیل می‌شوند» استفاده شده باشد، این بدان معناست که پیاده‌سازی عملگر برای انواع عددی توکار، همان‌طور که در بخش :ref:`انواع عددی ` مستندات کتابخانه استاندارد توضیح داده شده است، کار می‌کند." msgid "Some additional rules apply for certain operators and non-numeric operands (for example, a string as a left argument to the ``%`` operator). Extensions must define their own conversion behavior." msgstr "برخی قواعد اضافی برای برخی عملگرها و عملوندهای غیرعددی اعمال می‌شوند (برای مثال، یک رشته به‌عنوان آرگومان سمت چپ عملگر ``%``). افزونه‌ها باید رفتار تبدیل خود را تعریف کنند." msgid "Atoms" msgstr "اتم‌ها" msgid "Atoms are the most basic elements of expressions. The simplest atoms are :ref:`builtin constants `, :ref:`names ` and :ref:`literals `. More complex atoms are enclosed in paired delimiters:" msgstr "اتم‌ها اساسی‌ترین عناصر عبارت‌ها هستند. ساده‌ترین اتم‌ها :ref:`ثابت‌های توکار `، :ref:`نام‌ها ` و :ref:`لیترال‌ها ` هستند. اتم‌های پیچیده‌تر در درون جفت‌جداکننده‌ها قرار می‌گیرند:" msgid "``()`` (parentheses): :ref:`groups `, :ref:`tuple displays `, :ref:`yield atoms `, and :ref:`generator expressions `;" msgstr "``()`` (پرانتزها): :ref:`گروه‌ها `، :ref:`نمایش‌های تاپل `، :ref:`اتم‌های yield ` و :ref:`عبارت‌های مولد `؛" msgid "``[]`` (square brackets): :ref:`list displays `;" msgstr "``[]`` (براکت‌ها): :ref:`نمایش‌های فهرست `؛" msgid "``{}`` (curly braces): :ref:`dictionary ` and :ref:`set ` displays." msgstr "``{}`` (آکولادها): نمایش‌های :ref:`دیکشنری ` و :ref:`مجموعه `." msgid "Formally, the syntax for atoms is:" msgstr "به‌طور رسمی، سینتکس اتم‌ها عبارت است از:" msgid "Built-in constants" msgstr "ثابت‌های توکار" msgid "The keywords ``True``, ``False``, and ``None`` name :ref:`built-in constants `. The token ``...`` names the :py:data:`Ellipsis` constant." msgstr "کلیدواژه‌های ``True``، ``False`` و ``None`` نام‌های :ref:`ثابت‌های توکار ` هستند. توکن ``...`` نام ثابت :py:data:`Ellipsis` است." msgid "Evaluation of these atoms yields the corresponding value." msgstr "ارزیابی این اتم‌ها مقدار متناظر را به دست می‌دهد." msgid "Several more built-in constants are available as global variables, but only the ones mentioned here are :ref:`keywords `. In particular, these names cannot be reassigned or used as attributes:" msgstr "چند ثابت توکار دیگر نیز به‌عنوان متغیرهای سراسری در دسترس هستند، اما تنها مواردی که در اینجا ذکر شده‌اند :ref:`کلیدواژه‌ها ` هستند. به‌ویژه، این نام‌ها را نمی‌توان دوباره مقداردهی کرد یا به‌عنوان ویژگی استفاده کرد:" msgid "" ">>> False = 123\n" " File \"\", line 1\n" " False = 123\n" " ^^^^^\n" "SyntaxError: cannot assign to False" msgstr "" ">>> False = 123\n" " File \"\", line 1\n" " False = 123\n" " ^^^^^\n" "SyntaxError: cannot assign to False" msgid "Formally, the syntax for built-in constants is:" msgstr "به‌طور رسمی، نحوه (سینتکس) ثابت‌های توکار به این صورت است:" msgid "Identifiers (Names)" msgstr "شناسه‌ها (نام‌ها)" msgid "An identifier occurring as an atom is a name. See section :ref:`identifiers` for lexical definition and section :ref:`naming` for documentation of naming and binding." msgstr "یک شناسه که به‌عنوان یک اتم (atom) ظاهر می‌شود، یک نام است. بخش :ref:`identifiers` را برای تعریف واژگانی و بخش :ref:`naming` را برای مستندات نام‌گذاری و پیوند ببینید." msgid "When the name is bound to an object, evaluation of the atom yields that object. When a name is not bound, an attempt to evaluate it raises a :exc:`NameError` exception." msgstr "هنگامی که نام به یک شیء مقید شده باشد، ارزیابی اتم، آن شیء را حاصل می‌کند. هنگامی که نامی مقید نشده باشد، تلاش برای ارزیابی آن، استثنای :exc:`NameError` را پرتاب می‌کند." msgid "Private name mangling" msgstr "تغییر نام خصوصی (private name mangling)" msgid "When an identifier that textually occurs in a class definition begins with two or more underscore characters and does not end in two or more underscores, it is considered a :dfn:`private name` of that class." msgstr "هرگاه شناسه‌ای که در متن تعریف یک کلاس آمده باشد با ۲ یا چند نویسه زیرخط آغاز شود و به ۲ یا چند زیرخط ختم نشود، یک :dfn:`نام خصوصی (private name)` برای آن کلاس محسوب می‌شود." msgid "The :ref:`class specifications `." msgstr ":ref:`مشخصات کلاس `." msgid "More precisely, private names are transformed to a longer form before code is generated for them. If the transformed name is longer than 255 characters, implementation-defined truncation may happen." msgstr "دقیق‌تر اینکه، نام‌های خصوصی پیش از تولید کد برای آن‌ها به شکل طولانی‌تری تبدیل می‌شوند. اگر نام تبدیل‌شده طولانی‌تر از ۲۵۵ نویسه باشد، ممکن است کوتاه‌سازی (truncation) تعریف‌شده توسط پیاده‌سازی رخ دهد." msgid "The transformation is independent of the syntactical context in which the identifier is used but only the following private identifiers are mangled:" msgstr "این تبدیل مستقل از زمینه‌ی نحوی‌ای است که شناسه در آن استفاده می‌شود، اما تنها شناسه‌های خصوصی زیر تغییر نام داده می‌شوند:" msgid "Any name used as the name of a variable that is assigned or read or any name of an attribute being accessed." msgstr "هر نامی که به‌عنوان نام متغیری استفاده شود که به آن مقدار انتساب داده می‌شود یا خوانده می‌شود، یا هر نامی از یک ویژگی که مورد دسترسی قرار می‌گیرد." msgid "The :attr:`~definition.__name__` attribute of nested functions, classes, and type aliases is however not mangled." msgstr "با این حال، ویژگی :attr:`~definition.__name__` در توابع، کلاس‌ها و نام‌های مستعار نوع تودرتو تغییر نام نمی‌یابد." msgid "The name of imported modules, e.g., ``__spam`` in ``import __spam``. If the module is part of a package (i.e., its name contains a dot), the name is *not* mangled, e.g., the ``__foo`` in ``import __foo.bar`` is not mangled." msgstr "نام ماژول‌های ایمپورت‌شده، برای مثال ``__spam`` در ``import __spam``. اگر ماژول بخشی از یک بسته باشد (یعنی نام آن شامل نقطه باشد)، نام دستکاری *نمی‌شود*، برای مثال ``__foo`` در ``import __foo.bar`` دستکاری نمی‌شود." msgid "The name of an imported member, e.g., ``__f`` in ``from spam import __f``." msgstr "نام یک عضو ایمپورت‌شده، مثلاً ``__f`` در ``from spam import __f``." msgid "The transformation rule is defined as follows:" msgstr "قاعده تبدیل به‌صورت زیر تعریف شده است:" msgid "The class name, with leading underscores removed and a single leading underscore inserted, is inserted in front of the identifier, e.g., the identifier ``__spam`` occurring in a class named ``Foo``, ``_Foo`` or ``__Foo`` is transformed to ``_Foo__spam``." msgstr "نام کلاس، پس از حذف زیرسطرهای آغازین و افزودن یک زیرخط در ابتدا، در جلوی شناسه قرار می‌گیرد؛ برای مثال، شناسه‌ی ``__spam`` که در کلاسی با نام ``Foo``، ``_Foo`` یا ``__Foo`` آمده باشد، به ``_Foo__spam`` تبدیل می‌شود." msgid "If the class name consists only of underscores, the transformation is the identity, e.g., the identifier ``__spam`` occurring in a class named ``_`` or ``__`` is left as is." msgstr "اگر نام کلاس فقط از زیرخط تشکیل شده باشد، تبدیل همانی است؛ برای مثال، شناسه‌ی ``__spam`` که در کلاسی با نام ``_`` یا ``__`` آمده است، بدون تغییر باقی می‌ماند." msgid "Literals" msgstr "مقادیر لفظی" msgid "A :dfn:`literal` is a textual representation of a value. Python supports numeric, string and bytes literals. :ref:`Format strings ` and :ref:`template strings ` are treated as string literals." msgstr ":dfn:`لفظی (literal)` نمایشی متنی از یک مقدار است. پایتون از مقادیر لفظی عددی، رشته‌ای و بایتی پشتیبانی می‌کند. :ref:`اف‌استرینگ‌ها ` و :ref:`رشته‌های قالبی ` به‌عنوان مقادیر لفظی رشته‌ای در نظر گرفته می‌شوند." msgid "Numeric literals consist of a single :token:`NUMBER ` token, which names an integer, floating-point number, or an imaginary number. See the :ref:`numbers` section in Lexical analysis documentation for details." msgstr "مقادیر لفظی عددی از یک توکن :token:`NUMBER ` تشکیل شده‌اند که یک عدد صحیح، عدد ممیز شناور یا عدد موهومی را مشخص می‌کند. برای جزئیات، بخش :ref:`numbers` را در مستندات تحلیل واژگانی ببینید." msgid "String and bytes literals may consist of several tokens. See section :ref:`string-concatenation` for details." msgstr "مقادیر لفظی رشته و بایت ممکن است از چندین توکن تشکیل شده باشند. برای جزئیات، بخش :ref:`string-concatenation` را ببینید." msgid "Note that negative and complex numbers, like ``-3`` or ``3+4.2j``, are syntactically not literals, but :ref:`unary ` or :ref:`binary ` arithmetic operations involving the ``-`` or ``+`` operator." msgstr "توجه داشته باشید که اعداد منفی و مختلط، مانند ``-3`` یا ``3+4.2j``، از نظر سینتکسی لفظی نیستند، بلکه عملیات حسابی :ref:`یک‌عملوندی ` یا :ref:`دوعملوندی ` هستند که شامل عملگر ``-`` یا ``+`` می‌شوند." msgid "Evaluation of a literal yields an object of the given type (:class:`int`, :class:`float`, :class:`complex`, :class:`str`, :class:`bytes`, or :class:`~string.templatelib.Template`) with the given value. The value may be approximated in the case of floating-point and imaginary literals." msgstr "ارزیابی یک لفظی، شیء‌ای از نوع داده‌شده (:class:`int`، :class:`float`، :class:`complex`، :class:`str`، :class:`bytes`، یا :class:`~string.templatelib.Template`) با مقدار داده‌شده را به دست می‌دهد. در مورد مقادیر لفظی ممیز شناور و موهومی، ممکن است مقدار تقریبی باشد." msgid "The formal grammar for literals is:" msgstr "دستور زبان صوری برای مقادیر لفظی چنین است:" msgid "Literals and object identity" msgstr "مقادیر لفظی و هویت شیء" msgid "All literals correspond to immutable data types, and hence the object's identity is less important than its value. Multiple evaluations of literals with the same value (either the same occurrence in the program text or a different occurrence) may obtain the same object or a different object with the same value." msgstr "همه‌ی مقادیر لفظی با انواع داده‌ی تغییرناپذیر متناظر هستند، و از این رو، هویت شیء کم‌اهمیت‌تر از مقدار آن است. ارزیابی‌های متعدد مقادیر لفظیی با مقدار یکسان (چه همان محل در متن برنامه و چه محلی دیگر) ممکن است همان شیء یا شیء متفاوتی با همان مقدار را به دست آورند." msgid "CPython implementation detail" msgstr "جزئیات پیاده‌سازی CPython" msgid "For example, in CPython, *small* integers with the same value evaluate to the same object::" msgstr "برای مثال، در CPython، اعداد صحیح *کوچک* با مقدار یکسان، به یک شیء یکسان ارزیابی می‌شوند::" msgid "" ">>> x = 7\n" ">>> y = 7\n" ">>> x is y\n" "True" msgstr "" ">>> x = 7\n" ">>> y = 7\n" ">>> x is y\n" "True" msgid "However, large integers evaluate to different objects::" msgstr "با این حال، اعداد صحیح بزرگ به اشیاء متفاوتی ارزیابی می‌شوند::" msgid "" ">>> x = 123456789\n" ">>> y = 123456789\n" ">>> x is y\n" "False" msgstr "" ">>> x = 123456789\n" ">>> y = 123456789\n" ">>> x is y\n" "False" msgid "This behavior may change in future versions of CPython. In particular, the boundary between \"small\" and \"large\" integers has already changed in the past." msgstr "این رفتار ممکن است در نسخه‌های آینده CPython تغییر کند. به‌ویژه، مرز بین اعداد صحیح «کوچک» و «بزرگ» پیش‌تر تغییر کرده است." msgid "CPython will emit a :py:exc:`SyntaxWarning` when you compare literals using ``is``::" msgstr "CPython هنگامی که مقادیر لفظی را با استفاده از ``is`` مقایسه می‌کنید، یک :py:exc:`SyntaxWarning` نشان می‌دهد::" msgid "" ">>> x = 7\n" ">>> x is 7\n" ":1: SyntaxWarning: \"is\" with 'int' literal. Did you mean \"==\"?\n" "True" msgstr "" ">>> x = 7\n" ">>> x is 7\n" ":1: SyntaxWarning: \"is\" with 'int' literal. Did you mean \"==\"?\n" "True" msgid "See :ref:`faq-identity-with-is` for more information." msgstr "برای اطلاعات بیشتر، :ref:`faq-identity-with-is` را ببینید." msgid ":ref:`Template strings ` are immutable but may reference mutable objects as :class:`~string.templatelib.Interpolation` values. For the purposes of this section, two t-strings have the \"same value\" if both their structure and the *identity* of the values match." msgstr ":ref:`رشته‌های الگو ` تغییرناپذیر هستند، اما ممکن است به اشیای تغییرپذیر به‌عنوان مقادیر :class:`~string.templatelib.Interpolation` ارجاع دهند. برای اهداف این بخش، دو تی‌استرینگ «مقدار یکسان» دارند اگر هم ساختار آن‌ها و هم *هویت* مقادیرشان مطابقت داشته باشد." msgid "Currently, each evaluation of a template string results in a different object." msgstr "در حال حاضر، هر ارزیابی از یک رشته‌ی قالب به یک شیء متفاوت منجر می‌شود." msgid "String literal concatenation" msgstr "الحاق رشته‌های لفظی" msgid "Multiple adjacent string or bytes literals, possibly using different quoting conventions, are allowed, and their meaning is the same as their concatenation::" msgstr "مقادیر لفظی مجاور رشته یا بایت، که ممکن است از قواعد متفاوتی برای علامت نقل‌قول استفاده کنند، مجاز هستند و معنای آن‌ها همان معنای الحاق آن‌ها است::" msgid "" ">>> \"hello\" 'world'\n" "\"helloworld\"" msgstr "" ">>> \"hello\" 'world'\n" "\"helloworld\"" msgid "This feature is defined at the syntactical level, so it only works with literals. To concatenate string expressions at run time, the '+' operator may be used::" msgstr "این قابلیت در سطح سینتکس تعریف شده است، بنابراین فقط با مقادیر لفظی کار می‌کند. برای الحاق عبارات رشته‌ای در ران‌تایم، می‌توان از عملگر '+' استفاده کرد::" msgid "" ">>> greeting = \"Hello\"\n" ">>> space = \" \"\n" ">>> name = \"Blaise\"\n" ">>> print(greeting + space + name) # not: print(greeting space name)\n" "Hello Blaise" msgstr "" ">>> greeting = \"Hello\"\n" ">>> space = \" \"\n" ">>> name = \"Blaise\"\n" ">>> print(greeting + space + name) # not: print(greeting space name)\n" "Hello Blaise" msgid "Literal concatenation can freely mix raw strings, triple-quoted strings, and formatted string literals. For example::" msgstr "در الحاق لفظی می‌توان آزادانه رشته‌های خام، رشته‌های سه‌نقل‌قولی و مقادیر لفظی رشته‌ای قالب‌بندی‌شده را با هم ترکیب کرد. برای مثال::" msgid "" ">>> \"Hello\" r', ' f\"{name}!\"\n" "\"Hello, Blaise!\"" msgstr "" ">>> \"Hello\" r', ' f\"{name}!\"\n" "\"Hello, Blaise!\"" msgid "This feature can be used to reduce the number of backslashes needed, to split long strings conveniently across long lines, or even to add comments to parts of strings. For example::" msgstr "می‌توان از این قابلیت برای کاهش تعداد بک‌اسلش‌های مورد نیاز، تقسیم راحت رشته‌های طولانی در سطرهای طولانی، یا حتی افزودن کامنت به بخش‌هایی از رشته‌ها استفاده کرد. برای مثال::" msgid "" "re.compile(\"[A-Za-z_]\" # letter or underscore\n" " \"[A-Za-z0-9_]*\" # letter, digit or underscore\n" " )" msgstr "" "re.compile(\"[A-Za-z_]\" # letter or underscore\n" " \"[A-Za-z0-9_]*\" # letter, digit or underscore\n" " )" msgid "However, bytes literals may only be combined with other byte literals; not with string literals of any kind. Also, template string literals may only be combined with other template string literals::" msgstr "با این حال، مقادیر لفظی بایت فقط می‌توانند با دیگر مقادیر لفظی بایت ترکیب شوند؛ نه با مقادیر لفظی رشته از هیچ نوعی. همچنین، مقادیر لفظی رشته قالب فقط می‌توانند با دیگر مقادیر لفظی رشته قالب ترکیب شوند::" msgid "" ">>> t\"Hello\" t\"{name}!\"\n" "Template(strings=('Hello', '!'), interpolations=(...))" msgstr "" ">>> t\"Hello\" t\"{name}!\"\n" "Template(strings=('Hello', '!'), interpolations=(...))" msgid "Formally:" msgstr "به‌طور رسمی:" msgid "Parenthesized groups" msgstr "گروه‌های پرانتزگذاری‌شده" msgid "A :dfn:`parenthesized group` is an expression enclosed in parentheses. The group evaluates to the same value as the expression inside." msgstr "یک :dfn:`گروه پرانتزدار` عبارتی است که در پرانتز محصور شده است. این گروه به همان مقداری ارزیابی می‌شود که عبارت درون آن ارزیابی می‌شود." msgid "Groups are used to override or clarify :ref:`operator precedence `, in the same way as in math notation. For example::" msgstr "گروه‌ها برای لغو یا شفاف‌سازی :ref:`تقدم عملگر `، به همان روش نمادگذاری ریاضی استفاده می‌شوند. برای مثال::" msgid "" ">>> 3 >> 3 >> (3 >> 3 >> 3 >> (3 >> [\"one\", \"two\", \"three\"]\n" "['one', 'two', 'three']\n" ">>> [1 + 2, 2 + 3]\n" "[3, 5]" msgstr "" ">>> [\"one\", \"two\", \"three\"]\n" "['one', 'two', 'three']\n" ">>> [1 + 2, 2 + 3]\n" "[3, 5]" msgid "In list, tuple and dictionary (but not set) displays, the series may be empty::" msgstr "در نمایش‌های فهرست، تاپل و دیکشنری (اما نه مجموعه)، دنباله می‌تواند خالی باشد::" msgid "" ">>> [] # empty list\n" "[]\n" ">>> () # empty tuple\n" "()\n" ">>> {} # empty dictionary\n" "{}" msgstr "" ">>> [] # empty list\n" "[]\n" ">>> () # empty tuple\n" "()\n" ">>> {} # empty dictionary\n" "{}" msgid "If the series is not empty, the items may be followed by an additional comma, which has no effect::" msgstr "اگر سری خالی نباشد، پس از آیتم‌ها می‌توان از یک ویرگول اضافی استفاده کرد که هیچ تأثیری ندارد::" msgid "" ">>> [\"one\", \"two\", \"three\",] # note comma after \"three\"\n" "['one', 'two', 'three']" msgstr "" ">>> [\"one\", \"two\", \"three\",] # note comma after \"three\"\n" "['one', 'two', 'three']" msgid "The trailing comma is often used for displays that span multiple lines (using :ref:`implicit line joining `), so when a future programmer adds a new entry at the end, they do not need to modify an existing line::" msgstr "ویرگول پایانی اغلب برای نمایش‌هایی استفاده می‌شود که چندین سطر را در بر می‌گیرند (با استفاده از :ref:`implicit line joining `)؛ بنابراین وقتی برنامه‌نویس آینده‌ای در انتهای آن ورودی جدیدی اضافه می‌کند، نیازی به تغییر سطر موجود ندارد::" msgid "" ">>> [\n" "... 'one',\n" "... 'two',\n" "... 'three',\n" "... ]\n" "['one', 'two', 'three']" msgstr "" ">>> [\n" "... 'one',\n" "... 'two',\n" "... 'three',\n" "... ]\n" "['one', 'two', 'three']" msgid "At runtime, when a display is evaluated, the listed items are evaluated from left to right and placed into a new container of the appropriate type." msgstr "در زمان ران‌تایم، هنگامی که یک نمایش ارزیابی می‌شود، آیتم‌های فهرست‌شده از چپ به راست ارزیابی شده و در ظرف جدیدی از نوع مناسب قرار می‌گیرند." msgid "For tuple, list and set (but not dict) displays, any item in the display may be prefixed with an asterisk (``*``). This denotes :ref:`iterable unpacking `. At runtime, the asterisk-prefixed expression must evaluate to an iterable, whose contents are inserted into the container at the location of the unpacking. For example::" msgstr "برای نمایش‌های تاپل، فهرست و مجموعه (اما نه دیکشنری)، هر آیتمی در نمایش می‌تواند پیشوندی با یک ستاره (``*``) داشته باشد. این موضوع نشان‌دهنده‌ی :ref:`iterable unpacking ` است. در زمان ران‌تایم، عبارتِ پیشوندگرفته با ستاره باید به یک پیمایش‌پذیر ارزیابی شود که محتویات آن در محل بازکردن بسته در ظرف درج می‌شوند. برای مثال::" msgid "" ">>> numbers = (1, 2)\n" ">>> [*numbers, 'word', *numbers]\n" "[1, 2, 'word', 1, 2]" msgstr "" ">>> numbers = (1, 2)\n" ">>> [*numbers, 'word', *numbers]\n" "[1, 2, 'word', 1, 2]" msgid "Dictionary displays use a similar mechanism called *dictionary unpacking*, denoted with a double asterisk (``**``). See :ref:`dict` for details." msgstr "نمایش‌های دیکشنری از مکانیسم مشابه‌ای به نام *بازکردن بسته‌ی دیکشنری* استفاده می‌کنند که با دو ستاره (``**``) مشخص می‌شود. برای جزئیات بیشتر :ref:`dict` را ببینید." msgid "A more advanced form of displays are :dfn:`comprehensions`, where items are computed via a set of looping and filtering instructions. See the :ref:`comprehensions` section for details." msgstr "نوع پیشرفته‌تری از نمایش‌ها، :dfn:`درک‌ها` هستند که در آن‌ها آیتم‌ها از طریق مجموعه‌ای از دستورات حلقه‌ای و فیلترینگ محاسبه می‌شوند. برای جزئیات، بخش :ref:`comprehensions` را ببینید." msgid "Iterable and dictionary unpacking in displays, originally proposed by :pep:`448`." msgstr "پیمایش‌پذیر و بازکردن بسته‌ی دیکشنری در نمایش‌ها که ابتدا توسط :pep:`448` پیشنهاد شد." msgid "List displays" msgstr "نمایش‌های فهرست" msgid "A :dfn:`list display` is a possibly empty series of expressions enclosed in square brackets. For example::" msgstr "یک :dfn:`نمایش فهرست` (list display) دنباله‌ای احتمالاً خالی از عبارت‌ها است که در داخل کروشه‌ها قرار دارد. برای نمونه::" msgid "" ">>> [\"one\", \"two\", \"three\"]\n" "['one', 'two', 'three']\n" ">>> [\"one\"] # One-element list\n" "['one']\n" ">>> [] # empty list\n" "[]" msgstr "" ">>> [\"one\", \"two\", \"three\"]\n" "['one', 'two', 'three']\n" ">>> [\"one\"] # One-element list\n" "['one']\n" ">>> [] # empty list\n" "[]" msgid "See :ref:`displays` for general information on displays." msgstr "برای اطلاعات عمومی درباره‌ی نمایش‌ها، :ref:`displays` را ببینید." msgid "The formal grammar for list displays is:" msgstr "گرامر رسمی نمایش‌های فهرست عبارت است از:" msgid "Set displays" msgstr "نمایش‌های مجموعه" msgid "A :dfn:`set display` is a *non-empty* series of expressions enclosed in curly braces. For example::" msgstr "یک :dfn:`نمایش مجموعه` (set display) دنباله‌ای *غیرخالی* از عبارت‌ها است که در داخل آکولادها قرار دارد. برای نمونه::" msgid "" ">>> {\"one\", \"two\", \"three\"}\n" "{'one', 'three', 'two'}\n" ">>> {\"one\"} # One-element set\n" "{'one'}" msgstr "" ">>> {\"one\", \"two\", \"three\"}\n" "{'one', 'three', 'two'}\n" ">>> {\"one\"} # One-element set\n" "{'one'}" msgid "There is no special syntax for the empty set. The ``{}`` literal is a :ref:`dictionary display ` that constructs an empty dictionary. Call :class:`set() ` with no arguments to get an empty set." msgstr "هیچ نحو خاصی برای مجموعه‌ی خالی وجود ندارد. لفظی ``{}`` یک :ref:`dictionary display ` است که یک دیکشنری خالی می‌سازد. برای دریافت یک مجموعه‌ی خالی، :class:`set() ` را بدون هیچ آرگومانی فراخوانی کنید." msgid "The formal grammar for set displays is:" msgstr "گرامر رسمی نمایش‌های مجموعه عبارت است از:" msgid "Tuple displays" msgstr "نمایش‌های تاپل" msgid "A :dfn:`tuple display` is a series of expressions enclosed in parentheses. For example::" msgstr "یک :dfn:`نمایش تاپل` (tuple display) دنباله‌ای از عبارت‌ها است که در داخل پرانتزها قرار دارد. برای نمونه::" msgid "" ">>> (1, 2)\n" "(1, 2)\n" ">>> () # an empty tuple\n" "()" msgstr "" ">>> (1, 2)\n" "(1, 2)\n" ">>> () # an empty tuple\n" "()" msgid "To avoid ambiguity, if a tuple display has exactly one element, it requires a trailing comma. Without it, you get a :ref:`parenthesized group `::" msgstr "برای جلوگیری از ابهام، اگر یک نمایش تاپل دقیقاً یک عنصر داشته باشد، به یک ویرگول پایانی نیاز دارد. بدون آن، یک :ref:`parenthesized group ` دریافت می‌کنید::" msgid "" ">>> ('single',) # single-element tuple\n" "('single',)\n" ">>> ('single') # no comma: single string\n" "'single'" msgstr "" ">>> ('single',) # single-element tuple\n" "('single',)\n" ">>> ('single') # no comma: single string\n" "'single'" msgid "To put it in other words, a tuple display is a parenthesized list of either:" msgstr "به عبارت دیگر، نمایش تاپل فهرستی است از موارد زیر که داخل پرانتز قرار گرفته‌اند:" msgid "two or more comma-separated expressions, or" msgstr "دو یا چند عبارت جداشده با کاما، یا" msgid "zero or more expressions, each followed by a comma." msgstr "صفر یا چند عبارت که هر کدام با یک ویرگول دنبال می‌شوند." msgid "Since tuples are immutable, :ref:`object identity rules for literals ` also apply to tuples: at runtime, two occurrences of tuples with the same values may or may not yield the same object." msgstr "از آنجایی که تاپل‌ها تغییرناپذیر هستند، :ref:`قوانین هویت شیء برای مقادیر ثابت ` نیز در مورد تاپل‌ها اعمال می‌شوند: در ران‌تایم، دو وقوع از تاپل‌ها با مقادیر یکسان ممکن است شیء یکسانی را تولید کنند یا نکنند." msgid "Python's syntax also includes :ref:`expression lists `, where a comma-separated list of expressions is *not* enclosed in parentheses but evaluates to tuple." msgstr "نحو پایتون همچنین شامل :ref:`expression lists ` است که در آن فهرستی از عباراتِ جداشده با ویرگول در پرانتز قرار *نمی‌گیرند* اما به یک تاپل ارزیابی می‌شوند." msgid "In other words, when it comes to tuple syntax, the comma is more important that the use of parentheses. Only the empty tuple is spelled without a comma." msgstr "به عبارت دیگر، هنگامی که صحبت از نحو تاپل به میان می‌آید، ویرگول مهم‌تر از استفاده از پرانتز است. فقط تاپل خالی بدون ویرگول نوشته می‌شود." msgid "The formal grammar for tuple displays is:" msgstr "گرامر رسمی برای نمایش‌های تاپل عبارت است از:" msgid "Dictionary displays" msgstr "نمایش‌های دیکشنری" msgid "A :dfn:`dictionary display` is a possibly empty series of :dfn:`dict items` enclosed in curly braces. Each dict item is a colon-separated pair of expressions: the :dfn:`key` and its associated :dfn:`value`. For example::" msgstr "یک :dfn:`dictionary display` سری احتمالاً خالی از :dfn:`dict items` است که درون آکولاد قرار گرفته‌اند. هر آیتم دیکشنری یک جفت عبارتِ جداشده با دونقطه است: :dfn:`key` و :dfn:`value` مرتبط با آن. برای مثال::" msgid "" ">>> {1: 'one', 2: 'two'}\n" "{1: 'one', 2: 'two'}" msgstr "" ">>> {1: 'one', 2: 'two'}\n" "{1: 'one', 2: 'two'}" msgid "At runtime, when a dictionary comprehension is evaluated, the expressions are evaluated from left to right. Each key object is used as a key into the dictionary to store the corresponding value. This means that you can specify the same key multiple times in the comprehension, and the final dictionary's value for a given key will be the last one given. For example::" msgstr "در ران‌تایم، هنگام ارزیابی یک درک دیکشنری، عبارت‌ها از چپ به راست ارزیابی می‌شوند. هر شیء کلید به عنوان کلیدی در دیکشنری برای ذخیره‌ی مقدار متناظر استفاده می‌شود. این بدان معناست که شما می‌توانید یک کلید را چندین بار در درک مشخص کنید و مقدار دیکشنری نهایی برای یک کلید مشخص، آخرین مقداری خواهد بود که داده شده است. برای مثال::" msgid "" ">>> {\n" "... 1: 'this will be overridden',\n" "... 2: 'two',\n" "... 1: 'also overridden',\n" "... 1: 'one',\n" "... }\n" "{1: 'one', 2: 'two'}" msgstr "" ">>> {\n" "... 1: 'this will be overridden',\n" "... 2: 'two',\n" "... 1: 'also overridden',\n" "... 1: 'one',\n" "... }\n" "{1: 'one', 2: 'two'}" msgid "Instead of a key-value pair, a dict item may be an expression prefixed by a double asterisk ``**``. This denotes :dfn:`dictionary unpacking`. At runtime, the expression must evaluate to a :term:`mapping`; each item of the mapping is added to the new dictionary. As with key-value pairs, later values replace values already set by earlier items and unpackings. This may be used to override a set of defaults::" msgstr "به‌جای جفت کلید-مقدار، یک آیتم دیکشنری ممکن است عبارتی باشد که با دو ستاره ``**`` پیشوند شده است. این نشان‌دهنده‌ی :dfn:`بازکردن بسته دیکشنری` است. در ران‌تایم، عبارت باید به یک :term:`نگاشت ` ارزیابی شود؛ هر آیتم از نگاشت به دیکشنری جدید اضافه می‌شود. همانند جفت‌های کلید-مقدار، مقادیر بعدی جایگزین مقادیری می‌شوند که قبلاً توسط آیتم‌ها و بازکردن بسته‌های قبلی تنظیم شده‌اند. این ممکن است برای بازنویسی مجموعه‌ای از مقادیر پیش‌فرض استفاده شود::" msgid "" ">>> defaults = {'color': 'blue', 'count': 8}\n" ">>> overrides = {'color': 'yellow'}\n" ">>> {**defaults, **overrides}\n" "{'color': 'yellow', 'count': 8}" msgstr "" ">>> defaults = {'color': 'blue', 'count': 8}\n" ">>> overrides = {'color': 'yellow'}\n" ">>> {**defaults, **overrides}\n" "{'color': 'yellow', 'count': 8}" msgid "Unpacking into dictionary displays, originally proposed by :pep:`448`." msgstr "واگشایی در نمایش‌های دیکشنری، که در ابتدا در :pep:`448` پیشنهاد شده بود." msgid "The formal grammar for dict displays is:" msgstr "گرامر رسمی برای نمایش‌های دیکشنری عبارت است از:" msgid "Comprehensions" msgstr "درک‌ها" msgid "List, set and dictionary :dfn:`comprehensions` are a form of :ref:`container displays ` where items are computed via a set of looping and filtering instructions rather than listed explicitly." msgstr ":dfn:`درک‌کننده‌های` فهرست، مجموعه و دیکشنری فرمی از :ref:`نمایش‌های ظرف ` هستند که در آن‌ها آیتم‌ها به جای فهرست‌شدن صریح، از طریق مجموعه‌ای از دستورالعمل‌های حلقه‌زنی و فیلترینگ محاسبه می‌شوند." msgid "In its simplest form, a comprehension consists of a single expression followed by a :keyword:`!for` clause. The :keyword:`!for` clause has the same syntax as the header of a :ref:`for statement `, without a trailing colon." msgstr "در ساده‌ترین شکل، یک درک‌کننده شامل یک عبارت واحد است که پس از آن یک بند :keyword:`!for` قرار دارد. بند :keyword:`!for` دارای همان نحو (سینتکس) سرآیند یک :ref:`دستور for ` است، بدون اینکه دو‌نقطه در انتهای آن قرار گیرد." msgid "For example, a list of the first ten squares is::" msgstr "برای مثال، فهرستی از ده مربع اول به‌صورت زیر است::" msgid "" ">>> [x**2 for x in range(10)]\n" "[0, 1, 4, 9, 16, 25, 36, 49, 64, 81]" msgstr "" ">>> [x**2 for x in range(10)]\n" "[0, 1, 4, 9, 16, 25, 36, 49, 64, 81]" msgid "At run time, a list comprehension creates a new list. The expression after :keyword:`!in` must evaluate to an :term:`iterable`. For each element of this iterable, the element is bound to the :keyword:`!for` clause's target as in a :keyword:`!for` statement, then the expression before :keyword:`!for` is evaluated with the target in scope and the result is added to the new list. Thus, the example above is roughly equivalent to defining and calling the following function::" msgstr "در زمان اجرا، یک درک فهرستی یک فهرست جدید ایجاد می‌کند. عبارت پس از :keyword:`!in` باید به یک :term:`پیمایش‌پذیر ` ارزیابی شود. برای هر عنصر از این پیمایش‌پذیر، عنصر به هدف بند :keyword:`!for` مانند یک دستور :keyword:`!for` متصل می‌شود، سپس عبارت قبل از :keyword:`!for` با هدف در محدوده ارزیابی می‌شود و نتیجه به فهرست جدید اضافه می‌شود. بنابراین، مثال بالا تقریباً معادل تعریف و فراخوانی تابع زیر است::" msgid "" "def make_list_of_squares(iterable):\n" " result = []\n" " for x in iterable:\n" " result.append(x**2)\n" " return result\n" "\n" "make_list_of_squares(range(10))" msgstr "" "def make_list_of_squares(iterable):\n" " result = []\n" " for x in iterable:\n" " result.append(x**2)\n" " return result\n" "\n" "make_list_of_squares(range(10))" msgid "Set comprehensions work similarly. For example, here is a set of lowercase letters::" msgstr "درک‌های مجموعه نیز به همین صورت کار می‌کنند. برای مثال، این هم مجموعه‌ای از حروف کوچک است::" msgid "" ">>> {x.lower() for x in ['a', 'A', 'b', 'C']}\n" "{'c', 'a', 'b'}" msgstr "" ">>> {x.lower() for x in ['a', 'A', 'b', 'C']}\n" "{'c', 'a', 'b'}" msgid "At run time, this corresponds roughly to calling this function::" msgstr "در زمان اجرا، این کار تقریباً معادل فراخوانی این تابع است::" msgid "" "def make_lowercase_set(iterable):\n" " result = set(iterable)\n" " for x in iterable:\n" " result.append(x.lower())\n" " return result\n" "\n" "make_lowercase_set(['a', 'A', 'b', 'C'])" msgstr "" "def make_lowercase_set(iterable):\n" " result = set(iterable)\n" " for x in iterable:\n" " result.append(x.lower())\n" " return result\n" "\n" "make_lowercase_set(['a', 'A', 'b', 'C'])" msgid "Dictionary comprehensions start with a colon-separated key-value pair instead of an expression. For example::" msgstr "درک‌های دیکشنری به جای یک عبارت، با یک جفت کلید-مقدار جدا شده با دو‌نقطه شروع می‌شوند. برای مثال::" msgid "" ">>> {func.__name__: func for func in [print, hex, any]}\n" "{'print': ,\n" " 'hex': ,\n" " 'any': }" msgstr "" ">>> {func.__name__: func for func in [print, hex, any]}\n" "{'print': ,\n" " 'hex': ,\n" " 'any': }" msgid "At run time, this corresponds roughly to::" msgstr "در زمان اجرا، این تقریباً معادل موارد زیر است::" msgid "" "def make_dict_mapping_names_to_functions(iterable):\n" " result = {}\n" " for func in iterable:\n" " result[func.__name__] = func\n" " return result\n" "\n" "iterable([print, hex, any])" msgstr "" "def make_dict_mapping_names_to_functions(iterable):\n" " result = {}\n" " for func in iterable:\n" " result[func.__name__] = func\n" " return result\n" "\n" "iterable([print, hex, any])" msgid "As in other kinds of dictionary displays, the same key may be specified multiple times. Earlier values are overwritten by ones that are evaluated later." msgstr "مانند سایر انواع نمایش‌های دیکشنری، ممکن است یک کلید چندین بار مشخص شود. مقادیر قبلی توسط مقادیری که بعدها ارزیابی می‌شوند، بازنویسی می‌شوند." msgid "There are no *tuple comprehensions*. A similar syntax is instead used for :ref:`generator expressions `, from which you can construct a tuple like this::" msgstr "چیزی به نام *درک تاپل* وجود ندارد. در عوض، نحو مشابهی برای :ref:`عبارت‌های مولد ` استفاده می‌شود که از طریق آن‌ها می‌توانید یک تاپل را به این شکل بسازید::" msgid "" ">>> tuple(x**2 for x in range(10))\n" "(0, 1, 4, 9, 16, 25, 36, 49, 64, 81)" msgstr "" ">>> tuple(x**2 for x in range(10))\n" "(0, 1, 4, 9, 16, 25, 36, 49, 64, 81)" msgid "Prior to Python 3.8, in dict comprehensions, the evaluation order of key and value was not well-defined. In CPython, the value was evaluated before the key. Starting with 3.8, the key is evaluated before the value, as proposed by :pep:`572`." msgstr "پیش از پایتون 3.8، در درک دیکشنری، ترتیب ارزیابی کلید و مقدار به‌خوبی تعریف‌نشده بود. در CPython، مقدار پیش از کلید ارزیابی می‌شد. از 3.8 به بعد، کلید پیش از مقدار ارزیابی می‌شود، همان‌طور که در :pep:`572` پیشنهاد شده است." msgid "Filtering in comprehensions" msgstr "فیلتر کردن در درک‌ها" msgid "The :keyword:`!for` clause may be followed by an :keyword:`!if` clause with an expression." msgstr "ممکن است پس از بند :keyword:`!for` یک بند :keyword:`!if` همراه با یک عبارت بیاید." msgid "For example, a list of names from the :mod:`math` module that start with ``f`` is::" msgstr "برای مثال، فهرستی از نام‌های ماژول :mod:`math` که با ``f`` شروع می‌شوند عبارت است از::" msgid "" ">>> [name for name in vars(math) if name.startswith('f')]\n" "['fabs', 'factorial', 'floor', 'fma', 'fmod', 'frexp', 'fsum']" msgstr "" ">>> [name for name in vars(math) if name.startswith('f')]\n" "['fabs', 'factorial', 'floor', 'fma', 'fmod', 'frexp', 'fsum']" msgid "At run time, the expression after :keyword:`!if` is evaluated before each element is added to the resulting container, and if it is false, the element is skipped. Thus, the above example roughly corresponds to defining and calling the following function::" msgstr "در زمان اجرا، عبارت موجود پس از :keyword:`!if` پیش از اضافه شدن هر المان به ظرف حاصل ارزیابی می‌شود و اگر نادرست باشد، آن المان نادیده گرفته می‌شود. بنابراین، مثال بالا تقریباً با تعریف و فراخوانی تابع زیر مطابقت دارد::" msgid "" "def get_math_f_names(iterable):\n" " result = []\n" " for name in iterable:\n" " if name.startswith('f'):\n" " result.append(name)\n" " return result\n" "\n" "get_math_f_names(vars(math))" msgstr "" "def get_math_f_names(iterable):\n" " result = []\n" " for name in iterable:\n" " if name.startswith('f'):\n" " result.append(name)\n" " return result\n" "\n" "get_math_f_names(vars(math))" msgid "Filtering is a special case of more complex comprehensions. See the next section for a more formal description." msgstr "فیلترکردن حالت خاصی از درک‌های پیچیده‌تر است. برای توضیحات رسمی‌تر، بخش بعدی را ببینید." msgid "Complex comprehensions" msgstr "درک‌های پیچیده" msgid "Generally, a comprehension's initial :keyword:`!for` clause may be followed by zero or more additional :keyword:`!for` or :keyword:`!if` clauses. For example, here is a list of names exposed by two Python modules, filtered to only include names that start with ``a``::" msgstr "به‌طور کلی، بند اول :keyword:`!for` در یک درک ممکن است با صفر یا چند بند اضافی :keyword:`!for` یا :keyword:`!if` دنبال شود. برای مثال، در اینجا فهرستی از نام‌های عرضه‌شده توسط دو ماژول پایتون آورده شده است که فیلتر شده‌اند تا فقط نام‌های شروع‌شونده با ``a`` را شامل شوند::" msgid "" ">>> import array\n" ">>> import math\n" ">>> [\n" "... name\n" "... for module in [array, math]\n" "... for name in vars(module)\n" "... if name.startswith('a')\n" "... ]\n" "['array', 'acos', 'acosh', 'asin', 'asinh', 'atan', 'atan2', 'atanh']" msgstr "" ">>> import array\n" ">>> import math\n" ">>> [\n" "... name\n" "... for module in [array, math]\n" "... for name in vars(module)\n" "... if name.startswith('a')\n" "... ]\n" "['array', 'acos', 'acosh', 'asin', 'asinh', 'atan', 'atan2', 'atanh']" msgid "At run time, this roughly corresponds to defining and calling::" msgstr "در زمان اجرا، این مورد تقریباً با تعریف و فراخوانی زیر مطابقت دارد::" msgid "" "def get_a_names(iterable):\n" " result = []\n" " for module in iterable:\n" " for name in vars(module):\n" " if name.startswith('a'):\n" " result.append(name)\n" " return result\n" "\n" "get_a_names([array, math])" msgstr "" "def get_a_names(iterable):\n" " result = []\n" " for module in iterable:\n" " for name in vars(module):\n" " if name.startswith('a'):\n" " result.append(name)\n" " return result\n" "\n" "get_a_names([array, math])" msgid "The elements of the new container are those that would be produced by considering each of the :keyword:`!for` or :keyword:`!if` clauses a block, nesting from left to right, and evaluating the expression to produce an element (or dictionary entry) each time the innermost block is reached." msgstr "عناصر ظرف جدید آنهایی هستند که با در نظر گرفتن هر یک از بندهای :keyword:`!for` یا :keyword:`!if` به عنوان یک بلوک، تودرتو کردن از چپ به راست، و ارزیابی عبارت برای تولید یک عنصر (یا ورودی دیکشنری) در هر بار رسیدن به داخلی‌ترین بلوک، تولید می‌شوند." msgid "Aside from the iterable expression in the leftmost :keyword:`!for` clause, the comprehension is executed in a separate implicitly nested scope. This ensures that names assigned to in the target list don't \"leak\" into the enclosing scope. For example::" msgstr "به‌جز عبارت پیمایش‌پذیر در سمت چپ‌ترین بند :keyword:`!for`، درک در یک محدوده‌ی تودرتوی ضمنی جداگانه اجرا می‌شود. این تضمین می‌کند که نام‌های تخصیص‌یافته در فهرست هدف به محدوده‌ی احاطه‌کننده «نشت» نکنند. برای مثال::" msgid "" ">>> x = 'old value'\n" ">>> [x**2 for x in range(10)] # this `x` is local to the comprehension\n" ">>> x\n" "'old value'" msgstr "" ">>> x = 'old value'\n" ">>> [x**2 for x in range(10)] # این `x` نسبت به درک محلی است\n" ">>> x\n" "'old value'" msgid "The iterable expression in the leftmost :keyword:`!for` clause is evaluated directly in the enclosing scope and then passed as an argument to the implicitly nested scope." msgstr "عبارت پیمایش‌پذیر در سمت چپ‌ترین بند :keyword:`!for` مستقیماً در محدوده‌ی احاطه‌کننده ارزیابی شده و سپس به عنوان آرگومانی به محدوده‌ی تودرتوی ضمنی ارسال می‌شود." msgid "Subsequent :keyword:`!for` clauses and any filter condition in the leftmost :keyword:`!for` clause cannot be evaluated in the enclosing scope as they may depend on the values obtained from the leftmost iterable." msgstr "بندهای بعدی :keyword:`!for` و هر شرط فیلتری در سمت چپ‌ترین بند :keyword:`!for` نمی‌توانند در محدوده‌ی احاطه‌کننده ارزیابی شوند زیرا ممکن است به مقادیر به‌دست‌آآمده از پیمایش‌پذیر سمت چپ بستگی داشته باشند." msgid "To ensure the comprehension always results in a container of the appropriate type, ``yield`` and ``yield from`` expressions are prohibited in the implicitly nested scope." msgstr "برای اطمینان از اینکه درک همیشه به ظرفی از نوع مناسب منجر می‌شود، عبارت‌های ``yield`` و ``yield from`` در محدوده‌ی تودرتوی ضمنی ممنوع هستند." msgid ":ref:`Assignment expressions ` are not allowed inside comprehension iterable expressions (that is, the expressions after the :keyword:`!in` keyword), nor anywhere within comprehensions that appear directly in a class definition." msgstr ":ref:`عبارت‌های انتساب ` در عبارت‌های پیمایش‌پذیر درک (یعنی عبارت‌های بعد از کلیدواژهین :keyword:`!in`) و همچنین در هیچ‌یک از درک‌هایی که مستقیماً در تعریف یک کلاس ظاهر می‌شوند، مجاز نیستند." msgid "``yield`` and ``yield from`` prohibited in the implicitly nested scope." msgstr "``yield`` و ``yield from`` در محدوده‌ی تودرتوی ضمنی ممنوع است." msgid "Unpacking in comprehensions" msgstr "بازکردن بسته در درک‌ها" msgid "If the expression of a list or set comprehension is starred, the result will be :ref:`unpacked ` to produce zero or more elements." msgstr "اگر عبارت یک فهرست یا درک مجموعه ستاره‌دار باشد، نتیجه :ref:`بازنشود ` تا صفر یا چند عنصر تولید کند." msgid "This is often used for \"flattening\" lists, for example::" msgstr "این کار اغلب برای «تخت‌سازی» فهرست‌ها استفاده می‌شود، برای مثال::" msgid "" ">>> students = ['Petr', 'Blaise', 'Jarka']\n" ">>> teachers = ['Salim', 'Bartosz']\n" ">>> lists_of_people = [students, teachers]\n" ">>> [*people for people in lists_of_people]\n" "['Petr', 'Blaise', 'Jarka', 'Salim', 'Bartosz']" msgstr "" ">>> students = ['Petr', 'Blaise', 'Jarka']\n" ">>> teachers = ['Salim', 'Bartosz']\n" ">>> lists_of_people = [students, teachers]\n" ">>> [*people for people in lists_of_people]\n" "['Petr', 'Blaise', 'Jarka', 'Salim', 'Bartosz']" msgid "At run time, this comprehension roughly corresponds to::" msgstr "در زمان اجرا، این درک تقریباً با موارد زیر مطابقت دارد::" msgid "" "def flatten_names(lists_of_people):\n" " result = []\n" " for people in lists_of_people:\n" " result.extend(people)\n" " return result" msgstr "" "def flatten_names(lists_of_people):\n" " result = []\n" " for people in lists_of_people:\n" " result.extend(people)\n" " return result" msgid "In dict comprehensions, a double-starred expression will be evaluated and then unpacked using :ref:`dictionary unpacking `, inserting zero or more key/value pairs into the new dictionary. As in other kinds of dictionary displays, if the same key is specified multiple times, the associated value in the resulting dictionary will be the last one specified." msgstr "در درک‌های دیکشنری، یک عبارت دو ستاره‌دار ارزیابی شده و سپس با استفاده از :ref:`بازکردن دیکشنری ` باز می‌شود و صفر یا چند جفت کلید/مقدار را در دیکشنری جدید درج می‌کند. مانند سایر انواع نمایش‌های دیکشنری، اگر یک کلید چندین بار مشخص شود، مقدار مرتبط در دیکشنری حاصل آخرین مقدار مشخص‌شده خواهد بود." msgid "For example::" msgstr "برای مثال::" msgid "" ">>> system_defaults = {'color': 'blue', 'count': 8}\n" ">>> user_defaults = {'color': 'yellow'}\n" ">>> overrides = {'count': 5}\n" "\n" ">>> configuration_sets = [system_defaults, user_defaults, overrides]\n" "\n" ">>> {**d for d in configuration_sets}\n" "{'color': 'yellow', 'count': 5}" msgstr "" ">>> system_defaults = {'color': 'blue', 'count': 8}\n" ">>> user_defaults = {'color': 'yellow'}\n" ">>> overrides = {'count': 5}\n" "\n" ">>> configuration_sets = [system_defaults, user_defaults, overrides]\n" "\n" ">>> {**d for d in configuration_sets}\n" "{'color': 'yellow', 'count': 5}" msgid "Unpacking in comprehensions using the ``*`` and ``**`` operators was introduced in :pep:`798`." msgstr "بازکردن بسته در درک‌ها با استفاده از عملگرهای ``*`` و ``**`` در :pep:`798` معرفی شد." msgid "Asynchronous comprehensions" msgstr "درک‌های ناهمگام" msgid "In an :keyword:`async def` function, an :keyword:`!async for` clause may be used to iterate over a :term:`asynchronous iterator`. A comprehension in an :keyword:`!async def` function may consist of either a :keyword:`!for` or :keyword:`!async for` clause following the leading expression, may contain additional :keyword:`!for` or :keyword:`!async for` clauses, and may also use :keyword:`await` expressions." msgstr "در یک تابع :keyword:`async def`، می‌توان از یک بند :keyword:`!async for` برای پیمایش روی یک :term:`پیمایش‌گر ناهمگام ` استفاده کرد. یک درک در یک تابع :keyword:`!async def` ممکن است شامل یک بند :keyword:`!for` یا :keyword:`!async for` به دنبال عبارت پیشرو باشد، ممکن است حاوی بندهای :keyword:`!for` یا :keyword:`!async for` اضافی باشد، و همچنین ممکن است از عبارت‌های :keyword:`await` استفاده کند." msgid "If a comprehension contains :keyword:`!async for` clauses, or if it contains :keyword:`!await` expressions or other asynchronous comprehensions anywhere except the iterable expression in the leftmost :keyword:`!for` clause, it is called an :dfn:`asynchronous comprehension`. An asynchronous comprehension may suspend the execution of the coroutine function in which it appears." msgstr "اگر یک درک حاوی بندهای :keyword:`!async for` باشد، یا اگر حاوی عبارت‌های :keyword:`!await` یا سایر درک‌های ناهمگام در هر جایی به‌جز عبارت پیمایش‌پذیر در سمت چپ‌ترین بند :keyword:`!for` باشد، به آن :dfn:`درک ناهمگام` گفته می‌شود. یک درک ناهمگام ممکن است اجرای تابع هم‌روالی را که در آن ظاهر می‌شود، به حالت تعلیق درآورد." msgid "Asynchronous comprehensions were introduced in :pep:`530`." msgstr "درک‌های ناهمگام در :pep:`530` معرفی شدند." msgid "Asynchronous comprehensions are now allowed inside comprehensions in asynchronous functions. Outer comprehensions implicitly become asynchronous." msgstr "درک‌های ناهمگام اکنون در داخل درک‌ها در توابع ناهمگام مجاز هستند. درک‌های بیرونی به‌طور ضمنی ناهمگام می‌شوند." msgid "Formal grammar for comprehensions" msgstr "گرامر رسمی برای درک‌ها" msgid "The formal grammar for comprehensions is:" msgstr "گرامر رسمی برای درک‌ها عبارت است از:" msgid "Generator expressions" msgstr "عبارت‌های تولیدگر" msgid "The syntax for :dfn:`generator expressions` is the same as for list :ref:`comprehensions `, except that they are enclosed in parentheses instead of brackets. For example::" msgstr "سینتکس :dfn:`عبارت‌های تولیدگر (generator expressions)` همانند :ref:`درک‌های فهرستی ` است، با این تفاوت که آن‌ها به جای کروشه در پرانتز قرار می‌گیرند. برای مثال::" msgid "" ">>> iterator = (x ** 2 for x in range(10))\n" ">>> iterator\n" "" msgstr "" ">>> iterator = (x ** 2 for x in range(10))\n" ">>> iterator\n" "" msgid "At runtime, a generator expression evaluates to a :term:`generator iterator` which yields the same values as the corresponding list comprehension::" msgstr "در ران‌تایم، یک عبارت تولیدگر به یک :term:`generator iterator` ارزیابی می‌شود که همان مقادیرِ درک فهرستی متناظر را تولید می‌کند::" msgid "" ">>> list(iterator)\n" "[0, 1, 4, 9, 16, 25, 36, 49, 64, 81]" msgstr "" ">>> list(iterator)\n" "[0, 1, 4, 9, 16, 25, 36, 49, 64, 81]" msgid "Thus, the example above is roughly equivalent to defining and calling the following generator function::" msgstr "بنابراین، مثال بالا تقریباً معادل تعریف و فراخوانی تابع تولیدگر زیر است::" msgid "" "def make_generator_of_squares(iterator):\n" " for x in iterator:\n" " yield x ** 2\n" "\n" "make_generator_of_squares(iter(range(10)))" msgstr "" "def make_generator_of_squares(iterator):\n" " for x in iterator:\n" " yield x ** 2\n" "\n" "make_generator_of_squares(iter(range(10)))" msgid "The enclosing parentheses can be omitted in calls when the generator expression is the only positional argument and there are no keyword arguments. See the :ref:`Calls section ` for details. For example::" msgstr "هنگامی که عبارت تولیدگر تنها آرگومان جایگاهی باشد و هیچ آرگومان کلیدواژه‌ای وجود نداشته باشد، می‌توان پرانتزهای دربرگیرنده را در فراخوانی‌ها حذف کرد. برای جزئیات، :ref:`بخش فراخوانی‌ها ` را ببینید. برای مثال::" msgid "" "# The parentheses after `sum` are part of the call syntax:\n" ">>> sum(x ** 2 for x in range(10))\n" "285\n" "\n" "# The generator needs its own parentheses if it's not the only argument:\n" ">>> sum((x ** 2 for x in range(10)), start=1000)\n" "1285" msgstr "" "# The parentheses after `sum` are part of the call syntax:\n" ">>> sum(x ** 2 for x in range(10))\n" "285\n" "\n" "# The generator needs its own parentheses if it's not the only argument:\n" ">>> sum((x ** 2 for x in range(10)), start=1000)\n" "1285" msgid "The iterable expression in the leftmost :keyword:`!for` clause is evaluated immediately, so that an error raised by this expression will be emitted at the point where the generator expression is defined, rather than at the point where the first value is retrieved::" msgstr "عبارت پیمایش‌پذیر در چپ‌ترین بند :keyword:`!for` بلافاصله ارزیابی می‌شود، به‌طوری که خطایی که این عبارت پرتاب می‌کند، در نقطه‌ای که عبارت تولیدگر تعریف می‌شود بروز می‌کند، نه در نقطه‌ای که نخستین مقدار بازیابی می‌شود::" msgid "" ">>> (x ** 2 for x in nonexistent_iterable)\n" "Traceback (most recent call last):\n" " ...\n" "NameError: name 'nonexistent_iterable' is not defined" msgstr "" ">>> (x ** 2 for x in nonexistent_iterable)\n" "Traceback (most recent call last):\n" " ...\n" "NameError: name 'nonexistent_iterable' is not defined" msgid "After the expression is evaluated, an iterator is created from the result, as if :py:func:`iter` was called on it. Any error raised when creating the iterator is also emitted immediately::" msgstr "پس از ارزیابی عبارت، یک پیمایش‌گر از نتیجه ایجاد می‌شود، گویی که :py:func:`iter` بر روی آن فراخوانی شده است. هر خطایی که هنگام ایجاد پیمایش‌گر پرتاب شود نیز بلافاصله منتشر می‌شود::" msgid "" ">>> (x ** 2 for x in None)\n" "Traceback (most recent call last):\n" " ...\n" "TypeError: 'NoneType' object is not iterable" msgstr "" ">>> (x ** 2 for x in None)\n" "Traceback (most recent call last):\n" " ...\n" "TypeError: 'NoneType' object is not iterable" msgid "All other expressions are evaluated lazily, in the same fashion as normal generators (that is, when the iterator is asked to yield a value)::" msgstr "تمام عبارت‌های دیگر به‌صورت تنبل ارزیابی می‌شوند، به همان شیوه‌ی تولیدگرهای معمولی (یعنی زمانی که از پیمایش‌گر خواسته شود مقداری را yield کند)::" msgid "" ">>> iterator = (nonexistent_value for x in range(10))\n" ">>> iterator\n" "\n" ">>> list(iterator)\n" "Traceback (most recent call last):\n" " ...\n" "NameError: name 'nonexistent_value' is not defined" msgstr "" ">>> iterator = (nonexistent_value for x in range(10))\n" ">>> iterator\n" "\n" ">>> list(iterator)\n" "Traceback (most recent call last):\n" " ...\n" "NameError: name 'nonexistent_value' is not defined" msgid "" ">>> iterator = (x * y for x in range(10) for y in nonexistent_iterable)\n" ">>> iterator\n" "\n" ">>> list(iterator)\n" "Traceback (most recent call last):\n" " ...\n" "NameError: name 'nonexistent_iterable' is not defined" msgstr "" ">>> iterator = (x * y for x in range(10) for y in nonexistent_iterable)\n" ">>> iterator\n" "\n" ">>> list(iterator)\n" "Traceback (most recent call last):\n" " ...\n" "NameError: name 'nonexistent_iterable' is not defined" msgid "To avoid interfering with the expected operation of the generator expression itself, ``yield`` and ``yield from`` expressions are prohibited inside the implicitly nested scope." msgstr "برای جلوگیری از اخلال در عملکرد مورد انتظار خود عبارت تولیدگر، عبارت‌های ``yield`` و ``yield from`` در محدوده تودرتوی ضمنی ممنوع هستند." msgid "If a generator expression contains either :keyword:`!async for` clauses or :keyword:`await` expressions it is called an :dfn:`asynchronous generator expression`. An asynchronous generator expression returns a new asynchronous generator object, which is an asynchronous iterator (see :ref:`async-iterators`)." msgstr "اگر یک عبارت تولیدگر شامل بندهای :keyword:`!async for` یا عبارات :keyword:`await` باشد، به آن :dfn:`عبارت تولیدگر ناهمگام (asynchronous generator expression)` گفته می‌شود. یک عبارت تولیدگر ناهمگام یک شیء تولیدگر ناهمگام جدید برمی‌گرداند که یک پیمایش‌گر ناهمگام است (به :ref:`async-iterators` مراجعه کنید)." msgid "The formal grammar for generator expressions is:" msgstr "دستور زبان صوری عبارت‌های تولیدگر:" msgid "Asynchronous generator expressions were introduced." msgstr "عبارات تولیدگر ناهمگام معرفی شدند." msgid "Prior to Python 3.7, asynchronous generator expressions could only appear in :keyword:`async def` coroutines. Starting with 3.7, any function can use asynchronous generator expressions." msgstr "پیش از پایتون 3.7، عبارات تولیدگر ناهمگام فقط می‌توانستند در هم‌روال‌های :keyword:`async def` ظاهر شوند. از 3.7 به بعد، هر تابعی می‌تواند از عبارات تولیدگر ناهمگام استفاده کند." msgid "Yield expressions" msgstr "عبارت‌های yield" msgid "The yield expression is used when defining a :term:`generator` function or an :term:`asynchronous generator` function and thus can only be used in the body of a function definition. Using a yield expression in a function's body causes that function to be a generator function, and using it in an :keyword:`async def` function's body causes that coroutine function to be an asynchronous generator function. For example::" msgstr "عبارت yield هنگام تعریف یک تابع :term:`تولیدگر ` یا یک تابع :term:`تولیدگر ناهمگام ` استفاده می‌شود و بنابراین فقط می‌تواند در بدنه‌ی تعریف یک تابع استفاده شود. استفاده از عبارت yield در بدنه‌ی یک تابع، آن تابع را به یک تابع تولیدگر تبدیل می‌کند، و استفاده از آن در بدنه‌ی یک تابع :keyword:`async def`، آن تابع هم‌روال را به یک تابع تولیدگر ناهمگام تبدیل می‌کند. برای مثال::" msgid "" "def gen(): # defines a generator function\n" " yield 123\n" "\n" "async def agen(): # defines an asynchronous generator function\n" " yield 123" msgstr "" "def gen(): # defines a generator function\n" " yield 123\n" "\n" "async def agen(): # defines an asynchronous generator function\n" " yield 123" msgid "Due to their side effects on the containing scope, ``yield`` expressions are not permitted as part of the implicitly defined scopes used to implement comprehensions and generator expressions." msgstr "به دلیل عوارض جانبی عبارات ``yield`` بر محدوده‌ی دربرگیرنده، این عبارات مجاز نیستند بخشی از محدوده‌هایی باشند که به‌طور ضمنی برای پیاده‌سازی درک‌ها و عبارات تولیدگر تعریف شده‌اند." msgid "Yield expressions prohibited in the implicitly nested scopes used to implement comprehensions and generator expressions." msgstr "عبارات yield در محدوده‌های تودرتوی ضمنی که برای پیاده‌سازی درک‌ها و عبارات تولیدگر به کار می‌روند، ممنوع است." msgid "Generator functions are described below, while asynchronous generator functions are described separately in section :ref:`asynchronous-generator-functions`." msgstr "توابع تولیدگر در ادامه توضیح داده شده‌اند، در حالی که توابع تولیدگر ناهمگام به‌طور جداگانه در بخش :ref:`asynchronous-generator-functions` توضیح داده شده‌اند." msgid "When a generator function is called, it returns an iterator known as a generator. That generator then controls the execution of the generator function. The execution starts when one of the generator's methods is called. At that time, the execution proceeds to the first yield expression, where it is suspended again, returning the value of :token:`~python-grammar:yield_list` to the generator's caller, or ``None`` if :token:`~python-grammar:yield_list` is omitted. By suspended, we mean that all local state is retained, including the current bindings of local variables, the instruction pointer, the internal evaluation stack, and the state of any exception handling. When the execution is resumed by calling one of the generator's methods, the function can proceed exactly as if the yield expression were just another external call. The value of the yield expression after resuming depends on the method which resumed the execution. If :meth:`~generator.__next__` is used (typically via either a :keyword:`for` or the :func:`next` builtin) then the result is :const:`None`. Otherwise, if :meth:`~generator.send` is used, then the result will be the value passed in to that method." msgstr "هنگامی که یک تابع تولیدگر فراخوانی می‌شود، یک پیمایش‌گر برمی‌گرداند که به‌عنوان تولیدگر شناخته می‌شود. سپس آن تولیدگر اجرای تابع تولیدگر را کنترل می‌کند. اجرا زمانی آغاز می‌شود که یکی از متدهای تولیدگر فراخوانی شود. در آن هنگام، اجرا به نخستین عبارت yield می‌رسد، جایی که دوباره معلق می‌شود و مقدار :token:`~python-grammar:yield_list` را به فراخواننده‌ی تولیدگر برمی‌گرداند، یا اگر :token:`~python-grammar:yield_list` حذف شده باشد، ``None`` را برمی‌گرداند. منظور از معلق بودن این است که تمام وضعیت محلی حفظ می‌شود، از جمله انتساب‌های کنونی متغیرهای محلی، اشاره‌گر دستور، پشته‌ی ارزیابی داخلی، و وضعیت هرگونه مدیریت استثنا. هنگامی که اجرا با فراخوانی یکی از متدهای تولیدگر از سر گرفته می‌شود، تابع می‌تواند دقیقاً به‌گونه‌ای پیش برود که گویی عبارت yield تنها یک فراخوانی خارجی دیگر باشد. مقدار عبارت yield پس از آنکه اجرا از سر گرفته شد، به متدی بستگی دارد که اجرا را از سر گرفته است. اگر از :meth:`~generator.__next__` استفاده شود (معمولاً از طریق :keyword:`for` یا تابع توکار :func:`next`)، نتیجه :const:`None` است. در غیر این صورت، اگر از :meth:`~generator.send` استفاده شود، نتیجه مقداری خواهد بود که به آن متد ارسال شده است." msgid "All of this makes generator functions quite similar to coroutines; they yield multiple times, they have more than one entry point and their execution can be suspended. The only difference is that a generator function cannot control where the execution should continue after it yields; the control is always transferred to the generator's caller." msgstr "همه‌ی این موارد باعث می‌شود توابع تولیدگر بسیار شبیه به هم‌روال‌ها باشند؛ آن‌ها چندین بار yield می‌کنند، بیش از یک نقطه‌ی ورود دارند و اجرای آن‌ها می‌تواند معلق شود. تنها تفاوت این است که تابع تولیدگر نمی‌تواند کنترل کند که پس از yield، اجرا باید از کجا ادامه یابد؛ کنترل همیشه به فراخواننده‌ی تولیدگر منتقل می‌شود." msgid "Yield expressions are allowed anywhere in a :keyword:`try` construct. If the generator is not resumed before it is finalized (by reaching a zero reference count or by being garbage collected), the generator-iterator's :meth:`~generator.close` method will be called, allowing any pending :keyword:`finally` clauses to execute." msgstr "عبارت‌های yield در هر جای یک ساختار :keyword:`try` مجاز هستند. اگر تولیدگر پیش از نهایی شدن (با رسیدن تعداد ارجاع‌ها به صفر یا زباله‌روبی شدن) از سر گرفته نشود، متد :meth:`~generator.close` پیمایش‌گر تولیدگر فراخوانی می‌شود تا امکان اجرای هر بند :keyword:`finally` در انتظار فراهم شود." msgid "When ``yield from `` is used, the supplied expression must be an iterable. The values produced by iterating that iterable are passed directly to the caller of the current generator's methods. Any values passed in with :meth:`~generator.send` and any exceptions passed in with :meth:`~generator.throw` are passed to the underlying iterator if it has the appropriate methods. If this is not the case, then :meth:`~generator.send` will raise :exc:`AttributeError` or :exc:`TypeError`, while :meth:`~generator.throw` will just raise the passed in exception immediately." msgstr "هنگامی که از ``yield from `` استفاده می‌شود، عبارت ارائه‌شده باید پیمایش‌پذیر باشد. مقادیری که با پیمایش آن پیمایش‌پذیر تولید می‌شوند، مستقیماً به فراخواننده‌ی متدهای تولیدگر فعلی ارسال می‌شوند. هر مقداری که با :meth:`~generator.send` ارسال شود و هر استثنایی که با :meth:`~generator.throw` ارسال شود، در صورتی که پیمایش‌گر زیرین متدهای مناسب را داشته باشد، به آن ارسال می‌شود. در غیر این صورت، :meth:`~generator.send` استثناهای :exc:`AttributeError` یا :exc:`TypeError` را پرتاب می‌کند، در حالی که :meth:`~generator.throw` فقط استثنای ارسال‌شده را بلافاصله پرتاب می‌کند." msgid "When the underlying iterator is complete, the :attr:`~StopIteration.value` attribute of the raised :exc:`StopIteration` instance becomes the value of the yield expression. It can be either set explicitly when raising :exc:`StopIteration`, or automatically when the subiterator is a generator (by returning a value from the subgenerator)." msgstr "هنگامی که پیمایش‌گر زیربنایی به پایان می‌رسد، ویژگی :attr:`~StopIteration.value` از نمونه‌ی پرتاب‌شده‌ی :exc:`StopIteration` به مقدار عبارت yield تبدیل می‌شود. این ویژگی می‌تواند یا هنگام پرتاب :exc:`StopIteration` به‌صراحت تنظیم شود، یا وقتی زیرپیمایش‌گر یک تولیدگر باشد به‌طور خودکار (با برگرداندن یک مقدار از زیرتولیدگر) تنظیم شود." msgid "Added ``yield from `` to delegate control flow to a subiterator." msgstr "``yield from `` افزوده شد تا جریان کنترل به یک زیرپیمایش‌گر (subiterator) واگذار شود." msgid "The parentheses may be omitted when the yield expression is the sole expression on the right hand side of an assignment statement." msgstr "هنگامی که عبارت yield تنها عبارت در سمت راست یک دستور انتساب باشد، می‌توان پرانتزها را حذف کرد." msgid ":pep:`255` - Simple Generators" msgstr ":pep:`255` - تولیدگرهای ساده" msgid "The proposal for adding generators and the :keyword:`yield` statement to Python." msgstr "پیشنهاد برای افزودن تولیدگرها و دستور :keyword:`yield` به پایتون." msgid ":pep:`342` - Coroutines via Enhanced Generators" msgstr ":pep:`342` - هم‌روال‌ها از طریق تولیدگرهای بهبودیافته" msgid "The proposal to enhance the API and syntax of generators, making them usable as simple coroutines." msgstr "پیشنهادی برای بهبود API و سینتکس تولیدگرها، تا بتوان از آن‌ها به‌عنوان هم‌روال‌های ساده استفاده کرد." msgid ":pep:`380` - Syntax for Delegating to a Subgenerator" msgstr ":pep:`380` - سینتکس واگذاری به یک زیرتولیدگر" msgid "The proposal to introduce the :token:`~python-grammar:yield_from` syntax, making delegation to subgenerators easy." msgstr "پیشنهاد برای معرفی سینتکس :token:`~python-grammar:yield_from`، که واگذاری به زیرتولیدگرها را آسان می‌کند." msgid ":pep:`525` - Asynchronous Generators" msgstr ":pep:`525` - تولیدگرهای ناهمگام" msgid "The proposal that expanded on :pep:`492` by adding generator capabilities to coroutine functions." msgstr "پیشنهادی که :pep:`492` را با افزودن قابلیت‌های تولیدگر به توابع هم‌روال گسترش داد." msgid "Examples" msgstr "مثال‌ها" msgid "Here is a simple example that demonstrates the behavior of generators and generator functions::" msgstr "در اینجا یک مثال ساده آمده است که رفتار تولیدگرها و توابع تولیدگر را نشان می‌دهد::" msgid "" ">>> def echo(value=None):\n" "... print(\"Execution starts when 'next()' is called for the first time.\")\n" "... try:\n" "... while True:\n" "... try:\n" "... value = (yield value)\n" "... except Exception as e:\n" "... value = e\n" "... finally:\n" "... print(\"Don't forget to clean up when 'close()' is called.\")\n" "...\n" ">>> generator = echo(1)\n" ">>> print(next(generator))\n" "Execution starts when 'next()' is called for the first time.\n" "1\n" ">>> print(next(generator))\n" "None\n" ">>> print(generator.send(2))\n" "2\n" ">>> generator.throw(TypeError, \"spam\")\n" "TypeError('spam',)\n" ">>> generator.close()\n" "Don't forget to clean up when 'close()' is called." msgstr "" ">>> def echo(value=None):\n" "... print(\"Execution starts when 'next()' is called for the first time.\")\n" "... try:\n" "... while True:\n" "... try:\n" "... value = (yield value)\n" "... except Exception as e:\n" "... value = e\n" "... finally:\n" "... print(\"Don't forget to clean up when 'close()' is called.\")\n" "...\n" ">>> generator = echo(1)\n" ">>> print(next(generator))\n" "Execution starts when 'next()' is called for the first time.\n" "1\n" ">>> print(next(generator))\n" "None\n" ">>> print(generator.send(2))\n" "2\n" ">>> generator.throw(TypeError, \"spam\")\n" "TypeError('spam',)\n" ">>> generator.close()\n" "Don't forget to clean up when 'close()' is called." msgid "For examples using ``yield from``, see :ref:`pep-380` in \"What's New in Python.\"" msgstr "برای مثال‌هایی که از ``yield from`` استفاده می‌کنند، به :ref:`pep-380` در «تازه‌های پایتون» مراجعه کنید." msgid "Asynchronous generator functions" msgstr "توابع تولیدگر ناهمگام" msgid "The presence of a yield expression in a function or method defined using :keyword:`async def` further defines the function as an :term:`asynchronous generator` function." msgstr "وجود عبارت yield در تابع یا متدی که با :keyword:`async def` تعریف شده است، آن تابع را به‌عنوان یک تابع :term:`تولیدگر ناهمگام ` نیز تعریف می‌کند." msgid "When an asynchronous generator function is called, it returns an asynchronous iterator known as an asynchronous generator object. That object then controls the execution of the generator function. An asynchronous generator object is typically used in an :keyword:`async for` statement in a coroutine function analogously to how a generator object would be used in a :keyword:`for` statement." msgstr "هنگامی که یک تابع تولیدگر ناهمگام فراخوانی می‌شود، یک پیمایش‌گر ناهمگام را بازمی‌گرداند که به‌عنوان یک شیء تولیدگر ناهمگام شناخته می‌شود. سپس آن شیء اجرای تابع تولیدگر را کنترل می‌کند. یک شیء تولیدگر ناهمگام به‌طور معمول در یک دستور :keyword:`async for` در یک تابع هم‌روال استفاده می‌شود، همان‌گونه که یک شیء تولیدگر در یک دستور :keyword:`for` استفاده می‌شود." msgid "Calling one of the asynchronous generator's methods returns an :term:`awaitable` object, and the execution starts when this object is awaited on. At that time, the execution proceeds to the first yield expression, where it is suspended again, returning the value of :token:`~python-grammar:yield_list` to the awaiting coroutine. As with a generator, suspension means that all local state is retained, including the current bindings of local variables, the instruction pointer, the internal evaluation stack, and the state of any exception handling. When the execution is resumed by awaiting on the next object returned by the asynchronous generator's methods, the function can proceed exactly as if the yield expression were just another external call. The value of the yield expression after resuming depends on the method which resumed the execution. If :meth:`~agen.__anext__` is used then the result is :const:`None`. Otherwise, if :meth:`~agen.asend` is used, then the result will be the value passed in to that method." msgstr "فراخوانی یکی از متدهای تولیدگر ناهمگام یک شیء :term:`awaitable` بازمی‌گرداند و اجرا هنگامی آغاز می‌شود که این شیء await شود. در آن هنگام، اجرا به نخستین عبارت yield می‌رسد، جایی که دوباره معلق می‌شود و مقدار :token:`~python-grammar:yield_list` را به هم‌روال در انتظار بازمی‌گرداند. مانند یک تولیدگر، تعلیق به این معناست که تمام وضعیت محلی حفظ می‌شود، از جمله پیوندهای فعلی متغیرهای محلی، اشاره‌گر دستور، پشته ارزیابی داخلی و وضعیت هرگونه مدیریت استثنا. هنگامی که اجرا با await کردن شیء بعدی که توسط متدهای تولیدگر ناهمگام بازمی‌گردد، از سر گرفته شود، تابع می‌تواند دقیقاً همان‌طور پیش برود که گویی عبارت yield صرفاً یک فراخوانی خارجی دیگر باشد. مقدار عبارت yield پس از ازسرگیری، به متدی بستگی دارد که اجرا را از سر گرفته است. اگر از :meth:`~agen.__anext__` استفاده شود، نتیجه :const:`None` است. در غیر این صورت، اگر از :meth:`~agen.asend` استفاده شود، نتیجه مقداری خواهد بود که به آن متد ارسال شده است." msgid "If an asynchronous generator happens to exit early by :keyword:`break`, the caller task being cancelled, or other exceptions, the generator's async cleanup code will run and possibly raise exceptions or access context variables in an unexpected context--perhaps after the lifetime of tasks it depends, or during the event loop shutdown when the async-generator garbage collection hook is called. To prevent this, the caller must explicitly close the async generator by calling :meth:`~agen.aclose` method to finalize the generator and ultimately detach it from the event loop." msgstr "اگر یک تولیدگر ناهمگام با :keyword:`break`، لغو شدن وظیفه فراخوان، یا سایر استثناها پیش از موعد خارج شود، کد پاک‌سازی ناهمگام تولیدگر اجرا خواهد شد و ممکن است در زمینه‌ای غیرمنتظره استثناهایی را پرتاب کند یا به متغیرهای زمینه دسترسی یابد—شاید پس از پایان عمر وظایفی که به آن‌ها وابسته است، یا در جریان خاموش شدن حلقه‌ی رویداد، هنگامی که قلاب زباله‌روبی تولیدگر ناهمگام فراخوانی می‌شود. برای جلوگیری از این موضوع، فراخوان باید به‌صراحت با فراخوانی متد :meth:`~agen.aclose` تولیدگر ناهمگام را ببندد تا تولیدگر را نهایی‌سازی کند و در نهایت آن را از حلقه‌ی رویداد جدا کند." msgid "In an asynchronous generator function, yield expressions are allowed anywhere in a :keyword:`try` construct. However, if an asynchronous generator is not resumed before it is finalized (by reaching a zero reference count or by being garbage collected), then a yield expression within a :keyword:`!try` construct could result in a failure to execute pending :keyword:`finally` clauses. In this case, it is the responsibility of the event loop or scheduler running the asynchronous generator to call the asynchronous generator-iterator's :meth:`~agen.aclose` method and run the resulting coroutine object, thus allowing any pending :keyword:`!finally` clauses to execute." msgstr "در یک تابع تولیدگر ناهمگام، عبارت‌های yield در هر جایی از ساختار :keyword:`try` مجاز هستند. با این حال، اگر یک تولیدگر ناهمگام پیش از نهایی شدن (با رسیدن شمار ارجاع به صفر یا با زباله‌روبی شدن) از سر گرفته نشود، آنگاه یک عبارت yield درون ساختار :keyword:`!try` ممکن است منجر به اجرا نشدن بندهای :keyword:`finally` در انتظار اجرا شود. در این حالت، بر عهده حلقه رویداد یا زمان‌بندِ در حال اجرای تولیدگر ناهمگام است که متد :meth:`~agen.aclose` پیمایش‌گر تولیدگر ناهمگام را فراخوانی کند و شیء هم‌روال حاصل را اجرا کند، تا بدین ترتیب امکان اجرای هر بند :keyword:`!finally` در انتظار اجرا فراهم شود." msgid "To take care of finalization upon event loop termination, an event loop should define a *finalizer* function which takes an asynchronous generator-iterator and presumably calls :meth:`~agen.aclose` and executes the coroutine. This *finalizer* may be registered by calling :func:`sys.set_asyncgen_hooks`. When first iterated over, an asynchronous generator-iterator will store the registered *finalizer* to be called upon finalization. For a reference example of a *finalizer* method see the implementation of ``asyncio.Loop.shutdown_asyncgens`` in :source:`Lib/asyncio/base_events.py`." msgstr "برای رسیدگی به نهایی‌سازی هنگام پایان حلقه رویداد، یک حلقه رویداد باید یک تابع *نهایی‌ساز* (finalizer) تعریف کند که یک پیمایش‌گرٔ تولیدگر ناهمگام را می‌گیرد و احتمالاً :meth:`~agen.aclose` را فراخوانی می‌کند و هم‌روال را اجرا می‌نماید. این *نهایی‌ساز* را می‌توان با فراخوانی :func:`sys.set_asyncgen_hooks` ثبت کرد. یک پیمایش‌گرٔ تولیدگر ناهمگام در نخستین پیمایش، *نهایی‌ساز* ثبت‌شده را ذخیره می‌کند تا در زمان نهایی‌سازی فراخوانی شود. برای دیدن یک نمونه‌ی مرجع از متد *نهایی‌ساز*، پیاده‌سازی ``asyncio.Loop.shutdown_asyncgens`` در :source:`Lib/asyncio/base_events.py` را ببینید." msgid "The expression ``yield from `` is a syntax error when used in an asynchronous generator function." msgstr "عبارت ``yield from `` هنگام استفاده در یک تابع تولیدگر ناهمگام، خطای نحوی است." msgid "Primaries" msgstr "اولیه‌ها" msgid "Primaries represent the most tightly bound operations of the language. Their syntax is:" msgstr "اولیه‌ها نشان‌دهنده‌ی محکم‌ترین عملیات زبان هستند. سینتکس آن‌ها به این صورت است:" msgid "Attribute references" msgstr "ارجاع‌های ویژگی" msgid "An attribute reference is a primary followed by a period and a name:" msgstr "ارجاع به ویژگی یک عبارت اصلی است که پس از آن یک نقطه و یک نام می‌آید:" msgid "The primary must evaluate to an object of a type that supports attribute references, which most objects do. This object is then asked to produce the attribute whose name is the identifier. The type and value produced is determined by the object. Multiple evaluations of the same attribute reference may yield different objects." msgstr "عبارت اصلی باید به شیء‌ای از نوعی ارزیابی شود که از ارجاع‌های ویژگی پشتیبانی می‌کند؛ بیشتر اشیاء نیز چنین هستند. سپس از این شیء خواسته می‌شود ویژگی‌ای با نام آن شناسه تولید کند. نوع و مقدار تولیدشده توسط شیء تعیین می‌شود. ارزیابی‌های متعدد یک ارجاع ویژگی یکسان ممکن است اشیاء متفاوتی تولید کنند." msgid "This production can be customized by overriding the :meth:`~object.__getattribute__` method or the :meth:`~object.__getattr__` method. The :meth:`!__getattribute__` method is called first and either returns a value or raises :exc:`AttributeError` if the attribute is not available." msgstr "این تولید را می‌توان با بازنویسی متد :meth:`~object.__getattribute__` یا متد :meth:`~object.__getattr__` سفارشی‌سازی کرد. متد :meth:`!__getattribute__` ابتدا فراخوانی می‌شود و یا مقداری را برمی‌گرداند یا در صورت در دسترس نبودن ویژگی، :exc:`AttributeError` را پرتاب می‌کند." msgid "If an :exc:`AttributeError` is raised and the object has a :meth:`!__getattr__` method, that method is called as a fallback." msgstr "اگر یک :exc:`AttributeError` پرتاب شود و شیء متد :meth:`!__getattr__` داشته باشد، آن متد به‌عنوان جایگزین فراخوانی می‌شود." msgid "Subscriptions and slicings" msgstr "زیرنویسی‌ها و اسلایس کردن‌ها" msgid "The :dfn:`subscription` syntax is usually used for selecting an element from a :ref:`container ` -- for example, to get a value from a :class:`dict`::" msgstr "سینتکس :dfn:`زیرنویسی (subscription)` معمولاً برای انتخاب یک عنصر از یک :ref:`ظرف ` استفاده می‌شود -- برای مثال، برای دریافت یک مقدار از یک :class:`dict`::" msgid "" ">>> digits_by_name = {'one': 1, 'two': 2}\n" ">>> digits_by_name['two'] # Subscripting a dictionary using the key 'two'\n" "2" msgstr "" ">>> digits_by_name = {'one': 1, 'two': 2}\n" ">>> digits_by_name['two'] # Subscripting a dictionary using the key 'two'\n" "2" msgid "In the subscription syntax, the object being subscribed -- a :ref:`primary ` -- is followed by a :dfn:`subscript` in square brackets. In the simplest case, the subscript is a single expression." msgstr "در سینتکس زیرنویسی (subscription)، پس از شیء مورد زیرنویسی — یک :ref:`اولیه ` — یک :dfn:`زیرنویس (subscript)` در کروشه‌های مربع قرار می‌گیرد. در ساده‌ترین حالت، زیرنویس یک عبارت واحد است." msgid "Depending on the type of the object being subscribed, the subscript is sometimes called a :term:`key` (for mappings), :term:`index` (for sequences), or *type argument* (for :term:`generic types `). Syntactically, these are all equivalent::" msgstr "بسته به نوع شیءای که زیرنویس بر آن اعمال می‌شود، زیرنویس گاهی :term:`کلید ` (برای نگاشت‌ها)، :term:`اندیس ` (برای دنباله‌ها)، یا *آرگومان نوع* (برای :term:`انواع عام `) نامیده می‌شود. از نظر سینتکسی، همه این‌ها معادل هستند::" msgid "" ">>> colors = ['red', 'blue', 'green', 'black']\n" ">>> colors[3] # Subscripting a list using the index 3\n" "'black'\n" "\n" ">>> list[str] # Parameterizing the list type using the type argument str\n" "list[str]" msgstr "" ">>> colors = ['red', 'blue', 'green', 'black']\n" ">>> colors[3] # Subscripting a list using the index 3\n" "'black'\n" "\n" ">>> list[str] # Parameterizing the list type using the type argument str\n" "list[str]" msgid "At runtime, the interpreter will evaluate the primary and the subscript, and call the primary's :meth:`~object.__getitem__` or :meth:`~object.__class_getitem__` :term:`special method` with the subscript as argument. For more details on which of these methods is called, see :ref:`classgetitem-versus-getitem`." msgstr "در ران‌تایم، مفسر عبارت اصلی و زیرنویس را ارزیابی می‌کند و :meth:`~object.__getitem__` یا :meth:`~object.__class_getitem__` آن را که :term:`متد ویژه ` است، با زیرنویس به‌عنوان آرگومان فراخوانی می‌کند. برای جزئیات بیشتر درباره‌ی این‌که کدام‌یک از این متدها فراخوانی می‌شود، :ref:`classgetitem-versus-getitem` را ببینید." msgid "To show how subscription works, we can define a custom object that implements :meth:`~object.__getitem__` and prints out the value of the subscript::" msgstr "برای نشان دادن چگونگی کار زیرنویسی، می‌توانیم یک شیء سفارشی تعریف کنیم که :meth:`~object.__getitem__` را پیاده‌سازی می‌کند و مقدار زیرنویس را چاپ می‌کند::" msgid "" ">>> class SubscriptionDemo:\n" "... def __getitem__(self, key):\n" "... print(f'subscripted with: {key!r}')\n" "...\n" ">>> demo = SubscriptionDemo()\n" ">>> demo[1]\n" "subscripted with: 1\n" ">>> demo['a' * 3]\n" "subscripted with: 'aaa'" msgstr "" ">>> class SubscriptionDemo:\n" "... def __getitem__(self, key):\n" "... print(f'subscripted with: {key!r}')\n" "...\n" ">>> demo = SubscriptionDemo()\n" ">>> demo[1]\n" "subscripted with: 1\n" ">>> demo['a' * 3]\n" "subscripted with: 'aaa'" msgid "See :meth:`~object.__getitem__` documentation for how built-in types handle subscription." msgstr "برای جزئیات مربوط به نحوه‌ی مدیریت زیرنویسی توسط انواع توکار، مستندات :meth:`~object.__getitem__` را ببینید." msgid "Subscriptions may also be used as targets in :ref:`assignment ` or :ref:`deletion ` statements. In these cases, the interpreter will call the subscripted object's :meth:`~object.__setitem__` or :meth:`~object.__delitem__` :term:`special method`, respectively, instead of :meth:`~object.__getitem__`." msgstr "از زیرنویسی‌ها نیز می‌توان به‌عنوان هدف در دستورهای :ref:`انتساب ` یا :ref:`حذف ` استفاده کرد. در این موارد، مفسر به‌ترتیب به‌جای :meth:`~object.__getitem__`، :term:`متد ویژه ` :meth:`~object.__setitem__` یا :meth:`~object.__delitem__` شیء مورد زیرنویسی را فراخوانی می‌کند." msgid "" ">>> colors = ['red', 'blue', 'green', 'black']\n" ">>> colors[3] = 'white' # Setting item at index\n" ">>> colors\n" "['red', 'blue', 'green', 'white']\n" ">>> del colors[3] # Deleting item at index 3\n" ">>> colors\n" "['red', 'blue', 'green']" msgstr "" ">>> colors = ['red', 'blue', 'green', 'black']\n" ">>> colors[3] = 'white' # Setting item at index\n" ">>> colors\n" "['red', 'blue', 'green', 'white']\n" ">>> del colors[3] # Deleting item at index 3\n" ">>> colors\n" "['red', 'blue', 'green']" msgid "All advanced forms of *subscript* documented in the following sections are also usable for assignment and deletion." msgstr "همه‌ی شکل‌های پیشرفته‌ی *زیرنویس* که در بخش‌های بعدی مستند شده‌اند، برای انتساب و حذف نیز قابل استفاده‌اند." msgid "Slicings" msgstr "اسلایس‌ها" msgid "A more advanced form of subscription, :dfn:`slicing`, is commonly used to extract a portion of a :ref:`sequence `. In this form, the subscript is a :term:`slice`: up to three expressions separated by colons. Any of the expressions may be omitted, but a slice must contain at least one colon::" msgstr "شکل پیشرفته‌تری از زیرنویسی، یعنی :dfn:`اسلایس کردن (slicing)`، معمولاً برای استخراج بخشی از یک :ref:`دنباله ` استفاده می‌شود. در این حالت، زیرنویس یک :term:`اسلایس ` است: حداکثر سه عبارت که با دونقطه از یکدیگر جدا شده‌اند. هر یک از عبارت‌ها ممکن است حذف شود، اما یک اسلایس باید دست‌کم شامل یک دونقطه باشد::" msgid "" ">>> number_names = ['zero', 'one', 'two', 'three', 'four', 'five']\n" ">>> number_names[1:3]\n" "['one', 'two']\n" ">>> number_names[1:]\n" "['one', 'two', 'three', 'four', 'five']\n" ">>> number_names[:3]\n" "['zero', 'one', 'two']\n" ">>> number_names[:]\n" "['zero', 'one', 'two', 'three', 'four', 'five']\n" ">>> number_names[::2]\n" "['zero', 'two', 'four']\n" ">>> number_names[:-3]\n" "['zero', 'one', 'two']\n" ">>> del number_names[4:]\n" ">>> number_names\n" "['zero', 'one', 'two', 'three']" msgstr "" ">>> number_names = ['zero', 'one', 'two', 'three', 'four', 'five']\n" ">>> number_names[1:3]\n" "['one', 'two']\n" ">>> number_names[1:]\n" "['one', 'two', 'three', 'four', 'five']\n" ">>> number_names[:3]\n" "['zero', 'one', 'two']\n" ">>> number_names[:]\n" "['zero', 'one', 'two', 'three', 'four', 'five']\n" ">>> number_names[::2]\n" "['zero', 'two', 'four']\n" ">>> number_names[:-3]\n" "['zero', 'one', 'two']\n" ">>> del number_names[4:]\n" ">>> number_names\n" "['zero', 'one', 'two', 'three']" msgid "When a slice is evaluated, the interpreter constructs a :class:`slice` object whose :attr:`~slice.start`, :attr:`~slice.stop` and :attr:`~slice.step` attributes, respectively, are the results of the expressions between the colons. Any missing expression evaluates to :const:`None`. This :class:`!slice` object is then passed to the :meth:`~object.__getitem__` or :meth:`~object.__class_getitem__` :term:`special method`, as above. ::" msgstr "هنگامی که یک اسلایس ارزیابی می‌شود، مفسر یک شیء :class:`slice` ایجاد می‌کند که ویژگی‌های :attr:`~slice.start`، :attr:`~slice.stop` و :attr:`~slice.step` آن به‌ترتیب نتایج عبارت‌های بین دونقطه‌ها هستند. هر عبارت جاافتاده به :const:`None` ارزیابی می‌شود. سپس این شیء :class:`!slice` به :meth:`~object.__getitem__` یا :meth:`~object.__class_getitem__` :term:`متد خاص `، همان‌طور که در بالا ذکر شد، داده می‌شود. ::" msgid "" "# continuing with the SubscriptionDemo instance defined above:\n" ">>> demo[2:3]\n" "subscripted with: slice(2, 3, None)\n" ">>> demo[::'spam']\n" "subscripted with: slice(None, None, 'spam')" msgstr "" "# continuing with the SubscriptionDemo instance defined above:\n" ">>> demo[2:3]\n" "subscripted with: slice(2, 3, None)\n" ">>> demo[::'spam']\n" "subscripted with: slice(None, None, 'spam')" msgid "Comma-separated subscripts" msgstr "زیرنویس‌های جداشده با ویرگول" msgid "The subscript can also be given as two or more comma-separated expressions or slices::" msgstr "همچنین می‌توان زیرنویس را به‌صورت دو یا چند عبارت یا اسلایس جداشده با کاما نیز مشخص کرد::" msgid "" "# continuing with the SubscriptionDemo instance defined above:\n" ">>> demo[1, 2, 3]\n" "subscripted with: (1, 2, 3)\n" ">>> demo[1:2, 3]\n" "subscripted with: (slice(1, 2, None), 3)" msgstr "" "# continuing with the SubscriptionDemo instance defined above:\n" ">>> demo[1, 2, 3]\n" "subscripted with: (1, 2, 3)\n" ">>> demo[1:2, 3]\n" "subscripted with: (slice(1, 2, None), 3)" msgid "This form is commonly used with numerical libraries for slicing multi-dimensional data. In this case, the interpreter constructs a :class:`tuple` of the results of the expressions or slices, and passes this tuple to the :meth:`~object.__getitem__` or :meth:`~object.__class_getitem__` :term:`special method`, as above." msgstr "این شکل معمولاً با کتابخانه‌های عددی برای اسلایس داده‌های چندبُعدی استفاده می‌شود. در این حالت، مفسر یک :class:`tuple` از نتایج عبارت‌ها یا اسلایس‌ها می‌سازد و این tuple را به :term:`متد ویژه ` :meth:`~object.__getitem__` یا :meth:`~object.__class_getitem__`، همان‌طور که در بالا آمد، ارسال می‌کند." msgid "The subscript may also be given as a single expression or slice followed by a comma, to specify a one-element tuple::" msgstr "همچنین می‌توان زیرنویس را به‌صورت یک عبارت یا اسلایس تنها به‌همراه ویرگولی پس از آن، برای مشخص کردن یک تاپل تک‌عضوی به کار برد::" msgid "" ">>> demo['spam',]\n" "subscripted with: ('spam',)" msgstr "" ">>> demo['spam',]\n" "subscripted with: ('spam',)" msgid "\"Starred\" subscriptions" msgstr "زیرنویسی‌های «ستاره‌دار»" msgid "Expressions in *tuple_slices* may be starred. See :pep:`646`." msgstr "عبارت‌های درون *tuple_slices* می‌توانند ستاره‌دار باشند. :pep:`646` را ببینید." msgid "The subscript can also contain a starred expression. In this case, the interpreter unpacks the result into a tuple, and passes this tuple to :meth:`~object.__getitem__` or :meth:`~object.__class_getitem__`::" msgstr "عبارت زیرنویس می‌تواند شامل یک عبارت ستاره‌دار نیز باشد. در این حالت، مفسر نتیجه را در قالب یک تاپل واگشایی می‌کند و این تاپل را به :meth:`~object.__getitem__` یا :meth:`~object.__class_getitem__` منتقل می‌کند::" msgid "" "# continuing with the SubscriptionDemo instance defined above:\n" ">>> demo[*range(10)]\n" "subscripted with: (0, 1, 2, 3, 4, 5, 6, 7, 8, 9)" msgstr "" "# continuing with the SubscriptionDemo instance defined above:\n" ">>> demo[*range(10)]\n" "subscripted with: (0, 1, 2, 3, 4, 5, 6, 7, 8, 9)" msgid "Starred expressions may be combined with comma-separated expressions and slices::" msgstr "می‌توان عبارت‌های ستاره‌دار را با عبارت‌های جداشده با کاما و اسلایس‌ها ترکیب کرد::" msgid "" ">>> demo['a', 'b', *range(3), 'c']\n" "subscripted with: ('a', 'b', 0, 1, 2, 'c')" msgstr "" ">>> demo['a', 'b', *range(3), 'c']\n" "subscripted with: ('a', 'b', 0, 1, 2, 'c')" msgid "Formal subscription grammar" msgstr "دستور زبان رسمی اشتراک" msgid "Recall that the ``|`` operator :ref:`denotes ordered choice `. Specifically, in :token:`!subscript`, if both alternatives would match, the first (:token:`!single_subscript`) has priority." msgstr "به یاد داشته باشید که عملگر ``|`` :ref:`بیانگر انتخاب ترتیبی ` است. به‌طور مشخص، در :token:`!subscript`، اگر هر دو جایگزین تطابق یابند، نخستین (:token:`!single_subscript`) اولویت دارد." msgid "Calls" msgstr "فراخوانی‌ها" msgid "A call calls a callable object (e.g., a :term:`function`) with a possibly empty series of :term:`arguments `:" msgstr "یک فراخوانی، یک شیء فراخوانی‌پذیر (برای مثال، یک :term:`تابع `) را با دنباله‌ای از :term:`آرگومان‌ها ` که ممکن است خالی باشد فراخوانی می‌کند:" msgid "An optional trailing comma may be present after the positional and keyword arguments but does not affect the semantics." msgstr "ممکن است یک ویرگول پایانی اختیاری پس از آرگومان‌های جایگاهی و کلیدواژه‌ای وجود داشته باشد، اما بر معناشناسی تأثیری نمی‌گذارد." msgid "The primary must evaluate to a callable object (user-defined functions, built-in functions, methods of built-in objects, class objects, methods of class instances, and all objects having a :meth:`~object.__call__` method are callable). All argument expressions are evaluated before the call is attempted. Please refer to section :ref:`function` for the syntax of formal :term:`parameter` lists." msgstr "عبارت اصلی باید به یک شیء فراخوانی‌پذیر ارزیابی شود (توابع تعریف‌شده توسط کاربر، توابع توکار، متدهای اشیاء توکار، اشیاء کلاس، متدهای نمونه‌های کلاس، و همه اشیایی که متد :meth:`~object.__call__` دارند، فراخوانی‌پذیر هستند). تمام عبارت‌های آرگومان پیش از تلاش برای فراخوانی ارزیابی می‌شوند. برای سینتکس فهرست‌های :term:`پارامتر ` صوری، به بخش :ref:`تابع ` مراجعه کنید." msgid "If keyword arguments are present, they are first converted to positional arguments, as follows. First, a list of unfilled slots is created for the formal parameters. If there are N positional arguments, they are placed in the first N slots. Next, for each keyword argument, the identifier is used to determine the corresponding slot (if the identifier is the same as the first formal parameter name, the first slot is used, and so on). If the slot is already filled, a :exc:`TypeError` exception is raised. Otherwise, the argument is placed in the slot, filling it (even if the expression is ``None``, it fills the slot). When all arguments have been processed, the slots that are still unfilled are filled with the corresponding default value from the function definition. (Default values are calculated, once, when the function is defined; thus, a mutable object such as a list or dictionary used as default value will be shared by all calls that don't specify an argument value for the corresponding slot; this should usually be avoided.) If there are any unfilled slots for which no default value is specified, a :exc:`TypeError` exception is raised. Otherwise, the list of filled slots is used as the argument list for the call." msgstr "اگر آرگومان‌های کلیدواژه‌ای وجود داشته باشند، آن‌ها ابتدا به آرگومان‌های جایگاهی تبدیل می‌شوند، به شرح زیر. نخست، فهرستی از جایگاه‌های پر نشده برای پارامترهای صوری ایجاد می‌شود. اگر N آرگومان جایگاهی وجود داشته باشد، آن‌ها در N جایگاه نخست قرار می‌گیرند. سپس، برای هر آرگومان کلیدواژه‌ای، از شناسه برای تعیین جایگاه متناظر استفاده می‌شود (اگر شناسه با نام نخستین پارامتر صوری یکسان باشد، نخستین جایگاه استفاده می‌شود، و به همین ترتیب). اگر جایگاه از قبل پر شده باشد، استثنای :exc:`TypeError` پرتاب می‌شود. در غیر این صورت، آرگومان در جایگاه قرار می‌گیرد و آن را پر می‌کند (حتی اگر عبارت ``None`` باشد، جایگاه را پر می‌کند). هنگامی که همه‌ی آرگومان‌ها پردازش شدند، جایگاه‌هایی که هنوز پر نشده‌اند با مقدار پیش‌فرض متناظر از تعریف تابع پر می‌شوند. (مقادیر پیش‌فرض یک بار، هنگام تعریف تابع محاسبه می‌شوند؛ بنابراین، یک شیء تغییرپذیر مانند فهرست یا دیکشنری که به‌عنوان مقدار پیش‌فرض استفاده شود، بین همه‌ی فراخوانی‌هایی که برای جایگاه متناظر مقدار آرگومان مشخص نمی‌کنند، مشترک خواهد بود؛ معمولاً باید از این کار اجتناب شود.) اگر جایگاه‌های پر نشده‌ای وجود داشته باشند که هیچ مقدار پیش‌فرضی برای آن‌ها مشخص نشده باشد، استثنای :exc:`TypeError` پرتاب می‌شود. در غیر این صورت، فهرست جایگاه‌های پر شده به‌عنوان فهرست آرگومان‌ها برای فراخوانی استفاده می‌شود." msgid "An implementation may provide built-in functions whose positional parameters do not have names, even if they are 'named' for the purpose of documentation, and which therefore cannot be supplied by keyword. In CPython, this is the case for functions implemented in C that use :c:func:`PyArg_ParseTuple` to parse their arguments." msgstr "یک پیاده‌سازی ممکن است توابع توکاری را ارائه دهد که پارامترهای جایگاهی آن‌ها نام ندارند، حتی اگر برای اهداف مستندسازی «نام‌گذاری‌شده» باشند، و بنابراین نمی‌توان آن‌ها را با کلیدواژه ارسال کرد. در CPython، این حالت برای توابعی صدق می‌کند که در C پیاده‌سازی شده‌اند و از :c:func:`PyArg_ParseTuple` برای تجزیه آرگومان‌های خود استفاده می‌کنند." msgid "If there are more positional arguments than there are formal parameter slots, a :exc:`TypeError` exception is raised, unless a formal parameter using the syntax ``*identifier`` is present; in this case, that formal parameter receives a tuple containing the excess positional arguments (or an empty tuple if there were no excess positional arguments)." msgstr "اگر آرگومان‌های جایگاهی بیشتری نسبت به جایگاه‌های پارامتر صوری وجود داشته باشد، استثنای :exc:`TypeError` پرتاب می‌شود، مگر اینکه یک پارامتر صوری با استفاده از سینتکس ``*identifier`` وجود داشته باشد؛ در این حالت، آن پارامتر صوری یک تاپل شامل آرگومان‌های جایگاهی مازاد را دریافت می‌کند (یا یک تاپل خالی اگر هیچ آرگومان جایگاهی مازادی وجود نداشته باشد)." msgid "If any keyword argument does not correspond to a formal parameter name, a :exc:`TypeError` exception is raised, unless a formal parameter using the syntax ``**identifier`` is present; in this case, that formal parameter receives a dictionary containing the excess keyword arguments (using the keywords as keys and the argument values as corresponding values), or a (new) empty dictionary if there were no excess keyword arguments." msgstr "اگر آرگومان کلیدواژه‌ای وجود داشته باشد که با نام یک پارامتر صوری مطابقت نداشته باشد، یک استثنای :exc:`TypeError` پرتاب می‌شود، مگر اینکه یک پارامتر صوری با استفاده از سینتکس ``**identifier`` وجود داشته باشد؛ در این حالت، آن پارامتر صوری یک دیکشنری حاوی آرگومان‌های کلیدواژه‌ای اضافی دریافت می‌کند (با استفاده از کلیدواژه‌ها به‌عنوان کلیدها و مقادیر آرگومان‌ها به‌عنوان مقادیر متناظر)، یا اگر آرگومان کلیدواژه‌ای اضافی وجود نداشته باشد، یک دیکشنری خالی (جدید) دریافت می‌کند." msgid "If the syntax ``*expression`` appears in the function call, ``expression`` must evaluate to an :term:`iterable`. Elements from these iterables are treated as if they were additional positional arguments. For the call ``f(x1, x2, *y, x3, x4)``, if *y* evaluates to a sequence *y1*, ..., *yM*, this is equivalent to a call with M+4 positional arguments *x1*, *x2*, *y1*, ..., *yM*, *x3*, *x4*." msgstr "اگر سینتکس ``*expression`` در فراخوانی تابع آمده باشد، ``expression`` باید به یک :term:`پیمایش‌پذیر ` ارزیابی شود. با عناصر این پیمایش‌پذیرها چنان رفتار می‌شود که گویی آرگومان‌های جایگاهی اضافی هستند. برای فراخوانی ``f(x1, x2, *y, x3, x4)``، اگر *y* به یک دنباله *y1*، ...، *yM* ارزیابی شود، این معادل یک فراخوانی با M+۴ آرگومان جایگاهی *x1*، *x2*، *y1*، ...، *yM*، *x3*، *x4* است." msgid "A consequence of this is that although the ``*expression`` syntax may appear *after* explicit keyword arguments, it is processed *before* the keyword arguments (and any ``**expression`` arguments -- see below). So::" msgstr "پیامد این موضوع آن است که اگرچه سینتکس ``*expression`` ممکن است *بعد از* آرگومان‌های کلیدواژه‌ای صریح ظاهر شود، اما *قبل از* آرگومان‌های کلیدواژه‌ای (و هر آرگومان ``**expression`` — در زیر ببینید) پردازش می‌شود. بنابراین::" msgid "" ">>> def f(a, b):\n" "... print(a, b)\n" "...\n" ">>> f(b=1, *(2,))\n" "2 1\n" ">>> f(a=1, *(2,))\n" "Traceback (most recent call last):\n" " File \"\", line 1, in \n" "TypeError: f() got multiple values for keyword argument 'a'\n" ">>> f(1, *(2,))\n" "1 2" msgstr "" ">>> def f(a, b):\n" "... print(a, b)\n" "...\n" ">>> f(b=1, *(2,))\n" "2 1\n" ">>> f(a=1, *(2,))\n" "Traceback (most recent call last):\n" " File \"\", line 1, in \n" "TypeError: f() got multiple values for keyword argument 'a'\n" ">>> f(1, *(2,))\n" "1 2" msgid "It is unusual for both keyword arguments and the ``*expression`` syntax to be used in the same call, so in practice this confusion does not often arise." msgstr "استفاده همزمان از آرگومان‌های کلیدواژه‌ای و سینتکس ``*expression`` در یک فراخوانی غیرمعمول است، بنابراین در عمل این سردرگمی اغلب پیش نمی‌آید." msgid "If the syntax ``**expression`` appears in the function call, ``expression`` must evaluate to a :term:`mapping`, the contents of which are treated as additional keyword arguments. If a parameter matching a key has already been given a value (by an explicit keyword argument, or from another unpacking), a :exc:`TypeError` exception is raised." msgstr "اگر سینتکس ``**expression`` در فراخوانی تابع وجود داشته باشد، ``expression`` باید به یک :term:`نگاشت ` ارزیابی شود؛ محتوای آن به‌عنوان آرگومان‌های کلیدواژه‌ای اضافی در نظر گرفته می‌شود. اگر به پارامتری که با یک کلید مطابقت دارد، از قبل مقداری داده شده باشد (با یک آرگومان کلیدواژه‌ای صریح، یا از واگشایی دیگری)، استثنای :exc:`TypeError` پرتاب می‌شود." msgid "When ``**expression`` is used, each key in this mapping must be a string. Each value from the mapping is assigned to the first formal parameter eligible for keyword assignment whose name is equal to the key. A key need not be a Python identifier (e.g. ``\"max-temp °F\"`` is acceptable, although it will not match any formal parameter that could be declared). If there is no match to a formal parameter the key-value pair is collected by the ``**`` parameter, if there is one, or if there is not, a :exc:`TypeError` exception is raised." msgstr "هنگامی که از ``**expression`` استفاده می‌شود، هر کلید در این نگاشت باید یک رشته باشد. هر مقدار از این نگاشت به اولین پارامتر رسمی واجد شرایط برای انتساب کلیدواژه‌ای که نام آن برابر با کلید است، اختصاص می‌یابد. کلید لازم نیست یک شناسه پایتون باشد (برای مثال ``\"max-temp °F\"`` قابل قبول است، اگرچه با هیچ پارامتر رسمی‌ای که بتوان آن را اعلان کرد مطابقت نخواهد داشت). اگر هیچ مطابقتی با یک پارامتر رسمی وجود نداشته باشد، جفت کلید-مقدار توسط پارامتر ``**`` جمع‌آوری می‌شود، در صورتی که چنین پارامتری وجود داشته باشد، و در غیر این صورت، استثنای :exc:`TypeError` پرتاب می‌شود." msgid "Formal parameters using the syntax ``*identifier`` or ``**identifier`` cannot be used as positional argument slots or as keyword argument names." msgstr "نمی‌توان از پارامترهای صوری با سینتکس ``*identifier`` یا ``**identifier`` به‌عنوان جایگاه‌های آرگومان‌های جایگاهی یا نام‌های آرگومان‌های کلیدواژه‌ای استفاده کرد." msgid "Function calls accept any number of ``*`` and ``**`` unpackings, positional arguments may follow iterable unpackings (``*``), and keyword arguments may follow dictionary unpackings (``**``). Originally proposed by :pep:`448`." msgstr "فراخوانی‌های تابع هر تعداد واگشایی ``*`` و ``**`` را می‌پذیرند، آرگومان‌های جایگاهی می‌توانند پس از واگشایی‌های پیمایش‌پذیر (``*``) بیایند، و آرگومان‌های کلیدواژه‌ای می‌توانند پس از واگشایی‌های دیکشنری (``**``) بیایند. در ابتدا توسط :pep:`448` پیشنهاد شد." msgid "A call always returns some value, possibly ``None``, unless it raises an exception. How this value is computed depends on the type of the callable object." msgstr "یک فراخوانی همیشه مقداری را برمی‌گرداند، که ممکن است ``None`` باشد، مگر آنکه استثنایی را پرتاب کند. نحوه محاسبه این مقدار به نوع شیء فراخوانی‌پذیر بستگی دارد." msgid "If it is---" msgstr "اگر این‌طور باشد---" msgid "a user-defined function:" msgstr "یک تابع تعریف‌شده توسط کاربر:" msgid "The code block for the function is executed, passing it the argument list. The first thing the code block will do is bind the formal parameters to the arguments; this is described in section :ref:`function`. When the code block executes a :keyword:`return` statement, this specifies the return value of the function call. If execution reaches the end of the code block without executing a :keyword:`return` statement, the return value is ``None``." msgstr "بلوک کد مربوط به تابع اجرا می‌شود و فهرست آرگومان‌ها به آن داده می‌شود. نخستین کاری که بلوک کد انجام می‌دهد، مقیدسازی پارامترهای صوری به آرگومان‌ها است؛ این موضوع در بخش :ref:`تابع ` توضیح داده شده است. هنگامی که بلوک کد یک دستور :keyword:`return` را اجرا می‌کند، مقدار بازگشتی فراخوانی تابع را مشخص می‌کند. اگر اجرا به انتهای بلوک کد برسد بدون آنکه دستور :keyword:`return` اجرا شود، مقدار بازگشتی ``None`` است." msgid "a built-in function or method:" msgstr "یک تابع یا متد توکار:" msgid "The result is up to the interpreter; see :ref:`built-in-funcs` for the descriptions of built-in functions and methods." msgstr "نتیجه به مفسر بستگی دارد؛ برای توضیحات توابع و متدهای توکار به :ref:`built-in-funcs` مراجعه کنید." msgid "a class object:" msgstr "یک شیء کلاس:" msgid "A new instance of that class is returned." msgstr "یک نمونه جدید از آن کلاس بازگردانده می‌شود." msgid "a class instance method:" msgstr "یک متد نمونه‌ی کلاس:" msgid "The corresponding user-defined function is called, with an argument list that is one longer than the argument list of the call: the instance becomes the first argument." msgstr "تابع تعریف‌شده توسط کاربر متناظر فراخوانی می‌شود، با فهرست آرگومانی که یک آیتم بیشتر از فهرست آرگومان‌های فراخوانی دارد: نمونه اولین آرگومان می‌شود." msgid "a class instance:" msgstr "یک نمونه از کلاس:" msgid "The class must define a :meth:`~object.__call__` method; the effect is then the same as if that method was called." msgstr "کلاس باید یک متد :meth:`~object.__call__` تعریف کند؛ در این صورت اثر آن همانند حالتی است که گویی آن متد فراخوانی‌شده باشد." msgid "Await expression" msgstr "عبارت await" msgid "Suspend the execution of :term:`coroutine` on an :term:`awaitable` object. Can only be used inside a :term:`coroutine function`." msgstr "اجرای :term:`هم‌روال ` را بر روی یک شیء :term:`awaitable` معلق می‌کند. فقط می‌تواند درون یک :term:`تابع هم‌روال ` استفاده شود." msgid "The power operator" msgstr "عملگر توان" msgid "The power operator binds more tightly than unary operators on its left; it binds less tightly than unary operators on its right. The syntax is:" msgstr "عملگر توان نسبت به عملگرهای یک‌عملوندی در سمت چپ خود، اولویت بیشتری دارد؛ این عملگر نسبت به عملگرهای یک‌عملوندی در سمت راست خود، اولویت کمتری دارد. سینتکس به این صورت است:" msgid "Thus, in an unparenthesized sequence of power and unary operators, the operators are evaluated from right to left (this does not constrain the evaluation order for the operands): ``-1**2`` results in ``-1``." msgstr "بنابراین، در یک دنباله بدون پرانتز از عملگرهای توان و یک‌عملوندی، عملگرها از راست به چپ ارزیابی می‌شوند (این موضوع ترتیب ارزیابی عملوندها را محدود نمی‌کند): ``-1**2`` برابر با ``-1`` می‌شود." msgid "The power operator has the same semantics as the built-in :func:`pow` function, when called with two arguments: it yields its left argument raised to the power of its right argument. Numeric arguments are first :ref:`converted to a common type `, and the result is of that type." msgstr "عملگر توان همان معنایی را دارد که تابع توکار :func:`pow` هنگام فراخوانی با دو آرگومان دارد: این عملگر، آرگومان چپ خود را به توان آرگومان راست خود برمی‌گرداند. آرگومان‌های عددی ابتدا :ref:`به یک نوع مشترک تبدیل می‌شوند `، و نتیجه از آن نوع است." msgid "For int operands, the result has the same type as the operands unless the second argument is negative; in that case, all arguments are converted to float and a float result is delivered. For example, ``10**2`` returns ``100``, but ``10**-2`` returns ``0.01``." msgstr "برای عملوندهای int، نتیجه هم‌نوع با عملوندها است، مگر اینکه آرگومان دوم منفی باشد؛ در آن صورت، تمام آرگومان‌ها به float تبدیل می‌شوند و نتیجه‌ای از نوع float برگردانده می‌شود. برای مثال، ``10**2`` مقدار ``100`` را برمی‌گرداند، اما ``10**-2`` مقدار ``0.01`` را برمی‌گرداند." msgid "Raising ``0.0`` to a negative power results in a :exc:`ZeroDivisionError`. Raising a negative number to a fractional power results in a :class:`complex` number. (In earlier versions it raised a :exc:`ValueError`.)" msgstr "رساندن ``0.0`` به توان منفی منجر به :exc:`ZeroDivisionError` می‌شود. رساندن یک عدد منفی به توان کسری منجر به یک عدد :class:`complex` می‌شود. (در نسخه‌های پیشین، :exc:`ValueError` پرتاب می‌شد.)" msgid "This operation can be customized using the special :meth:`~object.__pow__` and :meth:`~object.__rpow__` methods." msgstr "این عملیات را می‌توان با استفاده از متدهای ویژه‌ی :meth:`~object.__pow__` و :meth:`~object.__rpow__` سفارشی کرد." msgid "Unary arithmetic and bitwise operations" msgstr "عملیات حسابی و بیتی یک‌عملوندی" msgid "All unary arithmetic and bitwise operations have the same priority:" msgstr "تمام عملیات حسابی و بیتی یک‌عملوندی اولویت یکسانی دارند:" msgid "The unary ``-`` (minus) operator yields the negation of its numeric argument; the operation can be overridden with the :meth:`~object.__neg__` special method." msgstr "عملگر یک‌عملوندی ``-`` (منفی)، منفیِ آرگومان عددی خود را برمی‌گرداند؛ این عملیات را می‌توان با متد ویژه :meth:`~object.__neg__` بازنویسی کرد." msgid "The unary ``+`` (plus) operator yields its numeric argument unchanged; the operation can be overridden with the :meth:`~object.__pos__` special method." msgstr "عملگر یک‌عملوندی ``+`` (مثبت) آرگومان عددی خود را بدون تغییر برمی‌گرداند؛ این عملیات را می‌توان با متد ویژه :meth:`~object.__pos__` بازنویسی کرد." msgid "The unary ``~`` (invert) operator yields the bitwise inversion of its integer argument. The bitwise inversion of ``x`` is defined as ``-(x+1)``. It only applies to integral numbers or to custom objects that override the :meth:`~object.__invert__` special method." msgstr "عملگر یک‌عملوندی ``~`` (وارون‌سازی) وارونگی بیتی آرگومان عدد صحیح خود را حاصل می‌کند. وارونگی بیتی ``x`` به صورت ``-(x+1)`` تعریف شده است. این عملگر فقط بر اعداد صحیح یا اشیاء سفارشی‌ای اعمال می‌شود که متد ویژه :meth:`~object.__invert__` را بازنویسی کرده‌اند." msgid "In all three cases, if the argument does not have the proper type, a :exc:`TypeError` exception is raised." msgstr "در هر سه حالت، اگر آرگومان نوع مناسب نداشته باشد، استثنای :exc:`TypeError` پرتاب می‌شود." msgid "Binary arithmetic operations" msgstr "عملیات حسابی دودویی" msgid "The binary arithmetic operations have the conventional priority levels. Note that some of these operations also apply to certain non-numeric types. Apart from the power operator, there are only two levels, one for multiplicative operators and one for additive operators:" msgstr "عملیات حسابی دودویی دارای سطوح اولویت مرسوم هستند. توجه داشته باشید که برخی از این عملیات بر برخی انواع غیرعددی نیز اعمال می‌شوند. به جز عملگر توان، تنها دو سطح وجود دارد، یکی برای عملگرهای ضربی و دیگری برای عملگرهای جمعی:" msgid "The ``*`` (multiplication) operator yields the product of its arguments. The arguments must either both be numbers, or one argument must be an integer and the other must be a sequence. In the former case, the numbers are :ref:`converted to a common real type ` and then multiplied together. In the latter case, sequence repetition is performed; a negative repetition factor yields an empty sequence." msgstr "عملگر ``*`` (ضرب) حاصل‌ضرب آرگومان‌هایش را به دست می‌دهد. آرگومان‌ها باید یا هر دو عدد باشند، یا یکی از آرگومان‌ها باید عدد صحیح و دیگری باید یک دنباله باشد. در حالت اول، اعداد :ref:`به یک نوع حقیقی مشترک تبدیل می‌شوند ` و سپس در هم ضرب می‌شوند. در حالت دوم، تکرار دنباله انجام می‌شود؛ ضریب تکرار منفی، یک دنباله خالی به دست می‌دهد." msgid "This operation can be customized using the special :meth:`~object.__mul__` and :meth:`~object.__rmul__` methods." msgstr "این عملیات را می‌توان با استفاده از متدهای ویژه‌ی :meth:`~object.__mul__` و :meth:`~object.__rmul__` سفارشی‌سازی کرد." msgid "If only one operand is a complex number, the other operand is converted to a floating-point number." msgstr "اگر تنها یکی از عملوندها یک عدد مختلط باشد، عملوند دیگر به یک عدد ممیز شناور تبدیل می‌شود." msgid "The ``@`` (at) operator is intended to be used for matrix multiplication. No builtin Python types implement this operator." msgstr "عملگر ``@`` (at) برای ضرب ماتریسی در نظر گرفته شده است. هیچ‌یک از انواع توکار پایتون این عملگر را پیاده‌سازی نمی‌کنند." msgid "This operation can be customized using the special :meth:`~object.__matmul__` and :meth:`~object.__rmatmul__` methods." msgstr "این عملیات را می‌توان با استفاده از متدهای ویژه :meth:`~object.__matmul__` و :meth:`~object.__rmatmul__` سفارشی‌سازی کرد." msgid "The ``/`` (division) and ``//`` (floor division) operators yield the quotient of their arguments. The numeric arguments are first :ref:`converted to a common type `. Division of integers yields a float, while floor division of integers results in an integer; the result is that of mathematical division with the 'floor' function applied to the result. Division by zero raises the :exc:`ZeroDivisionError` exception." msgstr "عملگرهای ``/`` (تقسیم) و ``//`` (تقسیم کف) خارج‌قسمت آرگومان‌های خود را برمی‌گردانند. آرگومان‌های عددی ابتدا :ref:`به یک نوع مشترک تبدیل می‌شوند `. تقسیم اعداد صحیح یک مقدار شناور برمی‌گرداند، در حالی که تقسیم کفِ اعداد صحیح یک عدد صحیح نتیجه می‌دهد؛ نتیجه، حاصل تقسیم ریاضی است که تابع 'floor' بر آن اعمال شده است. تقسیم بر صفر استثنای :exc:`ZeroDivisionError` را پرتاب می‌کند." msgid "The division operation can be customized using the special :meth:`~object.__truediv__` and :meth:`~object.__rtruediv__` methods. The floor division operation can be customized using the special :meth:`~object.__floordiv__` and :meth:`~object.__rfloordiv__` methods." msgstr "عملیات تقسیم را می‌توان با استفاده از متدهای ویژه :meth:`~object.__truediv__` و :meth:`~object.__rtruediv__` سفارشی‌سازی کرد. عملیات تقسیم کف را می‌توان با استفاده از متدهای ویژه :meth:`~object.__floordiv__` و :meth:`~object.__rfloordiv__` سفارشی‌سازی کرد." msgid "The ``%`` (modulo) operator yields the remainder from the division of the first argument by the second. The numeric arguments are first :ref:`converted to a common type `. A zero right argument raises the :exc:`ZeroDivisionError` exception. The arguments may be floating-point numbers, e.g., ``3.14%0.7`` equals ``0.34`` (since ``3.14`` equals ``4*0.7 + 0.34``.) The modulo operator always yields a result with the same sign as its second operand (or zero); the absolute value of the result is strictly smaller than the absolute value of the second operand [#]_." msgstr "عملگر ``%`` (باقی‌مانده) باقی‌مانده‌ی تقسیم آرگومان اول بر آرگومان دوم را برمی‌گرداند. آرگومان‌های عددی ابتدا :ref:`به یک نوع مشترک تبدیل می‌شوند `. صفر بودن آرگومان سمت راست باعث پرتاب استثنای :exc:`ZeroDivisionError` می‌شود. آرگومان‌ها ممکن است اعداد ممیز شناور باشند، برای مثال، ``3.14%0.7`` برابر ``0.34`` است (زیرا ``3.14`` برابر ``4*0.7 + 0.34`` است.) عملگر باقی‌مانده همیشه نتیجه‌ای با همان علامت عملوند دوم خود (یا صفر) حاصل می‌کند؛ مقدار مطلق نتیجه اکیداً کوچک‌تر از مقدار مطلق عملوند دوم است [#]_." msgid "The floor division and modulo operators are connected by the following identity: ``x == (x//y)*y + (x%y)``. Floor division and modulo are also connected with the built-in function :func:`divmod`: ``divmod(x, y) == (x//y, x%y)``. [#]_." msgstr "عملگرهای تقسیم کف و باقی‌مانده با اتحاد زیر به یکدیگر مرتبط هستند: ``x == (x//y)*y + (x%y)``. تقسیم کف و باقی‌مانده همچنین با تابع توکار :func:`divmod` مرتبط هستند: ``divmod(x, y) == (x//y, x%y)``. [#]_." msgid "In addition to performing the modulo operation on numbers, the ``%`` operator is also overloaded by string objects to perform old-style string formatting (also known as interpolation). The syntax for string formatting is described in the Python Library Reference, section :ref:`old-string-formatting`." msgstr "علاوه بر انجام عملیات باقی‌مانده روی اعداد، اشیاء رشته نیز عملگر ``%`` را سربارگذاری کرده‌اند تا قالب‌بندی رشته به سبک قدیمی (که به آن درون‌یابی (interpolation) نیز گفته می‌شود) انجام شود. سینتکس قالب‌بندی رشته در مرجع کتابخانه پایتون، بخش :ref:`old-string-formatting` توضیح داده شده است." msgid "The *modulo* operation can be customized using the special :meth:`~object.__mod__` and :meth:`~object.__rmod__` methods." msgstr "عملیات *باقی‌مانده* را می‌توان با استفاده از متدهای ویژه :meth:`~object.__mod__` و :meth:`~object.__rmod__` سفارشی‌سازی کرد." msgid "The floor division operator, the modulo operator, and the :func:`divmod` function are not defined for complex numbers. Instead, convert to a floating-point number using the :func:`abs` function if appropriate." msgstr "عملگر تقسیم کف، عملگر باقی‌مانده (modulo)، و تابع :func:`divmod` برای اعداد مختلط تعریف نشده‌اند. در عوض، در صورت مناسب بودن، با استفاده از تابع :func:`abs` آن را به یک عدد ممیز شناور تبدیل کنید." msgid "The ``+`` (addition) operator yields the sum of its arguments. The arguments must either both be numbers or both be sequences of the same type. In the former case, the numbers are :ref:`converted to a common real type ` and then added together. In the latter case, the sequences are concatenated." msgstr "عملگر ``+`` (جمع) حاصل‌جمع آرگومان‌های خود را برمی‌گرداند. آرگومان‌ها باید یا هر دو عدد یا هر دو دنباله‌هایی از یک نوع باشند. در حالت اول، اعداد :ref:`به یک نوع حقیقی مشترک تبدیل می‌شوند ` و سپس با هم جمع می‌شوند. در حالت دوم، دنباله‌ها به یکدیگر الحاق می‌شوند." msgid "This operation can be customized using the special :meth:`~object.__add__` and :meth:`~object.__radd__` methods." msgstr "این عملیات را می‌توان با استفاده از متدهای ویژه‌ی :meth:`~object.__add__` و :meth:`~object.__radd__` سفارشی کرد." msgid "The ``-`` (subtraction) operator yields the difference of its arguments. The numeric arguments are first :ref:`converted to a common real type `." msgstr "عملگر ``-`` (تفریق)، تفاضل آرگومان‌های خود را برمی‌گرداند. آرگومان‌های عددی ابتدا :ref:`به یک نوع حقیقی مشترک تبدیل می‌شوند `." msgid "This operation can be customized using the special :meth:`~object.__sub__` and :meth:`~object.__rsub__` methods." msgstr "این عملیات را می‌توان با استفاده از متدهای ویژه‌ی :meth:`~object.__sub__` و :meth:`~object.__rsub__` سفارشی‌سازی کرد." msgid "Shifting operations" msgstr "عملیات جابه‌جایی" msgid "The shifting operations have lower priority than the arithmetic operations:" msgstr "عملیات جابه‌جایی اولویت پایین‌تری نسبت به عملیات حسابی دارند:" msgid "These operators accept integers as arguments. They shift the first argument to the left or right by the number of bits given by the second argument." msgstr "این عملگرها، اعداد صحیح را به‌عنوان آرگومان می‌پذیرند. آن‌ها آرگومان اول را به تعداد بیت‌های تعیین‌شده توسط آرگومان دوم، به چپ یا راست شیفت می‌دهند." msgid "The left shift operation can be customized using the special :meth:`~object.__lshift__` and :meth:`~object.__rlshift__` methods. The right shift operation can be customized using the special :meth:`~object.__rshift__` and :meth:`~object.__rrshift__` methods." msgstr "عملیات شیفت چپ را می‌توان با استفاده از متدهای ویژه :meth:`~object.__lshift__` و :meth:`~object.__rlshift__` سفارشی‌سازی کرد. عملیات شیفت راست را می‌توان با استفاده از متدهای ویژه :meth:`~object.__rshift__` و :meth:`~object.__rrshift__` سفارشی‌سازی کرد." msgid "A right shift by *n* bits is defined as floor division by ``pow(2,n)``. A left shift by *n* bits is defined as multiplication with ``pow(2,n)``." msgstr "شیفت راست به اندازه‌ی *n* بیت به‌صورت تقسیم کف بر ``pow(2,n)`` تعریف می‌شود. شیفت چپ به اندازه‌ی *n* بیت به‌صورت ضرب در ``pow(2,n)`` تعریف می‌شود." msgid "Binary bitwise operations" msgstr "عملیات بیت‌به‌بیت دودویی" msgid "Each of the three bitwise operations has a different priority level:" msgstr "هر یک از سه عملیات بیتی، سطح اولویت متفاوتی دارد:" msgid "The ``&`` operator yields the bitwise AND of its arguments, which must be integers or one of them must be a custom object overriding :meth:`~object.__and__` or :meth:`~object.__rand__` special methods." msgstr "عملگر ``&`` حاصل AND بیت‌به‌بیت آرگومان‌هایش را برمی‌گرداند، که باید اعداد صحیح باشند یا یکی از آن‌ها باید یک شیء سفارشی باشد که متدهای ویژه :meth:`~object.__and__` یا :meth:`~object.__rand__` را بازنویسی می‌کند." msgid "The ``^`` operator yields the bitwise XOR (exclusive OR) of its arguments, which must be integers or one of them must be a custom object overriding :meth:`~object.__xor__` or :meth:`~object.__rxor__` special methods." msgstr "عملگر ``^`` حاصل XOR بیتی (یا انحصاری) آرگومان‌های خود را برمی‌گرداند؛ این آرگومان‌ها باید عدد صحیح باشند یا یکی از آن‌ها باید یک شیء سفارشی باشد که متدهای ویژه‌ی :meth:`~object.__xor__` یا :meth:`~object.__rxor__` را بازنویسی کرده باشد." msgid "The ``|`` operator yields the bitwise (inclusive) OR of its arguments, which must be integers or one of them must be a custom object overriding :meth:`~object.__or__` or :meth:`~object.__ror__` special methods." msgstr "عملگر ``|`` حاصل OR بیتی (شمولی) آرگومان‌هایش را برمی‌گرداند؛ آرگومان‌ها باید عدد صحیح باشند یا یکی از آن‌ها باید یک شیء سفارشی باشد که متدهای ویژه‌ی :meth:`~object.__or__` یا :meth:`~object.__ror__` را بازنویسی می‌کند." msgid "Comparisons" msgstr "مقایسه‌ها" msgid "Unlike C, all comparison operations in Python have the same priority, which is lower than that of any arithmetic, shifting or bitwise operation. Also unlike C, expressions like ``a < b < c`` have the interpretation that is conventional in mathematics:" msgstr "برخلاف C، تمام عملیات مقایسه‌ای در پایتون اولویت یکسانی دارند که از اولویت هر عملیات حسابی، جابه‌جایی یا عملیات بیت‌به‌بیتی پایین‌تر است. همچنین برخلاف C، عبارت‌هایی مانند ``a < b < c`` تفسیری دارند که در ریاضیات مرسوم است:" msgid "Comparisons yield boolean values: ``True`` or ``False``. Custom :dfn:`rich comparison methods` may return non-boolean values. In this case Python will call :func:`bool` on such value in boolean contexts." msgstr "مقایسه‌ها مقادیر بولی را حاصل می‌کنند: ``True`` یا ``False``. ممکن است :dfn:`متدهای مقایسه غنی (rich comparison methods)` سفارشی، مقادیر غیربولی برگردانند. در این صورت، پایتون در زمینه‌های بولی، :func:`bool` را روی چنین مقداری فراخوانی می‌کند." msgid "Comparisons can be chained arbitrarily, e.g., ``x < y z``" msgstr "``x > y and y > z`` دلالت بر ``x > z`` دارد" msgid "``x < y and y = y`` (برای ترتیب کامل)" msgid "``x > y`` and ``not x y`` و ``not x (greater)" msgstr "> (بزرگ‌تر)" msgid "=" msgid "==" msgstr "==" msgid "!=" msgstr "!=" msgid "chaining" msgstr "زنجیره‌سازی" msgid "comparisons" msgstr "مقایسه‌ها" msgid "in" msgstr "در" msgid "not in" msgstr "not in" msgid "membership" msgstr "عضویت" msgid "test" msgstr "آزمون" msgid "is" msgstr "is" msgid "is not" msgstr "نیست" msgid "identity" msgstr "هویت" msgid "Conditional" msgstr "شرطی" msgid "Boolean" msgstr "بولی" msgid "not" msgstr "نه" msgid ":= (colon equals)" msgstr ":= (دونقطه مساوی)" msgid "assignment expression" msgstr "عبارت انتساب" msgid "walrus operator" msgstr "عملگر والروس (walrus operator)" msgid "named expression" msgstr "عبارت نام‌دار" msgid "assignment" msgstr "انتساب" msgid "conditional" msgstr "conditional" msgid "ternary" msgstr "سه‌تایی" msgid "conditional expression" msgstr "عبارت شرطی" msgid "else" msgstr "در غیر این صورت" msgid "lambda" msgstr "لامبدا" msgid "form" msgstr "فرم" msgid "anonymous" msgstr "ناشناس" msgid "lambda expression" msgstr "عبارت lambda" msgid "evaluation" msgstr "ارزیابی" msgid "order" msgstr "ترتیب" msgid "precedence" msgstr "اولویت" #~ msgid "Generator-iterator methods" #~ msgstr "متدهای تولیدگر-پیمایش‌گر" #~ msgid "This subsection describes the methods of a generator iterator. They can be used to control the execution of a generator function." #~ msgstr "این زیربخش متدهای یک پیمایش‌گر تولیدگر را شرح می‌دهد. می‌توان از آن‌ها برای کنترل اجرای یک تابع تولیدگر استفاده کرد." #~ msgid "Note that calling any of the generator methods below when the generator is already executing raises a :exc:`ValueError` exception." #~ msgstr "توجه داشته باشید که فراخوانی هر یک از متدهای تولیدگر زیر، هنگامی که تولیدگر از قبل در حال اجرا است، باعث پرتاب یک استثنای :exc:`ValueError` می‌شود." #~ msgid "Starts the execution of a generator function or resumes it at the last executed yield expression. When a generator function is resumed with a :meth:`~generator.__next__` method, the current yield expression always evaluates to :const:`None`. The execution then continues to the next yield expression, where the generator is suspended again, and the value of the :token:`~python-grammar:yield_list` is returned to :meth:`__next__`'s caller. If the generator exits without yielding another value, a :exc:`StopIteration` exception is raised." #~ msgstr "اجرای یک تابع تولیدگر را آغاز می‌کند یا آن را از آخرین عبارت yield اجراشده از سر می‌گیرد. هنگامی که یک تابع تولیدگر با متد :meth:`~generator.__next__` از سر گرفته می‌شود، عبارت yield جاری همیشه به :const:`None` ارزیابی می‌شود. سپس اجرا تا عبارت yield بعدی ادامه می‌یابد، جایی که تولیدگر دوباره معلق می‌شود، و مقدار :token:`~python-grammar:yield_list` به فراخواننده‌ی :meth:`__next__` بازگردانده می‌شود. اگر تولیدگر بدون اینکه مقدار دیگری yield کند خارج شود، استثنای :exc:`StopIteration` پرتاب می‌شود." #~ msgid "This method is normally called implicitly, e.g. by a :keyword:`for` loop, or by the built-in :func:`next` function." #~ msgstr "این متد معمولاً به‌صورت ضمنی فراخوانی می‌شود، مثلاً توسط یک حلقه :keyword:`for`، یا توسط تابع توکار :func:`next`." #~ msgid "Resumes the execution and \"sends\" a value into the generator function. The *value* argument becomes the result of the current yield expression. The :meth:`send` method returns the next value yielded by the generator, or raises :exc:`StopIteration` if the generator exits without yielding another value. When :meth:`send` is called to start the generator, it must be called with :const:`None` as the argument, because there is no yield expression that could receive the value." #~ msgstr "اجرا را از سر می‌گیرد و یک مقدار را به تابع تولیدگر «ارسال» می‌کند. آرگومان *value* به نتیجه‌ی عبارت yield جاری تبدیل می‌شود. متد :meth:`send` مقدار بعدی تولیدشده توسط تولیدگر را برمی‌گرداند، یا اگر تولیدگر بدون تولید مقدار دیگری خارج شود، :exc:`StopIteration` را پرتاب می‌کند. هنگامی که :meth:`send` برای شروع تولیدگر فراخوانی می‌شود، باید با :const:`None` به‌عنوان آرگومان فراخوانی شود، زیرا هیچ عبارت yield وجود ندارد که بتواند مقدار را دریافت کند." #~ msgid "Raises an exception at the point where the generator was paused, and returns the next value yielded by the generator function. If the generator exits without yielding another value, a :exc:`StopIteration` exception is raised. If the generator function does not catch the passed-in exception, or raises a different exception, then that exception propagates to the caller." #~ msgstr "استثنایی را در نقطه‌ای که تولیدگر متوقف شده بود، پرتاب می‌کند و مقدار بعدی‌ای را که تابع تولیدگر آن را تولید می‌کند، برمی‌گرداند. اگر تولیدگر بدون تولید مقدار دیگری خارج شود، استثنای :exc:`StopIteration` پرتاب می‌شود. اگر تابع تولیدگر، استثنای ارسال‌شده را نگیرد یا استثنای متفاوتی پرتاب کند، آن استثنا به فراخواننده منتشر می‌شود." #~ msgid "In typical use, this is called with a single exception instance similar to the way the :keyword:`raise` keyword is used." #~ msgstr "در استفاده معمول، این با یک نمونه استثنا فراخوانی می‌شود، مشابه روشی که از کلیدواژه :keyword:`raise` استفاده می‌شود." #~ msgid "For backwards compatibility, however, the second signature is supported, following a convention from older versions of Python. The *type* argument should be an exception class, and *value* should be an exception instance. If the *value* is not provided, the *type* constructor is called to get an instance. If *traceback* is provided, it is set on the exception, otherwise any existing :attr:`~BaseException.__traceback__` attribute stored in *value* may be cleared." #~ msgstr "با این حال، برای سازگاری با نسخه‌های قدیمی، امضای دوم طبق قراردادی از نسخه‌های قدیمی‌تر پایتون پشتیبانی می‌شود. آرگومان *type* باید یک کلاس استثنا باشد و *value* باید یک نمونه استثنا باشد. اگر *value* ارائه نشود، سازنده‌ی *type* برای ایجاد یک نمونه فراخوانی می‌شود. اگر *traceback* ارائه شود، روی استثنا تنظیم می‌شود؛ در غیر این صورت، ممکن است هر ویژگی :attr:`~BaseException.__traceback__` موجود که در *value* ذخیره‌شده باشد پاک شود." #~ msgid "The second signature \\(type\\[, value\\[, traceback\\]\\]\\) is deprecated and may be removed in a future version of Python." #~ msgstr "امضای دوم \\(type\\[, value\\[, traceback\\]\\]\\) منسوخ شده است و ممکن است در نسخه‌ای آینده از پایتون حذف شود." #~ msgid "Raises a :exc:`GeneratorExit` exception at the point where the generator function was paused (equivalent to calling ``throw(GeneratorExit)``). The exception is raised by the yield expression where the generator was paused. If the generator function catches the exception and returns a value, this value is returned from :meth:`close`. If the generator function is already closed, or raises :exc:`GeneratorExit` (by not catching the exception), :meth:`close` returns :const:`None`. If the generator yields a value, a :exc:`RuntimeError` is raised. If the generator raises any other exception, it is propagated to the caller. If the generator has already exited due to an exception or normal exit, :meth:`close` returns :const:`None` and has no other effect." #~ msgstr "استثنای :exc:`GeneratorExit` را در نقطه‌ای که تابع تولیدگر در آن متوقف شده بود پرتاب می‌کند (معادل فراخوانی ``throw(GeneratorExit)``). این استثنا در عبارت yield که تولیدگر در آن متوقف شده بود پرتاب می‌شود. اگر تابع تولیدگر استثنا را بگیرد و مقداری را برگرداند، این مقدار از :meth:`close` برگردانده می‌شود. اگر تابع تولیدگر از قبل بسته شده باشد، یا :exc:`GeneratorExit` را پرتاب کند (با نگرفتن استثنا)، :meth:`close` مقدار :const:`None` را برمی‌گرداند. اگر تولیدگر مقداری را yield کند، استثنای :exc:`RuntimeError` پرتاب می‌شود. اگر تولیدگر هر استثنای دیگری را پرتاب کند، آن استثنا به فراخواننده منتقل می‌شود. اگر تولیدگر از قبل به دلیل یک استثنا یا خروج عادی خارج شده باشد، :meth:`close` مقدار :const:`None` را برمی‌گرداند و هیچ اثر دیگری ندارد." #~ msgid "If a generator returns a value upon being closed, the value is returned by :meth:`close`." #~ msgstr "اگر یک تولیدگر هنگام بسته شدن مقداری برگرداند، آن مقدار توسط :meth:`close` برگردانده می‌شود." #~ msgid "Asynchronous generator-iterator methods" #~ msgstr "متدهای تولیدگر-پیمایش‌گر ناهمگام" #~ msgid "This subsection describes the methods of an asynchronous generator iterator, which are used to control the execution of a generator function." #~ msgstr "این زیربخش، متدهای پیمایش‌گر تولیدگر ناهمگام را شرح می‌دهد که برای کنترل اجرای تابع تولیدگر به کار می‌روند." #~ msgid "Returns an awaitable which when run starts to execute the asynchronous generator or resumes it at the last executed yield expression. When an asynchronous generator function is resumed with an :meth:`~agen.__anext__` method, the current yield expression always evaluates to :const:`None` in the returned awaitable, which when run will continue to the next yield expression. The value of the :token:`~python-grammar:yield_list` of the yield expression is the value of the :exc:`StopIteration` exception raised by the completing coroutine. If the asynchronous generator exits without yielding another value, the awaitable instead raises a :exc:`StopAsyncIteration` exception, signalling that the asynchronous iteration has completed." #~ msgstr "یک awaitable برمی‌گرداند که هنگام اجرا، اجرای تولیدگر ناهمگام را آغاز می‌کند یا آن را در آخرین عبارت yield اجراشده از سر می‌گیرد. هنگامی که یک تابع تولیدگر ناهمگام با متد :meth:`~agen.__anext__` از سر گرفته شود، عبارت yield جاری همیشه در awaitable برگردانده‌شده، به :const:`None` ارزیابی می‌شود، که وقتی اجرا شود، به عبارت yield بعدی ادامه می‌دهد. مقدار :token:`~python-grammar:yield_list` عبارت yield، مقدار استثنای :exc:`StopIteration` است که توسط هم‌روال کامل‌شونده پرتاب می‌شود. اگر تولیدگر ناهمگام بدون اینکه مقدار دیگری را yield کند، خارج شود، awaitable در عوض یک استثنا :exc:`StopAsyncIteration` پرتاب می‌کند، که نشان می‌دهد تکرار ناهمگام کامل شده است." #~ msgid "This method is normally called implicitly by a :keyword:`async for` loop." #~ msgstr "این متد معمولاً به‌صورت ضمنی توسط یک حلقه‌ی :keyword:`async for` فراخوانی می‌شود." #~ msgid "Returns an awaitable which when run resumes the execution of the asynchronous generator. As with the :meth:`~generator.send` method for a generator, this \"sends\" a value into the asynchronous generator function, and the *value* argument becomes the result of the current yield expression. The awaitable returned by the :meth:`asend` method will return the next value yielded by the generator as the value of the raised :exc:`StopIteration`, or raises :exc:`StopAsyncIteration` if the asynchronous generator exits without yielding another value. When :meth:`asend` is called to start the asynchronous generator, it must be called with :const:`None` as the argument, because there is no yield expression that could receive the value." #~ msgstr "یک شیء انتظارپذیر (awaitable) بازمی‌گرداند که هنگام اجرا، اجرای تولیدگر ناهمگام را از سر می‌گیرد. همانند متد :meth:`~generator.send` برای یک تولیدگر، این متد یک مقدار را به تابع تولیدگر ناهمگام «ارسال» می‌کند و آرگومان *value* به نتیجه‌ی عبارت yield جاری تبدیل می‌شود. شیء انتظارپذیر بازگردانده‌شده توسط متد :meth:`asend`، مقدار بعدی را که توسط تولیدگر yield شده است، به‌عنوان مقدار :exc:`StopIteration` پرتاب‌شده بازمی‌گرداند، یا اگر تولیدگر ناهمگام بدون yield کردن مقدار دیگری خارج شود، :exc:`StopAsyncIteration` را پرتاب می‌کند. هنگامی که :meth:`asend` برای شروع تولیدگر ناهمگام فراخوانی می‌شود، باید با :const:`None` به‌عنوان آرگومان فراخوانی شود، زیرا هیچ عبارت yield وجود ندارد که بتواند مقدار را دریافت کند." #~ msgid "Returns an awaitable that raises an exception of type ``type`` at the point where the asynchronous generator was paused, and returns the next value yielded by the generator function as the value of the raised :exc:`StopIteration` exception. If the asynchronous generator exits without yielding another value, a :exc:`StopAsyncIteration` exception is raised by the awaitable. If the generator function does not catch the passed-in exception, or raises a different exception, then when the awaitable is run that exception propagates to the caller of the awaitable." #~ msgstr "یک شیء انتظارپذیر (awaitable) بازمی‌گرداند که در نقطه‌ای که تولیدگر ناهمگام مکث کرده بود، استثنایی از نوع ``type`` پرتاب می‌کند و مقدار بعدی تولیدشده توسط تابع تولیدگر را به‌عنوان مقدار استثنای :exc:`StopIteration` پرتاب‌شده بازمی‌گرداند. اگر تولیدگر ناهمگام بدون تولید مقدار دیگری خارج شود، یک استثنای :exc:`StopAsyncIteration` توسط awaitable پرتاب می‌شود. اگر تابع تولیدگر استثنای داده‌شده را نگیرد یا استثنای دیگری پرتاب کند، آنگاه هنگامی که awaitable اجرا می‌شود، آن استثنا به فراخواننده‌ی awaitable منتشر می‌شود." #~ msgid "Returns an awaitable that when run will throw a :exc:`GeneratorExit` into the asynchronous generator function at the point where it was paused. If the asynchronous generator function then exits gracefully, is already closed, or raises :exc:`GeneratorExit` (by not catching the exception), then the returned awaitable will raise a :exc:`StopIteration` exception. Any further awaitables returned by subsequent calls to the asynchronous generator will raise a :exc:`StopAsyncIteration` exception. If the asynchronous generator yields a value, a :exc:`RuntimeError` is raised by the awaitable. If the asynchronous generator raises any other exception, it is propagated to the caller of the awaitable. If the asynchronous generator has already exited due to an exception or normal exit, then further calls to :meth:`aclose` will return an awaitable that does nothing." #~ msgstr "یک شیء awaitable بازمی‌گرداند که هنگام اجرا، یک استثنای :exc:`GeneratorExit` را به درون تابع تولیدگر ناهمگام در نقطه‌ای که متوقف شده بود پرتاب می‌کند. اگر تابع تولیدگر ناهمگام سپس به‌صورت مناسب خارج شود، از قبل بسته شده باشد، یا استثنای :exc:`GeneratorExit` را پرتاب کند (با نگرفتن استثنا)، آنگاه شیء awaitable بازگشت‌داده‌شده یک استثنای :exc:`StopIteration` پرتاب خواهد کرد. هر شیء awaitable بعدی که توسط فراخوانی‌های بعدی تولیدگر ناهمگام بازگشت داده شود، یک استثنای :exc:`StopAsyncIteration` پرتاب خواهد کرد. اگر تولیدگر ناهمگام مقداری را yield کند، شیء awaitable یک استثنای :exc:`RuntimeError` پرتاب می‌کند. اگر تولیدگر ناهمگام استثنای دیگری پرتاب کند، آن استثنا به فراخواننده‌ی شیء awaitable منتقل می‌شود. اگر تولیدگر ناهمگام از قبل به دلیل یک استثنا یا خروج عادی خارج شده باشد، آنگاه فراخوانی‌های بعدی :meth:`aclose` یک شیء awaitable بازمی‌گردانند که هیچ کاری انجام نمی‌دهد." #~ msgid "StopIteration" #~ msgstr "StopIteration" #~ msgid "GeneratorExit" #~ msgstr "GeneratorExit" #~ msgid "asynchronous-generator" #~ msgstr "تولیدگر ناهمگام" #~ msgid "StopAsyncIteration" #~ msgstr "StopAsyncIteration" #~ msgid "A parenthesized form is an optional expression list enclosed in parentheses:" #~ msgstr "شکل پرانتزدار، یک فهرست عبارت اختیاری است که در پرانتز محصور شده است:" #~ msgid "A parenthesized expression list yields whatever that expression list yields: if the list contains at least one comma, it yields a tuple; otherwise, it yields the single expression that makes up the expression list." #~ msgstr "یک فهرست عبارت پرانتزبندی‌شده، هر آنچه را که آن فهرست عبارت برمی‌گرداند، برمی‌گرداند: اگر فهرست دست‌کم شامل یک ویرگول باشد، یک تاپل برمی‌گرداند؛ در غیر این صورت، عبارت واحدی را برمی‌گرداند که فهرست عبارت را تشکیل می‌دهد." #~ msgid "Note that tuples are not formed by the parentheses, but rather by use of the comma. The exception is the empty tuple, for which parentheses *are* required --- allowing unparenthesized \"nothing\" in expressions would cause ambiguities and allow common typos to pass uncaught." #~ msgstr "توجه داشته باشید که تاپل‌ها با پرانتزها تشکیل نمی‌شوند، بلکه با استفاده از کاما تشکیل می‌شوند. استثنا، تاپل خالی است که برای آن پرانتزها *الزامی* هستند — اجازه دادن به «هیچ» بدون پرانتز در عبارت‌ها باعث ایجاد ابهام می‌شود و اجازه می‌دهد خطاهای تایپی رایج بدون شناسایی باقی بمانند." #~ msgid "Displays for lists, sets and dictionaries" #~ msgstr "نمایش فهرست‌ها، مجموعه‌ها و دیکشنری‌ها" #~ msgid "For constructing a list, a set or a dictionary Python provides special syntax called \"displays\", each of them in two flavors:" #~ msgstr "برای ساختن فهرست، مجموعه یا دیکشنری، پایتون سینتکس خاصی به نام «نمایش‌ها» (displays) فراهم می‌کند که هر کدام دو گونه دارند:" #~ msgid "either the container contents are listed explicitly, or" #~ msgstr "یا محتویات ظرف به‌صورت صریح فهرست می‌شوند، یا" #~ msgid "Common syntax elements for comprehensions are:" #~ msgstr "عناصر نحوی مشترک برای درک‌ها عبارتند از:" #~ msgid "A list display yields a new list object, the contents being specified by either a list of expressions or a comprehension. When a comma-separated list of expressions is supplied, its elements are evaluated from left to right and placed into the list object in that order. When a comprehension is supplied, the list is constructed from the elements resulting from the comprehension." #~ msgstr "یک نمایش فهرست، یک شیء فهرست جدید حاصل می‌کند که محتوای آن توسط یک فهرست از عبارت‌ها یا یک درک فهرستی مشخص می‌شود. هنگامی که یک فهرست از عبارت‌های جداشده با کاما ارائه شود، عناصر آن از چپ به راست ارزیابی می‌شوند و با همان ترتیب در شیء فهرست قرار می‌گیرند. هنگامی که یک درک فهرستی ارائه شود، فهرست از عناصر حاصل از آن درک ساخته می‌شود." #~ msgid "A set display is denoted by curly braces and distinguishable from dictionary displays by the lack of colons separating keys and values:" #~ msgstr "نمایش مجموعه با آکولادها مشخص می‌شود و به دلیل نبود علامت دونقطه برای جدا کردن کلیدها و مقدارها، از نمایش‌های دیکشنری قابل تشخیص است:" #~ msgid "A set display yields a new mutable set object, the contents being specified by either a sequence of expressions or a comprehension. When a comma-separated list of expressions is supplied, its elements are evaluated from left to right and added to the set object. When a comprehension is supplied, the set is constructed from the elements resulting from the comprehension." #~ msgstr "یک نمایش مجموعه، یک شیء مجموعه‌ی تغییرپذیر جدید ایجاد می‌کند که محتوای آن یا با دنباله‌ای از عبارت‌ها یا با یک درک مشخص می‌شود. هنگامی که یک فهرست جداشده با کاما از عبارت‌ها ارائه شود، عناصر آن از چپ به راست ارزیابی می‌شوند و به شیء مجموعه افزوده می‌شوند. هنگامی که یک درک ارائه شود، مجموعه از عناصر حاصل از آن درک ساخته می‌شود." #~ msgid "An empty set cannot be constructed with ``{}``; this literal constructs an empty dictionary." #~ msgstr "یک مجموعه خالی را نمی‌توان با ``{}`` ساخت؛ این لفظی یک دیکشنری خالی می‌سازد." #~ msgid "A dictionary display is a possibly empty series of dict items (key/value pairs) enclosed in curly braces:" #~ msgstr "نمایش دیکشنری دنباله‌ای از آیتم‌های دیکشنری (جفت‌های کلید/مقدار) است که ممکن است خالی باشد و در آکولاد محصور شده است:" #~ msgid "A dictionary display yields a new dictionary object." #~ msgstr "یک نمایش دیکشنری، یک شیء دیکشنری جدید ایجاد می‌کند." #~ msgid "A dict comprehension, in contrast to list and set comprehensions, needs two expressions separated with a colon followed by the usual \"for\" and \"if\" clauses. When the comprehension is run, the resulting key and value elements are inserted in the new dictionary in the order they are produced." #~ msgstr "درک دیکشنری، برخلاف درک فهرستی و درک مجموعه، به دو عبارت نیاز دارد که با یک دونقط از هم جدا شده‌اند و پس از آن‌ها بندهای معمول «for» و «if» می‌آیند. هنگامی که درک اجرا می‌شود، عناصر کلید و مقدار حاصل به ترتیبی که تولید می‌شوند، در دیکشنری جدید درج می‌شوند." #~ msgid "Restrictions on the types of the key values are listed earlier in section :ref:`types`. (To summarize, the key type should be :term:`hashable`, which excludes all mutable objects.) Clashes between duplicate keys are not detected; the last value (textually rightmost in the display) stored for a given key value prevails." #~ msgstr "محدودیت‌های مربوط به نوع مقادیر کلید، پیش‌تر در بخش :ref:`types` فهرست شده‌اند. (به‌طور خلاصه، نوع کلید باید :term:`hashable` باشد که همه‌ی شیءهای تغییرپذیر را مستثنا می‌کند.) برخورد میان کلیدهای تکراری تشخیص داده نمی‌شود؛ آخرین مقداری که برای یک مقدار کلید مشخص ذخیره شده است (یعنی مقداری که از نظر متنی در نمایش، سمت راست‌تر قرار دارد) معتبر است." #~ msgid "hashable" #~ msgstr "هش‌پذیر"