lexical_analysis.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-09-16 12:56+0000\n"
"PO-Revision-Date: 2026-09-13 09:00+0330\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n"
"Language: fa\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
"X-Generator: Poedit 3.6\n"

msgid "Lexical analysis"
msgstr "تحلیل واژگانی"

msgid "A Python program is read by a *parser*.  Input to the parser is a stream of :term:`tokens <token>`, generated by the *lexical analyzer* (also known as the *tokenizer*). This chapter describes how the lexical analyzer produces these tokens."
msgstr "یک برنامه‌ی پایتون توسط یک *پارسر* خوانده می‌شود. ورودی پارسر جریانی از :term:`توکن‌ها <token>` است که توسط *تحلیل‌گر واژگانی* (که با نام *توکن‌ساز* نیز شناخته می‌شود) تولید می‌شود. این فصل شرح می‌دهد که تحلیل‌گر واژگانی چگونه این توکن‌ها را تولید می‌کند."

msgid "The lexical analyzer determines the program text's :ref:`encoding <encodings>` (UTF-8 by default), and decodes the text into :ref:`source characters <lexical-source-character>`. If the text cannot be decoded, a :exc:`SyntaxError` is raised."
msgstr "تحلیل‌گر واژگانی، :ref:`کدگذاری <encodings>` متن برنامه را تعیین می‌کند (به‌طور پیش‌فرض UTF-8)، و متن را به :ref:`نویسه‌های منبع <lexical-source-character>` کدگشایی می‌کند. اگر متن نتواند کدگشایی شود، یک :exc:`SyntaxError` پرتاب می‌شود."

msgid "Next, the lexical analyzer uses the source characters to generate a stream of tokens. The type of a generated token generally depends on the next source character to be processed. Similarly, other special behavior of the analyzer depends on the first source character that hasn't yet been processed. The following table gives a quick summary of these source characters, with links to sections that contain more information."
msgstr "در ادامه، تحلیل‌گر واژگانی از نویسه‌های منبع برای تولید جریانی از توکن‌ها استفاده می‌کند. نوع یک توکن تولیدشده عموماً به نویسه منبع بعدی که قرار است پردازش شود، بستگی دارد. به‌طور مشابه، سایر رفتارهای خاص تحلیل‌گر به نخستین نویسه منبع که هنوز پردازش‌نشده است، بستگی دارد. جدول زیر خلاصه‌ای سریع از این نویسه‌های منبع را به‌همراه پیوندهایی به بخش‌هایی که اطلاعات بیشتری دارند، ارائه می‌دهد."

msgid "Character"
msgstr "نویسه"

msgid "Next token (or other relevant documentation)"
msgstr "توکن بعدی (یا سایر مستندات مرتبط)"

msgid "space"
msgstr "فاصله"

msgid "tab"
msgstr "زبانه"

msgid "formfeed"
msgstr "تغذیه‌ی صفحه (formfeed)"

msgid ":ref:`Whitespace <whitespace>`"
msgstr ":ref:`فضای سفید <whitespace>`"

msgid "CR, LF"
msgstr "CR, LF"

msgid ":ref:`New line <line-structure>`"
msgstr ":ref:`خط جدید <line-structure>`"

msgid ":ref:`Indentation <indentation>`"
msgstr ":ref:`تورفتگی <indentation>`"

msgid "backslash (``\\``)"
msgstr "بک‌اسلش (``\\``)"

msgid ":ref:`Explicit line joining <explicit-joining>`"
msgstr ":ref:`پیوند صریح سطرهای <explicit-joining>`"

msgid "(Also significant in :ref:`string escape sequences <escape-sequences>`)"
msgstr "(همچنین قابل‌توجه در :ref:`دنباله‌های خنثی‌سازی رشته <escape-sequences>`)"

msgid "hash (``#``)"
msgstr "هش (``#``)"

msgid ":ref:`Comment <comments>`"
msgstr ":ref:`کامنت <comments>`"

msgid "quote (``'``, ``\"``)"
msgstr "علامت نقل‌قول (``'``، ``\"``)"

msgid ":ref:`String literal <strings>`"
msgstr ":ref:`رشته‌ی لفظی <strings>`"

msgid "ASCII letter (``a``-``z``, ``A``-``Z``)"
msgstr "حرف ASCII (``a``-``z``، ``A``-``Z``)"

msgid "non-ASCII character"
msgstr "نویسه‌ی غیر ASCII"

msgid ":ref:`Name <identifiers>`"
msgstr ":ref:`نام <identifiers>`"

msgid "Prefixed :ref:`string or bytes literal <strings>`"
msgstr ":ref:`لفظی رشته یا بایت‌ها <strings>` پیشونددار"

msgid "underscore (``_``)"
msgstr "زیرخط (``_``)"

msgid "(Can also be part of :ref:`numeric literals <numbers>`)"
msgstr "(همچنین می‌تواند بخشی از :ref:`مقادیر لفظی عددی <numbers>` باشد)"

msgid "number (``0``-``9``)"
msgstr "عدد (``0``-``9``)"

msgid ":ref:`Numeric literal <numbers>`"
msgstr ":ref:`لفظی عددی <numbers>`"

msgid "dot (``.``)"
msgstr "نقطه (``.``)"

msgid ":ref:`Operator <operators>`"
msgstr ":ref:`عملگر <operators>`"

msgid "question mark (``?``)"
msgstr "علامت سؤال (``?``)"

msgid "dollar (``$``)"
msgstr "دلار (``$``)"

msgid "backquote (``​`​``)"
msgstr "بک‌کوت (``​`​``)"

msgid "control character"
msgstr "نویسه‌ی کنترلی"

msgid "Error (outside string literals and comments)"
msgstr "خطا (خارج از رشته‌های لفظی و کامنت‌ها)"

msgid "other printing character"
msgstr "نویسه چاپی دیگر"

msgid ":ref:`Operator or delimiter <operators>`"
msgstr ":ref:`عملگر یا جداکننده <operators>`"

msgid "end of file"
msgstr "پایان پرونده"

msgid ":ref:`End marker <endmarker-token>`"
msgstr ":ref:`نشانگر پایان <endmarker-token>`"

msgid "Line structure"
msgstr "ساختار سطر"

msgid "A Python program is divided into a number of *logical lines*."
msgstr "یک برنامه پایتون به تعدادی *خط منطقی* تقسیم می‌شود."

msgid "Logical lines"
msgstr "سطرهای منطقی"

msgid "The end of a logical line is represented by the token :data:`~token.NEWLINE`. Statements cannot cross logical line boundaries except where :data:`!NEWLINE` is allowed by the syntax (e.g., between statements in compound statements). A logical line is constructed from one or more *physical lines* by following the :ref:`explicit <explicit-joining>` or :ref:`implicit <implicit-joining>` *line joining* rules."
msgstr "پایان یک خط منطقی با توکن :data:`~token.NEWLINE` نمایش داده می‌شود. دستورها نمی‌توانند از مرزهای سطر منطقی عبور کنند، مگر در مواردی که :data:`!NEWLINE` از نظر سینتکس مجاز باشد (مثلاً بین دستورها در دستورهای مرکب). یک خط منطقی از یک یا چند *خط فیزیکی* با پیروی از قواعد *اتصال خط* :ref:`صریح <explicit-joining>` یا :ref:`ضمنی <implicit-joining>` تشکیل می‌شود."

msgid "Physical lines"
msgstr "سطرهای فیزیکی"

msgid "A physical line is a sequence of characters terminated by one the following end-of-line sequences:"
msgstr "یک خط فیزیکی، دنباله‌ای از نویسه‌ها است که با یکی از دنباله‌های پایان خط زیر پایان می‌یابد:"

msgid "the Unix form using ASCII LF (linefeed),"
msgstr "قالب یونیکسی با استفاده از ASCII LF (خط جدید)،"

msgid "the Windows form using the ASCII sequence CR LF (return followed by linefeed),"
msgstr "شکل ویندوزی با استفاده از دنباله‌ی ASCII یعنی CR LF (بازگشت به دنبال خط جدید)،"

msgid "the '`Classic Mac OS`__' form using the ASCII CR (return) character."
msgstr "قالب «`Classic Mac OS`__» که از نویسه‌ی ASCII CR (return) استفاده می‌کند."

msgid "Regardless of platform, each of these sequences is replaced by a single ASCII LF (linefeed) character. (This is done even inside :ref:`string literals <strings>`.) Each line can use any of the sequences; they do not need to be consistent within a file."
msgstr "صرف‌نظر از سکو، هر یک از این دنباله‌ها با یک نویسه‌ی ASCII LF (linefeed) جایگزین می‌شود. (این کار حتی در داخل :ref:`string literals <strings>` نیز انجام می‌شود.) هر خط می‌تواند از هر یک از این دنباله‌ها استفاده کند؛ لازم نیست که این دنباله‌ها در یک پرونده یکدست باشند."

msgid "The end of input also serves as an implicit terminator for the final physical line."
msgstr "پایان ورودی همچنین به‌عنوان پایان‌دهنده‌ای ضمنی برای آخرین خط فیزیکی عمل می‌کند."

msgid "Formally:"
msgstr "به‌صورت رسمی:"

msgid "Comments"
msgstr "کامنت‌ها"

msgid "A comment starts with a hash character (``#``) that is not part of a string literal, and ends at the end of the physical line.  A comment signifies the end of the logical line unless the implicit line joining rules are invoked. Comments are ignored by the syntax."
msgstr "یک کامنت با نویسه‌ی هش (``#``) که بخشی از یک رشته‌ی لفظی نیست، آغاز می‌شود و در پایان خط فیزیکی تمام می‌شود. یک کامنت نشان‌دهنده‌ی پایان خط منطقی است، مگر اینکه قواعد پیوستن ضمنی سطرهای اعمال شوند. کامنت‌ها توسط سینتکس نادیده گرفته می‌شوند."

msgid "Encoding declarations"
msgstr "اعلامیه‌های کدگذاری"

msgid "If a comment in the first or second line of the Python script matches the regular expression ``coding[=:]\\s*([-\\w.]+)``, this comment is processed as an encoding declaration; the first group of this expression names the encoding of the source code file. The encoding declaration must appear on a line of its own. If it is the second line, the first line must also be a comment-only line. The recommended forms of an encoding expression are ::"
msgstr "اگر یک کامنت در خط اول یا دوم اسکریپت پایتون با عبارت باقاعده ``coding[=:]\\s*([-\\w.]+)`` مطابقت داشته باشد، این کامنت به‌عنوان یک اعلامیه کدگذاری پردازش می‌شود؛ اولین گروه این عبارت، کدگذاری پرونده کد منبع را مشخص می‌کند. اعلامیه کدگذاری باید در خط جداگانه‌ای قرار گیرد. اگر در خط دوم باشد، خط اول نیز باید تنها شامل کامنت باشد. شکل‌های توصیه‌شده برای عبارت کدگذاری عبارتند از ::"

msgid "# -*- coding: <encoding-name> -*-"
msgstr "# -*- coding: <encoding-name> -*-"

msgid "which is recognized also by GNU Emacs, and ::"
msgstr "که GNU Emacs نیز آن را شناسایی می‌کند، و ::"

msgid "# vim:fileencoding=<encoding-name>"
msgstr "# vim:fileencoding=<encoding-name>"

msgid "which is recognized by Bram Moolenaar's VIM."
msgstr "که توسط VIM متعلق به Bram Moolenaar شناسایی می‌شود."

msgid "If no encoding declaration is found, the default encoding is UTF-8.  If the implicit or explicit encoding of a file is UTF-8, an initial UTF-8 byte-order mark (``b'\\xef\\xbb\\xbf'``) is ignored rather than being a syntax error."
msgstr "اگر هیچ اعلان کدگذاری یافت نشود، کدگذاری پیش‌فرض UTF-8 است. اگر کدگذاری ضمنی یا صریح یک پرونده UTF-8 باشد، یک نشانگر ترتیب بایت (byte-order mark) اولیه‌ی UTF-8 (``b'\\xef\\xbb\\xbf'``) به‌جای اینکه خطای سینتکس باشد، نادیده گرفته می‌شود."

msgid "If an encoding is declared, the encoding name must be recognized by Python (see :ref:`standard-encodings`). The encoding is used for all lexical analysis, including string literals, comments and identifiers."
msgstr "اگر کدگذاری اعلام‌شده باشد، نام کدگذاری باید توسط پایتون شناخته شود (به :ref:`standard-encodings` مراجعه کنید). از این کدگذاری برای تمام تحلیل واژگانی، از جمله رشته‌های لفظی، کامنت‌ها و شناسه‌ها استفاده می‌شود."

msgid "All lexical analysis, including string literals, comments and identifiers, works on Unicode text decoded using the source encoding. Any Unicode code point, except the NUL control character, can appear in Python source."
msgstr "تمام تحلیل واژگانی، شامل مقادیر لفظی رشته، کامنت‌ها و شناسه‌ها، روی متن یونیکد کدگشایی‌شده با کدگذاری منبع انجام می‌شود. هر نقطه کد یونیکد، به‌جز نویسه کنترلی NUL، می‌تواند در منبع پایتون ظاهر شود."

msgid "Explicit line joining"
msgstr "پیوند صریح سطرهای"

msgid "Two or more physical lines may be joined into logical lines using backslash characters (``\\``), as follows: when a physical line ends in a backslash that is not part of a string literal or comment, it is joined with the following forming a single logical line, deleting the backslash and the following end-of-line character.  For example::"
msgstr "دو یا چند خط فیزیکی را می‌توان با استفاده از نویسه‌های بک‌اسلش (``\\``) به هم پیوست کرد تا سطرهای منطقی تشکیل شوند، به این صورت: هرگاه یک خط فیزیکی با بک‌اسلشی پایان یابد که بخشی از یک لفظی رشته یا کامنت نیست، با خط بعدی پیوسته می‌شود و یک خط منطقی واحد را تشکیل می‌دهد؛ در این حالت بک‌اسلش و نویسه‌ی پایان خط بعدی حذف می‌شوند. برای مثال::"

msgid ""
"if 1900 < year < 2100 and 1 <= month <= 12 \\\n"
"   and 1 <= day <= 31 and 0 <= hour < 24 \\\n"
"   and 0 <= minute < 60 and 0 <= second < 60:   # Looks like a valid date\n"
"        return 1"
msgstr ""
"if 1900 < year < 2100 and 1 <= month <= 12 \\\n"
"   and 1 <= day <= 31 and 0 <= hour < 24 \\\n"
"   and 0 <= minute < 60 and 0 <= second < 60:   # Looks like a valid date\n"
"        return 1"

