veryhigh.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:
# Revisto <theRevisto@gmail.com>, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-09-16 12:56+0000\n"
"PO-Revision-Date: 2021-06-28 00:50+0000\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/python/python-docs-fa/)\n"
"Language: fa\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"

msgid "The Very High Level Layer"
msgstr "لایه سطح بسیار بالا"

msgid "The functions in this chapter will let you execute Python source code given in a file or a buffer, but they will not let you interact in a more detailed way with the interpreter."
msgstr "توابع این فصل به شما اجازه می‌دهند کد منبع پایتونِ ارائه‌شده در یک پرونده یا بافر را اجرا کنید، اما به شما اجازه نمی‌دهند به شکلی دقیق‌تر با مفسر تعامل کنید."

msgid "Several of these functions accept a start symbol from the grammar as a parameter.  The available start symbols are :c:data:`Py_eval_input`, :c:data:`Py_file_input`, :c:data:`Py_single_input`, and :c:data:`Py_func_type_input`.  These are described following the functions which accept them as parameters."
msgstr "چندین تابع از میان این توابع، یک نماد آغاز از گرامر را به‌عنوان پارامتر می‌پذیرند. نمادهای آغاز موجود عبارت‌اند از :c:data:`Py_eval_input`، :c:data:`Py_file_input`، :c:data:`Py_single_input` و :c:data:`Py_func_type_input`. این نمادها پس از توابعی که آن‌ها را به‌عنوان پارامتر می‌پذیرند، توصیف شده‌اند."

msgid "Note also that several of these functions take :c:expr:`FILE*` parameters.  One particular issue which needs to be handled carefully is that the :c:type:`FILE` structure for different C libraries can be different and incompatible.  Under Windows (at least), it is possible for dynamically linked extensions to actually use different libraries, so care should be taken that :c:expr:`FILE*` parameters are only passed to these functions if it is certain that they were created by the same library that the Python runtime is using."
msgstr "همچنین توجه داشته باشید که تعدادی از این توابع پارامترهای :c:expr:`FILE*` می‌گیرند. یک مسئله‌ی خاص که باید با دقت به آن پرداخته شود این است که ساختار :c:type:`FILE` در کتابخانه‌های C مختلف می‌تواند متفاوت و ناسازگار باشد. در ویندوز (حداقل)، این امکان وجود دارد که ماژول‌های توسعه‌ای با پیوند پویا در واقع از کتابخانه‌های متفاوتی استفاده کنند، بنابراین باید مراقب باشید که پارامترهای :c:expr:`FILE*` تنها زمانی به این توابع ارسال شوند که مطمئن باشید آن‌ها توسط همان کتابخانه‌ای که ران‌تایم پایتون از آن استفاده می‌کند ایجاد شده‌اند."

msgid "This is a simplified interface to :c:func:`PyRun_AnyFileExFlags` below, leaving *closeit* set to ``0`` and *flags* set to ``NULL``."
msgstr "این یک رابط ساده‌شده برای :c:func:`PyRun_AnyFileExFlags` در پایین است که *closeit* را روی ``0`` و *flags* را روی ``NULL`` تنظیم می‌کند."

msgid "This is a simplified interface to :c:func:`PyRun_AnyFileExFlags` below, leaving the *closeit* argument set to ``0``."
msgstr "این یک رابط ساده‌شده برای :c:func:`PyRun_AnyFileExFlags` در ادامه است که در آن، آرگومان *closeit* روی ``0`` تنظیم باقی می‌ماند."

msgid "This is a simplified interface to :c:func:`PyRun_AnyFileExFlags` below, leaving the *flags* argument set to ``NULL``."
msgstr "این یک رابط ساده‌شده برای :c:func:`PyRun_AnyFileExFlags` در پایین است که آرگومان *flags* را برابر ``NULL`` قرار می‌دهد."

msgid "If *fp* refers to a file associated with an interactive device (console or terminal input or Unix pseudo-terminal), return the value of :c:func:`PyRun_InteractiveLoop`, otherwise return the result of :c:func:`PyRun_SimpleFile`.  *filename* is decoded from the filesystem encoding (:func:`sys.getfilesystemencoding`).  If *filename* is ``NULL``, this function uses ``\"???\"`` as the filename. If *closeit* is true, the file is closed before ``PyRun_SimpleFileExFlags()`` returns."
msgstr "اگر *fp* به پرونده‌ای اشاره کند که با یک دستگاه تعاملی (کنسول یا ورودی پایانه یا شبه‌پایانه‌ی یونیکس) مرتبط است، مقدار :c:func:`PyRun_InteractiveLoop` را برمی‌گرداند، در غیر این صورت نتیجه‌ی :c:func:`PyRun_SimpleFile` را برمی‌گرداند. *filename* از کدگذاری سامانه فایل‌بندی (:func:`sys.getfilesystemencoding`) کدگشایی می‌شود. اگر *filename* برابر ``NULL`` باشد، این تابع از ``\"???\"`` به‌عنوان نام پرونده استفاده می‌کند. اگر *closeit* درست باشد، پرونده پیش از بازگشت ``PyRun_SimpleFileExFlags()`` بسته می‌شود."

msgid "This is a simplified interface to :c:func:`PyRun_SimpleStringFlags` below, leaving the :c:struct:`PyCompilerFlags`\\* argument set to ``NULL``."
msgstr "این یک رابط ساده‌شده برای :c:func:`PyRun_SimpleStringFlags` در پایین است که در آن آرگومان :c:struct:`PyCompilerFlags`\\* روی ``NULL`` تنظیم‌شده باقی می‌ماند."

