function.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-10-22 14:54+0000\n"
"PO-Revision-Date: 2021-06-28 00:48+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 "Function Objects"
msgstr "شیءهای تابع"

msgid "There are a few functions specific to Python functions."
msgstr "چند تابع وجود دارند که مختص توابع پایتون هستند."

msgid "The C structure used for functions."
msgstr "ساختار C استفاده‌شده برای توابع."

msgid "This is an instance of :c:type:`PyTypeObject` and represents the Python function type.  It is exposed to Python programmers as ``types.FunctionType``."
msgstr "این نمونه‌ای از :c:type:`PyTypeObject` است و نوع تابع پایتون را نمایندگی می‌کند. این نوع به برنامه‌نویسان پایتون به صورت ``types.FunctionType`` در دسترس قرار گرفته است."

msgid "Return true if *o* is a function object (has type :c:data:`PyFunction_Type`). The parameter must not be ``NULL``.  This function always succeeds."
msgstr "اگر *o* یک شیء تابع باشد (نوع :c:data:`PyFunction_Type` را داشته باشد)، true را برمی‌گرداند. پارامتر نباید ``NULL`` باشد. این تابع همیشه با موفقیت انجام می‌شود."

msgid "Return a new function object associated with the code object *code*. *globals* must be a dictionary with the global variables accessible to the function."
msgstr "شیء تابع جدیدی مرتبط با شیء کد *code* را برمی‌گرداند. *globals* باید دیکشنری‌ای شامل متغیرهای سراسری قابل دسترس برای تابع باشد."

msgid "The function's docstring and name are retrieved from the code object. :attr:`~function.__module__` is retrieved from *globals*. The argument defaults, annotations and closure are set to ``NULL``. :attr:`~function.__qualname__` is set to the same value as the code object's :attr:`~codeobject.co_qualname` field."
msgstr "رشته مستند و نام تابع از شیء کد بازیابی می‌شوند. :attr:`~function.__module__` از *globals* بازیابی می‌شود. مقادیر پیش‌فرض آرگومان‌ها، حاشیه‌نویسی‌ها و بستار به ``NULL`` تنظیم می‌شوند. :attr:`~function.__qualname__` به همان مقدار فیلد :attr:`~codeobject.co_qualname` شیء کد تنظیم می‌شود."

msgid "As :c:func:`PyFunction_New`, but also allows setting the function object's :attr:`~function.__qualname__` attribute. *qualname* should be a unicode object or ``NULL``; if ``NULL``, the :attr:`!__qualname__` attribute is set to the same value as the code object's :attr:`~codeobject.co_qualname` field."
msgstr "مانند :c:func:`PyFunction_New` است، اما به‌علاوه امکان تنظیم ویژگی :attr:`~function.__qualname__` شیء تابع را نیز فراهم می‌کند. *qualname* باید یک شیء یونیکد یا ``NULL`` باشد؛ اگر ``NULL`` باشد، ویژگی :attr:`!__qualname__` به همان مقدار فیلد :attr:`~codeobject.co_qualname` شیء کد تنظیم می‌شود."

msgid "Return the code object associated with the function object *op*."
msgstr "شیء کدِ مرتبط با شیء تابع *op* را برمی‌گرداند."

msgid "Return the globals dictionary associated with the function object *op*."
msgstr "دیکشنری سراسری مرتبط با شیء تابع *op* را برمی‌گرداند."

msgid "Return a :term:`borrowed reference` to the :attr:`~function.__module__` attribute of the :ref:`function object <user-defined-funcs>` *op*. It can be *NULL*."
msgstr "یک :term:`ارجاع امانتی <borrowed reference>` به ویژگی :attr:`~function.__module__` از :ref:`شیء تابع <user-defined-funcs>` *op* برمی‌گرداند. می‌تواند *NULL* باشد."

msgid "This is normally a :class:`string <str>` containing the module name, but can be set to any other object by Python code."
msgstr "این به‌طور معمول یک :class:`رشته <str>` حاوی نام ماژول است، اما می‌تواند توسط کد پایتون به هر شیء دیگری تنظیم شود."