msgid "A line ending in a backslash cannot carry a comment.  A backslash does not continue a comment.  A backslash does not continue a token except for string literals (i.e., tokens other than string literals cannot be split across physical lines using a backslash).  A backslash is illegal elsewhere on a line outside a string literal."
msgstr "سطری که با بک‌اسلش پایان می‌یابد، نمی‌تواند حاوی یک کامنت باشد. بک‌اسلش یک کامنت را ادامه نمی‌دهد. بک‌اسلش یک توکن را ادامه نمی‌دهد، مگر در مورد رشته‌های لفظی (یعنی توکن‌هایی غیر از رشته‌های لفظی نمی‌توانند با استفاده از بک‌اسلش بین سطرهای فیزیکی شکسته شوند). بک‌اسلش در هر جای دیگری از یک خط، خارج از یک رشته‌ی لفظی، غیرمجاز است."

msgid "Implicit line joining"
msgstr "پیوند ضمنی سطرهای"

msgid "Expressions in parentheses, square brackets or curly braces can be split over more than one physical line without using backslashes. For example::"
msgstr "عبارات داخل پرانتز، کروشه یا آکولاد را می‌توان بدون استفاده از بک‌اسلش در بیش از یک خط فیزیکی تقسیم کرد. برای مثال::"

msgid ""
"month_names = ['Januari', 'Februari', 'Maart',      # These are the\n"
"               'April',   'Mei',      'Juni',       # Dutch names\n"
"               'Juli',    'Augustus', 'September',  # for the months\n"
"               'Oktober', 'November', 'December']   # of the year"
msgstr ""
"month_names = ['Januari', 'Februari', 'Maart',      # These are the\n"
"               'April',   'Mei',      'Juni',       # Dutch names\n"
"               'Juli',    'Augustus', 'September',  # for the months\n"
"               'Oktober', 'November', 'December']   # of the year"

msgid "Implicitly continued lines can carry comments.  The indentation of the continuation lines is not important.  Blank continuation lines are allowed. There is no NEWLINE token between implicit continuation lines.  Implicitly continued lines can also occur within triple-quoted strings (see below); in that case they cannot carry comments."
msgstr "سطرهای ادامه‌یافته به‌صورت ضمنی می‌توانند حاوی کامنت باشند. تورفتگی سطرهای ادامه مهم نیست. سطرهای ادامه خالی مجاز هستند. بین سطرهای ادامه ضمنی هیچ توکن NEWLINE وجود ندارد. سطرهای ادامه‌یافته به‌صورت ضمنی همچنین می‌توانند درون رشته‌های سه‌نقل‌قولی (در ادامه ببینید) رخ دهند؛ در این حالت نمی‌توانند حاوی کامنت باشند."

msgid "Blank lines"
msgstr "سطرهای خالی"

msgid "A logical line that contains only spaces, tabs, formfeeds and possibly a comment, is ignored (i.e., no :data:`~token.NEWLINE` token is generated). During interactive input of statements, handling of a blank line may differ depending on the implementation of the read-eval-print loop. In the standard interactive interpreter, an entirely blank logical line (that is, one containing not even whitespace or a comment) terminates a multi-line statement."
msgstr "یک خط منطقی که فقط شامل فاصله‌ها، تب‌ها، تغذیه‌های صفحه (formfeeds) و احتمالاً یک کامنت باشد، نادیده گرفته می‌شود (یعنی هیچ توکن :data:`~token.NEWLINE` تولید نمی‌شود). در حین ورودی تعاملی دستورها، پردازش یک خط خالی ممکن است بسته به پیاده‌سازی حلقه‌ی خواندن-ارزیابی-چاپ (read-eval-print loop) متفاوت باشد. در مفسر تعاملی استاندارد، یک خط منطقی کاملاً خالی (یعنی سطری که حتی شامل هیچ نویسه‌ی خالی یا کامنتی هم نباشد) یک دستور چندخطی را پایان می‌دهد."

msgid "Indentation"
msgstr "تورفتگی"

msgid "Leading whitespace (spaces and tabs) at the beginning of a logical line is used to compute the indentation level of the line, which in turn is used to determine the grouping of statements."
msgstr "فضای سفید ابتدایی (فاصله‌ها و تب‌ها) در آغاز یک خط منطقی، برای محاسبه‌ی سطح تورفتگی آن خط استفاده می‌شود، که به نوبه‌ی خود برای تعیین گروه‌بندی دستورات به کار می‌رود."

msgid "Tabs are replaced (from left to right) by one to eight spaces such that the total number of characters up to and including the replacement is a multiple of eight (this is intended to be the same rule as used by Unix).  The total number of spaces preceding the first non-blank character then determines the line's indentation.  Indentation cannot be split over multiple physical lines using backslashes; the whitespace up to the first backslash determines the indentation."
msgstr "تب‌ها (از چپ به راست) با ۱ تا ۸ فاصله جایگزین می‌شوند، به‌گونه‌ای که تعداد کل نویسه‌ها تا پایان جایگزینی، مضربی از ۸ باشد (هدف این است که همان قاعده‌ای باشد که در یونیکس استفاده می‌شود). سپس تعداد کل فاصله‌های پیش از اولین نویسه‌ی غیرسفید، تورفتگی خط را تعیین می‌کند. تورفتگی را نمی‌توان با استفاده از بک‌اسلش‌ها به چند خط فیزیکی تقسیم کرد؛ فضای سفید تا اولین بک‌اسلش، تورفتگی را تعیین می‌کند."

msgid "Indentation is rejected as inconsistent if a source file mixes tabs and spaces in a way that makes the meaning dependent on the worth of a tab in spaces; a :exc:`TabError` is raised in that case."
msgstr "اگر یک پرونده منبع تب‌ها و فاصله‌ها را به‌گونه‌ای با هم ترکیب کند که معنا به ارزش یک تب بر حسب فاصله وابسته باشد، تورفتگی به‌عنوان ناسازگار رد می‌شود؛ در این صورت یک :exc:`TabError` پرتاب می‌شود."

msgid "**Cross-platform compatibility note:** because of the nature of text editors on non-UNIX platforms, it is unwise to use a mixture of spaces and tabs for the indentation in a single source file.  It should also be noted that different platforms may explicitly limit the maximum indentation level."
msgstr "**یادداشت سازگاری بین‌سکویی:** به دلیل ماهیت ویرایشگرهای متن در سکوهای غیر UNIX، استفاده از ترکیبی از فاصله‌ها و تب‌ها برای تورفتگی در یک پرونده منبع واحد، عاقلانه نیست. همچنین باید توجه داشت که سکوهای مختلف ممکن است به‌صراحت حداکثر سطح تورفتگی را محدود کنند."

msgid "A formfeed character may be present at the start of the line; it will be ignored for the indentation calculations above.  Formfeed characters occurring elsewhere in the leading whitespace have an undefined effect (for instance, they may reset the space count to zero)."
msgstr "ممکن است یک نویسه‌ی تغذیه‌ی صفحه (formfeed) در ابتدای خط وجود داشته باشد؛ این نویسه در محاسبات تورفتگی ذکرشده در بالا نادیده گرفته می‌شود. نویسه‌های تغذیه‌ی صفحه (formfeed) که در جاهای دیگر فضای سفید ابتدای خط قرار دارند، اثر تعریف‌نشده‌ای دارند (برای نمونه، ممکن است تعداد فاصله‌ها را به صفر بازنشانی کنند)."

msgid "The indentation levels of consecutive lines are used to generate :data:`~token.INDENT` and :data:`~token.DEDENT` tokens, using a stack, as follows."
msgstr "سطوح تورفتگی سطرهای متوالی، با استفاده از یک پشته، به شرح زیر برای تولید توکن‌های :data:`~token.INDENT` و :data:`~token.DEDENT` استفاده می‌شوند."

msgid "Before the first line of the file is read, a single zero is pushed on the stack; this will never be popped off again.  The numbers pushed on the stack will always be strictly increasing from bottom to top.  At the beginning of each logical line, the line's indentation level is compared to the top of the stack. If it is equal, nothing happens. If it is larger, it is pushed on the stack, and one :data:`!INDENT` token is generated.  If it is smaller, it *must* be one of the numbers occurring on the stack; all numbers on the stack that are larger are popped off, and for each number popped off a :data:`!DEDENT` token is generated. At the end of the file, a :data:`!DEDENT` token is generated for each number remaining on the stack that is larger than zero."
msgstr "پیش از آنکه نخستین خط پرونده خوانده شود، یک صفر روی پشته قرار می‌گیرد؛ این صفر هرگز دوباره از پشته برداشته نخواهد شد. اعدادی که روی پشته قرار می‌گیرند، همیشه از پایین به بالا به‌طور اکید صعودی خواهند بود. در آغاز هر خط منطقی، سطح تورفتگی آن خط با بالای پشته مقایسه می‌شود. اگر برابر باشد، هیچ اتفاقی نمی‌افتد. اگر بزرگ‌تر باشد، روی پشته قرار می‌گیرد و یک توکن :data:`!INDENT` تولید می‌شود. اگر کوچک‌تر باشد، *باید* یکی از اعداد موجود روی پشته باشد؛ تمام اعداد بزرگ‌تر روی پشته برداشته می‌شوند و به ازای هر عدد برداشته‌شده، یک توکن :data:`!DEDENT` تولید می‌شود. در پایان پرونده، به ازای هر عدد باقی‌مانده روی پشته که بزرگ‌تر از صفر باشد، یک توکن :data:`!DEDENT` تولید می‌شود."

msgid "Here is an example of a correctly (though confusingly) indented piece of Python code::"
msgstr "در اینجا نمونه‌ای از یک قطعه کد پایتون با تورفتگی صحیح (هرچند گیج‌کننده) آمده است::"

msgid ""
"def perm(l):\n"
"        # Compute the list of all permutations of l\n"
"    if len(l) <= 1:\n"
"                  return [l]\n"
"    r = []\n"
"    for i in range(len(l)):\n"
"             s = l[:i] + l[i+1:]\n"
"             p = perm(s)\n"
"             for x in p:\n"
"              r.append(l[i:i+1] + x)\n"
"    return r"
msgstr ""
"def perm(l):\n"
"        # Compute the list of all permutations of l\n"
"    if len(l) <= 1:\n"
"                  return [l]\n"
"    r = []\n"
"    for i in range(len(l)):\n"
"             s = l[:i] + l[i+1:]\n"
"             p = perm(s)\n"
"             for x in p:\n"
"              r.append(l[i:i+1] + x)\n"
"    return r"

msgid "The following example shows various indentation errors::"
msgstr "مثال زیر خطاهای مختلف تورفتگی را نشان می‌دهد::"

msgid ""
" def perm(l):                       # error: first line indented\n"
"for i in range(len(l)):             # error: not indented\n"
"    s = l[:i] + l[i+1:]\n"
"        p = perm(l[:i] + l[i+1:])   # error: unexpected indent\n"
"        for x in p:\n"
"                r.append(l[i:i+1] + x)\n"
"            return r                # error: inconsistent dedent"
msgstr ""
" def perm(l):                       # error: first line indented\n"
"for i in range(len(l)):             # error: not indented\n"
"    s = l[:i] + l[i+1:]\n"
"        p = perm(l[:i] + l[i+1:])   # error: unexpected indent\n"
"        for x in p:\n"
"                r.append(l[i:i+1] + x)\n"
"            return r                # error: inconsistent dedent"

msgid "(Actually, the first three errors are detected by the parser; only the last error is found by the lexical analyzer --- the indentation of ``return r`` does not match a level popped off the stack.)"
msgstr "(در واقع، سه خطای اول توسط پارسر تشخیص داده می‌شوند؛ تنها آخرین خطا توسط تحلیل‌گر واژگانی (lexical analyzer) پیدا می‌شود --- تورفتگی ``return r`` با سطحی که از پشته برداشته شده است مطابقت ندارد.)"

msgid "Whitespace between tokens"
msgstr "فضای سفید بین توکن‌ها"

msgid "Except at the beginning of a logical line or in string literals, the whitespace characters space, tab and formfeed can be used interchangeably to separate tokens:"
msgstr "به‌جز در ابتدای یک خط منطقی یا در رشته‌های لفظی (string literals)، می‌توان از نویسه‌های فضای خالی یعنی فاصله، تب و تغذیه‌ی صفحه (formfeed) برای جدا کردن توکن‌ها به‌جای یکدیگر استفاده کرد:"

msgid "Whitespace is needed between two tokens only if their concatenation could otherwise be interpreted as a different token. For example, ``ab`` is one token, but ``a b`` is two tokens. However, ``+a`` and ``+ a`` both produce two tokens, ``+`` and ``a``, as ``+a`` is not a valid token."
msgstr "فضای سفید تنها زمانی بین دو توکن لازم است که در نبود آن، الحاق آن‌ها بتواند به‌عنوان یک توکن متفاوت تفسیر شود. برای مثال، ``ab`` یک توکن است، اما ``a b`` دو توکن است. با این حال، ``+a`` و ``+ a`` هر دو، دو توکن ``+`` و ``a`` را تولید می‌کنند، زیرا ``+a`` یک توکن معتبر نیست."

msgid "End marker"
msgstr "نشانگر پایان"

msgid "At the end of non-interactive input, the lexical analyzer generates an :data:`~token.ENDMARKER` token."
msgstr "در پایان ورودی غیرتعاملی، تحلیل‌گر واژگانی یک توکن :data:`~token.ENDMARKER` تولید می‌کند."

msgid "Other tokens"
msgstr "سایر توکن‌ها"

msgid "Besides :data:`~token.NEWLINE`, :data:`~token.INDENT` and :data:`~token.DEDENT`, the following categories of tokens exist: *identifiers* and *keywords* (:data:`~token.NAME`), *literals* (such as :data:`~token.NUMBER` and :data:`~token.STRING`), and other symbols (*operators* and *delimiters*, :data:`~token.OP`). Whitespace characters (other than logical line terminators, discussed earlier) are not tokens, but serve to delimit tokens. Where ambiguity exists, a token comprises the longest possible string that forms a legal token, when read from left to right."
msgstr "علاوه بر :data:`~token.NEWLINE`، :data:`~token.INDENT` و :data:`~token.DEDENT`، دسته‌های زیر از توکن‌ها وجود دارند: *شناسه‌ها* و *کلیدواژه‌ها* (:data:`~token.NAME`)، *مقادیر لفظی* (مانند :data:`~token.NUMBER` و :data:`~token.STRING`)، و نمادهای دیگر (*عملگرها* و *جداکننده‌ها*، :data:`~token.OP`). نویسه‌های فضای سفید (غیر از پایان‌دهنده‌های خط منطقی، که پیش‌تر به آن‌ها پرداخته شد) توکن محسوب نمی‌شوند، بلکه برای جداسازی توکن‌ها به کار می‌روند. در صورت وجود ابهام، یک توکن شامل طولانی‌ترین رشته‌ی ممکن است که هنگام خواندن از چپ به راست، یک توکن معتبر تشکیل می‌دهد."