msgid "Executes the Python source code from *command* in the :mod:`__main__` module according to the *flags* argument. If :mod:`__main__` does not already exist, it is created.  Returns ``0`` on success or ``-1`` if an exception was raised.  If there was an error, there is no way to get the exception information. For the meaning of *flags*, see below."
msgstr "کد منبع پایتون را از *command* مطابق با آرگومان *flags* در ماژول :mod:`__main__` اجرا می‌کند. اگر :mod:`__main__` از قبل وجود نداشته باشد، ایجاد می‌شود. در صورت موفقیت ``0`` و در صورتی که استثنایی رخ داده باشد ``-1`` برمی‌گرداند. اگر خطایی رخ داده باشد، راهی برای به‌دست آوردن اطلاعات استثنا وجود ندارد. برای معنای *flags*، به ادامه مراجعه کنید."

msgid "Note that if an otherwise unhandled :exc:`SystemExit` is raised, this function will not return ``-1``, but exit the process, as long as :c:member:`PyConfig.inspect` is zero."
msgstr "توجه داشته باشید که اگر استثنای :exc:`SystemExit` که به نحوی دیگر مدیریت‌نشده باشد raise شود، این تابع ``-1`` را برنمی‌گرداند، بلکه فرایند را خاتمه می‌دهد، مادامی که :c:member:`PyConfig.inspect` صفر باشد."

msgid "This is a simplified interface to :c:func:`PyRun_SimpleFileExFlags` below, leaving *closeit* set to ``0`` and *flags* set to ``NULL``."
msgstr "این یک رابط ساده‌شده برای :c:func:`PyRun_SimpleFileExFlags` در پایین است که در آن *closeit* برابر ``0`` و *flags* برابر ``NULL`` قرار می‌گیرد."

msgid "This is a simplified interface to :c:func:`PyRun_SimpleFileExFlags` below, leaving *flags* set to ``NULL``."
msgstr "این یک رابط ساده‌شده برای :c:func:`PyRun_SimpleFileExFlags` در پایین است که *flags* را برابر ``NULL`` قرار می‌دهد."

msgid "Similar to :c:func:`PyRun_SimpleStringFlags`, but the Python source code is read from *fp* instead of an in-memory string. *filename* should be the name of the file, it is decoded from :term:`filesystem encoding and error handler`. If *closeit* is true, the file is closed before ``PyRun_SimpleFileExFlags()`` returns."
msgstr "مشابه :c:func:`PyRun_SimpleStringFlags` است، اما کد منبع پایتون به‌جای یک رشته‌ی در حافظه، از *fp* خوانده می‌شود. *filename* باید نام پرونده باشد؛ این نام با :term:`filesystem encoding and error handler` کدگشایی می‌شود. اگر *closeit* درست باشد، پرونده پیش از بازگشت ``PyRun_SimpleFileExFlags()`` بسته می‌شود."

msgid "On Windows, *fp* should be opened as binary mode (e.g. ``fopen(filename, \"rb\")``). Otherwise, Python may not handle script file with LF line ending correctly."
msgstr "در ویندوز، *fp* باید در حالت دودویی باز شود (مثلاً ``fopen(filename, \"rb\")``). در غیر این صورت، ممکن است پایتون پرونده اسکریپت با پایان سطر LF را به‌درستی مدیریت نکند."

msgid "Read and execute a single statement from a file associated with an interactive device according to the *flags* argument.  The user will be prompted using ``sys.ps1`` and ``sys.ps2``. *filename* must be a Python :class:`str` object."
msgstr "یک دستور را از پرونده‌ای که با یک دستگاه تعاملی مرتبط است، مطابق با آرگومان *flags* می‌خواند و اجرا می‌کند. به کاربر با استفاده از ``sys.ps1`` و ``sys.ps2`` اعلان نمایش داده می‌شود. *filename* باید یک شیء :class:`str` پایتون باشد."

msgid "Returns ``0`` when the input was executed successfully, ``-1`` if there was an exception, or an error code from the :file:`errcode.h` include file distributed as part of Python if there was a parse error.  (Note that :file:`errcode.h` is not included by :file:`Python.h`, so must be included specifically if needed.)"
msgstr "اگر ورودی با موفقیت اجرا شده باشد، ``0`` را برمی‌گرداند؛ اگر استثنایی رخ داده باشد، ``-1`` را؛ و اگر خطای تجزیه رخ داده باشد، کد خطایی از پرونده‌ی include با نام :file:`errcode.h` که به‌عنوان بخشی از پایتون توزیع می‌شود. (توجه داشته باشید که :file:`errcode.h` توسط :file:`Python.h` include نمی‌شود، بنابراین در صورت نیاز باید به‌طور خاص include شود.)"

msgid "This is a simplified interface to :c:func:`PyRun_InteractiveOneFlags` below, leaving *flags* set to ``NULL``."
msgstr "این یک رابط ساده‌شده برای :c:func:`PyRun_InteractiveOneFlags` در پایین است که در آن *flags* بر ``NULL`` قرار می‌گیرد."

