frame.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:
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
# 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-21 11:59+0000\n"
"PO-Revision-Date: 2026-09-11 13:56+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 "Frame objects"
msgstr "اشیای فریم"

msgid "The C structure of the objects used to describe frame objects."
msgstr "ساختار C اشیایی که برای توصیف اشیاء فریم استفاده می‌شوند."

msgid "There are no public members in this structure."
msgstr "هیچ عضو عمومی در این ساختار وجود ندارد."

msgid "The members of this structure were removed from the public C API. Refer to the :ref:`What's New entry <pyframeobject-3.11-hiding>` for details."
msgstr "اعضای این ساختار از API عمومی C حذف شدند. برای جزئیات، به :ref:`مدخل «What's New» <pyframeobject-3.11-hiding>` مراجعه کنید."

msgid "The :c:func:`PyEval_GetFrame` and :c:func:`PyThreadState_GetFrame` functions can be used to get a frame object."
msgstr "از توابع :c:func:`PyEval_GetFrame` و :c:func:`PyThreadState_GetFrame` می‌توان برای به‌دست‌آوردن یک شیء فریم استفاده کرد."

msgid "See also :ref:`Reflection <reflection>`."
msgstr "همچنین ببینید :ref:`بازتاب <reflection>`."

msgid "The type of frame objects. It is the same object as :py:class:`types.FrameType` in the Python layer."
msgstr "نوع اشیاء فریم. این همان شیء :py:class:`types.FrameType` در لایه‌ی پایتون است."

msgid "Previously, this type was only available after including ``<frameobject.h>``."
msgstr "پیش‌تر، این نوع تنها پس از گنجاندن ``<frameobject.h>`` در دسترس بود."

msgid "Create a new frame object. This function returns a :term:`strong reference` to the new frame object on success, and returns ``NULL`` with an exception set on failure."
msgstr "یک شیء فریم جدید ایجاد می‌کند. این تابع در صورت موفقیت، یک :term:`ارجاع قوی <strong reference>` به شیء فریم جدید برمی‌گرداند و در صورت شکست، ``NULL`` را همراه با یک استثنای تنظیم‌شده برمی‌گرداند."

msgid "Return non-zero if *obj* is a frame object."
msgstr "اگر *obj* یک شیء فریم باشد، مقدار غیر صفر برمی‌گرداند."

msgid "Previously, this function was only available after including ``<frameobject.h>``."
msgstr "پیش‌تر، این تابع تنها پس از گنجاندن ``<frameobject.h>`` در دسترس بود."

msgid "Get the *frame* next outer frame."
msgstr "گرفتن فریم بیرونی بعدیِ *frame*."

msgid "Return a :term:`strong reference`, or ``NULL`` if *frame* has no outer frame. This raises no exceptions."
msgstr "یک :term:`ارجاع قوی <strong reference>` برمی‌گرداند، یا اگر *frame* فریم بیرونی نداشته باشد، ``NULL``. این تابع هیچ استثنایی ایجاد نمی‌کند."

msgid "Get the *frame*'s :attr:`~frame.f_builtins` attribute."
msgstr "ویژگی :attr:`~frame.f_builtins` *فریم* را دریافت می‌کند."

msgid "Return a :term:`strong reference`. The result cannot be ``NULL``."
msgstr "یک :term:`strong reference` برمی‌گرداند. نتیجه نمی‌تواند ``NULL`` باشد."

msgid "Get the *frame* code."
msgstr "دریافت کد *فریم* ."

msgid "Return a :term:`strong reference`."
msgstr "یک :term:`strong reference` را برمی‌گرداند."

msgid "The result (frame code) cannot be ``NULL``."
msgstr "نتیجه (کد فریم) نمی‌تواند ``NULL`` باشد."

msgid "Get the generator, coroutine, or async generator that owns this frame, or ``NULL`` if this frame is not owned by a generator. Does not raise an exception, even if the return value is ``NULL``."
msgstr "تولیدگر، هم‌روال یا تولیدگر ناهمگامی را که مالک این فریم است به دست می‌آورد، یا ``NULL`` اگر این فریم متعلق به هیچ تولیدگری نباشد. حتی اگر مقدار بازگشتی ``NULL`` باشد، استثنایی ایجاد نمی‌کند."

