"Project-Id-Version: Python 3.14\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2026-08-26 03:59+0000\n"

"PO-Revision-Date: 2026-07-28 10:05+0330\n"

"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"

"Language-Team: Persian (https://github.com/python/python-docs-fa/)\n"

"Language: fa\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Plural-Forms: nplurals=2; plural=(n > 1);\n"

"X-Generator: Poedit 3.6\n"

msgid "Using the Python Interpreter"

msgstr "استفاده از مفسر پایتون"

msgid "Invoking the Interpreter"

msgstr "فراخوانی مفسر"

msgid "The Python interpreter is usually installed as |usr_local_bin_python_x_dot_y_literal| on those machines where it is available; putting :file:`/usr/local/bin` in your Unix shell's search path makes it possible to start it by typing the command:"

msgstr "مفسر پایتون معمولاً روی سیستم‌هایی که در دسترس است، در مسیر |usr_local_bin_python_x_dot_y_literal| نصب می‌شود. اگر مسیر :file:`/usr/local/bin` را به مسیر جست‌وجوی شل یونیکس خود اضافه کنید، می‌توانید با وارد کردن دستور زیر آن را اجرا کنید:"

msgid "python3.14"

msgstr "python3.14"

msgid "to the shell. [#]_ Since the choice of the directory where the interpreter lives is an installation option, other places are possible; check with your local Python guru or system administrator. (E.g., :file:`/usr/local/python` is a popular alternative location.)"

msgstr "در شل. [#]_ از آنجا که انتخاب محل نصب مفسر به تنظیمات نصب بستگی دارد، ممکن است در مسیرهای دیگری نیز قرار داشته باشد؛ در این صورت با مسئول سیستم یا فرد آشنا با پایتون در سیستم خود مشورت کنید. (برای مثال، :file:`/usr/local/python` نیز محل رایج دیگری برای نصب است.)"

msgid "On Windows machines where you have installed Python from the :ref:`Microsoft Store <windows-store>`, the |python_x_dot_y_literal| command will be available. If you have the :ref:`py.exe launcher <launcher>` installed, you can use the :file:`py` command. See :ref:`setting-envvars` for other ways to launch Python."

msgstr "در ویندوز، اگر پایتون را از :ref:`Microsoft Store <windows-store>` نصب کرده باشید، دستور |python_x_dot_y_literal| در دسترس خواهد بود. اگر :ref:`راه‌انداز py.exe <launcher>` را نیز نصب کرده باشید، می‌توانید از دستور :file:`py` استفاده کنید. برای روش‌های دیگر اجرای پایتون، به بخش :ref:`setting-envvars` مراجعه کنید."

msgid "Typing an end-of-file character (:kbd:`Control-D` on Unix, :kbd:`Control-Z` on Windows) at the primary prompt causes the interpreter to exit with a zero exit status. If that doesn't work, you can exit the interpreter by typing the following command: ``quit()``."

msgstr "با وارد کردن نویسهٔ پایان فایل (:kbd:`Control-D` در یونیکس و :kbd:`Control-Z` در ویندوز) در اعلان اصلی، مفسر با کد خروج صفر خاتمه می‌یابد. اگر این روش کار نکرد، می‌توانید با وارد کردن دستور ``quit()`` از مفسر خارج شوید."

msgid "The interpreter's line-editing features include interactive editing, history substitution and code completion on most systems. Perhaps the quickest check to see whether command line editing is supported is typing a word in on the Python prompt, then pressing Left arrow (or :kbd:`Control-b`). If the cursor moves, you have command line editing; see Appendix :ref:`tut-interacting` for an introduction to the keys. If nothing appears to happen, or if a sequence like ``^[[D`` or ``^B`` appears, command line editing isn't available; you'll only be able to use backspace to remove characters from the current line."

msgstr "ویژگی‌های ویرایش خط فرمان مفسر در بیشتر سیستم‌ها شامل ویرایش تعاملی، جایگزینی تاریخچه و تکمیل خودکار کد است. شاید سریع‌ترین راه برای بررسی پشتیبانی از ویرایش خط فرمان این باشد که در اعلان پایتون یک کلمه تایپ کنید و سپس کلید پیکان چپ (یا :kbd:`Control-b`) را فشار دهید. اگر مکان‌نما جابه‌جا شد، ویرایش خط فرمان پشتیبانی می‌شود؛ برای آشنایی با کلیدها به پیوست :ref:`tut-interacting` مراجعه کنید. اگر هیچ اتفاقی نیفتاد یا دنباله‌ای مانند ``^[[D`` یا ``^B`` نمایش داده شد، ویرایش خط فرمان در دسترس نیست و تنها می‌توانید با کلید Backspace نویسه‌های خط جاری را حذف کنید."

msgid "The interpreter operates somewhat like the Unix shell: when called with standard input connected to a tty device, it reads and executes commands interactively; when called with a file name argument or with a file as standard input, it reads and executes a *script* from that file."