msgid "Similar to :c:func:`PyRun_InteractiveOneObject`, but *filename* is a :c:expr:`const char*`, which is decoded from the :term:`filesystem encoding and error handler`."
msgstr "مشابه :c:func:`PyRun_InteractiveOneObject`، با این تفاوت که *filename* یک :c:expr:`const char*` است که از :term:`کدگذاری سامانه فایل‌بندی و هندلر خطا <filesystem encoding and error handler>` کدگشایی می‌شود."

msgid "This is a simplified interface to :c:func:`PyRun_InteractiveLoopFlags` below, leaving *flags* set to ``NULL``."
msgstr "این یک رابط ساده‌شده برای :c:func:`PyRun_InteractiveLoopFlags` در ادامه است که در آن *flags* بر ``NULL`` تنظیم می‌شود."

msgid "Read and execute statements from a file associated with an interactive device until EOF is reached.  The user will be prompted using ``sys.ps1`` and ``sys.ps2``.  *filename* is decoded from the :term:`filesystem encoding and error handler`.  Returns ``0`` at EOF or a negative number upon failure."
msgstr "دستورها را از پرونده‌ای که با یک دستگاه تعاملی مرتبط است می‌خواند و اجرا می‌کند تا زمانی که به EOF برسد. به کاربر با استفاده از ``sys.ps1`` و ``sys.ps2`` اعلان نمایش داده می‌شود. *filename* از :term:`کدگذاری سامانه فایل‌بندی و هندلر خطا <filesystem encoding and error handler>` کدگشایی می‌شود. در EOF مقدار ``0`` و در صورت شکست یک عدد منفی برمی‌گرداند."

msgid "Can be set to point to a function with the prototype ``int func(void)``.  The function will be called when Python's interpreter prompt is about to become idle and wait for user input from the terminal.  The return value is ignored.  Overriding this hook can be used to integrate the interpreter's prompt with other event loops, as done in :file:`Modules/_tkinter.c` in the Python source code."
msgstr "می‌توان آن را طوری تنظیم کرد که به تابعی با پیش‌نمونه‌ی ``int func(void)`` اشاره کند. این تابع زمانی فراخوانی می‌شود که اعلان مفسر پایتون در شرف بی‌کار شدن و انتظار برای ورودی کاربر از پایانه باشد. مقدار بازگشتی نادیده گرفته می‌شود. از بازنویسی این قلاب می‌توان برای یکپارچه‌سازی اعلان مفسر با حلقه‌های رویداد دیگر استفاده کرد، همان‌گونه که در :file:`Modules/_tkinter.c` در کد منبع پایتون انجام شده است."

msgid "This function is only called from the :ref:`main interpreter <sub-interpreter-support>`."
msgstr "این تابع فقط از :ref:`مفسر اصلی <sub-interpreter-support>` فراخوانی می‌شود."

msgid "Can be set to point to a function with the prototype ``char *func(FILE *stdin, FILE *stdout, char *prompt)``, overriding the default function used to read a single line of input at the interpreter's prompt.  The function is expected to output the string *prompt* if it's not ``NULL``, and then read a line of input from the provided standard input file, returning the resulting string.  For example, The :mod:`readline` module sets this hook to provide line-editing and tab-completion features."
msgstr "می‌تواند برای اشاره به تابعی با پیش‌نمونه‌ی ``char *func(FILE *stdin, FILE *stdout, char *prompt)`` تنظیم شود که تابع پیش‌فرضِ استفاده‌شده برای خواندن یک سطر ورودی در اعلان مفسر را بازنویسی می‌کند. انتظار می‌رود این تابع در صورت ``NULL`` نبودن *prompt*، رشته‌ی *prompt* را به خروجی بفرستد و سپس یک سطر ورودی از پرونده‌ی ورودی استانداردِ ارائه‌شده بخواند و رشته‌ی حاصل را برگرداند. برای مثال، ماژول :mod:`readline` این قلاب را برای فراهم کردن قابلیت‌های ویرایش سطر و تکمیل با کلید Tab تنظیم می‌کند."

msgid "The result must be a string allocated by :c:func:`PyMem_RawMalloc` or :c:func:`PyMem_RawRealloc`, or ``NULL`` if an error occurred."
msgstr "نتیجه باید رشته‌ای باشد که توسط :c:func:`PyMem_RawMalloc` یا :c:func:`PyMem_RawRealloc` تخصیص داده‌شده باشد، یا ``NULL`` در صورت وقوع خطا."

msgid "The result must be allocated by :c:func:`PyMem_RawMalloc` or :c:func:`PyMem_RawRealloc`, instead of being allocated by :c:func:`PyMem_Malloc` or :c:func:`PyMem_Realloc`."
msgstr "نتیجه باید توسط :c:func:`PyMem_RawMalloc` یا :c:func:`PyMem_RawRealloc` تخصیص داده شود، نه توسط :c:func:`PyMem_Malloc` یا :c:func:`PyMem_Realloc`."

msgid "This is a simplified interface to :c:func:`PyRun_StringFlags` below, leaving *flags* set to ``NULL``."
msgstr "این یک رابط ساده‌شده برای :c:func:`PyRun_StringFlags` در ادامه است که در آن *flags* روی ``NULL`` تنظیم می‌شود."