msgid "Return a :term:`strong reference`, or ``NULL``."
msgstr "یک :term:`ارجاع قوی <strong reference>` یا ``NULL`` برمی‌گرداند."

msgid "Get the *frame*'s :attr:`~frame.f_globals` attribute."
msgstr "گرفتن ویژگی :attr:`~frame.f_globals` از *فریم*."

msgid "Get the *frame*'s :attr:`~frame.f_lasti` attribute."
msgstr "ویژگی :attr:`~frame.f_lasti` *فریم* را دریافت کنید."

msgid "Returns -1 if ``frame.f_lasti`` is ``None``."
msgstr "اگر ``frame.f_lasti`` برابر با ``None`` باشد، مقدار -1 را برمی‌گرداند."

msgid "Get the variable *name* of *frame*."
msgstr "متغیر *name* را از *frame* می‌گیرد."

msgid "Return a :term:`strong reference` to the variable value on success."
msgstr "در صورت موفقیت، یک :term:`ارجاع قوی <strong reference>` به مقدار متغیر برمی‌گرداند."

msgid "Raise :exc:`NameError` and return ``NULL`` if the variable does not exist."
msgstr "اگر متغیر وجود نداشته باشد، :exc:`NameError` را پرتاب کرده و ``NULL`` را برمی‌گرداند."

msgid "Raise an exception and return ``NULL`` on error."
msgstr "در صورت خطا، یک استثنا ایجاد کرده و ``NULL`` را برمی‌گرداند."

msgid "*name* type must be a :class:`str`."
msgstr "نوع *name* باید :class:`str` باشد."

msgid "Similar to :c:func:`PyFrame_GetVar`, but the variable name is a C string encoded in UTF-8."
msgstr "مشابه :c:func:`PyFrame_GetVar`، اما نام متغیر یک رشته C کدگذاری‌شده با UTF-8 است."

msgid "Get the *frame*'s :attr:`~frame.f_locals` attribute. If the frame refers to an :term:`optimized scope`, this returns a write-through proxy object that allows modifying the locals. In all other cases (classes, modules, :func:`exec`, :func:`eval`) it returns the mapping representing the frame locals directly (as described for :func:`locals`)."
msgstr "ویژگی :attr:`~frame.f_locals` *فریم* را دریافت می‌کند. اگر فریم به یک :term:`محدوده بهینه‌شده <optimized scope>` اشاره کند، یک شیء پراکسی نوشتن‌همزمان برمی‌گرداند که امکان تغییر متغیرهای محلی را فراهم می‌کند. در تمام موارد دیگر (کلاس‌ها، ماژول‌ها، :func:`exec`، :func:`eval`) نگاشتی را برمی‌گرداند که متغیرهای محلی فریم را به‌طور مستقیم نمایش می‌دهد (همان‌طور که برای :func:`locals` توضیح داده شده است)."

msgid "As part of :pep:`667`, return an instance of :c:var:`PyFrameLocalsProxy_Type`."
msgstr "به عنوان بخشی از :pep:`667`، یک نمونه از :c:var:`PyFrameLocalsProxy_Type` را برمی‌گرداند."

msgid "Return the line number that *frame* is currently executing."
msgstr "شماره سطری که *frame* هم‌اکنون در حال اجرای آن است را بازمی‌گرداند."

msgid "Frame locals proxies"
msgstr "پراکسی‌های متغیرهای محلی فریم"

msgid "The :attr:`~frame.f_locals` attribute on a :ref:`frame object <frame-objects>` is an instance of a \"frame-locals proxy\". The proxy object exposes a write-through view of the underlying locals dictionary for the frame. This ensures that the variables exposed by ``f_locals`` are always up to date with the live local variables in the frame itself."
msgstr "ویژگی :attr:`~frame.f_locals` روی یک :ref:`شیء فریم <frame-objects>`، نمونه‌ای از «پراکسی متغیرهای محلی فریم» (frame-locals proxy) است. شیء پراکسی یک نمای نوشتن‌همزمان از دیکشنری متغیرهای محلی زیرین فریم ارائه می‌دهد. این تضمین می‌کند که متغیرهای ارائه‌شده توسط ``f_locals`` همیشه با متغیرهای محلی زنده در خودِ فریم به‌روز باشند."