msgid "Return the argument default values of the function object *op*. This can be a tuple of arguments or ``NULL``."
msgstr "مقادیر پیش‌فرض آرگومان‌های شیء تابع *op* را برمی‌گرداند. این می‌تواند یک تاپل از آرگومان‌ها یا ``NULL`` باشد."

msgid "Set the argument default values for the function object *op*. *defaults* must be ``Py_None`` or a tuple."
msgstr "مقادیر پیش‌فرض آرگومان‌ها را برای شیء تابع *op* تنظیم می‌کند. *defaults* باید ``Py_None`` یا یک تاپل باشد."

msgid "Raises :exc:`SystemError` and returns ``-1`` on failure."
msgstr "در صورت شکست، :exc:`SystemError` ایجاد می‌کند و ``-1`` را برمی‌گرداند."

msgid "Set the vectorcall field of a given function object *func*."
msgstr "فیلد vectorcall از شیء تابع داده‌شده *func* را تنظیم می‌کند."

msgid "Warning: extensions using this API must preserve the behavior of the unaltered (default) vectorcall function!"
msgstr "هشدار: ماژول‌های توسعه‌ای که از این API استفاده می‌کنند، باید رفتار تابع vectorcall دست‌نخورده (پیش‌فرض) را حفظ کنند!"

msgid "Return the keyword-only argument default values of the function object *op*. This can be a dictionary of arguments or ``NULL``."
msgstr "مقادیر پیش‌فرض آرگومان‌های فقط‌کلیدواژه‌ای شیء تابع *op* را برمی‌گرداند. این می‌تواند یک دیکشنری از آرگومان‌ها یا ``NULL`` باشد."

msgid "Set the keyword-only argument default values of the function object *op*. *defaults* must be a dictionary of keyword-only arguments or ``Py_None``."
msgstr "مقادیر پیش‌فرض آرگومان‌های فقط کلیدواژه‌ای شیء تابع *op* را تنظیم می‌کند. *defaults* باید یک دیکشنری از آرگومان‌های فقط کلیدواژه‌ای یا ``Py_None`` باشد."

msgid "This function returns ``0`` on success, and returns ``-1`` with an exception set on failure."
msgstr "این تابع در صورت موفقیت ``0`` را برمی‌گرداند و در صورت شکست ``-1`` را همراه با تنظیم یک استثنا برمی‌گرداند."

msgid "Return the closure associated with the function object *op*. This can be ``NULL`` or a tuple of cell objects."
msgstr "بستار مرتبط با شیء تابع *op* را برمی‌گرداند. این می‌تواند ``NULL`` یا تاپلی از شیءهای سلولی (cell objects) باشد."

msgid "Set the closure associated with the function object *op*. *closure* must be ``Py_None`` or a tuple of cell objects."
msgstr "بستار مرتبط با شیء تابع *op* را تنظیم می‌کند. *closure* باید ``Py_None`` یا تاپلی از اشیاء سلول باشد."

msgid "Return the annotations of the function object *op*. This can be a mutable dictionary or ``NULL``."
msgstr "حاشیه‌نویسی‌های شیء تابع *op* را برمی‌گرداند. این می‌تواند یک دیکشنری تغییرپذیر یا ``NULL`` باشد."

msgid "Set the annotations for the function object *op*. *annotations* must be a dictionary or ``Py_None``."
msgstr "حاشیه‌نویسی‌های شیء تابع *op* را تنظیم می‌کند. *annotations* باید یک دیکشنری یا ``Py_None`` باشد."

msgid "These functions are similar to their ``PyFunction_Get*`` counterparts, but do not do type checking. Passing anything other than an instance of :c:data:`PyFunction_Type` is undefined behavior."
msgstr "این توابع مشابه همتایان ``PyFunction_Get*`` خود هستند، اما بررسی نوع انجام نمی‌دهند. ارسال هر چیزی غیر از نمونه‌ای از :c:data:`PyFunction_Type` رفتار تعریف‌نشده است."