msgid "Execute Python source code from *str* in the context specified by the objects *globals* and *locals* with the compiler flags specified by *flags*.  *globals* must be a dictionary; *locals* can be any object that implements the mapping protocol.  The parameter *start* specifies the start symbol and must be one of the :ref:`available start symbols <start-symbols>`."
msgstr "کد منبع پایتون را از *str* در زمینه‌ای که توسط اشیاء *globals* و *locals* مشخص شده است، همراه با پرچم‌های کامپایلر که توسط *flags* مشخص شده‌اند، اجرا می‌کند.  *globals* باید یک دیکشنری باشد؛ *locals* می‌تواند هر شیئی باشد که پروتکل نگاشت را پیاده‌سازی کند.  پارامتر *start* نماد شروع را مشخص می‌کند و باید یکی از :ref:`نمادهای شروع موجود <start-symbols>` باشد."

msgid "Returns the result of executing the code as a Python object, or ``NULL`` if an exception was raised."
msgstr "نتیجه‌ی اجرای کد را به‌صورت یک شیء پایتون برمی‌گرداند، یا در صورت رخ دادن استثنا ``NULL`` را برمی‌گرداند."

msgid "This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving *closeit* set to ``0`` and *flags* set to ``NULL``."
msgstr "این یک رابط ساده‌شده برای :c:func:`PyRun_FileExFlags` در پایین است که در آن *closeit* برابر ``0`` و *flags* برابر ``NULL`` قرار می‌گیرد."

msgid "This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving *flags* set to ``NULL``."
msgstr "این یک رابط ساده‌شده برای :c:func:`PyRun_FileExFlags` در ادامه است که *flags* را روی ``NULL`` تنظیم می‌کند."

msgid "This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving *closeit* set to ``0``."
msgstr "این یک رابط ساده‌شده برای :c:func:`PyRun_FileExFlags` در زیر است که در آن *closeit* روی ``0`` تنظیم می‌شود."

msgid "Similar to :c:func:`PyRun_StringFlags`, but the Python source code is read from *fp* instead of an in-memory string. *filename* should be the name of the file, it is decoded from the :term:`filesystem encoding and error handler`. If *closeit* is true, the file is closed before :c:func:`PyRun_FileExFlags` returns."
msgstr "مشابه :c:func:`PyRun_StringFlags` است، اما کد منبع پایتون به‌جای یک رشته درون حافظه، از *fp* خوانده می‌شود. *filename* باید نام پرونده باشد که از :term:`filesystem encoding and error handler` کدگشایی می‌شود. اگر *closeit* درست باشد، پرونده پیش از آنکه :c:func:`PyRun_FileExFlags` بازگردد، بسته می‌شود."

msgid "This is a simplified interface to :c:func:`Py_CompileStringFlags` below, leaving *flags* set to ``NULL``."
msgstr "این یک رابط ساده‌شده برای :c:func:`Py_CompileStringFlags` در ادامه است که *flags* را برابر ``NULL`` قرار می‌دهد."

msgid "This is a simplified interface to :c:func:`Py_CompileStringExFlags` below, with *optimize* set to ``-1``."
msgstr "این یک رابط ساده‌شده برای :c:func:`Py_CompileStringExFlags` در ادامه است که در آن *optimize* روی ``-1`` تنظیم شده است."

msgid "Parse and compile the Python source code in *str*, returning the resulting code object.  The start symbol is given by *start*; this can be used to constrain the code which can be compiled and should be :ref:`available start symbols <start-symbols>`.  The filename specified by *filename* is used to construct the code object and may appear in tracebacks or :exc:`SyntaxError` exception messages.  This returns ``NULL`` if the code cannot be parsed or compiled."
msgstr "کد منبع پایتون موجود در *str* را تجزیه و کامپایل می‌کند و شیء کد حاصل را برمی‌گرداند. نماد آغازین توسط *start* تعیین می‌شود؛ از آن می‌توان برای محدود کردن کدی که قابل کامپایل است استفاده کرد و باید یکی از :ref:`نمادهای آغازین موجود <start-symbols>` باشد. نام پرونده‌ای که توسط *filename* مشخص می‌شود برای ساخت شیء کد به کار می‌رود و ممکن است در ردگیری‌های پشته یا پیام‌های استثنای :exc:`SyntaxError` ظاهر شود. اگر کد قابل تجزیه یا کامپایل نباشد، ``NULL`` برگردانده می‌شود."

msgid "The integer *optimize* specifies the optimization level of the compiler; a value of ``-1`` selects the optimization level of the interpreter as given by :option:`-O` options.  Explicit levels are ``0`` (no optimization; ``__debug__`` is true), ``1`` (asserts are removed, ``__debug__`` is false) or ``2`` (docstrings are removed too)."
msgstr "عدد صحیح *optimize* سطح بهینه‌سازی کامپایلر را مشخص می‌کند؛ مقدار ``-1`` سطح بهینه‌سازی مفسر را همان‌طور که با گزینه‌های :option:`-O` مشخص شده است انتخاب می‌کند.  سطح‌های صریح عبارت‌اند از ``0`` (بدون بهینه‌سازی؛ ``__debug__`` درست است)، ``1`` (ادعاها حذف می‌شوند و ``__debug__`` نادرست است) یا ``2`` (رشته‌های مستند نیز حذف می‌شوند)."

msgid "Like :c:func:`Py_CompileStringObject`, but *filename* is a byte string decoded from the :term:`filesystem encoding and error handler`."
msgstr "مانند :c:func:`Py_CompileStringObject`، با این تفاوت که *filename* یک رشته بایتی است که با :term:`کدگذاری سامانه فایل‌بندی و هندلر خطا <filesystem encoding and error handler>` کدگشایی شده است."