msgid "Names (identifiers and keywords)"
msgstr "نام‌ها (شناسه‌ها و کلیدواژه‌ها)"

msgid ":data:`~token.NAME` tokens represent *identifiers*, *keywords*, and *soft keywords*."
msgstr "توکن‌های :data:`~token.NAME` نشان‌دهنده‌ی *شناسه‌ها*، *کلیدواژه‌ها* و *کلیدواژه‌های نرم* هستند."

msgid "Names are composed of the following characters:"
msgstr "نام‌ها از نویسه‌های زیر تشکیل شده‌اند:"

msgid "uppercase and lowercase letters (``A-Z`` and ``a-z``),"
msgstr "حروف بزرگ و کوچک (``A-Z`` و ``a-z``)،"

msgid "the underscore (``_``),"
msgstr "زیرخط (``_``)،"

msgid "digits (``0`` through ``9``), which cannot appear as the first character, and"
msgstr "ارقام (``0`` تا ``9``)، که نمی‌توانند به‌عنوان اولین نویسه ظاهر شوند، و"

msgid "non-ASCII characters. Valid names may only contain \"letter-like\" and \"digit-like\" characters; see :ref:`lexical-names-nonascii` for details."
msgstr "نویسه‌های غیر ASCII. نام‌های معتبر فقط می‌توانند شامل نویسه‌های «حرف‌مانند» و «رقم‌مانند» باشند؛ برای جزئیات :ref:`lexical-names-nonascii` را ببینید."

msgid "Names must contain at least one character, but have no upper length limit. Case is significant."
msgstr "نام‌ها باید حداقل شامل یک نویسه باشند، اما محدودیت بالایی برای طول آن‌ها وجود ندارد. بزرگی و کوچکی حروف اهمیت دارد."

msgid "Formally, names are described by the following lexical definitions:"
msgstr "به‌طور رسمی، نام‌ها با تعاریف واژگانی زیر توصیف می‌شوند:"

msgid "Note that not all names matched by this grammar are valid; see :ref:`lexical-names-nonascii` for details."
msgstr "توجه داشته باشید که همه‌ی نام‌هایی که با این گرامر مطابقت دارند، معتبر نیستند؛ برای جزئیات :ref:`lexical-names-nonascii` را ببینید."

msgid "Keywords"
msgstr "کلیدواژه‌ها"

msgid "The following names are used as reserved words, or *keywords* of the language, and cannot be used as ordinary identifiers.  They must be spelled exactly as written here:"
msgstr "نام‌های زیر به‌عنوان واژه‌های رزروشده، یا *کلیدواژه‌های* زبان، استفاده می‌شوند و نمی‌توان از آن‌ها به‌عنوان شناسه‌های عادی استفاده کرد. آن‌ها باید دقیقاً به همان شکلی که اینجا نوشته شده‌اند، نوشته شوند:"

msgid ""
"False      await      else       import     pass\n"
"None       break      except     in         raise\n"
"True       class      finally    is         return\n"
"and        continue   for        lambda     try\n"
"as         def        from       nonlocal   while\n"
"assert     del        global     not        with\n"
"async      elif       if         or         yield"
msgstr ""
"False      await      else       import     pass\n"
"None       break      except     in         raise\n"
"True       class      finally    is         return\n"
"and        continue   for        lambda     try\n"
"as         def        from       nonlocal   while\n"
"assert     del        global     not        with\n"
"async      elif       if         or         yield"

msgid "Soft Keywords"
msgstr "کلیدواژه‌های نرم"

msgid "Some names are only reserved under specific contexts. These are known as *soft keywords*:"
msgstr "برخی نام‌ها تنها در زمینه‌های خاص محفوظ هستند. این موارد به‌عنوان *کلیدواژه‌های نرم* شناخته می‌شوند:"

msgid "``match``, ``case``, and ``_``, when used in the :keyword:`match` statement."
msgstr "``match``، ``case`` و ``_``، هنگامی که در دستور :keyword:`match` استفاده می‌شوند."

msgid "``type``, when used in the :keyword:`type` statement."
msgstr "``type``، هنگامی که در دستور :keyword:`type` استفاده می‌شود."

msgid "These syntactically act as keywords in their specific contexts, but this distinction is done at the parser level, not when tokenizing."
msgstr "این موارد از نظر نحوی در زمینه‌های خاص خود به‌عنوان کلیدواژه عمل می‌کنند، اما این تمایز در سطح پارسر صورت می‌گیرد، نه هنگام توکن‌بندی (tokenizing)."

msgid "As soft keywords, their use in the grammar is possible while still preserving compatibility with existing code that uses these names as identifier names."
msgstr "به‌عنوان کلیدواژه‌های نرم (soft keywords)، استفاده از آن‌ها در دستور زبان ممکن است، در حالی که سازگاری با کد موجودی که از این نام‌ها به‌عنوان شناسه استفاده می‌کند همچنان حفظ می‌شود."

msgid "``type`` is now a soft keyword."
msgstr "``type`` اکنون یک کلیدواژه نرم (soft keyword) است."

msgid "Reserved classes of identifiers"
msgstr "کلاس‌های رزروشده‌ی شناسه‌ها"

msgid "Certain classes of identifiers (besides keywords) have special meanings.  These classes are identified by the patterns of leading and trailing underscore characters:"
msgstr "برخی از کلاس‌های شناسه‌ها (به‌جز کلیدواژه‌ها) معانی خاصی دارند. این کلاس‌ها با الگوهای نویسه‌های زیرخط آغازین و پایانی شناسایی می‌شوند:"

msgid "``_*``"
msgstr "``_*``"

msgid "Not imported by ``from module import *``."
msgstr "با ``from module import *`` ایمپورت نمی‌شود."

msgid "``_``"
msgstr "``_``"

msgid "In a ``case`` pattern within a :keyword:`match` statement, ``_`` is a :ref:`soft keyword <soft-keywords>` that denotes a :ref:`wildcard <wildcard-patterns>`."
msgstr "در یک الگوی ``case`` درون یک دستور :keyword:`match`، ``_`` یک :ref:`کلیدواژه نرم <soft-keywords>` است که یک :ref:`wildcard <wildcard-patterns>` را نشان می‌دهد."

msgid "Separately, the interactive interpreter makes the result of the last evaluation available in the variable ``_``. (It is stored in the :mod:`builtins` module, alongside built-in functions like ``print``.)"
msgstr "به‌طور جداگانه، مفسر تعاملی نتیجه آخرین ارزیابی را در متغیر ``_`` در دسترس قرار می‌دهد. (این نتیجه در ماژول :mod:`builtins`، در کنار توابع توکار مانند ``print`` ذخیره می‌شود.)"

msgid "Elsewhere, ``_`` is a regular identifier. It is often used to name \"special\" items, but it is not special to Python itself."
msgstr "در جاهای دیگر، ``_`` یک شناسه معمولی است. اغلب از آن برای نام‌گذاری آیتم‌های «خاص» استفاده می‌شود، اما برای خود پایتون خاص نیست."

msgid "The name ``_`` is often used in conjunction with internationalization; refer to the documentation for the :mod:`gettext` module for more information on this convention."
msgstr "نام ``_`` اغلب همراه با بین‌المللی‌سازی استفاده می‌شود؛ برای اطلاعات بیشتر درباره این قرارداد، به مستندات ماژول :mod:`gettext` مراجعه کنید."

msgid "It is also commonly used for unused variables."
msgstr "همچنین به‌طور رایج برای متغیرهای استفاده‌نشده به کار می‌رود."

msgid "``__*__``"
msgstr "``__*__``"

msgid "System-defined names, informally known as \"dunder\" names. These names are defined by the interpreter and its implementation (including the standard library). Current system names are discussed in the :ref:`specialnames` section and elsewhere. More will likely be defined in future versions of Python.  *Any* use of ``__*__`` names, in any context, that does not follow explicitly documented use, is subject to breakage without warning."
msgstr "نام‌های تعریف‌شده توسط سیستم، که به‌طور غیررسمی به نام‌های «dunder» شناخته می‌شوند. این نام‌ها توسط مفسر و پیاده‌سازی آن (از جمله کتابخانه استاندارد) تعریف شده‌اند. نام‌های سیستمی فعلی در بخش :ref:`specialnames` و جاهای دیگر بررسی شده‌اند. احتمالاً نام‌های بیشتری در نسخه‌های آینده پایتون تعریف خواهند شد. *هر* استفاده‌ای از نام‌های ``__*__``، در هر زمینه‌ای، که از کاربرد به‌صراحت مستندشده پیروی نکند، در معرض از کار افتادن بدون هشدار است."

msgid "``__*``"
msgstr "``__*``"

msgid "Class-private names.  Names in this category, when used within the context of a class definition, are re-written to use a mangled form to help avoid name clashes between \"private\" attributes of base and derived classes. See section :ref:`atom-identifiers`."
msgstr "نام‌های خصوصی کلاس. نام‌های این دسته، هنگامی که در زمینه‌ی تعریف کلاس استفاده شوند، به‌شکل درهم‌ریخته (mangled form) بازنویسی می‌شوند تا به جلوگیری از تداخل نام میان ویژگی‌های «خصوصی» کلاس‌های پایه و مشتق‌شده کمک کنند. بخش :ref:`atom-identifiers` را ببینید."

msgid "Non-ASCII characters in names"
msgstr "نویسه‌های غیر ASCII در نام‌ها"

msgid "Names that contain non-ASCII characters need additional normalization and validation beyond the rules and grammar explained :ref:`above <identifiers>`. For example, ``ř_1``, ``蛇``, or ``साँप``  are valid names, but ``r〰2``, ``€``, or ``🐍`` are not."
msgstr "نام‌هایی که شامل نویسه‌های غیر ASCII هستند، به نرمال‌سازی و اعتبارسنجی بیشتری فراتر از قواعد و دستور زبان توضیح‌داده‌شده در :ref:`بالا <identifiers>` نیاز دارند. برای مثال، ``ř_1``، ``蛇`` یا ``साँप`` نام‌های معتبر هستند، اما ``r〰2``، ``€`` یا ``🐍`` معتبر نیستند."

msgid "This section explains the exact rules."
msgstr "این بخش قواعد دقیق را توضیح می‌دهد."

msgid "All names are converted into the `normalization form`_ NFKC while parsing. This means that, for example, some typographic variants of characters are converted to their \"basic\" form. For example, ``fiⁿₐˡᵢᶻₐᵗᵢᵒₙ`` normalizes to ``finalization``, so Python treats them as the same name::"
msgstr "تمام نام‌ها هنگام تجزیه به `normalization form`_ NFKC تبدیل می‌شوند. این بدان معناست که، برای مثال، برخی صورت‌های تایپوگرافیک نویسه‌ها به فرم «پایه» خود تبدیل می‌شوند. برای مثال، ``fiⁿₐˡᵢᶻₐᵗᵢᵒₙ`` به ``finalization`` نرمال‌سازی می‌شود، بنابراین پایتون آن‌ها را یک نام یکسان در نظر می‌گیرد::"

msgid ""
">>> fiⁿₐˡᵢᶻₐᵗᵢᵒₙ = 3\n"
">>> finalization\n"
"3"
msgstr ""
">>> fiⁿₐˡᵢᶻₐᵗᵢᵒₙ = 3\n"
">>> finalization\n"
"3"

msgid "Normalization is done at the lexical level only. Run-time functions that take names as *strings* generally do not normalize their arguments. For example, the variable defined above is accessible at run time in the :func:`globals` dictionary as ``globals()[\"finalization\"]`` but not ``globals()[\"fiⁿₐˡᵢᶻₐᵗᵢᵒₙ\"]``."
msgstr "نرمال‌سازی فقط در سطح واژگانی انجام می‌شود. توابع ران‌تایمی که نام‌ها را به‌عنوان *رشته* دریافت می‌کنند، معمولاً آرگومان‌های خود را نرمال‌سازی نمی‌کنند. برای مثال، متغیر تعریف‌شده در بالا در ران‌تایم در دیکشنری :func:`globals` به‌صورت ``globals()[\"finalization\"]`` قابل دسترسی است، اما به‌صورت ``globals()[\"fiⁿₐˡᵢᶻₐᵗᵢᵒₙ\"]`` قابل دسترسی نیست."

msgid "Similarly to how ASCII-only names must contain only letters, digits and the underscore, and cannot start with a digit, a valid name must start with a character in the \"letter-like\" set ``xid_start``, and the remaining characters must be in the \"letter- and digit-like\" set ``xid_continue``."
msgstr "همان‌طور که نام‌های فقط ASCII باید فقط شامل حروف، ارقام و زیرخط باشند و نمی‌توانند با یک رقم آغاز شوند، یک نام معتبر باید با نویسه‌ای از مجموعه «شبیه‌حروف» ``xid_start`` آغاز شود و نویسه‌های باقی‌مانده باید در مجموعه «شبیه‌حروف و ارقام» ``xid_continue`` قرار داشته باشند."

msgid "These sets are based on the *XID_Start* and *XID_Continue* sets as defined by the Unicode standard annex `UAX-31`_. Python's ``xid_start`` additionally includes the underscore (``_``). Note that Python does not necessarily conform to `UAX-31`_."
msgstr "این مجموعه‌ها بر پایه‌ی مجموعه‌های *XID_Start* و *XID_Continue* هستند، همان‌گونه که در پیوست `UAX-31`_ استاندارد یونیکد تعریف شده‌اند. ``xid_start`` پایتون افزون بر این شامل زیرخط (``_``) نیز می‌شود. توجه داشته باشید که پایتون لزوماً با `UAX-31`_ مطابقت ندارد."

msgid "A non-normative listing of characters in the *XID_Start* and *XID_Continue* sets as defined by Unicode is available in the `DerivedCoreProperties.txt`_ file in the Unicode Character Database. For reference, the construction rules for the ``xid_*`` sets are given below."
msgstr "فهرست غیرهنجاری (non-normative) از نویسه‌های موجود در مجموعه‌های *XID_Start* و *XID_Continue*، طبق تعریف یونیکد، در پرونده `DerivedCoreProperties.txt`_ در پایگاه داده نویسه‌های یونیکد در دسترس است. برای ارجاع، قواعد ساخت مجموعه‌های ``xid_*`` در زیر آمده است."

msgid "The set ``id_start`` is defined as the union of:"
msgstr "مجموعه ``id_start`` به‌صورت اجتماع زیر تعریف شده است:"

msgid "Unicode category ``<Lu>`` - uppercase letters (includes ``A`` to ``Z``)"
msgstr "دسته‌ی یونیکد ``<Lu>`` - حروف بزرگ (شامل ``A`` تا ``Z``)"