msgid "Register *callback* as a function watcher for the current interpreter. Return an ID which may be passed to :c:func:`PyFunction_ClearWatcher`. In case of error (e.g. no more watcher IDs available), return ``-1`` and set an exception."
msgstr "*callback* را به‌عنوان ناظر تابع برای مفسر جاری ثبت می‌کند. شناسه‌ای برمی‌گرداند که می‌توان آن را به :c:func:`PyFunction_ClearWatcher` پاس داد. در صورت بروز خطا (مثلاً وقتی دیگر شناسه ناظری در دسترس نباشد)، مقدار ``-1`` را برمی‌گرداند و یک استثنا تنظیم می‌کند."

msgid "Clear watcher identified by *watcher_id* previously returned from :c:func:`PyFunction_AddWatcher` for the current interpreter. Return ``0`` on success, or ``-1`` and set an exception on error (e.g.  if the given *watcher_id* was never registered.)"
msgstr "دیده‌بان (watcher) شناسایی‌شده توسط *watcher_id* که پیش‌تر از :c:func:`PyFunction_AddWatcher` برای مفسر فعلی برگردانده شده است را حذف می‌کند. در صورت موفقیت ``0`` را برمی‌گرداند، یا در صورت خطا ``-1`` را برمی‌گرداند و یک استثنا تنظیم می‌کند (مثلاً اگر *watcher_id* داده‌شده هرگز ثبت نشده باشد.)"

msgid "Enumeration of possible function watcher events:"
msgstr "فهرست رویداد‌های ممکن ناظر تابع (function watcher):"

msgid "``PyFunction_EVENT_CREATE``"
msgstr "``PyFunction_EVENT_CREATE``"

msgid "``PyFunction_EVENT_DESTROY``"
msgstr "``PyFunction_EVENT_DESTROY``"

msgid "``PyFunction_EVENT_MODIFY_CODE``"
msgstr "``PyFunction_EVENT_MODIFY_CODE``"

msgid "``PyFunction_EVENT_MODIFY_DEFAULTS``"
msgstr "``PyFunction_EVENT_MODIFY_DEFAULTS``"

msgid "``PyFunction_EVENT_MODIFY_KWDEFAULTS``"
msgstr "``PyFunction_EVENT_MODIFY_KWDEFAULTS``"

msgid "Apply the macro *V* to each suffix of :c:type:`PyFunction_WatchEvent` constants. Currently expands to ``V(CREATE) V(DESTROY) V(MODIFY_CODE) V(MODIFY_DEFAULTS) V(MODIFY_KWDEFAULTS) V(MODIFY_QUALNAME)``. The macro *V* must accept one event name and supply any punctuation needed between expansions."
msgstr "کلان‌دستور *V* را روی هر پسوند از ثابت‌های :c:type:`PyFunction_WatchEvent` اعمال کنید. در حال حاضر به ``V(CREATE) V(DESTROY) V(MODIFY_CODE) V(MODIFY_DEFAULTS) V(MODIFY_KWDEFAULTS) V(MODIFY_QUALNAME)`` گسترش می‌یابد. کلان‌دستور *V* باید یک نام رویداد را بپذیرد و هرگونه علائم نگارشی مورد نیاز بین گسترش‌ها را فراهم کند."

msgid "Type of a function watcher callback function."
msgstr "نوع تابع کال‌بک دیده‌بان (watcher) تابع."

msgid "If *event* is ``PyFunction_EVENT_CREATE`` or ``PyFunction_EVENT_DESTROY`` then *new_value* will be ``NULL``. Otherwise, *new_value* will hold a :term:`borrowed reference` to the new value that is about to be stored in *func* for the attribute that is being modified."
msgstr "اگر *event* برابر ``PyFunction_EVENT_CREATE`` یا ``PyFunction_EVENT_DESTROY`` باشد، *new_value* برابر ``NULL`` خواهد بود. در غیر این صورت، *new_value* حاوی یک :term:`borrowed reference` به مقدار جدیدی خواهد بود که قرار است در *func* برای ویژگی‌ای که در حال تغییر است ذخیره شود."