msgid "See :pep:`667` for more information."
msgstr "برای اطلاعات بیشتر به :pep:`667` مراجعه کنید."

msgid "The type of frame :func:`locals` proxy objects."
msgstr "نوع شیءهای پراکسی :func:`locals` در فریم."

msgid "Return non-zero if *obj* is a frame :func:`locals` proxy."
msgstr "اگر *obj* یک پراکسی :func:`locals` فریم باشد، مقدار غیر صفر را برمی‌گرداند."

msgid "Legacy local variable APIs"
msgstr "APIهای قدیمی متغیر محلی"

msgid "These APIs are :term:`soft deprecated`. As of Python 3.13, they do nothing. They exist solely for backwards compatibility."
msgstr "این API‌ها :term:`soft deprecated` هستند. از پایتون 3.13 به بعد، آن‌ها هیچ کاری انجام نمی‌دهند. آن‌ها صرفاً برای سازگاری با نسخه‌های قبلی وجود دارند."

msgid "Prior to Python 3.13, this function would copy the :attr:`~frame.f_locals` attribute of *f* to the internal \"fast\" array of local variables, allowing changes in frame objects to be visible to the interpreter. If *clear* was true, this function would process variables that were unset in the locals dictionary."
msgstr "پیش از پایتون 3.13، این تابع ویژگی :attr:`~frame.f_locals` از *f* را به آرایه‌ی داخلی «سریع» (fast) متغیرهای محلی کپی می‌کرد، به‌طوری‌که تغییرات در اشیاء فریم برای مفسر قابل مشاهده می‌شدند. اگر *clear* درست بود، این تابع متغیرهایی را که در دیکشنری متغیرهای محلی تنظیم نشده بودند پردازش می‌کرد."

msgid "This function now does nothing."
msgstr "این تابع اکنون کاری انجام نمی‌دهد."

msgid "Prior to Python 3.13, this function would copy the internal \"fast\" array of local variables (which is used by the interpreter) to the :attr:`~frame.f_locals` attribute of *f*, allowing changes in local variables to be visible to frame objects."
msgstr "پیش از پایتون 3.13، این تابع آرایه داخلی «سریع» متغیرهای محلی (که توسط مفسر استفاده می‌شود) را به ویژگی :attr:`~frame.f_locals` از *f* کپی می‌کرد، به‌طوری که تغییرات در متغیرهای محلی برای اشیاء فریم قابل مشاهده باشند."

msgid "Prior to Python 3.13, this function was similar to :c:func:`PyFrame_FastToLocals`, but would return ``0`` on success, and ``-1`` with an exception set on failure."
msgstr "پیش از پایتون 3.13، این تابع مشابه :c:func:`PyFrame_FastToLocals` بود، اما در صورت موفقیت ``0`` و در صورت شکست ``-1`` به همراه استثنای تنظیم‌شده برمی‌گرداند."

msgid ":pep:`667`"
msgstr ":pep:`667`"

msgid "Internal frames"
msgstr "فریم‌های داخلی"

msgid "Unless using :pep:`523`, you will not need this."
msgstr "مگر اینکه از :pep:`523` استفاده کنید، به این نیاز نخواهید داشت."

msgid "The interpreter's internal frame representation."
msgstr "نمایش داخلی فریم در مفسر."

msgid "Return a :term:`strong reference` to the code object for the frame."
msgstr "یک :term:`strong reference` به شیء کدِ فریم را برمی‌گرداند."

msgid "Return the byte offset into the last executed instruction."
msgstr "آفست بایتیِ آخرین دستور اجرا‌شده را برمی‌گرداند."

msgid "Return the currently executing line number, or -1 if there is no line number."
msgstr "شماره‌ی سطر در حال اجرا را برمی‌گرداند، یا -1 اگر شماره‌ی سطری وجود نداشته باشد."

msgid "An array of executable kinds (executor types) for frames, used for internal debugging and tracing."
msgstr "آرایه‌ای از انواع اجراکننده (executor types) برای فریم‌ها، که برای اشکال‌زدایی داخلی و ردگیری استفاده می‌شود."