msgid "Unicode category ``<Ll>`` - lowercase letters (includes ``a`` to ``z``)"
msgstr "دسته یونیکد ``<Ll>`` - حروف کوچک (شامل ``a`` تا ``z``)"

msgid "Unicode category ``<Lt>`` - titlecase letters"
msgstr "دسته یونیکد ``<Lt>`` - حروف عنوان‌نویسی‌شده (titlecase)"

msgid "Unicode category ``<Lm>`` - modifier letters"
msgstr "رده‌ی یونیکد ``<Lm>`` - حروف اصلاح‌کننده"

msgid "Unicode category ``<Lo>`` - other letters"
msgstr "دسته‌ی یونیکد ``<Lo>`` - حروف دیگر"

msgid "Unicode category ``<Nl>`` - letter numbers"
msgstr "دسته یونیکد ``<Nl>`` - اعداد حرفی"

msgid "{``\"_\"``} - the underscore"
msgstr "{``\"_\"``} - زیرخط"

msgid "``<Other_ID_Start>`` - an explicit set of characters in `PropList.txt`_ to support backwards compatibility"
msgstr "``<Other_ID_Start>`` - مجموعه‌ای صریح از نویسه‌ها در `PropList.txt`_ برای پشتیبانی از سازگاری با نسخه‌های پیشین"

msgid "The set ``xid_start`` then closes this set under NFKC normalization, by removing all characters whose normalization is not of the form ``id_start id_continue*``."
msgstr "سپس مجموعه‌ی ``xid_start`` این مجموعه را تحت نرمال‌سازی NFKC، با حذف تمام نویسه‌هایی که نرمال‌سازی آن‌ها به شکل ``id_start id_continue*`` نیست، بسته می‌کند."

msgid "The set ``id_continue`` is defined as the union of:"
msgstr "مجموعه‌ی ``id_continue`` به‌صورت اجتماع زیر تعریف می‌شود:"

msgid "``id_start`` (see above)"
msgstr "``id_start`` (بالا را ببینید)"

msgid "Unicode category ``<Nd>`` - decimal numbers (includes ``0`` to ``9``)"
msgstr "دسته‌بندی یونیکد ``<Nd>`` - اعداد دهدهی (شامل ``0`` تا ``9`` می‌شود)"

msgid "Unicode category ``<Pc>`` - connector punctuations"
msgstr "دسته یونیکد ``<Pc>`` - نمادگذاری‌های اتصال"

msgid "Unicode category ``<Mn>`` - nonspacing marks"
msgstr "دسته‌ی یونیکد ``<Mn>`` - علامت‌های بدون فاصله"

msgid "Unicode category ``<Mc>`` - spacing combining marks"
msgstr "دسته‌ی یونیکد ``<Mc>`` - علامت‌های ترکیبی فاصله‌دار"

msgid "``<Other_ID_Continue>`` - another explicit set of characters in `PropList.txt`_ to support backwards compatibility"
msgstr "``<Other_ID_Continue>`` - مجموعه صریح دیگری از نویسه‌ها در `PropList.txt`_ برای پشتیبانی از سازگاری با عقب"

msgid "Again, ``xid_continue`` closes this set under NFKC normalization."
msgstr "باز هم، ``xid_continue`` این مجموعه را تحت نرمال‌سازی NFKC بسته می‌کند."

msgid "Unicode categories use the version of the Unicode Character Database as included in the :mod:`unicodedata` module."
msgstr "دسته‌بندی‌های یونیکد از همان نسخه‌ای از پایگاه داده‌ی نویسه‌های یونیکد استفاده می‌کنند که در ماژول :mod:`unicodedata` گنجانده شده است."

msgid ":pep:`3131` -- Supporting Non-ASCII Identifiers"
msgstr ":pep:`3131` -- پشتیبانی از شناسه‌های غیر ASCII"

msgid ":pep:`672` -- Unicode-related Security Considerations for Python"
msgstr ":pep:`672` -- ملاحظات امنیتی مرتبط با یونیکد برای پایتون"

msgid "Literals"
msgstr "مقادیر لفظی"

msgid "Literals are notations for constant values of some built-in types."
msgstr "مقادیر لفظی نشانه‌هایی برای مقادیر ثابت برخی از انواع توکار هستند."

msgid "In terms of lexical analysis, Python has :ref:`string, bytes <strings>` and :ref:`numeric <numbers>` literals."
msgstr "از نظر تحلیل واژگانی، پایتون دارای مقادیر لفظی :ref:`رشته، بایت <strings>` و :ref:`عددی <numbers>` است."

msgid "Other \"literals\" are lexically denoted using :ref:`keywords <keywords>` (``None``, ``True``, ``False``) and the special :ref:`ellipsis token <lexical-ellipsis>` (``...``)."
msgstr "سایر «مقادیر لفظی» از نظر واژگانی با استفاده از :ref:`کلیدواژه‌ها <keywords>` (``None``، ``True``، ``False``) و :ref:`توکن سه‌نقطه <lexical-ellipsis>` ویژه (``...``) نشان داده می‌شوند."

msgid "String and Bytes literals"
msgstr "مقادیر لفظی رشته و بایت"

msgid "String literals are text enclosed in single quotes (``'``) or double quotes (``\"``). For example:"
msgstr "مقادیر لفظی رشته، متن‌هایی هستند که درون علامت نقل‌قول تکی (``'``) یا علامت نقل‌قول دوتایی (``\"``) قرار گرفته‌اند. برای مثال:"

msgid ""
"\"spam\"\n"
"'eggs'"
msgstr ""
"\"spam\"\n"
"'eggs'"

msgid "The quote used to start the literal also terminates it, so a string literal can only contain the other quote (except with escape sequences, see below). For example:"
msgstr "علامت نقل‌قولی که برای آغاز مقدار لفظی به کار می‌رود، آن را نیز پایان می‌دهد، بنابراین یک رشته‌ی لفظی فقط می‌تواند شامل علامت نقل‌قول دیگر باشد (مگر با استفاده از دنباله‌های خنثی‌سازی، در زیر ببینید). برای مثال:"

msgid ""
"'Say \"Hello\", please.'\n"
"\"Don't do that!\""
msgstr ""
"'Say \"Hello\", please.'\n"
"\"Don't do that!\""

msgid "Except for this limitation, the choice of quote character (``'`` or ``\"``) does not affect how the literal is parsed."
msgstr "به جز این محدودیت، انتخاب نویسه‌ی علامت نقل‌قول (``'`` یا ``\"``) تأثیری بر نحوه‌ی تجزیه‌ی لفظی ندارد."

msgid "Inside a string literal, the backslash (``\\``) character introduces an :dfn:`escape sequence`, which has special meaning depending on the character after the backslash. For example, ``\\\"`` denotes the double quote character, and does *not* end the string:"
msgstr "در یک لفظی رشته، نویسه‌ی بک‌اسلش (``\\``) یک :dfn:`دنباله‌ی خنثی‌سازی (escape sequence)` را آغاز می‌کند که بسته به نویسه‌ی پس از بک‌اسلش، معنای خاصی دارد. برای مثال، ``\\\"`` نشان‌دهنده‌ی نویسه‌ی علامت نقل‌قول دوتایی است و رشته را به پایان *نمی‌رساند*:"

msgid ""
">>> print(\"Say \\\"Hello\\\" to everyone!\")\n"
"Say \"Hello\" to everyone!"
msgstr ""
">>> print(\"Say \\\"Hello\\\" to everyone!\")\n"
"Say \"Hello\" to everyone!"

msgid "See :ref:`escape sequences <escape-sequences>` below for a full list of such sequences, and more details."
msgstr "برای فهرست کاملی از چنین دنباله‌هایی و جزئیات بیشتر، :ref:`دنباله‌های خنثی‌سازی <escape-sequences>` را در زیر ببینید."

msgid "Triple-quoted strings"
msgstr "رشته‌های سه‌علامت‌نقل‌قولی"

msgid "Strings can also be enclosed in matching groups of three single or double quotes. These are generally referred to as :dfn:`triple-quoted strings`::"
msgstr "رشته‌ها همچنین می‌توانند درون گروه‌های سه‌تایی همسان از علامت‌های نقل‌قول تکی یا دوتایی محصور شوند. به این رشته‌ها به‌طور کلی :dfn:`رشته‌های سه‌نقل‌قولی (triple-quoted strings)` گفته می‌شود::"

msgid "\"\"\"This is a triple-quoted string.\"\"\""
msgstr "\"\"\"این یک رشته سه‌نقل‌قولی است.\"\"\""

msgid "In triple-quoted literals, unescaped quotes are allowed (and are retained), except that three unescaped quotes in a row terminate the literal, if they are of the same kind (``'`` or ``\"``) used at the start::"
msgstr "در مقادیر لفظی سه‌نقل‌قولی، علامت‌های نقل‌قول خنثی‌نشده مجاز هستند (و حفظ می‌شوند)، به این استثنا که سه علامت نقل‌قول خنثی‌نشده پشت‌سرهم، اگر از همان نوع (``'`` یا ``\"``) استفاده‌شده در ابتدا باشند، لفظی را پایان می‌دهند::"

msgid "\"\"\"This string has \"quotes\" inside.\"\"\""
msgstr "\"\"\"این رشته در خود \"علامت‌های نقل‌قول\" دارد.\"\"\""

msgid "Unescaped newlines are also allowed and retained::"
msgstr "سطرهای جدید خنثی‌نشده نیز مجاز هستند و حفظ می‌شوند::"

msgid ""
"'''This triple-quoted string\n"
"continues on the next line.'''"
msgstr ""
"'''This triple-quoted string\n"
"continues on the next line.'''"

msgid "String prefixes"
msgstr "پیشوندهای رشته"

msgid "String literals can have an optional :dfn:`prefix` that influences how the content of the literal is parsed, for example:"
msgstr "رشته‌های لفظی می‌توانند یک :dfn:`prefix` اختیاری داشته باشند که بر نحوه‌ی تجزیه‌ی محتوای آن‌ها تأثیر می‌گذارد، برای مثال:"

msgid ""
"b\"data\"\n"
"f'{result=}'"
msgstr ""
"b\"data\"\n"
"f'{result=}'"

msgid "The allowed prefixes are:"
msgstr "پیشوندهای مجاز عبارتند از:"

msgid "``b``: :ref:`Bytes literal <bytes-literal>`"
msgstr "``b``: :ref:`لفظی بایت <bytes-literal>`"

msgid "``r``: :ref:`Raw string <raw-strings>`"
msgstr "``r``: :ref:`رشته خام <raw-strings>`"

msgid "``f``: :ref:`Formatted string literal <f-strings>` (\"f-string\")"
msgstr "``f``: :ref:`رشته لفظی قالب‌بندی‌شده <f-strings>` («اف‌استرینگ»)"

msgid "``t``: :ref:`Template string literal <t-strings>` (\"t-string\")"
msgstr "``t``: :ref:`رشته‌ی الگویی <t-strings>` («t-string»)"

msgid "``u``: No effect (allowed for backwards compatibility)"
msgstr "``u``: بدون اثر (برای سازگاری با نسخه‌های پیشین مجاز است)"

msgid "See the linked sections for details on each type."
msgstr "برای جزئیات مربوط به هر نوع، بخش‌های پیوندشده را ببینید."

msgid "Prefixes are case-insensitive (for example, '``B``' works the same as '``b``'). The '``r``' prefix can be combined with '``f``', '``t``' or '``b``', so '``fr``', '``rf``', '``tr``', '``rt``', '``br``', and '``rb``' are also valid prefixes."
msgstr "پیشوندها به بزرگی و کوچکی حروف حساس نیستند (برای مثال، '``B``' مانند '``b``' عمل می‌کند). پیشوند '``r``' می‌تواند با '``f``'، '``t``' یا '``b``' ترکیب شود، بنابراین '``fr``'، '``rf``'، '``tr``'، '``rt``'، '``br``' و '``rb``' نیز پیشوندهای معتبر هستند."

msgid "The ``'rb'`` prefix of raw bytes literals has been added as a synonym of ``'br'``."
msgstr "پیشوند ``'rb'`` برای مقادیر لفظی بایت خام به‌عنوان مترادفی برای ``'br'`` افزوده شده است."

msgid "Support for the unicode legacy literal (``u'value'``) was reintroduced to simplify the maintenance of dual Python 2.x and 3.x codebases. See :pep:`414` for more information."
msgstr "پشتیبانی از لفظی قدیمی یونیکد (``u'value'``) دوباره معرفی شد تا نگهداری پایگاه‌های کد دوگانه‌ی Python 2.x و 3.x ساده‌تر شود. برای اطلاعات بیشتر، :pep:`414` را ببینید."

msgid "Formal grammar"
msgstr "دستور زبان صوری"

msgid "String literals, except :ref:`\"f-strings\" <f-strings>` and :ref:`\"t-strings\" <t-strings>`, are described by the following lexical definitions."
msgstr "رشته‌های لفظی، به‌جز :ref:`«اف‌استرینگ‌ها» <f-strings>` و :ref:`«تی‌استرینگ‌ها» <t-strings>`، با تعاریف واژگانی زیر توصیف شده‌اند."

msgid "These definitions use :ref:`negative lookaheads <lexical-lookaheads>` (``!``) to indicate that an ending quote ends the literal."
msgstr "این تعریف‌ها از :ref:`پیش‌نگرهای منفی <lexical-lookaheads>` (``!``) استفاده می‌کنند تا نشان دهند که علامت نقل‌قول پایانی، لفظی را پایان می‌دهد."

msgid "Note that as in all lexical definitions, whitespace is significant. In particular, the prefix (if any) must be immediately followed by the starting quote."
msgstr "توجه داشته باشید که مانند همه‌ی تعاریف واژگانی، فضای سفید معنادار است. به‌ویژه، پیشوند (در صورت وجود) باید بلافاصله با علامت نقل‌قول آغازین دنبال شود."

msgid "Escape sequences"
msgstr "دنباله‌های خنثی‌سازی"

msgid "Unless an '``r``' or '``R``' prefix is present, escape sequences in string and bytes literals are interpreted according to rules similar to those used by Standard C.  The recognized escape sequences are:"
msgstr "مگر آنکه پیشوند '``r``' یا '``R``' وجود داشته باشد، دنباله‌های خنثی‌سازی در مقادیر لفظی رشته و بایت طبق قوانینی مشابه قوانین به‌کاررفته در C استاندارد تفسیر می‌شوند. دنباله‌های خنثی‌سازی شناخته‌شده عبارتند از:"

msgid "Escape Sequence"
msgstr "دنباله‌ی خنثی‌سازی"

msgid "Meaning"
msgstr "معنی"

msgid "``\\``\\ <newline>"
msgstr "``\\``\\ <newline>"