msgstr "عملکرد مفسر تا حدی شبیه شل یونیکس است: اگر ورودی استاندارد آن به یک دستگاه tty متصل باشد، دستورات را به‌صورت تعاملی می‌خواند و اجرا می‌کند؛ اما اگر نام یک فایل یا خود فایل به‌عنوان ورودی استاندارد به آن داده شود، *اسکریپت* موجود در آن فایل را می‌خواند و اجرا می‌کند."

msgid "A second way of starting the interpreter is ``python -c command [arg] ...``, which executes the statement(s) in *command*, analogous to the shell's :option:`-c` option. Since Python statements often contain spaces or other characters that are special to the shell, it is usually advised to quote *command* in its entirety."

msgstr "روش دیگر برای اجرای مفسر، استفاده از دستور ``python -c command [arg] ...`` است که دستور(های) موجود در *command* را اجرا می‌کند؛ مشابه گزینهٔ :option:`-c` در شل. از آنجا که دستورات پایتون معمولاً شامل فاصله یا نویسه‌هایی هستند که برای شل معنای ویژه‌ای دارند، معمولاً توصیه می‌شود کل *command* را داخل نقل‌قول قرار دهید."

msgid "Some Python modules are also useful as scripts. These can be invoked using ``python -m module [arg] ...``, which executes the source file for *module* as if you had spelled out its full name on the command line."

msgstr "برخی از ماژول‌های پایتون را نیز می‌توان به‌صورت اسکریپت اجرا کرد. این کار با استفاده از دستور ``python -m module [arg] ...`` انجام می‌شود که فایل مبدأ مربوط به *module* را طوری اجرا می‌کند که گویی نام کامل آن را در خط فرمان وارد کرده‌اید."

msgid "When a script file is used, it is sometimes useful to be able to run the script and enter interactive mode afterwards. This can be done by passing :option:`-i` before the script."

msgstr "هنگامی که یک فایل اسکریپت اجرا می‌شود، گاهی مفید است که پس از پایان اجرای اسکریپت وارد حالت تعاملی شوید. این کار با قرار دادن گزینهٔ :option:`-i` پیش از نام اسکریپت امکان‌پذیر است."

msgid "All command line options are described in :ref:`using-on-general`."

msgstr "همهٔ گزینه‌های خط فرمان در بخش :ref:`using-on-general` توضیح داده شده‌اند."

msgid "Argument Passing"

msgstr "ارسال آرگومان‌ها"

msgid "When known to the interpreter, the script name and additional arguments thereafter are turned into a list of strings and assigned to the ``argv`` variable in the ``sys`` module. You can access this list by executing ``import sys``. The length of the list is at least one; when no script and no arguments are given, ``sys.argv[0]`` is an empty string. When the script name is given as ``'-'`` (meaning standard input), ``sys.argv[0]`` is set to ``'-'``. When :option:`-c` *command* is used, ``sys.argv[0]`` is set to ``'-c'``. When :option:`-m` *module* is used, ``sys.argv[0]`` is set to the full name of the located module. Options found after :option:`-c` *command* or :option:`-m` *module* are not consumed by the Python interpreter's option processing but left in ``sys.argv`` for the command or module to handle."

msgstr "اگر مفسر نام اسکریپت و آرگومان‌های پس از آن را دریافت کند، آن‌ها را به فهرستی از رشته‌ها تبدیل کرده و در متغیر ``argv`` از ماژول ``sys`` قرار می‌دهد. با اجرای ``import sys`` می‌توانید به این فهرست دسترسی داشته باشید. طول این فهرست همیشه حداقل یک است؛ اگر هیچ اسکریپت یا آرگومانی ارائه نشود، مقدار ``sys.argv[0]`` یک رشتهٔ خالی خواهد بود. اگر نام اسکریپت ``'-'`` باشد (به معنی ورودی استاندارد)، مقدار ``sys.argv[0]`` برابر ``'-'`` خواهد بود. هنگام استفاده از :option:`-c` *command*، مقدار ``sys.argv[0]`` برابر ``'-c'`` است. هنگام استفاده از :option:`-m` *module*، مقدار ``sys.argv[0]`` برابر نام کامل ماژول پیدا‌شده خواهد بود. گزینه‌هایی که پس از :option:`-c` *command* یا :option:`-m` *module* قرار می‌گیرند، توسط مفسر پایتون پردازش نمی‌شوند و بدون تغییر در ``sys.argv`` باقی می‌مانند تا خود دستور یا ماژول آن‌ها را پردازش کند."

msgid "Interactive Mode"

msgstr "حالت تعاملی"

msgid "When commands are read from a tty, the interpreter is said to be in *interactive mode*. In this mode it prompts for the next command with the *primary prompt*, usually three greater-than signs (``>>>``); for continuation lines it prompts with the *secondary prompt*, by default three dots (``...``). The interpreter prints a welcome message stating its version number and a copyright notice before printing the first prompt:"