msgid "Tools like debuggers and profilers can use this to identify the type of execution context associated with a frame (such as to filter out internal frames). The entries are indexed by the following constants:"
msgstr "ابزارهایی مانند اشکال‌زداها و پروفایل‌گیرها می‌توانند از این برای شناسایی نوع زمینه اجرای مرتبط با یک فریم استفاده کنند (مانند پالایش فریم‌های داخلی). ورودی‌ها با ثابت‌های زیر اندیس‌گذاری می‌شوند:"

msgid "Constant"
msgstr "ثابت"

msgid "Description"
msgstr "توضیحات"

msgid "The frame is internal (For example: inlined) and should be skipped by tools."
msgstr "این فریم داخلی است (برای مثال: درون‌خطی‌شده (inlined)) و باید توسط ابزارها نادیده گرفته شود."

msgid "The frame corresponds to a standard Python function."
msgstr "این فریم متناظر با یک تابع استاندارد پایتون است."

msgid "The frame corresponds to a function defined in native code."
msgstr "این فریم مربوط به تابعی است که در کد بومی تعریف شده است."

msgid "The frame corresponds to a method on a class instance."
msgstr "فریم متناظر با متدی روی نمونه‌ای از یک کلاس است."

msgid "Note that reading the executable kind from a frame is currently only possible with undocumented internal APIs."
msgstr "توجه کنید که خواندن نوع اجرایی از یک قاب در حال حاضر تنها با APIهای داخلی مستندنشده امکان‌پذیر است."

msgid "The number of entries in :c:data:`PyUnstable_ExecutableKinds`."
msgstr "تعداد ورودی‌های :c:data:`PyUnstable_ExecutableKinds`."

#~ msgid "However, Python's C API lacks a function to read the executable kind from a frame. Instead, use this recipe:"
#~ msgstr "با این حال، API زبان C پایتون تابعی برای خواندن نوع اجراکننده (executable) از یک فریم ندارد. در عوض، از این دستورالعمل استفاده کنید:"

#~ msgid ""
#~ "int\n"
#~ "get_executable_kind(PyFrameObject *frame)\n"
#~ "{\n"
#~ "   _PyInterpreterFrame *f = frame->f_frame;\n"
#~ "   PyObject *exec = PyStackRef_AsPyObjectBorrow(f->f_executable);\n"
#~ "\n"
#~ "   if (PyCode_Check(exec)) {\n"
#~ "      return PyUnstable_EXECUTABLE_KIND_PY_FUNCTION;\n"
#~ "   }\n"
#~ "   if (PyMethod_Check(exec)) {\n"
#~ "      return PyUnstable_EXECUTABLE_KIND_BUILTIN_FUNCTION;\n"
#~ "   }\n"
#~ "   if (Py_IS_TYPE(exec, &PyMethodDescr_Type)) {\n"
#~ "      return PyUnstable_EXECUTABLE_KIND_METHOD_DESCRIPTOR;\n"
#~ "   }\n"
#~ "\n"
#~ "   return PyUnstable_EXECUTABLE_KIND_SKIP;\n"
#~ "}"
#~ msgstr ""
#~ "int\n"
#~ "get_executable_kind(PyFrameObject *frame)\n"
#~ "{\n"
#~ "   _PyInterpreterFrame *f = frame->f_frame;\n"
#~ "   PyObject *exec = PyStackRef_AsPyObjectBorrow(f->f_executable);\n"
#~ "\n"
#~ "   if (PyCode_Check(exec)) {\n"
#~ "      return PyUnstable_EXECUTABLE_KIND_PY_FUNCTION;\n"
#~ "   }\n"
#~ "   if (PyMethod_Check(exec)) {\n"
#~ "      return PyUnstable_EXECUTABLE_KIND_BUILTIN_FUNCTION;\n"
#~ "   }\n"
#~ "   if (Py_IS_TYPE(exec, &PyMethodDescr_Type)) {\n"
#~ "      return PyUnstable_EXECUTABLE_KIND_METHOD_DESCRIPTOR;\n"
#~ "   }\n"
#~ "\n"
#~ "   return PyUnstable_EXECUTABLE_KIND_SKIP;\n"
#~ "}"