msgid "This is a simplified interface to :c:func:`PyEval_EvalCodeEx`, with just the code object, and global and local variables.  The other arguments are set to ``NULL``."
msgstr "این یک رابط ساده‌شده برای :c:func:`PyEval_EvalCodeEx` است که تنها شیء کد و متغیرهای سراسری و محلی را در بر می‌گیرد. سایر آرگومان‌ها روی ``NULL`` تنظیم می‌شوند."

msgid "Evaluate a precompiled code object, given a particular environment for its evaluation.  This environment consists of a dictionary of global variables, a mapping object of local variables, arrays of arguments, keywords and defaults, a dictionary of default values for :ref:`keyword-only <keyword-only_parameter>` arguments and a closure tuple of cells."
msgstr "یک شیء کد پیش‌کامپایل‌شده را، با در اختیار داشتن محیطی مشخص برای ارزیابی آن، ارزیابی می‌کند.  این محیط شامل یک دیکشنری از متغیرهای سراسری، یک شیء نگاشت از متغیرهای محلی، آرایه‌هایی از آرگومان‌ها، کلیدواژه‌ها و مقادیر پیش‌فرض، یک دیکشنری از مقادیر پیش‌فرض برای آرگومان‌های :ref:`فقط‌کلیدواژه‌ای <keyword-only_parameter>` و یک تاپل بستار از سلول‌ها است."

msgid "Evaluate an execution frame.  This is a simplified interface to :c:func:`PyEval_EvalFrameEx`, for backward compatibility."
msgstr "یک فریم اجرا (execution frame) را ارزیابی می‌کند. این، برای سازگاری با نسخه‌های قبلی، یک رابط ساده‌شده برای :c:func:`PyEval_EvalFrameEx` است."

msgid "This is the main, unvarnished function of Python interpretation.  The code object associated with the execution frame *f* is executed, interpreting bytecode and executing calls as needed.  The additional *throwflag* parameter can mostly be ignored - if true, then it causes an exception to immediately be thrown; this is used for the :meth:`~generator.throw` methods of generator objects."
msgstr "این تابع اصلی و بی‌پیرایه‌ی تفسیر پایتون است. شیء کد مرتبط با فریم اجرای *f* اجرا می‌شود، بایت‌کد تفسیر می‌شود و فراخوانی‌ها در صورت نیاز اجرا می‌شوند. پارامتر اضافی *throwflag* را می‌توان تا حد زیادی نادیده گرفت — اگر درست باشد، باعث می‌شود یک استثنا بلافاصله پرتاب شود؛ این حالت برای متدهای :meth:`~generator.throw` اشیاء تولیدگر به کار می‌رود."

msgid "This function now includes a debug assertion to help ensure that it does not silently discard an active exception."
msgstr "این تابع اکنون شامل یک ادعای اشکال‌زدایی است که به اطمینان از اینکه استثنای فعال به‌صورت خاموش دور انداخته نمی‌شود کمک می‌کند."

msgid "This function changes the flags of the current evaluation frame, and returns true on success, false on failure."
msgstr "این تابع پرچم‌های فریم ارزیابی جاری را تغییر می‌دهد و در صورت موفقیت مقدار true و در صورت شکست مقدار false را برمی‌گرداند."

msgid "This is the structure used to hold compiler flags.  In cases where code is only being compiled, it is passed as ``int flags``, and in cases where code is being executed, it is passed as ``PyCompilerFlags *flags``.  In this case, ``from __future__ import`` can modify *flags*."
msgstr "این ساختاری است که برای نگه‌داشتن پرچم‌های کامپایلر استفاده می‌شود. در مواردی که کد فقط کامپایل می‌شود، به‌صورت ``int flags`` پاس داده می‌شود، و در مواردی که کد اجرا می‌شود، به‌صورت ``PyCompilerFlags *flags`` پاس داده می‌شود. در این حالت، ``from __future__ import`` می‌تواند *flags* را تغییر دهد."

msgid "Whenever ``PyCompilerFlags *flags`` is ``NULL``, :c:member:`~PyCompilerFlags.cf_flags` is treated as equal to ``0``, and any modification due to ``from __future__ import`` is discarded."
msgstr "هرگاه ``PyCompilerFlags *flags`` برابر ``NULL`` باشد، :c:member:`~PyCompilerFlags.cf_flags` برابر با ``0`` در نظر گرفته می‌شود، و هرگونه تغییر ناشی از ``from __future__ import`` دور ریخته می‌شود."

msgid "Compiler flags."
msgstr "پرچم‌های کامپایلر."

msgid "*cf_feature_version* is the minor Python version. It should be initialized to ``PY_MINOR_VERSION``."
msgstr "*cf_feature_version* نسخه فرعی پایتون است. باید به ``PY_MINOR_VERSION`` مقداردهی اولیه شود."

msgid "The field is ignored by default, it is used if and only if ``PyCF_ONLY_AST`` flag is set in :c:member:`~PyCompilerFlags.cf_flags`."
msgstr "این فیلد به‌طور پیش‌فرض نادیده گرفته می‌شود و اگر و تنها اگر پرچم ``PyCF_ONLY_AST`` در :c:member:`~PyCompilerFlags.cf_flags` تنظیم شده باشد، استفاده می‌شود."

msgid "Added *cf_feature_version* field."
msgstr "فیلد *cf_feature_version* افزوده شد."