msgid ":ref:`string-escape-ignore`"
msgstr ":ref:`string-escape-ignore`"

msgid "``\\\\``"
msgstr "``\\\\``"

msgid ":ref:`Backslash <string-escape-escaped-char>`"
msgstr ":ref:`بک‌اسلش <string-escape-escaped-char>`"

msgid "``\\'``"
msgstr "``\\'``"

msgid ":ref:`Single quote <string-escape-escaped-char>`"
msgstr ":ref:`علامت نقل‌قول تکی <string-escape-escaped-char>`"

msgid "``\\\"``"
msgstr "``\\\"``"

msgid ":ref:`Double quote <string-escape-escaped-char>`"
msgstr ":ref:`علامت نقل‌قول دوتایی <string-escape-escaped-char>`"

msgid "``\\a``"
msgstr "``\\a``"

msgid "ASCII Bell (BEL)"
msgstr "زنگ ASCII (BEL)"

msgid "``\\b``"
msgstr "``\\b``"

msgid "ASCII Backspace (BS)"
msgstr "پس‌بر ASCII (BS)"

msgid "``\\f``"
msgstr "``\\f``"

msgid "ASCII Formfeed (FF)"
msgstr "تغذیه‌ی صفحه ASCII (FF)"

msgid "``\\n``"
msgstr "``\\n``"

msgid "ASCII Linefeed (LF)"
msgstr "تغذیه‌ی سطر ASCII (LF)"

msgid "``\\r``"
msgstr "``\\r``"

msgid "ASCII Carriage Return (CR)"
msgstr "بازگشت به ابتدای سطر ASCII (CR)"

msgid "``\\t``"
msgstr "``\\t``"

msgid "ASCII Horizontal Tab (TAB)"
msgstr "تب افقی ASCII (TAB)"

msgid "``\\v``"
msgstr "``\\v``"

msgid "ASCII Vertical Tab (VT)"
msgstr "تب عمودی ASCII (VT)"

msgid ":samp:`\\\\\\\\{ooo}`"
msgstr ":samp:`\\\\\\\\{ooo}`"

msgid ":ref:`string-escape-oct`"
msgstr ":ref:`string-escape-oct`"

msgid ":samp:`\\\\x{hh}`"
msgstr ":samp:`\\\\x{hh}`"

msgid ":ref:`string-escape-hex`"
msgstr ":ref:`string-escape-hex`"

msgid ":samp:`\\\\N\\\\{{name}\\\\}`"
msgstr ":samp:`\\\\N\\\\{{name}\\\\}`"

msgid ":ref:`string-escape-named`"
msgstr ":ref:`string-escape-named`"

msgid ":samp:`\\\\u{xxxx}`"
msgstr ":samp:`\\\\u{xxxx}`"

msgid ":ref:`Hexadecimal Unicode character <string-escape-long-hex>`"
msgstr ":ref:`نویسه‌ی یونیکد مبنای شانزده <string-escape-long-hex>`"

msgid ":samp:`\\\\U{xxxxxxxx}`"
msgstr ":samp:`\\\\U{xxxxxxxx}`"

msgid "Ignored end of line"
msgstr "پایان خط نادیده گرفته می‌شود"

msgid "A backslash can be added at the end of a line to ignore the newline::"
msgstr "برای چشم‌پوشی از خط جدید، می‌توان یک بک‌اسلش در انتهای خط اضافه کرد::"

msgid ""
">>> 'This string will not include \\\n"
"... backslashes or newline characters.'\n"
"'This string will not include backslashes or newline characters.'"
msgstr ""
">>> 'This string will not include \\\n"
"... backslashes or newline characters.'\n"
"'This string will not include backslashes or newline characters.'"

msgid "The same result can be achieved using :ref:`triple-quoted strings <strings>`, or parentheses and :ref:`string literal concatenation <string-concatenation>`."
msgstr "همین نتیجه را می‌توان با استفاده از :ref:`رشته‌های با سه علامت نقل‌قول <strings>`، یا پرانتزها و :ref:`الحاق رشته‌های لفظی <string-concatenation>` به دست آورد."

msgid "Escaped characters"
msgstr "نویسه‌های خنثی‌شده"

msgid "To include a backslash in a non-:ref:`raw <raw-strings>` Python string literal, it must be doubled. The ``\\\\`` escape sequence denotes a single backslash character::"
msgstr "برای درج یک بک‌اسلش در یک لفظی رشته پایتون غیر :ref:`خام <raw-strings>`، باید آن را دو برابر کرد. دنباله خنثی‌سازی ``\\\\`` نشان‌دهنده یک نویسه بک‌اسلش است::"

msgid ""
">>> print('C:\\\\Program Files')\n"
"C:\\Program Files"
msgstr ""
">>> print('C:\\\\Program Files')\n"
"C:\\Program Files"

msgid "Similarly, the ``\\'`` and ``\\\"`` sequences denote the single and double quote character, respectively::"
msgstr "به همین ترتیب، دنباله‌های ``\\'`` و ``\\\"`` به‌ترتیب نشان‌دهنده‌ی نویسه‌ی نقل‌قول تکی و دوتایی هستند::"

msgid ""
">>> print('\\' and \\\"')\n"
"' and \""
msgstr ""
">>> print('\\' and \\\"')\n"
"' and \""

msgid "Octal character"
msgstr "نویسه‌ی مبنای هشت"

msgid "The sequence :samp:`\\\\\\\\{ooo}` denotes a *character* with the octal (base 8) value *ooo*::"
msgstr "دنباله‌ی :samp:`\\\\\\\\{ooo}` یک *نویسه* با مقدار مبنای ۸ *ooo* را نشان می‌دهد::"

msgid ""
">>> '\\120'\n"
"'P'"
msgstr ""
">>> '\\120'\n"
"'P'"

msgid "Up to three octal digits (0 through 7) are accepted."
msgstr "تا سه رقم مبنای هشت (۰ تا ۷) پذیرفته می‌شود."

msgid "In a bytes literal, *character* means a *byte* with the given value. In a string literal, it means a Unicode character with the given value."
msgstr "در یک لفظی bytes، *نویسه* به معنای یک *بایت* با مقدار داده‌شده است. در یک لفظی رشته، به معنای یک نویسه‌ی یونیکد با مقدار داده‌شده است."

msgid "Octal escapes with value larger than ``0o377`` (255) produce a :exc:`DeprecationWarning`."
msgstr "دنباله‌های خنثی‌سازی مبنای هشت با مقدار بزرگ‌تر از ``0o377`` (۲۵۵) یک :exc:`DeprecationWarning` تولید می‌کنند."

msgid "Octal escapes with value larger than ``0o377`` (255) produce a :exc:`SyntaxWarning`. In a future Python version they will raise a :exc:`SyntaxError`."
msgstr "دنباله‌های خنثی‌سازی مبنای هشت با مقداری بزرگ‌تر از ``0o377`` (۲۵۵) یک :exc:`SyntaxWarning` تولید می‌کنند. در نسخه‌ای آینده از پایتون یک :exc:`SyntaxError` پرتاب خواهند کرد."

msgid "Hexadecimal character"
msgstr "نویسه‌ی مبنای شانزده"

msgid "The sequence :samp:`\\\\x{hh}` denotes a *character* with the hex (base 16) value *hh*::"
msgstr "دنباله‌ی :samp:`\\\\x{hh}` یک *نویسه* با مقدار مبنای شانزده (مبنای ۱۶) *hh* را نشان می‌دهد::"

msgid ""
">>> '\\x50'\n"
"'P'"
msgstr ""
">>> '\\x50'\n"
"'P'"

msgid "Unlike in Standard C, exactly two hex digits are required."
msgstr "برخلاف C استاندارد، دقیقاً دو رقم مبنای شانزده لازم است."

msgid "Named Unicode character"
msgstr "نویسه‌ی یونیکد نام‌دار"

msgid "The sequence :samp:`\\\\N\\\\{{name}\\\\}` denotes a Unicode character with the given *name*::"
msgstr "دنباله‌ی :samp:`\\\\N\\\\{{name}\\\\}` یک نویسه‌ی یونیکد با *نام* داده‌شده را نشان می‌دهد::"

msgid ""
">>> '\\N{LATIN CAPITAL LETTER P}'\n"
"'P'\n"
">>> '\\N{SNAKE}'\n"
"'🐍'"
msgstr ""
">>> '\\N{LATIN CAPITAL LETTER P}'\n"
"'P'\n"
">>> '\\N{SNAKE}'\n"
"'🐍'"

msgid "This sequence cannot appear in :ref:`bytes literals <bytes-literal>`."
msgstr "این دنباله نمی‌تواند در :ref:`مقادیر لفظی بایتی <bytes-literal>` ظاهر شود."

msgid "Support for `name aliases <https://www.unicode.org/Public/16.0.0/ucd/NameAliases.txt>`__ has been added."
msgstr "پشتیبانی از `نام‌های مستعار <https://www.unicode.org/Public/16.0.0/ucd/NameAliases.txt>`__ اضافه شده است."

msgid "Hexadecimal Unicode characters"
msgstr "نویسه‌های یونیکد مبنای شانزده"

msgid "These sequences :samp:`\\\\u{xxxx}` and :samp:`\\\\U{xxxxxxxx}` denote the Unicode character with the given hex (base 16) value. Exactly four digits are required for ``\\u``; exactly eight digits are required for ``\\U``. The latter can encode any Unicode character."
msgstr "این دنباله‌ها :samp:`\\\\u{xxxx}` و :samp:`\\\\U{xxxxxxxx}` نویسه‌ی یونیکد با مقدار داده‌شده به مبنای شانزده را نشان می‌دهند. برای ``\\u`` دقیقاً چهار رقم لازم است؛ برای ``\\U`` دقیقاً هشت رقم لازم است. دومی می‌تواند هر نویسه‌ی یونیکد را کدگذاری کند."

msgid ""
">>> '\\u1234'\n"
"'ሴ'\n"
">>> '\\U0001f40d'\n"
"'🐍'"
msgstr ""
">>> '\\u1234'\n"
"'ሴ'\n"
">>> '\\U0001f40d'\n"
"'🐍'"

msgid "These sequences cannot appear in :ref:`bytes literals <bytes-literal>`."
msgstr "این دنباله‌ها نمی‌توانند در :ref:`مقادیر لفظی بایتی <bytes-literal>` ظاهر شوند."

msgid "Unrecognized escape sequences"
msgstr "دنباله‌های خنثی‌سازی شناسایی‌نشده"

msgid "Unlike in Standard C, all unrecognized escape sequences are left in the string unchanged, that is, *the backslash is left in the result*::"
msgstr "برخلاف C استاندارد، همه‌ی دنباله‌های خنثی‌سازی ناشناخته بدون تغییر در رشته باقی می‌مانند، یعنی *بک‌اسلش در نتیجه باقی می‌ماند*::"

msgid ""
">>> print('\\q')\n"
"\\q\n"
">>> list('\\q')\n"
"['\\\\', 'q']"
msgstr ""
">>> print('\\q')\n"
"\\q\n"
">>> list('\\q')\n"
"['\\\\', 'q']"

msgid "Note that for bytes literals, the escape sequences only recognized in string literals (``\\N...``, ``\\u...``, ``\\U...``) fall into the category of unrecognized escapes."
msgstr "توجه داشته باشید که برای مقادیر لفظی bytes، دنباله‌های خنثی‌سازیی که فقط در مقادیر لفظی رشته‌ای شناسایی می‌شوند (``\\N...``، ``\\u...``، ``\\U...``) در دسته دنباله‌های خنثی‌سازی ناشناخته قرار می‌گیرند."

msgid "Unrecognized escape sequences produce a :exc:`DeprecationWarning`."
msgstr "دنباله‌های خنثی‌سازی ناشناخته، یک :exc:`DeprecationWarning` ایجاد می‌کنند."

msgid "Unrecognized escape sequences produce a :exc:`SyntaxWarning`. In a future Python version they will raise a :exc:`SyntaxError`."
msgstr "دنباله‌های خنثی‌سازی ناشناخته باعث ایجاد یک :exc:`SyntaxWarning` می‌شوند. در یک نسخه آینده از پایتون، این دنباله‌ها یک :exc:`SyntaxError` پرتاب خواهند کرد."

msgid "Bytes literals"
msgstr "مقادیر لفظی بایتی"

msgid ":dfn:`Bytes literals` are always prefixed with '``b``' or '``B``'; they produce an instance of the :class:`bytes` type instead of the :class:`str` type. They may only contain ASCII characters; bytes with a numeric value of 128 or greater must be expressed with escape sequences (typically :ref:`string-escape-hex` or :ref:`string-escape-oct`):"
msgstr ":dfn:`مقادیر لفظی بایت (Bytes literals)` همیشه پیشوند '``b``' یا '``B``' دارند؛ آن‌ها نمونه‌ای از نوع :class:`bytes` را به جای نوع :class:`str` تولید می‌کنند. آن‌ها فقط می‌توانند شامل نویسه‌های ASCII باشند؛ بایت‌هایی با مقدار عددی ۱۲۸ یا بیشتر باید با دنباله‌های خنثی‌سازی نوشته شوند (معمولاً :ref:`string-escape-hex` یا :ref:`string-escape-oct`):"

msgid ""
">>> b'\\x89PNG\\r\\n\\x1a\\n'\n"
"b'\\x89PNG\\r\\n\\x1a\\n'\n"
">>> list(b'\\x89PNG\\r\\n\\x1a\\n')\n"
"[137, 80, 78, 71, 13, 10, 26, 10]"
msgstr ""
">>> b'\\x89PNG\\r\\n\\x1a\\n'\n"
"b'\\x89PNG\\r\\n\\x1a\\n'\n"
">>> list(b'\\x89PNG\\r\\n\\x1a\\n')\n"
"[137, 80, 78, 71, 13, 10, 26, 10]"

msgid "Similarly, a zero byte must be expressed using an escape sequence (typically ``\\0`` or ``\\x00``)."
msgstr "به‌طور مشابه، یک بایت صفر باید با استفاده از یک دنباله خنثی‌سازی بیان شود (معمولاً ``\\0`` یا ``\\x00``)."

msgid "Raw string literals"
msgstr "مقادیر لفظی رشته خام"