msgid "The callback may inspect but must not modify *func*; doing so could have unpredictable effects, including infinite recursion."
msgstr "کال‌بک می‌تواند *func* را بررسی کند اما نباید آن را تغییر دهد؛ انجام این کار می‌تواند پیامدهای غیرقابل پیش‌بینی، از جمله بازگشتی بی‌نهایت، داشته باشد."

msgid "If *event* is ``PyFunction_EVENT_CREATE``, then the callback is invoked after *func* has been fully initialized. Otherwise, the callback is invoked before the modification to *func* takes place, so the prior state of *func* can be inspected. The runtime is permitted to optimize away the creation of function objects when possible. In such cases no event will be emitted. Although this creates the possibility of an observable difference of runtime behavior depending on optimization decisions, it does not change the semantics of the Python code being executed."
msgstr "اگر *event* برابر ``PyFunction_EVENT_CREATE`` باشد، کال‌بک پس از آنکه *func* به‌طور کامل مقداردهی اولیه‌شده باشد فراخوانی می‌شود. در غیر این صورت، کال‌بک پیش از اعمال تغییر روی *func* فراخوانی می‌شود، به‌طوری‌که بتوان وضعیت پیشین *func* را بررسی کرد. ران‌تایم مجاز است در صورت امکان، ایجاد اشیاء تابع را با بهینه‌سازی حذف کند. در چنین مواردی هیچ رویدادی منتشر نخواهد شد. اگرچه این امر امکان بروز تفاوت قابل مشاهده در رفتار ران‌تایم بسته به تصمیمات بهینه‌سازی را ایجاد می‌کند، اما معناشناسی کد پایتون در حال اجرا را تغییر نمی‌دهد."

msgid "If *event* is ``PyFunction_EVENT_DESTROY``,  Taking a reference in the callback to the about-to-be-destroyed function will resurrect it, preventing it from being freed at this time. When the resurrected object is destroyed later, any watcher callbacks active at that time will be called again."
msgstr "اگر *event* برابر با ``PyFunction_EVENT_DESTROY`` باشد، گرفتن ارجاعی در کال‌بک به تابعی که در آستانه‌ی نابودی است، آن را احیا می‌کند و مانع از آزاد شدن آن در این زمان می‌شود. هنگامی که شیء احیا‌شده بعداً نابود شود، هر کال‌بک ناظری که در آن زمان فعال باشد، دوباره فراخوانی خواهد شد."

msgid "If the callback sets an exception, it must return ``-1``; this exception will be printed as an unraisable exception using :c:func:`PyErr_WriteUnraisable`. Otherwise it should return ``0``."
msgstr "اگر کال‌بک استثنایی تنظیم کند، باید ``-1`` را بازگرداند؛ این استثنا با استفاده از :c:func:`PyErr_WriteUnraisable` به‌عنوان یک استثنای غیرقابل برافراشتن (unraisable) چاپ خواهد شد. در غیر این صورت باید ``0`` را بازگرداند."

msgid "There may already be a pending exception set on entry to the callback. In this case, the callback should return ``0`` with the same exception still set. This means the callback may not call any other API that can set an exception unless it saves and clears the exception state first, and restores it before returning."
msgstr "ممکن است هنگام ورود به کال‌بک، از قبل یک استثنای معلق تنظیم‌شده باشد. در این حالت، کال‌بک باید ``0`` را برگرداند در حالی که همان استثنا همچنان تنظیم‌شده است. این بدان معناست که کال‌بک نباید هیچ API دیگری را که می‌تواند استثنا تنظیم کند فراخوانی کند، مگر آنکه ابتدا وضعیت استثنا را ذخیره و پاک کند و پیش از بازگشت، آن را بازگردانی کند."

msgid "object"
msgstr "شیء"

msgid "function"
msgstr "تابع"

msgid "MethodType (in module types)"
msgstr "MethodType (در ماژول types)"