msgid "The available compiler flags are accessible as macros:"
msgstr "پرچم‌های موجود کامپایلر به‌صورت ماکرو دسترس‌پذیر هستند:"

msgid "See :ref:`compiler flags <ast-compiler-flags>` in documentation of the :py:mod:`!ast` Python module, which exports these constants under the same names."
msgstr "به :ref:`پرچم‌های کامپایلر <ast-compiler-flags>` در مستندات ماژول :py:mod:`!ast` پایتون مراجعه کنید؛ این ماژول این ثابت‌ها را با همین نام‌ها اکسپورت می‌کند."

msgid "Low-level flags"
msgstr "پرچم‌های سطح پایین"

msgid "The following flags and masks serve narrow needs of the standard library and interactive interpreters.  Code outside the standard library rarely has a reason to use them.  They are considered implementation details and may change at any time."
msgstr "پرچم‌ها و نقاب‌های زیر نیازهای محدود کتابخانه استاندارد و مفسرهای تعاملی را برآورده می‌کنند. کدِ خارج از کتابخانه استاندارد به‌ندرت دلیلی برای استفاده از آن‌ها دارد. این موارد به‌عنوان جزئیات پیاده‌سازی در نظر گرفته می‌شوند و ممکن است در هر زمان تغییر کنند."

msgid "This flag is a private interface between the compiler and the :mod:`codeop` module.  Do not use it; its behavior is unsupported and may change without warning."
msgstr "این پرچم یک رابط خصوصی بین کامپایلر و ماژول :mod:`codeop` است. از آن استفاده نکنید؛ رفتار آن پشتیبانی نمی‌شود و ممکن است بدون اطلاع قبلی تغییر کند."

msgid "With this flag set, when compilation fails because the source text ends where more input is expected, for example in the middle of an indented block or an unterminated string literal, the error raised is the undocumented ``_IncompleteInputError``, a subclass of :exc:`SyntaxError`.  The :mod:`codeop` module sets this flag, together with :c:macro:`PyCF_DONT_IMPLY_DEDENT`, to tell input that is incomplete apart from input with a real syntax error, so that interactive interpreters know when to prompt for another line instead of reporting an error."
msgstr "با تنظیم این پرچم، وقتی کامپایل به این دلیل شکست می‌خورد که متن مبدأ در جایی پایان می‌یابد که ورودی بیشتری مورد انتظار است (برای مثال در میانه‌ی یک بلوک تورفته یا یک رشته‌ی لفظی ناتمام)، خطای ایجادشده ``_IncompleteInputError`` است؛ زیرکلاسی مستندنشده از :exc:`SyntaxError`. ماژول :mod:`codeop` این پرچم را همراه با :c:macro:`PyCF_DONT_IMPLY_DEDENT` تنظیم می‌کند تا ورودی ناقص از ورودی‌ای که واقعاً خطای سینتکس دارد تشخیص داده شود و مفسرهای تعاملی بدانند چه زمانی به‌جای گزارش خطا، برای دریافت سطر دیگری اعلانی نمایش دهند."

msgid "By default, when compiling with the :c:var:`Py_single_input` start symbol, reaching the end of the source text implicitly closes any open indented blocks.  With this flag set, open blocks are only closed if the last line of the source ends with a newline; otherwise, compilation fails with a :exc:`SyntaxError`:"
msgstr "به‌طور پیش‌فرض، هنگام کامپایل با نماد آغاز :c:var:`Py_single_input`، رسیدن به پایان متن مبدأ به‌طور ضمنی همه‌ی بلوک‌های تورفته‌ی باز را می‌بندد. با تنظیم این پرچم، بلوک‌های باز فقط زمانی بسته می‌شوند که آخرین سطر متن مبدأ با سطر جدید تمام شود؛ در غیر این صورت، کامپایل با خطای :exc:`SyntaxError` شکست می‌خورد:"

msgid ""
"PyCompilerFlags flags = {\n"
"    .cf_flags = 0,\n"
"    .cf_feature_version = PY_MINOR_VERSION,\n"
"};\n"
"const char *source = \"if a:\\n    pass\";\n"
"\n"
"/* The \"if\" block is closed implicitly;\n"
"   this returns a code object: */\n"
"Py_CompileStringFlags(source, \"<input>\", Py_single_input, &flags);\n"
"\n"
"/* With the flag, this fails with a SyntaxError,\n"
"   because the last line does not end with a newline: */\n"
"flags.cf_flags = PyCF_DONT_IMPLY_DEDENT;\n"
"Py_CompileStringFlags(source, \"<input>\", Py_single_input, &flags);"
msgstr ""
"PyCompilerFlags flags = {\n"
"    .cf_flags = 0,\n"
"    .cf_feature_version = PY_MINOR_VERSION,\n"
"};\n"
"const char *source = \"if a:\\n    pass\";\n"
"\n"
"/* بلوک «if» به‌طور ضمنی بسته می‌شود؛\n"
"   این یک شیء کد برمی‌گرداند: */\n"
"Py_CompileStringFlags(source, \"<input>\", Py_single_input, &flags);\n"
"\n"
"/* با این پرچم، این کار با خطای SyntaxError شکست می‌خورد،\n"
"   زیرا سطر آخر به سطر جدید ختم نمی‌شود: */\n"
"flags.cf_flags = PyCF_DONT_IMPLY_DEDENT;\n"
"Py_CompileStringFlags(source, \"<input>\", Py_single_input, &flags);"