msgid "Both string and bytes literals may optionally be prefixed with a letter '``r``' or '``R``'; such constructs are called :dfn:`raw string literals` and :dfn:`raw bytes literals` respectively and treat backslashes as literal characters. As a result, in raw string literals, :ref:`escape sequences <escape-sequences>` are not treated specially:"
msgstr "هم مقادیر لفظی رشته و هم مقادیر لفظی بایت می‌توانند به‌صورت اختیاری با حرف '``r``' یا '``R``' پیشوند بگیرند؛ به چنین ساختارهایی به‌ترتیب :dfn:`مقادیر لفظی رشته خام (raw string literals)` و :dfn:`مقادیر لفظی بایت خام (raw bytes literals)` گفته می‌شود و آن‌ها بک‌اسلش‌ها را به‌عنوان نویسه‌های لفظی در نظر می‌گیرند. در نتیجه، در مقادیر لفظی رشته خام، :ref:`دنباله‌های خنثی‌سازی <escape-sequences>` به‌صورت ویژه پردازش نمی‌شوند:"

msgid ""
">>> r'\\d{4}-\\d{2}-\\d{2}'\n"
"'\\\\d{4}-\\\\d{2}-\\\\d{2}'"
msgstr ""
">>> r'\\d{4}-\\d{2}-\\d{2}'\n"
"'\\\\d{4}-\\\\d{2}-\\\\d{2}'"

msgid "Even in a raw literal, quotes can be escaped with a backslash, but the backslash remains in the result; for example, ``r\"\\\"\"`` is a valid string literal consisting of two characters: a backslash and a double quote; ``r\"\\\"`` is not a valid string literal (even a raw string cannot end in an odd number of backslashes).  Specifically, *a raw literal cannot end in a single backslash* (since the backslash would escape the following quote character).  Note also that a single backslash followed by a newline is interpreted as those two characters as part of the literal, *not* as a line continuation."
msgstr "حتی در یک لفظی خام، می‌توان علامت‌های نقل‌قول را با بک‌اسلش خنثی کرد، اما بک‌اسلش در نتیجه باقی می‌ماند؛ برای مثال، ``r\"\\\"\"`` یک لفظی رشته‌ی معتبر است که از دو نویسه تشکیل شده است: یک بک‌اسلش و یک علامت نقل‌قول دوتایی؛ ``r\"\\\"`` یک لفظی رشته‌ی معتبر نیست (حتی یک رشته‌ی خام نمی‌تواند با تعداد فردی از بک‌اسلش‌ها تمام شود). به‌طور مشخص، *یک لفظی خام نمی‌تواند با یک بک‌اسلش تمام شود* (زیرا بک‌اسلش، نویسه‌ی نقل‌قول بعدی را خنثی می‌کند). همچنین توجه داشته باشید که یک بک‌اسلش تنها که پس از آن یک نویسه‌ی خط جدید باشد، به‌عنوان همان دو نویسه و بخشی از لفظی تفسیر می‌شود، *نه* به‌عنوان ادامه‌ی خط."

msgid "f-strings"
msgstr "اف‌استرینگ‌ها"

msgid "The :keyword:`await` and :keyword:`async for` can be used in expressions within f-strings."
msgstr "می‌توان از :keyword:`await` و :keyword:`async for` در عبارت‌های درون اف‌استرینگ‌ها استفاده کرد."

msgid "Added the debug specifier (``=``)"
msgstr "مشخص‌کننده اشکال‌زدایی (``=``) افزوده شد."

msgid "Many restrictions on expressions within f-strings have been removed. Notably, nested strings, comments, and backslashes are now permitted."
msgstr "بسیاری از محدودیت‌های مربوط به عبارت‌های درون اف‌استرینگ‌ها برداشته شده‌اند. به‌ویژه، رشته‌های تودرتو، کامنت‌ها و بک‌اسلش‌ها اکنون مجاز هستند."

msgid "A :dfn:`formatted string literal` or :dfn:`f-string` is a string literal that is prefixed with '``f``' or '``F``'. Unlike other string literals, f-strings do not have a constant value. They may contain *replacement fields* delimited by curly braces ``{}``. Replacement fields contain expressions which are evaluated at run time. For example::"
msgstr "یک :dfn:`لفظی رشته قالب‌بندی‌شده (formatted string literal)` یا :dfn:`اف‌استرینگ (f-string)`، لفظی رشته‌ای است که با '``f``' یا '``F``' پیشوند دارد. برخلاف سایر مقادیر لفظی رشته، اف‌استرینگ‌ها مقدار ثابت ندارند. آن‌ها ممکن است حاوی *فیلدهای جایگزینی* باشند که با آکولاد ``{}`` محصور شده‌اند. فیلدهای جایگزینی حاوی عبارت‌هایی هستند که در ران‌تایم ارزیابی می‌شوند. برای مثال::"

msgid ""
">>> who = 'nobody'\n"
">>> nationality = 'Spanish'\n"
">>> f'{who.title()} expects the {nationality} Inquisition!'\n"
"'Nobody expects the Spanish Inquisition!'"
msgstr ""
">>> who = 'nobody'\n"
">>> nationality = 'Spanish'\n"
">>> f'{who.title()} expects the {nationality} Inquisition!'\n"
"'Nobody expects the Spanish Inquisition!'"

msgid "Any doubled curly braces (``{{`` or ``}}``) outside replacement fields are replaced with the corresponding single curly brace::"
msgstr "هر کمانک دوتایی (``{{`` یا ``}}``) خارج از فیلدهای جایگزینی، با کمانک تکی متناظر جایگزین می‌شود::"

msgid ""
">>> print(f'{{...}}')\n"
"{...}"
msgstr ""
">>> print(f'{{...}}')\n"
"{...}"

msgid "Other characters outside replacement fields are treated like in ordinary string literals. This means that escape sequences are decoded (except when a literal is also marked as a raw string), and newlines are possible in triple-quoted f-strings::"
msgstr "سایر نویسه‌های خارج از فیلدهای جایگزینی مانند لیترال‌های رشته‌ای معمولی رفتار می‌شوند. این بدان معنا است که دنباله‌های خنثی‌سازی کدگشایی می‌شوند (مگر وقتی که یک لیتِرال نیز به‌عنوان رشته خام علامت‌گذاری شده باشد) و امکان استفاده از سطرهای جدید در اف‌استرینگ‌های با سه علامت نقل‌قول وجود دارد::"

msgid ""
">>> name = 'Galahad'\n"
">>> favorite_color = 'blue'\n"
">>> print(f'{name}:\\t{favorite_color}')\n"
"Galahad:       blue\n"
">>> print(rf\"C:\\Users\\{name}\")\n"
"C:\\Users\\Galahad\n"
">>> print(f'''Three shall be the number of the counting\n"
"... and the number of the counting shall be three.''')\n"
"Three shall be the number of the counting\n"
"and the number of the counting shall be three."
msgstr ""
">>> name = 'Galahad'\n"
">>> favorite_color = 'blue'\n"
">>> print(f'{name}:\\t{favorite_color}')\n"
"Galahad:       blue\n"
">>> print(rf\"C:\\Users\\{name}\")\n"
"C:\\Users\\Galahad\n"
">>> print(f'''Three shall be the number of the counting\n"
"... and the number of the counting shall be three.''')\n"
"Three shall be the number of the counting\n"
"and the number of the counting shall be three."

msgid "Expressions in formatted string literals are treated like regular Python expressions. Each expression is evaluated in the context where the formatted string literal appears, in order from left to right. An empty expression is not allowed, and both :keyword:`lambda` and assignment expressions ``:=`` must be surrounded by explicit parentheses::"
msgstr "عبارات در رشته‌های قالب‌بندی‌شده مانند عبارات معمولی پایتون رفتار می‌شوند. هر عبارت در زمینه‌ای که رشته قالب‌بندی‌شده در آن ظاهر می‌شود، به ترتیب از چپ به راست ارزیابی می‌شود. عبارت خالی مجاز نیست، و هر دو عبارت :keyword:`lambda` و عبارت‌های انتساب ``:=`` باید در پرانتزهای صریح قرار گیرند::"

msgid ""
">>> f'{(half := 1/2)}, {half * 42}'\n"
"'0.5, 21.0'"
msgstr ""
">>> f'{(half := 1/2)}, {half * 42}'\n"
"'0.5, 21.0'"

msgid "Reusing the outer f-string quoting type inside a replacement field is permitted::"
msgstr "استفاده‌ی مجدد از نوع علامت نقل‌قول اف‌استرینگ بیرونی در داخل یک فیلد جایگزینی (replacement field) مجاز است::"

msgid ""
">>> a = dict(x=2)\n"
">>> f\"abc {a[\"x\"]} def\"\n"
"'abc 2 def'"
msgstr ""
">>> a = dict(x=2)\n"
">>> f\"abc {a[\"x\"]} def\"\n"
"'abc 2 def'"

msgid "Backslashes are also allowed in replacement fields and are evaluated the same way as in any other context::"
msgstr "بک‌اسلش‌ها نیز در فیلدهای جایگزینی مجاز هستند و به همان شیوه‌ی هر زمینه‌ی دیگری ارزیابی می‌شوند::"

msgid ""
">>> a = [\"a\", \"b\", \"c\"]\n"
">>> print(f\"List a contains:\\n{\"\\n\".join(a)}\")\n"
"List a contains:\n"
"a\n"
"b\n"
"c"
msgstr ""
">>> a = [\"a\", \"b\", \"c\"]\n"
">>> print(f\"List a contains:\\n{\"\\n\".join(a)}\")\n"
"List a contains:\n"
"a\n"
"b\n"
"c"

msgid "It is possible to nest f-strings::"
msgstr "می‌توان اف‌استرینگ‌ها را تودرتو کرد::"

msgid ""
">>> name = 'world'\n"
">>> f'Repeated:{f' hello {name}' * 3}'\n"
"'Repeated: hello world hello world hello world'"
msgstr ""
">>> name = 'world'\n"
">>> f'Repeated:{f' hello {name}' * 3}'\n"
"'Repeated: hello world hello world hello world'"

msgid "Portable Python programs should not use more than 5 levels of nesting."
msgstr "برنامه‌های پایتون قابل‌حمل نباید از بیش از ۵ سطح تودرتویی استفاده کنند."

msgid "CPython does not limit nesting of f-strings."
msgstr "CPython تودرتوی اف‌استرینگ‌ها را محدود نمی‌کند."

msgid "Replacement expressions can contain newlines in both single-quoted and triple-quoted f-strings and they can contain comments. Everything that comes after a ``#`` inside a replacement field is a comment (even closing braces and quotes). This means that replacement fields with comments must be closed in a different line:"
msgstr "عبارت‌های جایگزینی می‌توانند در هر دو نوع اف‌استرینگ با یک علامت نقل‌قول و با سه علامت نقل‌قول شامل سطرهای جدید باشند و همچنین می‌توانند شامل کامنت باشند. هر چیزی که پس از ``#`` درون یک فیلد جایگزینی بیاید، یک کامنت است (حتی آکولادهای بسته و علامت‌های نقل‌قول). این بدان معناست که فیلدهای جایگزینی دارای کامنت باید در خط دیگری بسته شوند:"

msgid ""
">>> a = 2\n"
">>> f\"abc{a  # This comment  }\"  continues until the end of the line\n"
"...       + 3}\"\n"
"'abc5'"
msgstr ""
">>> a = 2\n"
">>> f\"abc{a  # This comment  }\"  continues until the end of the line\n"
"...       + 3}\"\n"
"'abc5'"

msgid "After the expression, replacement fields may optionally contain:"
msgstr "پس از عبارت، فیلدهای جایگزینی می‌توانند به‌اختیار شامل موارد زیر باشند:"

msgid "a *debug specifier* -- an equal sign (``=``), optionally surrounded by whitespace on one or both sides;"
msgstr "یک *مشخص‌کننده اشکال‌زدایی* -- یک علامت تساوی (``=``)، که به‌صورت اختیاری در یک یا هر دو طرف با فضای سفید احاطه شده است؛"

msgid "a *conversion specifier* -- ``!s``, ``!r`` or ``!a``; and/or"
msgstr "یک *مشخص‌کننده تبدیل* -- ``!s``، ``!r`` یا ``!a``؛ و/یا"

msgid "a *format specifier* prefixed with a colon (``:``)."
msgstr "یک *مشخص‌کننده قالب* که با یک دونقطه (``:``) پیشوند داده شده است."

msgid "See the :ref:`Standard Library section on f-strings <stdtypes-fstrings>` for details on how these fields are evaluated."
msgstr "برای جزئیات درباره چگونگی ارزیابی این فیلدها، :ref:`بخش کتابخانه استاندارد درباره اف‌استرینگ‌ها <stdtypes-fstrings>` را ببینید."

msgid "As that section explains, *format specifiers* are passed as the second argument to the :func:`format` function to format a replacement field value. For example, they can be used to specify a field width and padding characters using the :ref:`Format Specification Mini-Language <formatspec>`::"
msgstr "همان‌طور که آن بخش توضیح می‌دهد، *مشخص‌کننده‌های قالب‌بندی* به‌عنوان دومین آرگومان به تابع :func:`format` ارسال می‌شوند تا مقدار یک فیلد جایگزینی را قالب‌بندی کنند. برای مثال، می‌توان از آن‌ها برای مشخص کردن عرض فیلد و نویسه‌های پرکننده با استفاده از :ref:`زبان کوچک مشخصات قالب‌بندی <formatspec>` استفاده کرد::"

msgid ""
">>> number = 14.3\n"
">>> f'{number:20.7f}'\n"
"'          14.3000000'"
msgstr ""
">>> number = 14.3\n"
">>> f'{number:20.7f}'\n"
"'          14.3000000'"

msgid "Top-level format specifiers may include nested replacement fields::"
msgstr "مشخص‌کننده‌های قالب سطح بالا ممکن است شامل فیلدهای جایگزینی تودرتو باشند::"

msgid ""
">>> field_size = 20\n"
">>> precision = 7\n"
">>> f'{number:{field_size}.{precision}f}'\n"
"'          14.3000000'"
msgstr ""
">>> field_size = 20\n"
">>> precision = 7\n"
">>> f'{number:{field_size}.{precision}f}'\n"
"'          14.3000000'"

msgid "These nested fields may include their own conversion fields and :ref:`format specifiers <formatspec>`::"
msgstr "این فیلدهای تودرتو ممکن است شامل فیلدهای تبدیل و :ref:`مشخص‌کننده‌های قالب <formatspec>` خود باشند::"

msgid ""
">>> number = 3\n"
">>> f'{number:{field_size}}'\n"
"'                   3'\n"
">>> f'{number:{field_size:05}}'\n"
"'00000000000000000003'"
msgstr ""
">>> number = 3\n"
">>> f'{number:{field_size}}'\n"
"'                   3'\n"
">>> f'{number:{field_size:05}}'\n"
"'00000000000000000003'"

msgid "However, these nested fields may not include more deeply nested replacement fields."
msgstr "با این حال، این فیلدهای تودرتو نمی‌توانند شامل فیلدهای جایگزینی با تودرتویی عمیق‌تر باشند."