msgstr "وقتی دستورات از یک tty خوانده می‌شوند، گفته می‌شود که مفسر در *حالت تعاملی* قرار دارد. در این حالت، مفسر برای دریافت دستور بعدی، *اعلان اصلی* را نمایش می‌دهد که معمولاً شامل سه علامت بزرگ‌تر از (``>>>``) است. برای خطوط ادامه نیز *اعلان ثانویه* را نمایش می‌دهد که به‌طور پیش‌فرض سه نقطه (``...``) است. پیش از نمایش اولین اعلان، مفسر پیام خوشامدگویی شامل شمارهٔ نسخه و اطلاعیهٔ حق نشر را چاپ می‌کند:"

msgid ""

msgstr ""

msgid "Continuation lines are needed when entering a multi-line construct. As an example, take a look at this :keyword:`if` statement::"

msgstr "خطوط ادامه زمانی لازم هستند که در حال وارد کردن یک سازهٔ چندخطی باشید. برای نمونه، به دستور :keyword:`if` زیر توجه کنید::"

msgid ""

msgstr ""

msgid "For more on interactive mode, see :ref:`tut-interac`."

msgstr "برای اطلاعات بیشتر دربارهٔ حالت تعاملی، به بخش :ref:`tut-interac` مراجعه کنید."

msgid "The Interpreter and Its Environment"

msgstr "مفسر و محیط آن"

msgid "Source Code Encoding"

msgstr "کدگذاری فایل‌های مبدأ"

msgid "By default, Python source files are treated as encoded in UTF-8. In that encoding, characters of most languages in the world can be used simultaneously in string literals, identifiers and comments --- although the standard library only uses ASCII characters for identifiers, a convention that any portable code should follow. To display all these characters properly, your editor must recognize that the file is UTF-8, and it must use a font that supports all the characters in the file."

msgstr "به‌طور پیش‌فرض، فایل‌های مبدأ پایتون با کدگذاری UTF-8 در نظر گرفته می‌شوند. در این کدگذاری، می‌توان نویسه‌های بیشتر زبان‌های دنیا را به‌طور هم‌زمان در رشته‌ها، شناسه‌ها و توضیحات به کار برد؛ هرچند کتابخانهٔ استاندارد فقط از نویسه‌های ASCII برای شناسه‌ها استفاده می‌کند، که این رویه برای کدهای قابل‌حمل نیز توصیه می‌شود. برای نمایش صحیح همهٔ این نویسه‌ها، ویرایشگر شما باید فایل را به‌عنوان UTF-8 تشخیص دهد و از قلمی استفاده کند که از تمام نویسه‌های موجود در فایل پشتیبانی کند."

msgid "To declare an encoding other than the default one, a special comment line should be added as the *first* line of the file. The syntax is as follows::"

msgstr "برای اعلام کدگذاری‌ای غیر از کدگذاری پیش‌فرض، باید یک خط توضیح ویژه را به‌عنوان *اولین* خط فایل اضافه کنید. قالب آن به شکل زیر است::"

msgid "# -*- coding: encoding -*-"

msgstr "# -*- coding: encoding -*-"

msgid "where *encoding* is one of the valid :mod:`codecs` supported by Python."

msgstr "که در آن *encoding* یکی از کدگذاری‌های معتبر پشتیبانی‌شده توسط ماژول :mod:`codecs` است."

msgid "For example, to declare that Windows-1252 encoding is to be used, the first line of your source code file should be::"

msgstr "برای مثال، اگر بخواهید از کدگذاری Windows-1252 استفاده کنید، اولین خط فایل مبدأ شما باید به شکل زیر باشد::"

msgid "# -*- coding: cp1252 -*-"

msgstr "# -*- coding: cp1252 -*-"

msgid "One exception to the *first line* rule is when the source code starts with a :ref:`UNIX \"shebang\" line <tut-scripts>`. In this case, the encoding declaration should be added as the second line of the file. For example::"

msgstr "یک استثنا برای قانون *اولین خط* زمانی است که فایل مبدأ با یک :ref:`خط «shebang» یونیکس <tut-scripts>` آغاز شود. در این صورت، اعلان کدگذاری باید در خط دوم فایل قرار گیرد. برای مثال::"

msgid ""

msgstr ""

msgid "Footnotes"

msgstr "پانویس‌ها"

msgid "On Unix, the Python 3.x interpreter is by default not installed with the executable named ``python``, so that it does not conflict with a simultaneously installed Python 2.x executable."

msgstr "در یونیکس، مفسر Python 3.x به‌طور پیش‌فرض با نام اجرایی ``python`` نصب نمی‌شود تا با نسخهٔ هم‌زمان نصب‌شدهٔ Python 2.x تداخلی نداشته باشد."