msgid "The :mod:`codeop` module uses this flag to detect incomplete interactive input.  While the user is still typing inside an indented block, the source does not yet end with a newline, so it fails to compile and the user is prompted for another line."
msgstr "ماژول :mod:`codeop` از این پرچم برای تشخیص ورودی تعاملی ناتمام استفاده می‌کند. هنگامی که کاربر هنوز مشغول تایپ کردن درون یک بلوک تورفته است، کد منبع هنوز به سطر جدید ختم نمی‌شود؛ در نتیجه کامپایل آن شکست می‌خورد و به کاربر اعلان می‌شود تا سطر دیگری وارد کند."

msgid "Read the source text as UTF-8, ignoring its :pep:`263` encoding declaration (\"coding cookie\"), if any:"
msgstr "متن منبع را به‌صورت UTF-8 بخوانید و در صورت وجود، اعلان کدگذاری :pep:`263` آن («coding cookie») را نادیده بگیرید:"

msgid ""
"PyCompilerFlags flags = {\n"
"    .cf_flags = 0,\n"
"    .cf_feature_version = PY_MINOR_VERSION,\n"
"};\n"
"const char *source = \"# coding: latin-1\\ns = '\\xe9'\\n\";\n"
"\n"
"/* The coding cookie is honored: byte 0xE9 is decoded as\n"
"   Latin-1, and this returns a code object that sets s to \"é\": */\n"
"Py_CompileStringFlags(source, \"<input>\", Py_file_input, &flags);\n"
"\n"
"/* With the flag, the cookie is ignored and compilation fails\n"
"   with a SyntaxError, because 0xE9 is not valid UTF-8: */\n"
"flags.cf_flags = PyCF_IGNORE_COOKIE;\n"
"Py_CompileStringFlags(source, \"<input>\", Py_file_input, &flags);"
msgstr ""
"PyCompilerFlags flags = {\n"
"    .cf_flags = 0,\n"
"    .cf_feature_version = PY_MINOR_VERSION,\n"
"};\n"
"const char *source = \"# coding: latin-1\\ns = '\\xe9'\\n\";\n"
"\n"
"/* کوکی کدگذاری (coding cookie) رعایت می‌شود: بایت 0xE9 به‌صورت Latin-1\n"
"   کدگشایی می‌شود و این یک شیء کد برمی‌گرداند که s را برابر \"é\" قرار می‌دهد: */\n"
"Py_CompileStringFlags(source, \"<input>\", Py_file_input, &flags);\n"
"\n"
"/* با این پرچم، کوکی نادیده گرفته می‌شود و کامپایل با خطای SyntaxError\n"
"   شکست می‌خورد، زیرا 0xE9 در UTF-8 معتبر نیست: */\n"
"flags.cf_flags = PyCF_IGNORE_COOKIE;\n"
"Py_CompileStringFlags(source, \"<input>\", Py_file_input, &flags);"

msgid "The :func:`compile`, :func:`eval` and :func:`exec` built-in functions set this flag when the source is a :class:`str` object, because they pass the text to the parser encoded as UTF-8."
msgstr "توابع توکار :func:`compile`، :func:`eval` و :func:`exec` این پرچم را زمانی تنظیم می‌کنند که منبع یک شیء :class:`str` باشد، زیرا متن را با کدگذاری UTF-8 به پارسر ارسال می‌کنند."

msgid "Mark the source text as known to be UTF-8 encoded. The :func:`compile`, :func:`eval` and :func:`exec` built-in functions set this flag, but it currently has no effect."
msgstr "متن مبدأ را به‌عنوان کدگذاری‌شده با UTF-8 علامت‌گذاری می‌کند. توابع توکار :func:`compile`، :func:`eval` و :func:`exec` این پرچم را تنظیم می‌کنند، اما در حال حاضر هیچ اثری ندارد."

msgid "The \"``PyCF``\" flags above can be combined with \"``CO_FUTURE``\" flags such as :c:macro:`CO_FUTURE_ANNOTATIONS` to enable features normally selectable using :ref:`future statements <future>`. See :ref:`c_codeobject_flags` for a complete list."
msgstr "پرچم‌های \"``PyCF``\" فوق را می‌توان با پرچم‌های \"``CO_FUTURE``\" مانند :c:macro:`CO_FUTURE_ANNOTATIONS` ترکیب کرد تا قابلیت‌هایی که به‌طور معمول با استفاده از :ref:`دستورهای آینده <future>` قابل‌انتخاب هستند، فعال شوند. برای فهرست کامل به :ref:`c_codeobject_flags` مراجعه کنید."

msgid "The following masks combine several flags:"
msgstr "نقاب‌های زیر چندین پرچم را ترکیب می‌کنند:"

msgid "Bitmask of all ``CO_FUTURE`` flags (see :ref:`c_codeobject_flags`), which select features normally enabled by :ref:`future statements <future>`. When code compiled with a ``PyCompilerFlags *flags`` argument contains a ``from __future__ import`` statement, the flag for the imported feature is added to *flags*, so that code executed later in the same context inherits it."
msgstr "نقاب بیتی همه پرچم‌های ``CO_FUTURE`` (نگاه کنید به :ref:`c_codeobject_flags`)، که قابلیت‌هایی را انتخاب می‌کنند که معمولاً توسط :ref:`دستورات آینده <future>` فعال می‌شوند. هنگامی که در کد کامپایل‌شده با آرگومان ``PyCompilerFlags *flags`` دستور ``from __future__ import`` وجود داشته باشد، پرچم قابلیت ایمپورت‌شده به *flags* افزوده می‌شود تا کدی که بعداً در همان زمینه اجرا می‌شود، آن را به ارث ببرد."