msgid "Formatted string literals cannot be used as :term:`docstrings <docstring>`, even if they do not include expressions::"
msgstr "مقادیر لفظی رشته قالب‌بندی‌شده را نمی‌توان به‌عنوان :term:`رشته مستند <docstring>` استفاده کرد، حتی اگر شامل عبارت نباشند::"

msgid ""
">>> def foo():\n"
"...     f\"Not a docstring\"\n"
"...\n"
">>> print(foo.__doc__)\n"
"None"
msgstr ""
">>> def foo():\n"
"...     f\"Not a docstring\"\n"
"...\n"
">>> print(foo.__doc__)\n"
"None"

msgid ":pep:`498` -- Literal String Interpolation"
msgstr ":pep:`498` -- درون‌یابی رشته‌ی لفظی"

msgid ":pep:`701` -- Syntactic formalization of f-strings"
msgstr ":pep:`701` -- رسمی‌سازی سینتکسی اف‌استرینگ‌ها"

msgid ":meth:`str.format`, which uses a related format string mechanism."
msgstr ":meth:`str.format`، که از سازوکار رشته‌ی قالب‌بندی مرتبط استفاده می‌کند."

msgid "t-strings"
msgstr "تی‌استرینگ‌ها (t-strings)"

msgid "A :dfn:`template string literal` or :dfn:`t-string` is a string literal that is prefixed with '``t``' or '``T``'. These strings follow the same syntax rules as :ref:`formatted string literals <f-strings>`. For differences in evaluation rules, see the :ref:`Standard Library section on t-strings <stdtypes-tstrings>`"
msgstr ":dfn:`رشته‌ی الگو (template string literal)` یا :dfn:`تی‌استرینگ (t-string)` یک رشته‌ی لفظی (string literal) است که با '``t``' یا '``T``' پیشوند داده‌شده است. این رشته‌ها از همان قواعد نحوی :ref:`رشته‌های قالب‌بندی‌شده <f-strings>` پیروی می‌کنند. برای تفاوت‌ها در قواعد ارزیابی، :ref:`بخش کتابخانه‌ی استاندارد درباره‌ی تی‌استرینگ‌ها <stdtypes-tstrings>` را ببینید"

msgid "Formal grammar for f-strings"
msgstr "دستور زبان رسمی برای اف‌استرینگ‌ها"

msgid "F-strings are handled partly by the :term:`lexical analyzer`, which produces the tokens :py:data:`~token.FSTRING_START`, :py:data:`~token.FSTRING_MIDDLE` and :py:data:`~token.FSTRING_END`, and partly by the parser, which handles expressions in the replacement field. The exact way the work is split is a CPython implementation detail."
msgstr "اف‌استرینگ‌ها تا حدی توسط تحلیل‌گر واژگانی (:term:`lexical analyzer`) پردازش می‌شوند که توکن‌های :py:data:`~token.FSTRING_START`، :py:data:`~token.FSTRING_MIDDLE` و :py:data:`~token.FSTRING_END` را تولید می‌کند، و تا حدی توسط پارسر که عبارت‌های درون فیلد جایگزینی را پردازش می‌کند. روش دقیق تقسیم این کار، جزئیاتی از پیاده‌سازی CPython است."

msgid "Correspondingly, the f-string grammar is a mix of :ref:`lexical and syntactic definitions <notation-lexical-vs-syntactic>`."
msgstr "به‌طور متناظر، گرامر اف‌استرینگ ترکیبی از :ref:`تعاریف واژگانی و نحوی <notation-lexical-vs-syntactic>` است."

msgid "Whitespace is significant in these situations:"
msgstr "فضای سفید در این موقعیت‌ها اهمیت دارد:"

msgid "There may be no whitespace in :py:data:`~token.FSTRING_START` (between the prefix and quote)."
msgstr "در :py:data:`~token.FSTRING_START` نباید هیچ فضای سفیدی وجود داشته باشد (بین پیشوند و علامت نقل‌قول)."

msgid "Whitespace in :py:data:`~token.FSTRING_MIDDLE` is part of the literal string contents."
msgstr "فضای سفید در :py:data:`~token.FSTRING_MIDDLE` بخشی از محتوای رشته‌ی لفظی است."

msgid "In ``fstring_replacement_field``, if ``f_debug_specifier`` is present, all whitespace after the opening brace until the ``f_debug_specifier``, as well as whitespace immediately following ``f_debug_specifier``, is retained as part of the expression."
msgstr "در ``fstring_replacement_field``، اگر ``f_debug_specifier`` وجود داشته باشد، تمام فضای سفید پس از آکولاد باز تا ``f_debug_specifier``، و همچنین فضای سفید بلافاصله پس از ``f_debug_specifier``، به‌عنوان بخشی از عبارت حفظ می‌شود."

msgid "The expression is not handled in the tokenization phase; it is retrieved from the source code using locations of the ``{`` token and the token after ``=``."
msgstr "عبارت در مرحله‌ی توکن‌بندی (tokenization) پردازش نمی‌شود؛ بلکه با استفاده از موقعیت‌های توکن ``{`` و توکن بعد از ``=`` از کد منبع بازیابی می‌شود."

msgid "The ``FSTRING_MIDDLE`` definition uses :ref:`negative lookaheads <lexical-lookaheads>` (``!``) to indicate special characters (backslash, newline, ``{``, ``}``) and sequences (``f_quote``)."
msgstr "تعریف ``FSTRING_MIDDLE`` از :ref:`پیش‌نگری‌های منفی (negative lookaheads) <lexical-lookaheads>` (``!``) برای مشخص کردن نویسه‌های خاص (بک‌اسلش، خط جدید، ``{``، ``}``) و دنباله‌ها (``f_quote``) استفاده می‌کند."

msgid "In the above grammar snippet, the ``f_quote`` and ``FSTRING_MIDDLE`` rules are context-sensitive -- they depend on the contents of ``FSTRING_START`` of the nearest enclosing ``fstring``."
msgstr "در قطعه دستور زبان بالا، قواعد ``f_quote`` و ``FSTRING_MIDDLE`` حساس به زمینه هستند — این قواعد به محتویات ``FSTRING_START`` در نزدیک‌ترین ``fstring`` دربرگیرنده بستگی دارند."

msgid "Constructing a more traditional formal grammar from this template is left as an exercise for the reader."
msgstr "ساخت یک دستور زبان صوری سنتی‌تر از این قالب، به‌عنوان تمرینی برای خواننده باقی می‌ماند."

msgid "The grammar for t-strings is identical to the one for f-strings, with *t* instead of *f* at the beginning of rule and token names and in the prefix."
msgstr "دستور زبان تی‌استرینگ‌ها با دستور زبان اف‌استرینگ‌ها یکسان است، با این تفاوت که *t* به‌جای *f* در ابتدای نام قواعد و توکن‌ها و در پیشوند قرار می‌گیرد."

msgid "Numeric literals"
msgstr "مقادیر لفظی عددی"

msgid ":data:`~token.NUMBER` tokens represent numeric literals, of which there are three types: integers, floating-point numbers, and imaginary numbers."
msgstr "توکن‌های :data:`~token.NUMBER` نشان‌دهنده‌ی لفظ‌های عددی هستند که سه نوع دارند: اعداد صحیح، اعداد ممیز شناور و اعداد موهومی."

msgid "The numeric value of a numeric literal is the same as if it were passed as a string to the :class:`int`, :class:`float` or :class:`complex` class constructor, respectively. Note that not all valid inputs for those constructors are also valid literals."
msgstr "مقدار عددی یک لفظی عددی (numeric literal) همان مقداری است که گویی آن لفظی به‌صورت یک رشته به سازنده‌ی کلاس :class:`int`، :class:`float` یا :class:`complex`، به‌ترتیب، ارسال شود. توجه داشته باشید که همه‌ی ورودی‌های معتبر برای آن سازنده‌ها، مقادیر لفظی معتبر نیز نیستند."

msgid "Numeric literals do not include a sign; a phrase like ``-1`` is actually an expression composed of the unary operator '``-``' and the literal ``1``."
msgstr "اعداد لفظی شامل علامت نمی‌شوند؛ عبارتی مانند ``-1`` در واقع عبارتی است که از عملگر یک‌عملوندی '``-``' و لفظ ``1`` تشکیل‌شده است."

msgid "Integer literals"
msgstr "مقادیر لفظی عدد صحیح"

msgid "Integer literals denote whole numbers. For example::"
msgstr "مقادیر لفظی عدد صحیح، اعداد حسابی را نشان می‌دهند. برای مثال::"

msgid ""
"7\n"
"3\n"
"2147483647"
msgstr ""
"7\n"
"3\n"
"2147483647"

msgid "There is no limit for the length of integer literals apart from what can be stored in available memory::"
msgstr "هیچ محدودیتی برای طول مقادیر لفظی عدد صحیح وجود ندارد، مگر آنچه می‌تواند در حافظه‌ی موجود ذخیره شود::"

msgid "7922816251426433759354395033679228162514264337593543950336"
msgstr "7922816251426433759354395033679228162514264337593543950336"

msgid "Underscores can be used to group digits for enhanced readability, and are ignored for determining the numeric value of the literal. For example, the following literals are equivalent::"
msgstr "می‌توان از زیرسطرها برای گروه‌بندی ارقام جهت خوانایی بهتر استفاده کرد، و آن‌ها هنگام تعیین مقدار عددی لفظی نادیده گرفته می‌شوند. برای مثال، مقادیر لفظی زیر معادل هستند::"

msgid ""
"100_000_000_000\n"
"100000000000\n"
"1_00_00_00_00_000"
msgstr ""
"100_000_000_000\n"
"100000000000\n"
"1_00_00_00_00_000"

msgid "Underscores can only occur between digits. For example, ``_123``, ``321_``, and ``123__321`` are *not* valid literals."
msgstr "زیرسطرها فقط می‌توانند بین ارقام قرار بگیرند. برای مثال، ``_123``، ``321_`` و ``123__321`` مقادیر لفظی معتبر *نیستند*."

msgid "Integers can be specified in binary (base 2), octal (base 8), or hexadecimal (base 16) using the prefixes ``0b``, ``0o`` and ``0x``, respectively. Hexadecimal digits 10 through 15 are represented by letters ``A``-``F``, case-insensitive.  For example::"
msgstr "می‌توان اعداد صحیح را به‌ترتیب با پیشوندهای ``0b``، ``0o`` و ``0x`` در مبنای ۲ (دودویی)، مبنای ۸ (هشت‌هشتی) یا مبنای شانزده (مبنای ۱۶) مشخص کرد. ارقام ۱۰ تا ۱۵ مبنای شانزده با حروف ``A``-``F`` و بدون حساسیت به بزرگی و کوچکی حروف نمایش داده می‌شوند. برای مثال::"

msgid ""
"0b100110111\n"
"0b_1110_0101\n"
"0o177\n"
"0o377\n"
"0xdeadbeef\n"
"0xDead_Beef"
msgstr ""
"0b100110111\n"
"0b_1110_0101\n"
"0o177\n"
"0o377\n"
"0xdeadbeef\n"
"0xDead_Beef"

msgid "An underscore can follow the base specifier. For example, ``0x_1f`` is a valid literal, but ``0_x1f`` and ``0x__1f`` are not."
msgstr "یک زیرخط می‌تواند پس از مشخص‌کننده‌ی مبنا بیاید. برای مثال، ``0x_1f`` یک لفظی معتبر است، اما ``0_x1f`` و ``0x__1f`` معتبر نیستند."

msgid "Leading zeros in a non-zero decimal number are not allowed. For example, ``0123`` is not a valid literal. This is for disambiguation with C-style octal literals, which Python used before version 3.0."
msgstr "صفرهای آغازین در یک عدد دهدهی غیرصفر مجاز نیستند. برای مثال، ``0123`` یک لفظ معتبر نیست. این برای تمایز از لفظ‌های مبنای هشت به‌سبک C است، که پایتون پیش از نسخه 3.0 از آن‌ها استفاده می‌کرد."

msgid "Formally, integer literals are described by the following lexical definitions:"
msgstr "به‌طور رسمی، مقادیر لفظی عدد صحیح با تعاریف واژگانی زیر توصیف می‌شوند:"

msgid "Underscores are now allowed for grouping purposes in literals."
msgstr "اکنون استفاده از زیرسطرها برای اهداف گروه‌بندی در مقادیر لفظی مجاز است."

msgid "Floating-point literals"
msgstr "مقادیر لفظی ممیز شناور"

msgid "Floating-point (float) literals, such as ``3.14`` or ``1.5``, denote :ref:`approximations of real numbers <datamodel-float>`."
msgstr "مقادیر لفظی ممیز شناور (float)، مانند ``3.14`` یا ``1.5``، بیانگر :ref:`تقریب‌هایی از اعداد حقیقی <datamodel-float>` هستند."

msgid "They consist of *integer* and *fraction* parts, each composed of decimal digits. The parts are separated by a decimal point, ``.``::"
msgstr "آن‌ها از بخش‌های *صحیح* و *کسری* تشکیل شده‌اند که هر یک از ارقام دهدهی ساخته شده است. این بخش‌ها با یک نقطه‌ی اعشار، ``.``، از هم جدا می‌شوند::"

msgid ""
"2.71828\n"
"4.0"
msgstr ""
"2.71828\n"
"4.0"

msgid "Unlike in integer literals, leading zeros are allowed. For example, ``077.010`` is legal, and denotes the same number as ``77.01``."
msgstr "برخلاف مقادیر لفظی عدد صحیح، صفرهای پیشرو مجاز هستند. برای مثال، ``077.010`` معتبر است و همان عدد ``77.01`` را نشان می‌دهد."

msgid "As in integer literals, single underscores may occur between digits to help readability::"
msgstr "مانند مقادیر لفظی عدد صحیح، زیرسطرهای تکی می‌توانند بین ارقام قرار بگیرند تا خوانایی را بهبود بخشند::"

msgid ""
"96_485.332_123\n"
"3.14_15_93"
msgstr ""
"96_485.332_123\n"
"3.14_15_93"

msgid "Either of these parts, but not both, can be empty. For example::"
msgstr "هر یک از این بخش‌ها می‌تواند خالی باشد، اما نه هر دو. برای مثال::"

msgid ""
"10.  # (equivalent to 10.0)\n"
".001  # (equivalent to 0.001)"
msgstr ""
"10.  # (equivalent to 10.0)\n"
".001  # (equivalent to 0.001)"

msgid "Optionally, the integer and fraction may be followed by an *exponent*: the letter ``e`` or ``E``, followed by an optional sign, ``+`` or ``-``, and a number in the same format as the integer and fraction parts. The ``e`` or ``E`` represents \"times ten raised to the power of\"::"
msgstr "به‌صورت اختیاری، ممکن است پس از بخش عدد صحیح و بخش کسری یک *توان* بیاید: حرف ``e`` یا ``E``، به دنبال آن یک علامت اختیاری، ``+`` یا ``-``، و عددی با همان قالب بخش‌های عدد صحیح و کسری. ``e`` یا ``E`` به معنای «ضرب در ده به توانِ» است::"

msgid ""
"1.0e3  # (represents 1.0×10³, or 1000.0)\n"
"1.166e-5  # (represents 1.166×10⁻⁵, or 0.00001166)\n"
"6.02214076e+23  # (represents 6.02214076×10²³, or 602214076000000000000000.)"
msgstr ""
"1.0e3  # (represents 1.0×10³, or 1000.0)\n"
"1.166e-5  # (represents 1.166×10⁻⁵, or 0.00001166)\n"
"6.02214076e+23  # (represents 6.02214076×10²³, or 602214076000000000000000.)"

msgid "In floats with only integer and exponent parts, the decimal point may be omitted::"
msgstr "در اعداد اعشاریی که فقط بخش عدد صحیح و بخش توان دارند، می‌توان نقطه اعشار را حذف کرد::"

msgid ""
"1e3  # (equivalent to 1.e3 and 1.0e3)\n"
"0e0  # (equivalent to 0.)"
msgstr ""
"1e3  # (equivalent to 1.e3 and 1.0e3)\n"
"0e0  # (equivalent to 0.)"

msgid "Formally, floating-point literals are described by the following lexical definitions:"
msgstr "به‌طور رسمی، مقادیر لفظی ممیز شناور با تعاریف واژگانی زیر توصیف می‌شوند:"

msgid "Imaginary literals"
msgstr "مقادیر لفظی موهومی"

msgid "Python has :ref:`complex number <typesnumeric>` objects, but no complex literals. Instead, *imaginary literals* denote complex numbers with a zero real part."
msgstr "پایتون اشیای :ref:`عدد مختلط <typesnumeric>` دارد، اما هیچ لفظی مختلطی ندارد. در عوض، *مقادیر لفظی موهومی* نشان‌دهنده‌ی اعداد مختلط با بخش حقیقی صفر هستند."

msgid "For example, in math, the complex number 3+4.2\\ *i* is written as the real number 3 added to the imaginary number 4.2\\ *i*. Python uses a similar syntax, except the imaginary unit is written as ``j`` rather than *i*::"
msgstr "برای مثال، در ریاضیات، عدد مختلط 3+4.2\\ *i* به‌صورت جمع عدد حقیقی 3 با عدد موهومی 4.2\\ *i* نوشته می‌شود. پایتون از سینتکس مشابهی استفاده می‌کند، با این تفاوت که واحد موهومی به‌جای *i* به‌صورت ``j`` نوشته می‌شود::"

msgid "3+4.2j"
msgstr "3+4.2j"

msgid "This is an expression composed of the :ref:`integer literal <integers>` ``3``, the :ref:`operator <operators>` '``+``', and the :ref:`imaginary literal <imaginary>` ``4.2j``. Since these are three separate tokens, whitespace is allowed between them::"
msgstr "این یک عبارت تشکیل‌شده از :ref:`لفظی عدد صحیح <integers>` ``3``، :ref:`عملگر <operators>` '``+``'، و :ref:`لفظی موهومی <imaginary>` ``4.2j`` است. از آن‌جا که این‌ها سه توکن جداگانه هستند، فضای خالی بین آن‌ها مجاز است::"

msgid "3 + 4.2j"
msgstr "3 + 4.2j"

msgid "No whitespace is allowed *within* each token. In particular, the ``j`` suffix, may not be separated from the number before it."
msgstr "هیچ فضای سفیدی در *درون* هر توکن مجاز نیست. به‌ویژه، پسوند ``j`` نمی‌تواند از عدد پیش از خود جدا شود."

msgid "The number before the ``j`` has the same syntax as a floating-point literal. Thus, the following are valid imaginary literals::"
msgstr "عدد پیش از ``j`` همان سینتکس یک لفظی ممیز شناور را دارد. بنابراین، موارد زیر مقادیر لفظی موهومی معتبر هستند::"

msgid ""
"4.2j\n"
"3.14j\n"
"10.j\n"
".001j\n"
"1e100j\n"
"3.14e-10j\n"
"3.14_15_93j"
msgstr ""
"4.2j\n"
"3.14j\n"
"10.j\n"
".001j\n"
"1e100j\n"
"3.14e-10j\n"
"3.14_15_93j"

msgid "Unlike in a floating-point literal the decimal point can be omitted if the imaginary number only has an integer part. The number is still evaluated as a floating-point number, not an integer::"
msgstr "برخلاف یک لفظی ممیز شناور، اگر عدد موهومی فقط بخش صحیح داشته باشد، می‌توان نقطه اعشار را حذف کرد. این عدد همچنان به‌عنوان یک عدد ممیز شناور ارزیابی می‌شود، نه یک عدد صحیح::"

msgid ""
"10j\n"
"0j\n"
"1000000000000000000000000j   # equivalent to 1e+24j"
msgstr ""
"10j\n"
"0j\n"
"1000000000000000000000000j   # equivalent to 1e+24j"

msgid "The ``j`` suffix is case-insensitive. That means you can use ``J`` instead::"
msgstr "پسوند ``j`` به بزرگی و کوچکی حروف حساس نیست. این بدان معناست که می‌توانید به جای آن از ``J`` استفاده کنید::"

msgid "3.14J   # equivalent to 3.14j"
msgstr "3.14J   # equivalent to 3.14j"

msgid "Formally, imaginary literals are described by the following lexical definition:"
msgstr "به‌طور رسمی، مقادیر لفظی موهومی با تعریف واژگانی زیر توصیف می‌شوند:"

msgid "Operators and delimiters"
msgstr "عملگرها و جداکننده‌ها"

msgid "The following grammar defines :dfn:`operator` and :dfn:`delimiter` tokens, that is, the generic :data:`~token.OP` token type. A :ref:`list of these tokens and their names <token_operators_delimiters>` is also available in the :mod:`!token` module documentation."
msgstr "دستور زبان زیر توکن‌های :dfn:`عملگر (operator)` و :dfn:`جداکننده (delimiter)` را تعریف می‌کند، یعنی نوع توکن عام :data:`~token.OP`. :ref:`فهرستی از این توکن‌ها و نام‌های آن‌ها <token_operators_delimiters>` نیز در مستندات ماژول :mod:`!token` در دسترس است."

msgid "Generally, *operators* are used to combine :ref:`expressions <expressions>`, while *delimiters* serve other purposes. However, there is no clear, formal distinction between the two categories."
msgstr "به‌طور کلی، *عملگرها* برای ترکیب :ref:`عبارت‌ها <expressions>` به کار می‌روند، در حالی که *جداکننده‌ها* کاربردهای دیگری دارند. با این حال، تمایز روشن و رسمی میان این دو دسته وجود ندارد."

msgid "Some tokens can serve as either operators or delimiters, depending on usage. For example, ``*`` is both the multiplication operator and a delimiter used for sequence unpacking, and ``@`` is both the matrix multiplication and a delimiter that introduces decorators."
msgstr "برخی توکن‌ها می‌توانند بسته به کاربرد، به‌عنوان عملگر یا جداکننده به کار روند. برای مثال، ``*`` هم عملگر ضرب است و هم جداکننده‌ای که برای واگشایی دنباله به کار می‌رود، و ``@`` هم عملگر ضرب ماتریسی است و هم جداکننده‌ای که دکوراتورها را معرفی می‌کند."

msgid "For some tokens, the distinction is unclear. For example, some people consider ``.``, ``(``, and ``)`` to be delimiters, while others see the :py:func:`getattr` operator and the function call operator(s)."
msgstr "برای برخی توکن‌ها، این تمایز نامشخص است. برای مثال، برخی افراد ``.``، ``(`` و ``)`` را جداکننده می‌دانند، در حالی که برخی دیگر آن‌ها را عملگر :py:func:`getattr` و عملگر(های) فراخوانی تابع می‌دانند."

msgid "Some of Python's operators, like ``and``, ``or``, and ``not in``, use :ref:`keyword <keywords>` tokens rather than \"symbols\" (operator tokens)."
msgstr "برخی از عملگرهای پایتون، مانند ``and``، ``or`` و ``not in``، به‌جای «نمادها» (توکن‌های عملگر) از توکن‌های :ref:`کلیدواژه <keywords>` استفاده می‌کنند."

msgid "A sequence of three consecutive periods (``...``) has a special meaning as an :py:data:`Ellipsis` literal."
msgstr "دنباله‌ای از سه نقطه‌ی متوالی (``...``) به‌عنوان یک لفظی :py:data:`Ellipsis` معنای ویژه‌ای دارد."

msgid "lexical analysis"
msgstr "تحلیل واژگانی"

msgid "parser"
msgstr "پارسر"

msgid "token"
msgstr "توکن"

msgid "line structure"
msgstr "ساختار خط"

msgid "logical line"
msgstr "خط منطقی"

msgid "physical line"
msgstr "خط فیزیکی"

msgid "line joining"
msgstr "پیوند سطرهای"

msgid "NEWLINE token"
msgstr "توکن NEWLINE"

msgid "comment"
msgstr "کامنت"

msgid "hash character"
msgstr "نویسه‌ی #"

msgid "# (hash)"
msgstr "# (هش)"

msgid "source character set"
msgstr "مجموعه نویسه‌های منبع"

msgid "encoding declarations (source file)"
msgstr "اعلامیه‌های کدگذاری (پرونده منبع)"

msgid "source encoding declaration"
msgstr "اعلامیه‌ی کدگذاری منبع"

msgid "line continuation"
msgstr "ادامه‌ی خط"

msgid "backslash character"
msgstr "نویسه‌ی بک‌اسلش"

msgid "blank line"
msgstr "خط خالی"

msgid "indentation"
msgstr "تورفتگی"

msgid "leading whitespace"
msgstr "فضای سفید ابتدایی"

msgid "grouping"
msgstr "گروه‌بندی"

msgid "statement grouping"
msgstr "گروه‌بندی دستورها"

msgid "INDENT token"
msgstr "توکن INDENT"

msgid "DEDENT token"
msgstr "توکن DEDENT"

msgid "identifier"
msgstr "شناسه"

msgid "name"
msgstr "نام"

msgid "keyword"
msgstr "کلیدواژه"

msgid "reserved word"
msgstr "واژه رزروشده"

msgid "soft keyword"
msgstr "کلیدواژه نرم"

msgid "_, identifiers"
msgstr "_، شناسه‌ها"

msgid "__, identifiers"
msgstr "__، شناسه‌ها"

msgid "literal"
msgstr "لفظی"

msgid "constant"
msgstr "ثابت"

msgid "string literal"
msgstr "رشته‌ی لفظی"

msgid "bytes literal"
msgstr "لفظی bytes"

msgid "ASCII"
msgstr "ASCII"

msgid "' (single quote)"
msgstr "' (علامت نقل‌قول تکی)"

msgid "\" (double quote)"
msgstr "\" (علامت نقل‌قول)"

msgid "triple-quoted string"
msgstr "رشته سه‌نقل‌قولی"

msgid "\"\"\""
msgstr "\"\"\""

msgid "'''"
msgstr "'''"

msgid "u'"
msgstr "u'"

msgid "u\""
msgstr "u\""

msgid "escape sequence"
msgstr "دنباله خنثی‌سازی"

msgid "Standard C"
msgstr "C استاندارد"

msgid "C"
msgstr "C"

msgid "\\ (backslash)"
msgstr "\\ (بک‌اسلش)"

msgid "\\\\"
msgstr "\\\\"

msgid "\\a"
msgstr "\\a"

msgid "\\b"
msgstr "\\b"

msgid "\\f"
msgstr "\\f"

msgid "\\n"
msgstr "\\n"

msgid "\\r"
msgstr "\\r"

msgid "\\t"
msgstr "\\t"

msgid "\\v"
msgstr "\\v"

msgid "\\x"
msgstr "\\x"

msgid "\\N"
msgstr "\\N"

msgid "\\u"
msgstr "\\u"

msgid "\\U"
msgstr "\\U"

msgid "unrecognized escape sequence"
msgstr "دنباله گریز ناشناخته"

msgid "b'"
msgstr "b'"

msgid "b\""
msgstr "b\""

msgid "r'"
msgstr "r'"

msgid "raw string literal"
msgstr "رشته‌ی لفظی خام"

msgid "r\""
msgstr "r\""

msgid "formatted string literal"
msgstr "لفظی رشته قالب‌بندی‌شده"

msgid "interpolated string literal"
msgstr "رشته‌ی لفظی درون‌یابی‌شده"

msgid "string"
msgstr "رشته"

msgid "formatted literal"
msgstr "لفظی قالب‌بندی‌شده"

msgid "interpolated literal"
msgstr "لفظی درون‌یابی‌شده (interpolated literal)"

msgid "f-string"
msgstr "اف‌استرینگ"

msgid "fstring"
msgstr "fstring"

msgid "f'"
msgstr "f'"

msgid "f\""
msgstr "f\""

msgid "{} (curly brackets)"
msgstr "{} (آکولاد)"

msgid "in formatted string literal"
msgstr "در رشته‌ی قالب‌بندی‌شده"

msgid "! (exclamation)"
msgstr "! (علامت تعجب)"

msgid ": (colon)"
msgstr ": (دونقطه)"

msgid "= (equals)"
msgstr "= (برابر)"

msgid "for help in debugging using string literals"
msgstr "برای کمک در اشکال‌زدایی با استفاده از مقادیر لفظی رشته‌ای"

msgid "number"
msgstr "عدد"

msgid "numeric literal"
msgstr "لفظی عددی"

msgid "integer literal"
msgstr "لفظی عدد صحیح"

msgid "floating-point literal"
msgstr "لفظی ممیز شناور"

msgid "hexadecimal literal"
msgstr "لفظی مبنای شانزده"

msgid "octal literal"
msgstr "لفظی مبنای هشت"

msgid "binary literal"
msgstr "لفظی دودویی"

msgid "decimal literal"
msgstr "لفظی دهدهی"

msgid "imaginary literal"
msgstr "لفظی موهومی"

msgid "complex literal"
msgstr "لفظی مختلط"

msgid "0b"
msgstr "0b"

msgid "0o"
msgstr "0o"

msgid "0x"
msgstr "0x"

msgid "_ (underscore)"
msgstr "_ (زیرخط)"

msgid "in numeric literal"
msgstr "در لفظی عددی"

msgid ". (dot)"
msgstr ". (نقطه)"

msgid "e"
msgstr "e"

msgid "j"
msgstr "j"

msgid "operators"
msgstr "عملگرها"

msgid "delimiters"
msgstr "جداکننده‌ها"