msgid "Do not use this mask in new code.  It is kept only so that old code passing its flags to :func:`compile` keeps working."
msgstr "از این نقاب در کد جدید استفاده نکنید. این نقاب فقط برای این نگه داشته شده است که کدهای قدیمی که پرچم‌های آن را به :func:`compile` ارسال می‌کنند، همچنان کار کنند."

msgid "Bitmask of flags for obsolete future features that no longer have any effect."
msgstr "نقاب بیتی پرچم‌های ویژگی‌های آینده‌ی منسوخ که دیگر هیچ تأثیری ندارند."

msgid "Bitmask of all ``PyCF`` flags that change how the source is compiled, such as :c:macro:`PyCF_ONLY_AST`. The :func:`compile` built-in function uses this mask to validate its *flags* argument."
msgstr "نقاب بیتی همه‌ی پرچم‌های ``PyCF`` که نحوه‌ی کامپایل کد منبع را تغییر می‌دهند، مانند :c:macro:`PyCF_ONLY_AST`. تابع توکار :func:`compile` از این نقاب برای اعتبارسنجی آرگومان *flags* خود استفاده می‌کند."

msgid "Available start symbols"
msgstr "نمادهای شروعِ در دسترس"

msgid "The start symbol from the Python grammar for isolated expressions; for use with :c:func:`Py_CompileString`."
msgstr "نماد آغاز از گرامر پایتون برای عبارت‌های مجزا؛ برای استفاده با :c:func:`Py_CompileString`."

msgid "The start symbol from the Python grammar for sequences of statements as read from a file or other source; for use with :c:func:`Py_CompileString`.  This is the symbol to use when compiling arbitrarily long Python source code."
msgstr "نماد شروع از گرامر پایتون برای دنباله‌های دستور، همان‌گونه که از یک پرونده یا منبع دیگر خوانده می‌شوند؛ برای استفاده همراه با :c:func:`Py_CompileString`. این نمادی است که هنگام کامپایل کردن کد منبع پایتون با طول دلخواه، باید از آن استفاده کنید."

msgid "The start symbol from the Python grammar for a single statement; for use with :c:func:`Py_CompileString`. This is the symbol used for the interactive interpreter loop."
msgstr "نماد آغاز از گرامر پایتون برای یک دستور؛ برای استفاده با :c:func:`Py_CompileString`. این نمادی است که در حلقه‌ی مفسر تعاملی استفاده می‌شود."

msgid "The start symbol from the Python grammar for a function type; for use with :c:func:`Py_CompileString`. This is used to parse \"signature type comments\" from :pep:`484`."
msgstr "نماد شروع از گرامر پایتون برای نوع تابع؛ برای استفاده با :c:func:`Py_CompileString`. از این برای تجزیه‌ی «کامنت‌های نوع امضا» از :pep:`484` استفاده می‌شود."

msgid "This requires the :c:macro:`PyCF_ONLY_AST` flag to be set."
msgstr "این نیازمند آن است که پرچم :c:macro:`PyCF_ONLY_AST` تنظیم‌شده باشد."

msgid ":py:class:`ast.FunctionType`"
msgstr ":py:class:`ast.FunctionType`"

msgid ":pep:`484`"
msgstr ":pep:`484`"

msgid "Stack Effects"
msgstr "اثرات پشته"

msgid ":py:func:`dis.stack_effect`"
msgstr ":py:func:`dis.stack_effect`"

msgid "Sentinel value representing an invalid stack effect."
msgstr "مقدار نشانگر که اثر پشته‌ی نامعتبر را نمایان می‌کند."

msgid "This is currently equivalent to ``INT_MAX``."
msgstr "این در حال حاضر معادل ``INT_MAX`` است."

msgid "Compute the stack effect of *opcode* with argument *oparg*."
msgstr "اثر پشته‌ای (stack effect) *opcode* را با آرگومان *oparg* محاسبه می‌کند."

msgid "On success, this function returns the stack effect; on failure, this returns :c:macro:`PY_INVALID_STACK_EFFECT`."
msgstr "در صورت موفقیت، این تابع اثر پشته (stack effect) را برمی‌گرداند؛ در صورت شکست، :c:macro:`PY_INVALID_STACK_EFFECT` را برمی‌گرداند."

msgid "Similar to :c:func:`PyCompile_OpcodeStackEffect`, but don't include the stack effect of jumping if *jump* is zero."
msgstr "مشابه :c:func:`PyCompile_OpcodeStackEffect` است، اما اگر *jump* صفر باشد، اثر پشته‌ی پرش را در بر نمی‌گیرد."

msgid "If *jump* is ``0``, this will not include the stack effect of jumping, but if *jump* is ``1`` or ``-1``, this will include it."
msgstr "اگر *jump* برابر ``0`` باشد، اثر پرش روی پشته در آن لحاظ نمی‌شود، اما اگر *jump* برابر ``1`` یا ``-1`` باشد، در آن لحاظ می‌شود."

msgid "Py_CompileString (C function)"
msgstr "Py_CompileString (تابع C)"