"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"Module Objects"
msgstr"اشیاء ماژول"
msgid"This instance of :c:type:`PyTypeObject` represents the Python module type. This is exposed to Python programs as :py:class:`types.ModuleType`."
msgstr"این نمونه از :c:type:`PyTypeObject` معرف نوع ماژول پایتون است. این نوع به برنامه‌های پایتون به‌صورت :py:class:`types.ModuleType` ارائه می‌شود."
msgid"Return true if *p* is a module object, or a subtype of a module object. This function always succeeds."
msgstr"اگر *p* یک شیء ماژول یا زیرنوعی از یک شیء ماژول باشد، مقدار true برمی‌گرداند. این تابع همیشه موفق می‌شود."
msgid"Return true if *p* is a module object, but not a subtype of :c:data:`PyModule_Type`. This function always succeeds."
msgstr"اگر *p* یک شیء ماژول باشد، اما زیرنوعی از :c:data:`PyModule_Type` نباشد، مقدار درست را برمی‌گرداند. این تابع همیشه با موفقیت اجرا می‌شود."
msgid"Return a new module object with :attr:`module.__name__` set to *name*. The module's :attr:`!__name__`, :attr:`~module.__doc__`, :attr:`~module.__package__` and :attr:`~module.__loader__` attributes are filled in (all but :attr:`!__name__` are set to ``None``). The caller is responsible for setting a :attr:`~module.__file__` attribute."
msgstr"یک شیء ماژول جدید با :attr:`module.__name__` تنظیم‌شده بر *name* برمی‌گرداند. ویژگی‌های :attr:`!__name__`، :attr:`~module.__doc__`، :attr:`~module.__package__` و :attr:`~module.__loader__` ماژول پر می‌شوند (همه به‌جز :attr:`!__name__` بر ``None`` تنظیم می‌شوند). تنظیم ویژگی :attr:`~module.__file__` بر عهده‌ی فراخواننده است."
msgid"Return ``NULL`` with an exception set on error."
msgstr"در صورت خطا، ``NULL`` به همراه استثنای تنظیم‌شده برمی‌گرداند."
msgid":attr:`~module.__package__` and :attr:`~module.__loader__` are now set to ``None``."
msgstr":attr:`~module.__package__` و :attr:`~module.__loader__` اکنون به ``None`` تنظیم می‌شوند."
msgid"Similar to :c:func:`PyModule_NewObject`, but the name is a UTF-8 encoded string instead of a Unicode object."
msgstr"مشابه :c:func:`PyModule_NewObject`، اما نام به جای یک شیء یونیکد، یک رشته کدگذاری‌شده با UTF-8 است."
msgid"Return the dictionary object that implements *module*'s namespace; this object is the same as the :attr:`~object.__dict__` attribute of the module object. If *module* is not a module object (or a subtype of a module object), :exc:`SystemError` is raised and ``NULL`` is returned."
msgstr"شیء دیکشنری‌ای را که فضای نام *module* را پیاده‌سازی می‌کند برمی‌گرداند؛ این شیء همان ویژگی :attr:`~object.__dict__` شیء ماژول است. اگر *module* یک شیء ماژول (یا زیرنوعی از شیء ماژول) نباشد، :exc:`SystemError` برخاسته می‌شود و ``NULL`` بازگردانده می‌شود."
msgid"It is recommended extensions use other ``PyModule_*`` and ``PyObject_*`` functions rather than directly manipulate a module's :attr:`~object.__dict__`."
msgstr"توصیه می‌شود ماژول‌های توسعه‌ای به‌جای دست‌کاری مستقیم :attr:`~object.__dict__` یک ماژول، از سایر توابع ``PyModule_*`` و ``PyObject_*`` استفاده کنند."
msgid"The returned reference is borrowed from the module; it is valid until the module is destroyed."
msgstr"ارجاع بازگردانده‌شده، ارجاعی امانتی از ماژول است؛ این ارجاع تا زمانی که ماژول نابود شود معتبر است."
msgid"Return *module*'s :attr:`~module.__name__` value. If the module does not provide one, or if it is not a string, :exc:`SystemError` is raised and ``NULL`` is returned."
msgstr"مقدار :attr:`~module.__name__` *module* را برمی‌گرداند. اگر ماژول آن را ارائه نکند یا اگر رشته نباشد، استثنای :exc:`SystemError` مطرح می‌شود و ``NULL`` برگردانده می‌شود."
msgid"Similar to :c:func:`PyModule_GetNameObject` but return the name encoded to ``'utf-8'``."
msgstr"مشابه :c:func:`PyModule_GetNameObject` است، اما نام را با کدگذاری ``'utf-8'`` برمی‌گرداند."
msgid"The returned buffer is only valid until the module is renamed or destroyed. Note that Python code may rename a module by setting its :py:attr:`~module.__name__` attribute."
msgstr"بافر بازگشتی تنها تا زمانی معتبر است که نام ماژول تغییر کند یا ماژول نابود شود. توجه داشته باشید که کد پایتون می‌تواند نام یک ماژول را با تنظیم ویژگی :py:attr:`~module.__name__` آن تغییر دهد."
msgid"Return a pointer to the :c:type:`PyModuleDef` struct from which the module was created, or ``NULL`` if the module wasn't created from a definition."
msgstr"اشاره‌گر به ساختار :c:type:`PyModuleDef` که ماژول از آن ایجاد شده است را برمی‌گرداند، یا ``NULL`` اگر ماژول از یک تعریف ایجاد نشده باشد."
msgid"On error, return ``NULL`` with an exception set. Use :c:func:`PyErr_Occurred` to tell this case apart from a missing :c:type:`!PyModuleDef`."
msgstr"در صورت خطا، ``NULL`` را همراه با استثنای تنظیم‌شده برگردانید. از :c:func:`PyErr_Occurred` برای تمایز این حالت از نبود :c:type:`!PyModuleDef` استفاده کنید."
msgid"Return the name of the file from which *module* was loaded using *module*'s :attr:`~module.__file__` attribute. If this is not defined, or if it is not a string, raise :exc:`SystemError` and return ``NULL``; otherwise return a reference to a Unicode object."
msgstr"نام پرونده‌ای را که *module* از آن بارگذاری شده است، با استفاده از ویژگی :attr:`~module.__file__` مربوط به *module* برمی‌گرداند. اگر این ویژگی تعریف نشده باشد یا رشته نباشد، استثنای :exc:`SystemError` را مطرح می‌کند و ``NULL`` برمی‌گرداند؛ در غیر این صورت، ارجاعی به یک شیء یونیکد برمی‌گرداند."
msgid"Similar to :c:func:`PyModule_GetFilenameObject` but return the filename encoded to 'utf-8'."
msgstr"مشابه :c:func:`PyModule_GetFilenameObject` است، اما نام پرونده را با کدگذاری 'utf-8' برمی‌گرداند."
msgid"The returned buffer is only valid until the module's :py:attr:`~module.__file__` attribute is reassigned or the module is destroyed."
msgstr"بافر بازگشتی تنها تا زمانی معتبر است که ویژگی :py:attr:`~module.__file__` ماژول دوباره مقداردهی شود یا ماژول نابود شود."
msgid":c:func:`PyModule_GetFilename` raises :exc:`UnicodeEncodeError` on unencodable filenames, use :c:func:`PyModule_GetFilenameObject` instead."
msgstr":c:func:`PyModule_GetFilename` برای نام‌های پرونده‌ی غیرقابل کدگذاری، استثنای :exc:`UnicodeEncodeError` را مطرح می‌کند؛ به‌جای آن از :c:func:`PyModule_GetFilenameObject` استفاده کنید."
msgid"Module definition"
msgstr"تعریف ماژول"
msgid"Modules created using the C API are typically defined using an array of :c:type:`PySlot` structs, which provides a \"description\" of how a module should be created. See :ref:`capi-slots` for more information on slots in general."
msgstr"ماژول‌های ایجادشده با استفاده از API زبان C معمولاً با استفاده از آرایه‌ای از ساختارهای :c:type:`PySlot` تعریف می‌شوند که «توضیحی» درباره‌ی نحوه‌ی ایجاد یک ماژول ارائه می‌دهد. برای اطلاعات بیشتر درباره‌ی جایگاه‌ها به‌طور کلی، به :ref:`capi-slots` مراجعه کنید."
msgid"Previously, a :c:type:`PyModuleDef` struct was necessary to define modules. The older way of defining modules is still available: consult either the :ref:`pymoduledef` section or earlier versions of this documentation if you plan to support earlier Python versions."
msgstr"پیش از این، برای تعریف ماژول‌ها ساختار :c:type:`PyModuleDef` ضروری بود. روش قدیمی‌تر تعریف ماژول‌ها همچنان در دسترس است: اگر قصد دارید از نسخه‌های قبلی پایتون پشتیبانی کنید، به بخش :ref:`pymoduledef` یا نسخه‌های قبلی این مستندات مراجعه کنید."
msgid"The slots array is usually used to define an extension module's “main” module object (see :ref:`extension-modules` for details). It can also be used to :ref:`create extension modules dynamically <module-from-slots>`."
msgstr"آرایه‌ی جایگاه‌ها معمولاً برای تعریف شیء ماژول «اصلی» یک ماژول توسعه‌ای استفاده می‌شود (برای جزئیات به :ref:`extension-modules` مراجعه کنید). همچنین می‌توان از آن برای :ref:`ایجاد پویای ماژول‌های توسعه‌ای <module-from-slots>` استفاده کرد."
msgid"Unless specified otherwise, the same slot ID may not be repeated in an array of slots."
msgstr"مگر اینکه جور دیگری مشخص شده باشد، ممکن است یک شناسه‌ی جایگاه در یک آرایه از جایگاه‌ها تکرار نشود."
msgid"Metadata slots"
msgstr"جایگاه‌های فراداده"
msgid":c:member:`Slot ID <PySlot.sl_id>` for the name of the new module, as a NUL-terminated UTF8-encoded ``const char *``."
msgstr":c:member:`شناسه‌ی جایگاه <PySlot.sl_id>` برای نام ماژول جدید، به شکل یک ``const char *`` کدگذاری‌شده با UTF-8 و پایان‌یافته با NUL."
msgid"Note that modules are typically created using a :py:class:`~importlib.machinery.ModuleSpec`, and when they are, the name from the spec will be used instead of :c:data:`!Py_mod_name`. However, it is still recommended to include this slot for introspection and debugging purposes."
msgstr"توجه داشته باشید که ماژول‌ها معمولاً با استفاده از یک :py:class:`~importlib.machinery.ModuleSpec` ایجاد می‌شوند و در این صورت، نام مشخصات به‌جای :c:data:`!Py_mod_name` استفاده خواهد شد. با این حال، همچنان توصیه می‌شود برای اهداف درون‌نگری و اشکال‌زدایی، این جایگاه را بگنجانید."
msgid"Use :c:member:`PyModuleDef.m_name` instead to support previous versions."
msgstr"برای پشتیبانی از نسخه‌های قبلی، به‌جای آن از :c:member:`PyModuleDef.m_name` استفاده کنید."
msgid":c:type:`Slot ID <PySlot.sl_id>` for the docstring of the new module, as a NUL-terminated UTF8-encoded ``const char *``."
msgstr":c:type:`شناسه‌ی شکاف <PySlot.sl_id>` برای رشته مستند ماژول جدید، به شکل یک ``const char *`` با انتهای تهی و کدگذاری‌شده با UTF-8."
msgid"Usually it is set to a variable created with :c:macro:`PyDoc_STRVAR`."
msgstr"معمولاً این مقدار روی متغیری تنظیم می‌شود که با :c:macro:`PyDoc_STRVAR` ایجاد شده است."
msgid"Use :c:member:`PyModuleDef.m_doc` instead to support previous versions."
msgstr"برای پشتیبانی از نسخه‌های قبلی، به‌جای آن از :c:member:`PyModuleDef.m_doc` استفاده کنید."
msgid"Feature slots"
msgstr"جایگاه‌های ویژگی"
msgid":c:member:`Slot ID <PySlot.sl_id>` whose value points to a :c:struct:`PyABIInfo` structure describing the ABI that the extension is using."
msgstr":c:member:`شناسه‌ی جایگاه <PySlot.sl_id>` که مقدار آن به ساختار :c:struct:`PyABIInfo` اشاره می‌کند و توصیف‌کننده‌ی ABI است که افزونه از آن استفاده می‌کند."
msgid"A suitable :c:struct:`!PyABIInfo` variable can be defined using the :c:macro:`PyABIInfo_VAR` macro, as in:"
msgstr"یک متغیر مناسب :c:struct:`!PyABIInfo` را می‌توان با استفاده از ماکروی :c:macro:`PyABIInfo_VAR` تعریف کرد، مانند:"
msgid""
"PyABIInfo_VAR(abi_info);\n"
"\n"
"static PySlot mymodule_slots[] = {\n"
" PySlot_DATA(Py_mod_abi, &abi_info),\n"
" ...\n"
"};"
msgstr""
"PyABIInfo_VAR(abi_info);\n"
"\n"
"static PySlot mymodule_slots[] = {\n"
" PySlot_DATA(Py_mod_abi, &abi_info),\n"
" ...\n"
"};"
msgid"When creating a module, Python checks the value of this slot using :c:func:`PyABIInfo_Check`."
msgstr"هنگام ایجاد یک ماژول، پایتون مقدار این جایگاه را با استفاده از :c:func:`PyABIInfo_Check` بررسی می‌کند."
msgid"This slot is required, except for modules created from :c:struct:`PyModuleDef`."
msgstr"این جایگاه الزامی است، به جز برای ماژول‌هایی که از :c:struct:`PyModuleDef` ایجاد شده‌اند."
msgid":c:member:`Slot ID <PySlot.sl_id>` whose value is one of:"
msgstr":c:member:`Slot ID <PySlot.sl_id>` که مقدار آن یکی از موارد زیر است:"
msgid"The module does not support being imported in subinterpreters."
msgstr"این ماژول از ایمپورت شدن در زیرمفسرها (subinterpreters) پشتیبانی نمی‌کند."
msgid"The module supports being imported in subinterpreters, but only when they share the main interpreter's GIL. (See :ref:`isolating-extensions-howto`.)"
msgstr"این ماژول از ایمپورت شدن در زیرمفسرها پشتیبانی می‌کند، اما تنها زمانی که آن‌ها قفل مفسر سراسری (GIL) مفسر اصلی را به اشتراک بگذارند. (به :ref:`isolating-extensions-howto` مراجعه کنید.)"
msgid"The module supports being imported in subinterpreters, even when they have their own GIL. (See :ref:`isolating-extensions-howto`.)"
msgstr"این ماژول از ایمپورت شدن در زیرمفسرها پشتیبانی می‌کند، حتی زمانی که آن‌ها قفل مفسر سراسری خود را دارند. (به :ref:`isolating-extensions-howto` مراجعه کنید.)"
msgid"This slot determines whether or not importing this module in a subinterpreter will fail."
msgstr"این جایگاه تعیین می‌کند که آیا ایمپورت کردن این ماژول در یک زیرمفسر شکست می‌خورد یا خیر."
msgid"If ``Py_mod_multiple_interpreters`` is not specified, the import machinery defaults to ``Py_MOD_MULTIPLE_INTERPRETERS_SUPPORTED``."
msgstr"اگر ``Py_mod_multiple_interpreters`` مشخص نشده باشد، سازوکار ایمپورت به‌صورت پیش‌فرض از ``Py_MOD_MULTIPLE_INTERPRETERS_SUPPORTED`` استفاده می‌کند."
msgid"For historical reasons, the values are declared as pointers (``void *``). When using :c:type:`PySlot` arrays, use :c:macro:`PySlot_DATA` for :c:macro:`!Py_mod_multiple_interpreters`:"
msgstr"به دلایل تاریخی، مقادیر به عنوان اشاره‌گر (``void *``) اعلام می‌شوند. هنگام استفاده از آرایه‌های :c:type:`PySlot`، از :c:macro:`PySlot_DATA` برای :c:macro:`!Py_mod_multiple_interpreters` استفاده کنید:"
msgid""
"PySlot_DATA(Py_mod_multiple_interpreters,\n"
" Py_MOD_PER_INTERPRETER_GIL_SUPPORTED)"
msgstr""
"PySlot_DATA(Py_mod_multiple_interpreters,\n"
" Py_MOD_PER_INTERPRETER_GIL_SUPPORTED)"
msgid"The module depends on the presence of the global interpreter lock (GIL), and may access global state without synchronization."
msgstr"این ماژول به وجود قفل مفسر سراسری (GIL) وابسته است و ممکن است بدون همگام‌سازی به وضعیت سراسری دسترسی داشته باشد."
msgid"The module is safe to run without an active GIL."
msgstr"اجرای این ماژول بدون قفل مفسر سراسریِ فعال، ایمن است."
msgid"This slot is ignored by Python builds not configured with :option:`--disable-gil`. Otherwise, it determines whether or not importing this module will cause the GIL to be automatically enabled. See :ref:`whatsnew313-free-threaded-cpython` for more detail."
msgstr"این جایگاه توسط ساخت‌های پایتون که با :option:`--disable-gil` پیکربندی نشده‌اند نادیده گرفته می‌شود. در غیر این صورت، تعیین می‌کند که آیا ایمپورت کردن این ماژول باعث می‌شود قفل مفسر سراسری (GIL) به‌طور خودکار فعال شود یا خیر. برای جزئیات بیشتر به :ref:`whatsnew313-free-threaded-cpython` مراجعه کنید."
msgid"If ``Py_mod_gil`` is not specified, the import machinery defaults to ``Py_MOD_GIL_USED``."
msgstr"اگر ``Py_mod_gil`` مشخص نشده باشد، سازوکار ایمپورت به‌طور پیش‌فرض از ``Py_MOD_GIL_USED`` استفاده می‌کند."
msgid"For historical reasons, the values are declared as pointers (``void *``). When using :c:type:`PySlot` arrays, use :c:macro:`PySlot_DATA` for :c:macro:`!Py_mod_gil`:"
msgstr"به دلایل تاریخی، مقادیر به عنوان اشاره‌گر (``void *``) اعلام می‌شوند. هنگام استفاده از آرایه‌های :c:type:`PySlot`، از :c:macro:`PySlot_DATA` برای :c:macro:`!Py_mod_gil` استفاده کنید:"
msgid":c:member:`Slot ID <PySlot.sl_id>` for a function that creates the module object itself. The function must have the signature:"
msgstr":c:member:`Slot ID <PySlot.sl_id>` برای تابعی که خود شیء ماژول را ایجاد می‌کند. این تابع باید امضای زیر را داشته باشد:"
msgid"The function will be called with:"
msgstr"این تابع با موارد زیر فراخوانی خواهد شد:"
msgid"*spec*: a ``ModuleSpec``-like object, meaning that any attributes defined for :py:class:`importlib.machinery.ModuleSpec` have matching semantics. However, any of the attributes may be missing."
msgstr"*spec*: یک شیء شبیه به ``ModuleSpec``، به این معنا که هر ویژگی تعریف‌شده برای :py:class:`importlib.machinery.ModuleSpec` دارای معناشناسی منطبق است. با این حال، ممکن است هر یک از ویژگی‌ها وجود نداشته باشند."
msgid"*def*: ``NULL``, or the module definition if the module is created from one."
msgstr"*def*: مقدار ``NULL``، یا تعریف ماژول در صورتی که ماژول از یکی از آن‌ها ایجاد شده باشد."
msgid"The function should return a new module object, or set an error and return ``NULL``."
msgstr"این تابع باید یک شیء ماژول جدید برگرداند، یا یک خطا را تنظیم کرده و ``NULL`` را برگرداند."
msgid"This function should be kept minimal. In particular, it should not call arbitrary Python code, as trying to import the same module again may result in an infinite loop."
msgstr"این تابع باید در حداقل ممکن نگه داشته شود. به‌ویژه، نباید کد دلخواه پایتون را فراخوانی کند، زیرا تلاش برای ایمپورت کردن مجدد همان ماژول ممکن است به حلقه بی‌نهایت منجر شود."
msgid"If ``Py_mod_create`` is not specified, the import machinery will create a normal module object using :c:func:`PyModule_New`. The name is taken from *spec*, not the definition, to allow extension modules to dynamically adjust to their place in the module hierarchy and be imported under different names through symlinks, all while sharing a single module definition."
msgstr"اگر ``Py_mod_create`` مشخص نشده باشد، مکانیزم ایمپورت با استفاده از :c:func:`PyModule_New` یک شیء ماژول معمولی ایجاد می‌کند. نام از *مشخصه* گرفته می‌شود، نه از تعریف، تا ماژول‌های توسعه‌ای بتوانند به‌طور پویا با جایگاه خود در سلسله‌مراتب ماژول سازگار شوند و از طریق پیوندهای نمادین با نام‌های مختلف ایمپورت شوند، در حالی که همگی یک تعریف ماژول واحد را به اشتراک می‌گذارند."
msgid"There is no requirement for the returned object to be an instance of :c:type:`PyModule_Type`. However, some slots may only be used with :c:type:`!PyModule_Type` instances; in particular:"
msgstr"هیچ الزامی وجود ندارد که شیء برگردانده‌شده نمونه‌ای از :c:type:`PyModule_Type` باشد. با این حال، برخی از جایگاه‌ها ممکن است فقط با نمونه‌های :c:type:`!PyModule_Type` استفاده شوند؛ به ویژه:"
msgid":c:macro:`Py_mod_exec`,"
msgstr":c:macro:`Py_mod_exec`،"
msgid":ref:`module state slots <ext-module-state-slots>` (``Py_mod_state_*``),"
msgstr":ref:`جایگاه‌های حالت ماژول <ext-module-state-slots>` (``Py_mod_state_*``)،"
msgid":c:macro:`Py_mod_token`."
msgstr":c:macro:`Py_mod_token`."
msgid"The *slots* argument may be a ``ModuleSpec``-like object, rather than a true :py:class:`~importlib.machinery.ModuleSpec` instance. Note that previous versions of CPython did not enforce this."
msgstr"آرگومان *slots* ممکن است یک شیء شبیه به ``ModuleSpec`` باشد، نه یک نمونه‌ی واقعی :py:class:`~importlib.machinery.ModuleSpec`. توجه داشته باشید که نسخه‌های قبلی سی‌پایتون این موضوع را اعمال نمی‌کردند."
msgid"The *def* argument may now be ``NULL``, since modules are not necessarily made from definitions."
msgstr"آرگومان *def* اکنون ممکن است ``NULL`` باشد، زیرا ماژول‌ها لزوماً از تعاریف ساخته نمی‌شوند."
msgid":c:member:`Slot ID <PySlot.sl_id>` for a function that will :dfn:`execute`, or initialize, the module. This function does the equivalent to executing the code of a Python module: typically, it adds classes and constants to the module. The signature of the function is:"
msgstr":c:member:`Slot ID <PySlot.sl_id>` برای تابعی که ماژول را :dfn:`execute` (اجرا) یا مقداردهی اولیه می‌کند. این تابع معادل اجرای کد یک ماژول پایتون عمل می‌کند: معمولاً کلاس‌ها و ثابت‌ها را به ماژول اضافه می‌کند. امضای تابع به صورت زیر است:"
msgid"See the :ref:`capi-module-support-functions` section for some useful functions to call."
msgstr"برای مشاهده‌ی برخی توابع مفید جهت فراخوانی، به بخش :ref:`capi-module-support-functions` مراجعه کنید."
msgid"For backwards compatibility, the :c:type:`PyModuleDef.m_slots` array may contain multiple :c:macro:`!Py_mod_exec` slots; these are processed in the order they appear in the array. Elsewhere (that is, in arguments to :c:func:`PyModule_FromSlotsAndSpec` and in return values of :samp:`PyModExport_{<name>}`), repeating the slot is not allowed."
msgstr"به منظور سازگاری با نسخه‌های قبل، آرایه‌ی :c:type:`PyModuleDef.m_slots` ممکن است حاوی چندین جایگاه :c:macro:`!Py_mod_exec` باشد؛ این موارد به ترتیبی که در آرایه ظاهر می‌شوند پردازش خواهند شد. جاهای دیگر (یعنی در آرگومان‌های :c:func:`PyModule_FromSlotsAndSpec` و مقادیر بازگشتی :samp:`PyModExport_{<name>}`)، تکرار جایگاه مجاز نیست."
msgid"Repeated ``Py_mod_exec`` slots are disallowed, except in :c:type:`PyModuleDef.m_slots`."
msgstr"جایگاه‌های تکراری ``Py_mod_exec`` مجاز نیستند، مگر در :c:type:`PyModuleDef.m_slots`."
msgid":c:member:`Slot ID <PySlot.sl_id>` for a table of module-level functions, as an array of :c:type:`PyMethodDef` values suitable as the *functions* argument to :c:func:`PyModule_AddFunctions`."
msgstr":c:member:`Slot ID <PySlot.sl_id>` برای جدولی از توابع در سطح ماژول، به صورت آرایه‌ای از مقادیر :c:type:`PyMethodDef` که به عنوان آرگومان *functions* برای :c:func:`PyModule_AddFunctions` مناسب است."
msgid"Like other slot IDs, a slots array may only contain one :c:macro:`!Py_mod_methods` entry. To add functions from multiple :c:type:`PyMethodDef` arrays, call :c:func:`PyModule_AddFunctions` in the :c:macro:`Py_mod_exec` function."
msgstr"مانند سایر شناسه‌های جایگاه، یک آرایه‌ی جایگاه ممکن است فقط حاوی یک ورودی :c:macro:`!Py_mod_methods` باشد. برای افزودن توابع از چندین آرایه‌ی :c:type:`PyMethodDef`، تابع :c:func:`PyModule_AddFunctions` را در تابع :c:macro:`Py_mod_exec` فراخوانی کنید."
msgid"The table must be statically allocated (or otherwise guaranteed to outlive the module object)."
msgstr"این جدول باید به صورت ایستا تخصیص داده شود (یا به نحوی تضمین شود که عمر آن بیشتر از شیء ماژول است)."
msgid"Use :c:member:`PyModuleDef.m_methods` instead to support previous versions."
msgstr"برای پشتیبانی از نسخه‌های قبلی، به‌جای آن از :c:member:`PyModuleDef.m_methods` استفاده کنید."
msgid"Module state"
msgstr"وضعیت ماژول"
msgid"Extension modules can have *module state* -- a piece of memory that is allocated on module creation, and freed when the module object is deallocated. The module state is specified using :ref:`dedicated slots <ext-module-state-slots>`."
msgstr"ماژول‌های توسعه‌ای می‌توانند *وضعیت ماژول* داشته باشند؛ تکه‌ای از حافظه که هنگام ایجاد ماژول تخصیص داده می‌شود و زمانی که شیء ماژول زدوده‌سازی می‌شود، آزاد می‌گردد. وضعیت ماژول با استفاده از :ref:`جایگاه‌های اختصاصی <ext-module-state-slots>` مشخص می‌شود."
msgid"A typical use of module state is storing an exception type -- or indeed *any* type object defined by the module --"
msgstr"یک کاربرد رایج وضعیت ماژول، ذخیره‌سازی یک نوع استثنا -- یا در واقع *هر* شیء نوع تعریف‌شده توسط ماژول -- است."
msgid"Unlike the module's Python attributes, Python code cannot replace or delete data stored in module state."
msgstr"بر خلاف ویژگی‌های پایتونی ماژول، کد پایتون نمی‌تواند داده‌های ذخیره‌شده در وضعیت ماژول را جایگزین یا حذف کند."
msgid"Keeping per-module information in attributes and module state, rather than in static globals, makes module objects *isolated* and safer for use in multiple sub-interpreters. It also helps Python do an orderly clean-up when it shuts down."
msgstr"نگهداری اطلاعات هر ماژول در ویژگی‌ها و وضعیت ماژول، به‌جای متغیرهای سراسری ایستا، اشیاء ماژول را *ایزوله* و برای استفاده در زیرمفسرهای متعدد امن‌تر می‌کند. همچنین به پایتون کمک می‌کند تا هنگام خاموش شدن، پاکسازی منظمی را انجام دهد."
msgid"Extensions that keep references to Python objects as part of module state must implement :c:macro:`Py_mod_state_traverse` and :c:macro:`Py_mod_state_clear` functions to avoid reference leaks."
msgstr"اکستنشن‌هایی که ارجاع به اشیاء پایتون را به عنوان بخشی از وضعیت ماژول نگه می‌دارند، باید توابع :c:macro:`Py_mod_state_traverse` و :c:macro:`Py_mod_state_clear` را پیاده‌سازی کنند تا از نشت ارجاعات جلوگیری شود."
msgid"To retrieve the state from a given module, use the following functions:"
msgstr"برای بازیابی وضعیت از یک ماژول مشخص، از توابع زیر استفاده کنید:"
msgid"Return the \"state\" of the module, that is, a pointer to the block of memory allocated at module creation time, or ``NULL``. See :c:macro:`Py_mod_state_size`."
msgstr"برگرداندن «وضعیت» ماژول؛ یعنی یک اشاره‌گر به بلوک حافظه‌ای که در زمان ایجاد ماژول تخصیص داده شده است، یا ``NULL``. به :c:macro:`Py_mod_state_size` مراجعه کنید."
msgid"On error, return ``NULL`` with an exception set. Use :c:func:`PyErr_Occurred` to tell this case apart from missing module state."
msgstr"در صورت بروز خطا، مقدار ``NULL`` را همراه با تنظیم یک استثنا برگردانید. از :c:func:`PyErr_Occurred` استفاده کنید تا این حالت را از وضعیت مفقود ماژول متمایز کنید."
msgid"Set *\\*result* to the size of *module*'s state, as specified using :c:macro:`Py_mod_state_size` (or :c:member:`PyModuleDef.m_size`), and return 0."
msgstr"مقدار *\\*result* را برابر با اندازه‌ی وضعیت *module*، همان‌طور که با استفاده از :c:macro:`Py_mod_state_size` (یا :c:member:`PyModuleDef.m_size`) مشخص شده است، قرار دهید و مقدار 0 را برگردانید."
msgid"On error, set *\\*result* to -1, and return -1 with an exception set."
msgstr"در صورت بروز خطا، *\\*result* را روی 1- تنظیم کنید و با تنظیم یک استثنا، 1- را برگردانید."
msgid"Slots for defining module state"
msgstr"جایگاه‌ها برای تعریف وضعیت ماژول"
msgid"The following :c:member:`slot IDs <PySlot.sl_id>` are available for defining the module state."
msgstr"شناسه‌های جایگاه :c:member:`slot IDs <PySlot.sl_id>` زیر برای تعریف وضعیت ماژول در دسترس هستند."
msgid":c:member:`Slot ID <PySlot.sl_id>` for the size of the module state, in bytes."
msgstr":c:member:`شناسه‌ی جایگاه <PySlot.sl_id>` برای اندازه‌ی وضعیت ماژول، بر حسب بایت."
msgid"Setting the value to a non-negative value means that the module can be re-initialized and specifies the additional amount of memory it requires for its state."
msgstr"تنظیم مقدار به یک مقدار غیرمنفی به این معنا است که ماژول می‌تواند دوباره مقداردهی اولیه شود و مقدار حافظه اضافی مورد نیاز برای وضعیت خود را مشخص می‌کند."
msgid"See :PEP:`3121` for more details."
msgstr"برای جزئیات بیشتر به :PEP:`3121` مراجعه کنید."
msgid"Use :c:func:`PyModule_GetStateSize` to retrieve the size of a given module."
msgstr"برای بازیابی اندازه‌ی یک ماژول مشخص، از :c:func:`PyModule_GetStateSize` استفاده کنید."
msgid"Use :c:member:`PyModuleDef.m_size` instead to support previous versions."
msgstr"برای پشتیبانی از نسخه‌های قبلی، به‌جای آن از :c:member:`PyModuleDef.m_size` استفاده کنید."
msgid":c:member:`Slot ID <PySlot.sl_id>` for a traversal function to call during GC traversal of the module object."
msgstr":c:member:`Slot ID <PySlot.sl_id>` برای یک تابع پیمایش که در طول پیمایش GC برای شیء ماژول فراخوانی می‌شود."
msgid"The signature of the function, and meanings of the arguments, is similar as for :c:member:`PyTypeObject.tp_traverse`:"
msgstr"امضای تابع و معانی آرگومان‌ها مشابه :c:member:`PyTypeObject.tp_traverse` است:"
msgid"This function is not called if the module state was requested but is not allocated yet. This is the case immediately after the module is created and before the module is executed (:c:data:`Py_mod_exec` function). More precisely, this function is not called if the state size (:c:data:`Py_mod_state_size`) is greater than 0 and the module state (as returned by :c:func:`PyModule_GetState`) is ``NULL``."
msgstr"اگر وضعیت ماژول درخواست شده باشد اما هنوز تخصیص نیافته باشد، این تابع فراخوانی نمی‌شود. این حالت بلافاصله پس از ایجاد ماژول و قبل از اجرای ماژول (تابع :c:data:`Py_mod_exec`) رخ می‌دهد. به عبارت دقیق‌تر، اگر اندازه‌ی وضعیت (:c:data:`Py_mod_state_size`) بزرگ‌تر از 0 باشد و وضعیت ماژول (که توسط :c:func:`PyModule_GetState` برگردانده می‌شود) برابر با ``NULL`` باشد، این تابع فراخوانی نمی‌شود."
msgid"Use :c:member:`PyModuleDef.m_traverse` instead to support previous versions."
msgstr"برای پشتیبانی از نسخه‌های قبلی، به‌جای آن از :c:member:`PyModuleDef.m_traverse` استفاده کنید."
msgid":c:member:`Slot ID <PySlot.sl_id>` for a clear function to call during GC clearing of the module object."
msgstr":c:member:`Slot ID <PySlot.sl_id>` برای یک تابع پاکسازی که در طول پاکسازی GC شیء ماژول فراخوانی می‌شود."
msgid"The signature of the function is:"
msgstr"امضای تابع به صورت زیر است:"
msgid"Like :c:member:`PyTypeObject.tp_clear`, this function is not *always* called before a module is deallocated. For example, when reference counting is enough to determine that an object is no longer used, the cyclic garbage collector is not involved and the :c:macro:`Py_mod_state_free` function is called directly."
msgstr"مانند :c:member:`PyTypeObject.tp_clear`، این تابع *همیشه* قبل از واگذاری حافظه (deallocation) یک ماژول فراخوانی نمی‌شود. برای مثال، زمانی که شمارش ارقام برای تشخیص اینکه آیا یک شیء دیگر استفاده نمی‌شود کافی است، جمع‌آور زباله‌ی چرخه‌ای درگیر نمی‌شود و تابع :c:macro:`Py_mod_state_free` مستقیماً فراخوانی می‌شود."
msgid"Use :c:member:`PyModuleDef.m_clear` instead to support previous versions."
msgstr"برای پشتیبانی از نسخه‌های قبلی، به‌جای آن از :c:member:`PyModuleDef.m_clear` استفاده کنید."
msgid":c:member:`Slot ID <PySlot.sl_id>` for a function to call during deallocation of the module object."
msgstr":c:member:`Slot ID <PySlot.sl_id>` برای تابعی که در طول واگذاری حافظه (deallocation) شیء ماژول فراخوانی می‌شود."
msgid"Use :c:member:`PyModuleDef.m_free` instead to support previous versions."
msgstr"برای پشتیبانی از نسخه‌های قبلی، به‌جای آن از :c:member:`PyModuleDef.m_free` استفاده کنید."
msgid"Module token"
msgstr"توکن ماژول"
msgid"Each module may have an associated *token*: a pointer-sized value intended to identify of the module state's memory layout. This means that if you have a module object, but you are not sure if it “belongs” to your extension, you can check using code like this:"
msgstr"هر ماژول ممکن است یک *توکن* (token) مرتبط داشته باشد: مقداری به اندازه‌ی اشاره‌گر که برای شناسایی چیدمان حافظه‌ی وضعیت ماژول در نظر گرفته شده است. این یعنی اگر شیء ماژولی دارید، اما مطمئن نیستید که آیا به افزونه‌ی شما «تعلق» دارد یا خیر، می‌توانید با استفاده از کدی شبیه به این آن را بررسی کنید:"
"// This module's state has the expected memory layout; it's safe to cast\n"
"struct my_state state = (struct my_state*)PyModule_GetState(module)"
msgid"A module's token -- and the *your_token* value to use in the above code -- is:"
msgstr"توکن یک ماژول — و مقداری از *your_token* که باید در کد بالا استفاده شود — به این صورت است:"
msgid"For modules created with :c:type:`PyModuleDef`: the address of that :c:type:`PyModuleDef`;"
msgstr"برای ماژول‌های ایجادشده با :c:type:`PyModuleDef`: آدرس همان :c:type:`PyModuleDef`؛"
msgid"For modules defined with the :c:macro:`Py_mod_token` slot: the value of that slot;"
msgstr"برای ماژول‌های تعریف‌شده با جایگاه :c:macro:`Py_mod_token`: مقدار آن جایگاه؛"
msgid"For modules created from an ``PyModExport_*`` :ref:`export hook <extension-export-hook>`: the slots array that the export hook returned (unless overridden with :c:macro:`Py_mod_token`)."
msgstr"برای ماژول‌های ایجادشده از یک :ref:`قلاب اکسپورت <extension-export-hook>` به نام ``PyModExport_*``: آرایه‌ی جایگاه‌هایی که قلاب اکسپورت برگردانده است (مگر اینکه با :c:macro:`Py_mod_token` بازنشانی شود)."
msgid":c:member:`Slot ID <PySlot.sl_id>` for the module token."
msgstr"مورد :c:member:`Slot ID <PySlot.sl_id>` برای توکن ماژول."
msgid"If you use this slot to set the module token (rather than rely on the default), you must ensure that:"
msgstr"اگر از این جایگاه برای تنظیم توکن ماژول استفاده می‌کنید (به‌جای اینکه به مقدار پیش‌فرض اتکا کنید)، باید مطمئن شوید که:"
msgid"The pointer outlives the class, so it's not reused for something else while the class exists."
msgstr"اشاره‌گر بیشتر از کلاس عمر می‌کند، بنابراین تا زمانی که کلاس وجود دارد، برای کار دیگری دوباره استفاده نمی‌شود."
msgid"It \"belongs\" to the extension module where the class lives, so it will not clash with other extensions."
msgstr"به ماژول توسعه‌ای که کلاس در آن قرار دارد «تعلق» دارد، بنابراین با سایر افزونه‌ها تداخل نخواهد داشت."
msgid"If the token points to a :c:type:`PyModuleDef` struct, the module should behave as if it was created from that :c:type:`PyModuleDef`. In particular, the module state must have matching layout and semantics."
msgstr"اگر توکن به یک struct از نوع :c:type:`PyModuleDef` اشاره کند، ماژول باید طوری رفتار کند که گویی از همان :c:type:`PyModuleDef` ایجاد شده است. به‌ویژه، وضعیت ماژول باید دارای چیدمان و معناشناسی منطبق باشد."
msgid"Modules created from :c:type:`PyModuleDef` always use the address of the :c:type:`PyModuleDef` as the token. This means that :c:macro:`!Py_mod_token` cannot be used in :c:member:`PyModuleDef.m_slots`."
msgstr"ماژول‌های ایجادشده از :c:type:`PyModuleDef` همیشه از آدرس :c:type:`PyModuleDef` به عنوان توکن استفاده می‌کنند. این یعنی :c:macro:`!Py_mod_token` را نمی‌توان در :c:member:`PyModuleDef.m_slots` استفاده کرد."
msgid"Set *\\*result* to the module token for *module* and return 0."
msgstr"مقدار *\\*result* را روی توکن ماژول برای *module* تنظیم کنید و مقدار 0 را برگردانید."
msgid"On error, set *\\*result* to NULL, and return -1 with an exception set."
msgstr"در صورت بروز خطا، *\\*result* را روی NULL تنظیم کنید و با تنظیم یک استثنا، مقدار 1- را برگردانید."
msgid"See also :c:func:`PyType_GetModuleByToken`."
msgstr"همچنین نگاه کنید به :c:func:`PyType_GetModuleByToken`."
msgid"Creating extension modules dynamically"
msgstr"ایجاد ماژول‌های توسعه‌ای به‌صورت پویا"
msgid"The following functions may be used to create an extension module dynamically, rather than from an extension's :ref:`export hook <extension-export-hook>`."
msgstr"توابع زیر ممکن است برای ایجاد پویای یک ماژول توسعه‌ای استفاده شوند، به‌جای اینکه از :ref:`قلاب اکسپورت <extension-export-hook>` افزونه استفاده شود."
msgid"Create a new module object, given an array of :ref:`slots <pymoduledef_slot>` and the :py:class:`~importlib.machinery.ModuleSpec` *spec*."
msgstr"یک شیء ماژول جدید ایجاد کنید، با توجه به آرایه‌ای از :ref:`جایگاه‌ها <pymoduledef_slot>` و مشخصات :py:class:`~importlib.machinery.ModuleSpec` به نام *spec*."
msgid"The *slots* argument must point to an array of :c:type:`PySlot` structures, terminated by an entry with slot ID of 0 (typically written as :c:macro:`PySlot_END`). The array must include a :c:data:`Py_mod_abi` entry."
msgstr"آرگومان *slots* باید به آرایه‌ای از ساختارهای :c:type:`PySlot` اشاره کند که با یک درایه با شناسه‌ی جایگاه 0 (که معمولاً به صورت :c:macro:`PySlot_END` نوشته می‌شود) خاتمه می‌یابد. آرایه باید شامل یک درایهی :c:data:`Py_mod_abi` باشد."
msgid"The *spec* argument may be any ``ModuleSpec``-like object, as described in :c:macro:`Py_mod_create` documentation. Currently, the *spec* must have a ``name`` attribute."
msgstr"آرگومان *spec* ممکن است هر شیء شبیه به ``ModuleSpec`` باشد، همان‌طور که در مستندات :c:macro:`Py_mod_create` توصیف شده است. در حال حاضر، *spec* باید دارای ویژگی ``name`` باشد."
msgid"On success, return the new module. On error, return ``NULL`` with an exception set."
msgstr"در صورت موفقیت، ماژول جدید را برگردانید. در صورت بروز خطا، مقدار ``NULL`` را همراه با تنظیم یک استثنا برگردانید."
msgid"Note that this does not process the module's execution slot (:c:data:`Py_mod_exec`). Both :c:func:`!PyModule_FromSlotsAndSpec` and :c:func:`PyModule_Exec` must be called to fully initialize a module. (See also :ref:`multi-phase-initialization`.)"
msgstr"توجه داشته باشید که این کار جایگاه اجرای ماژول (:c:data:`Py_mod_exec`) را پردازش نمی‌کند. برای مقداردهی اولیه کامل یک ماژول، باید هر دو تابع :c:func:`!PyModule_FromSlotsAndSpec` و :c:func:`PyModule_Exec` فراخوانی شوند. (همچنین به :ref:`multi-phase-initialization` مراجعه کنید.)"
msgid"Execute the :c:data:`Py_mod_exec` slot(s) of *module*."
msgstr"جایگاه(های) :c:data:`Py_mod_exec` مربوط به *module* را اجرا کنید."
msgid"On success, return 0. On error, return -1 with an exception set."
msgstr"در صورت موفقیت، 0 را برگردانید. در صورت بروز خطا، -1 را همراه با تنظیم یک استثنا برگردانید."
msgid"For clarity: If *module* has no slots, for example if it uses :ref:`legacy single-phase initialization <single-phase-initialization>`, this function does nothing and returns 0."
msgstr"برای شفافیت: اگر *module* هیچ جایگاهی نداشته باشد، برای نمونه اگر از :ref:`مقدهی اولیهی تک‌فاز قدیمی <single-phase-initialization>` استفاده کند، این تابع هیچ کاری انجام نمی‌دهد و مقدار 0 را برمی‌گرداند."
msgid"Module definition struct"
msgstr"ساختار تعریف ماژول"
msgid"Traditionally, extension modules were defined using a *module definition* as the “description\" of how a module should be created. Rather than using an array of :ref:`slots <pymoduledef_slot>` directly, the definition has dedicated members for most common functionality, and allows additional slots as an extension mechanism."
msgstr"به‌طور سنتی، ماژول‌های توسعه‌ای با استفاده از یک *تعریف ماژول* به عنوان «توصیفی» از نحوه‌ی ایجاد یک ماژول تعریف می‌شدند. به جای استفاده‌ی مستقیم از آرایه‌ای از :ref:`جایگاه‌ها <pymoduledef_slot>`، این تعریف اعضای اختصاصی برای بیشتر قابلیت‌های رایج دارد و جایگاه‌های اضافی را به عنوان مکانیزم توسعه‌ای مجاز می‌داند."
msgid"This way of defining modules is still available and there are no plans to remove it."
msgstr"این روش تعریف ماژول‌ها همچنان در دسترس است و هیچ برنامه‌ای برای حذف آن وجود ندارد."
msgid"The module definition struct, which holds information needed to create a module object."
msgstr"ساختار تعریف ماژول (struct) که اطلاعات لازم برای ایجاد یک شیء ماژول را در خود نگه می‌دارد."
msgid"This structure must be statically allocated (or be otherwise guaranteed to be valid while any modules created from it exist). Usually, there is only one variable of this type for each extension module defined this way."
msgstr"این ساختار باید به صورت ایستا تخصیص داده شود (یا به نحوی تضمین شود که تا زمانی که هر ماژولی که از آن ایجاد شده است وجود دارد، معتبر باقی می‌ماند). معمولاً برای هر ماژول توسعه‌ای که به این روش تعریف می‌شود، فقط یک متغیر از این نوع وجود دارد."
msgid"The struct, including all members, is part of the :ref:`Stable ABI <stable-abi>` for non-free-threaded builds (``abi3``). In the Stable ABI for free-threaded builds (``abi3t``), this struct is opaque, and unusable in practice; see :ref:`pymoduledef_slot` for a replacement."
msgstr"این ساختار، از جمله تمامی اعضا، بخشی از :ref:`ABI پایدار <stable-abi>` برای نسخه‌های غیر نخ‌آزاد (``abi3``) است. در ABI پایدار برای نسخه‌های ساخت نخ‌آزاد (``abi3t``)، این ساختار کدر است و در عمل قابل استفاده نیست؛ برای جایگزین، به :ref:`pymoduledef_slot` مراجعه کنید."
msgid"Always initialize this member to :c:macro:`PyModuleDef_HEAD_INIT`:"
msgstr"همیشه این عضو را مقداردهی اولیه کنید به :c:macro:`PyModuleDef_HEAD_INIT`:"
msgid"The type of :c:member:`!PyModuleDef.m_base`."
msgid"The struct is part of the :ref:`Stable ABI <stable-abi>` for non-free-threaded builds (``abi3``). In the Stable ABI for Free-Threaded Builds (``abi3t``), this struct is opaque, and unusable in practice."
msgstr"این ساختار بخشی از :ref:`ABI پایدار <stable-abi>` برای نسخه‌های غیر نخ‌آزاد (``abi3``) است. در ABI پایدار برای نسخه‌های ساخت نخ‌آزاد (``abi3t``)، این ساختار کدر است و در عمل قابل استفاده نیست."
msgid"The required initial value for :c:member:`!PyModuleDef.m_base`."
msgstr"مقدار اولیهی مورد نیاز برای :c:member:`!PyModuleDef.m_base`."
msgid"Corresponds to the :c:macro:`Py_mod_name` slot."
msgstr"متناظر با جایگاه :c:macro:`Py_mod_name`."
msgid"These members correspond to the :c:macro:`Py_mod_doc` slot. Setting this to NULL is equivalent to omitting the slot."
msgstr"این اعضا متناظر با جایگاه :c:macro:`Py_mod_doc` هستند. تنظیم کردن این مورد روی NULL معادل چشم‌پوشی کردن از آن جایگاه است."
msgid"Corresponds to the :c:macro:`Py_mod_state_size` slot. Setting this to zero is equivalent to omitting the slot."
msgstr"متناظر با جایگاه :c:macro:`Py_mod_state_size` است. تنظیم کردن این مورد روی صفر معادل چشم‌پوشی کردن از آن جایگاه است."
msgid"When using :ref:`legacy single-phase initialization <single-phase-initialization>` or when creating modules dynamically using :c:func:`PyModule_Create` or :c:func:`PyModule_Create2`, :c:member:`!m_size` may be set to -1. This indicates that the module does not support sub-interpreters, because it has global state."
msgstr"هنگام استفاده از :ref:`مقدهی اولیهی تک‌فاز قدیمی <single-phase-initialization>` یا هنگام ایجاد پویای ماژول‌ها با استفاده از :c:func:`PyModule_Create` یا :c:func:`PyModule_Create2`، ممکن است :c:member:`!m_size` روی -1 تنظیم شود. این نشان می‌دهد که ماژول از زیرمفسرها پشتیبانی نمی‌کند، زیرا دارای وضعیت سراسری است."
msgid"Corresponds to the :c:macro:`Py_mod_methods` slot. Setting this to NULL is equivalent to omitting the slot."
msgstr"متناظر با جایگاه :c:macro:`Py_mod_methods` است. تنظیم کردن این مورد روی NULL معادل چشم‌پوشی کردن از آن جایگاه است."
msgid"An array of additional slots, terminated by a ``{0, NULL}`` entry. Note that the entries use the older :c:type:`PyModuleDef_Slot` structure, rather than :c:type:`PySlot`."
msgstr"آرایه‌ای از جایگاه‌های اضافی که با یک درایهی ``{0, NULL}`` خاتمه می‌یابد. توجه داشته باشید که درایه‌ها به جای :c:type:`PySlot`، از ساختار قدیمی‌تر :c:type:`PyModuleDef_Slot` استفاده می‌کنند."
msgid"If the array contains slots corresponding to :c:type:`PyModuleDef` members, the values must match. For example, if you use :c:macro:`Py_mod_name` in :c:member:`!m_slots`, :c:member:`PyModuleDef.m_name` must be set to the same pointer (not just an equal string)."
msgstr"اگر آرایه حاوی جایگاه‌های متناظر با اعضای :c:type:`PyModuleDef` باشد، مقادیر باید مطابقت داشته باشند. برای نمونه، اگر از :c:macro:`Py_mod_name` در :c:member:`!m_slots` استفاده می‌کنید، :c:member:`PyModuleDef.m_name` باید روی همان اشاره‌گر (و نه صرفاً یک رشته‌ی برابر) تنظیم شود."
msgid"Prior to version 3.5, this member was always set to ``NULL``, and was defined as:"
msgstr"پیش از نسخه 3.5، این عضو همیشه روی ``NULL`` تنظیم می‌شد و به این صورت تعریف می‌شد:"
msgid"Older structure defining additional slots of a module."
msgstr"ساختار قدیمی‌تری که جایگاه‌های اضافی یک ماژول را تعریف می‌کند."
msgid"Note that a :c:type:`!PyModuleDef_Slot` array may be included in a :c:type:`!PySlot` array using :c:macro:`Py_mod_slots`, and vice versa using :c:macro:`Py_slot_subslots`."
msgstr"توجه داشته باشید که ممکن است یک آرایه‌ی :c:type:`!PyModuleDef_Slot` با استفاده از :c:macro:`Py_mod_slots` در یک آرایه‌ی :c:type:`!PySlot` گنجانده شود، و بالعکس با استفاده از :c:macro:`Py_slot_subslots`."
msgid"Each :c:type:`!PyModuleDef_Slot` structure ``modslot`` is interpreted as the following :c:type:`PySlot` structure::"
msgstr"هر ساختار :c:type:`!PyModuleDef_Slot` یعنی ``modslot`` به عنوان ساختار :c:type:`PySlot` زیر تفسیر می‌شود::"
msgid""
"(PySlot){\n"
" .sl_id=modslot.slot,\n"
" .sl_flags=PySlot_INTPTR | sub_static,\n"
" .sl_ptr=modslot.value\n"
"}"
msgstr""
"(PySlot){\n"
" .sl_id=modslot.slot,\n"
" .sl_flags=PySlot_INTPTR | sub_static,\n"
" .sl_ptr=modslot.value\n"
"}"
msgid"where ``sub_static`` is ``PySlot_STATIC`` if the slot requires the flag (such as for :c:macro:`Py_mod_methods`), or if this flag is present on the \"parent\" :c:macro:`!Py_mod_slots` slot (if any)."
msgstr"که در آن ``sub_static`` برابر با ``PySlot_STATIC`` است اگر جایگاه به پرچم نیاز داشته باشد (مانند :c:macro:`Py_mod_methods`)، یا اگر این پرچم روی جایگاه «والد» :c:macro:`!Py_mod_slots` (در صورت وجود) حضور داشته باشد."
msgid"Corresponds to :c:member:`PySlot.sl_id`."
msgstr"متناظر با :c:member:`PySlot.sl_id` است."
msgid"Corresponds to :c:member:`PySlot.sl_ptr`."
msgstr"متناظر با :c:member:`PySlot.sl_ptr`."
msgid"These members correspond to the :c:macro:`Py_mod_state_traverse`, :c:macro:`Py_mod_state_clear`, and :c:macro:`Py_mod_state_free` slots, respectively."
msgstr"این اعضا به ترتیب با جایگاه‌های :c:macro:`Py_mod_state_traverse`، :c:macro:`Py_mod_state_clear` و :c:macro:`Py_mod_state_free` مطابقت دارند."
msgid"Setting these members to NULL is equivalent to omitting the corresponding slots."
msgstr"مقداردهی این اعضا به NULL معادل حذف جایگاه‌های مربوطه است."
msgid":c:member:`m_traverse`, :c:member:`m_clear` and :c:member:`m_free` functions are no longer called before the module state is allocated."
msgstr"توابع :c:member:`m_traverse`، :c:member:`m_clear` و :c:member:`m_free` دیگر قبل از تخصیص یافتن وضعیت ماژول فراخوانی نمی‌شوند."
msgid"The type of ``PyModuleDef`` objects."
msgstr"نوع اشیاء ``PyModuleDef``."
msgid":c:member:`Slot ID <PySlot.sl_id>` that works like :c:macro:`Py_slot_subslots`, except it specifies an array of :c:type:`PyModuleDef_Slot` structures."
msgstr":c:member:`Slot ID <PySlot.sl_id>` که مانند :c:macro:`Py_slot_subslots` کار می‌کند، با این تفاوت که آرایه‌ای از ساختارهای :c:type:`PyModuleDef_Slot` را مشخص می‌کند."
msgid"The following API can be used to create modules from a :c:type:`!PyModuleDef` struct:"
msgstr"برای ایجاد ماژول‌ها از یک struct نوع :c:type:`!PyModuleDef` می‌توانید از API زیر استفاده کنید:"
msgid"Create a new module object, given the definition in *def*. This is a macro that calls :c:func:`PyModule_Create2` with *module_api_version* set to :c:macro:`PYTHON_API_VERSION`, or to :c:macro:`PYTHON_ABI_VERSION` if using the :ref:`limited API <limited-c-api>`."
msgstr"بر اساس تعریف داده‌شده در *def*، یک شیء ماژول جدید ایجاد می‌کند. این یک ماکرو است که :c:func:`PyModule_Create2` را با *module_api_version* برابر با :c:macro:`PYTHON_API_VERSION`، یا در صورت استفاده از :ref:`API محدود <limited-c-api>` برابر با :c:macro:`PYTHON_ABI_VERSION`، فراخوانی می‌کند."
msgid"Create a new module object, given the definition in *def*, assuming the API version *module_api_version*. If that version does not match the version of the running interpreter, a :exc:`RuntimeWarning` is emitted."
msgstr"یک شیء ماژول جدید، بر اساس تعریف موجود در *def* و با فرض نسخه API *module_api_version*، ایجاد می‌کند. اگر این نسخه با نسخه مفسر در حال اجرا مطابقت نداشته باشد، یک :exc:`RuntimeWarning` نشان داده می‌شود."
msgid"This function does not support slots. The :c:member:`~PyModuleDef.m_slots` member of *def* must be ``NULL``."
msgstr"این تابع از جایگاه‌ها پشتیبانی نمی‌کند. عضو :c:member:`~PyModuleDef.m_slots` از *def* باید ``NULL`` باشد."
msgid"Most uses of this function should be using :c:func:`PyModule_Create` instead; only use this if you are sure you need it."
msgstr"در بیشتر موارد، به جای این تابع باید از :c:func:`PyModule_Create` استفاده شود؛ تنها زمانی از آن استفاده کنید که مطمئن باشید به آن نیاز دارید."
msgid"This macro calls :c:func:`PyModule_FromDefAndSpec2` with *module_api_version* set to :c:macro:`PYTHON_API_VERSION`, or to :c:macro:`PYTHON_ABI_VERSION` if using the :ref:`limited API <limited-c-api>`."
msgstr"این ماکرو :c:func:`PyModule_FromDefAndSpec2` را با *module_api_version* تنظیم‌شده روی :c:macro:`PYTHON_API_VERSION`، یا روی :c:macro:`PYTHON_ABI_VERSION` در صورت استفاده از :ref:`API محدود <limited-c-api>` فراخوانی می‌کند."
msgid"Prefer :c:func:`PyModule_FromSlotsAndSpec` in new code."
msgstr"در کدهای جدید، :c:func:`PyModule_FromSlotsAndSpec` را ترجیح دهید."
msgid"Create a new module object, given the definition in *def* and the ModuleSpec *spec*, assuming the API version *module_api_version*. If that version does not match the version of the running interpreter, a :exc:`RuntimeWarning` is emitted."
msgstr"با توجه به تعریف موجود در *def* و ModuleSpec *spec*، و با فرض نسخه API *module_api_version*، یک شیء ماژول جدید ایجاد می‌کند. اگر آن نسخه با نسخه مفسر در حال اجرا مطابقت نداشته باشد، یک :exc:`RuntimeWarning` منتشر می‌شود."
msgid"Note that this does not process execution slots (:c:data:`Py_mod_exec`). Both ``PyModule_FromDefAndSpec`` and ``PyModule_ExecDef`` must be called to fully initialize a module."
msgstr"توجه داشته باشید که این، جایگاه‌های اجرا (:c:data:`Py_mod_exec`) را پردازش نمی‌کند. برای مقداردهی اولیهی کامل یک ماژول، باید هر دو ``PyModule_FromDefAndSpec`` و ``PyModule_ExecDef`` فراخوانی شوند."
msgid"Most uses of this function should be using :c:func:`PyModule_FromDefAndSpec` instead; only use this if you are sure you need it."
msgstr"در بیشتر موارد، به‌جای این تابع باید از :c:func:`PyModule_FromDefAndSpec` استفاده کرد؛ تنها در صورتی از این تابع استفاده کنید که مطمئن باشید به آن نیاز دارید."
msgid"Process any execution slots (:c:data:`Py_mod_exec`) given in *def*."
msgstr"پردازش هر جایگاه اجرا (:c:data:`Py_mod_exec`) که در *def* داده شده است."
msgid"To run a module's own execution slots, prefer :c:func:`PyModule_Exec`, which works on modules that were not created from a :c:type:`PyModuleDef` structure."
msgstr"برای اجرای جایگاه‌های اجرایی خودِ ماژول، :c:func:`PyModule_Exec` را ترجیح دهید که روی ماژول‌هایی که با ساختار :c:type:`PyModuleDef` ایجاد نشده‌اند، کار می‌کند."
msgid"The C API version, as an integer (``1013``) and string (``\"1013\"``), respectively. Defined for backwards compatibility."
msgstr"نسخه‌ی رابط برنامه‌نویسی کاربردی C، به ترتیب به صورت یک عدد صحیح (``1013``) و رشته (``\"1013\"``). برای سازگاری با نسخه‌های قبلی تعریف شده است."
msgid"Currently, this constant is not updated in new Python versions, and is not useful for versioning. This may change in the future."
msgstr"در حال حاضر، این ثابت در نسخه‌های جدید پایتون به‌روزرسانی نمی‌شود و برای نسخه‌بندی مفید نیست. این ممکن است در آینده تغییر کند."
msgid"Defined as ``3`` and ``\"3\"``, respectively, for backwards compatibility."
msgstr"برای سازگاری با نسخه‌های پیشین، به ترتیب به عنوان ``3`` و ``\"3\"`` تعریف شده است."
msgid"Support functions"
msgstr"توابع پشتیبانی"
msgid"The following functions are provided to help initialize a module object. They are intended for a module's execution slot (:c:data:`Py_mod_exec`), the initialization function for legacy :ref:`single-phase initialization <single-phase-initialization>`, or code that creates modules dynamically."
msgstr"توابع زیر برای کمک به مقداردهی اولیه یک شیء ماژول ارائه شده‌اند. آن‌ها برای جایگاه اجرای یک ماژول (:c:data:`Py_mod_exec`)، تابع مقداردهی اولیه برای مقداردهی اولیهی تک‌مرحله‌ای قدیمی (:ref:`single-phase initialization <single-phase-initialization>`)، یا کدی که ماژول‌ها را به صورت پویا ایجاد می‌کند، در نظر گرفته شده‌اند."
msgid"Add an object to *module* as *name*. This is a convenience function which can be used from the module's initialization function."
msgstr"یک شیء را با نام *name* به *module* اضافه می‌کند. این تابع برای راحتی کار فراهم شده و می‌توان از آن در تابع مقداردهی اولیهی ماژول استفاده کرد."
msgid"On success, return ``0``. On error, raise an exception and return ``-1``."
msgstr"در صورت موفقیت، ``0`` را برمی‌گرداند. در صورت خطا، یک استثنا ایجاد می‌کند (raise) و ``-1`` را برمی‌گرداند."
msgid"Example usage::"
msgstr"نمونه استفاده::"
msgid""
"static int\n"
"add_spam(PyObject *module, int value)\n"
"{\n"
" PyObject *obj = PyLong_FromLong(value);\n"
" if (obj == NULL) {\n"
" return -1;\n"
" }\n"
" int res = PyModule_AddObjectRef(module, \"spam\", obj);\n"
" Py_DECREF(obj);\n"
" return res;\n"
" }"
msgstr""
"static int\n"
"add_spam(PyObject *module, int value)\n"
"{\n"
" PyObject *obj = PyLong_FromLong(value);\n"
" if (obj == NULL) {\n"
" return -1;\n"
" }\n"
" int res = PyModule_AddObjectRef(module, \"spam\", obj);\n"
" Py_DECREF(obj);\n"
" return res;\n"
" }"
msgid"To be convenient, the function accepts ``NULL`` *value* with an exception set. In this case, return ``-1`` and just leave the raised exception unchanged."
msgstr"برای سهولت، تابع *مقدار* ``NULL`` را همراه با استثنای تنظیم‌شده می‌پذیرد. در این حالت، ``-1`` را برگردانید و استثنای ایجادشده را دست‌نخورده بگذارید."
msgid"The example can also be written without checking explicitly if *obj* is ``NULL``::"
msgstr"این مثال را می‌توان بدون بررسی صریح اینکه آیا *obj* برابر ``NULL`` است یا نه نیز نوشت::"
msgid""
"static int\n"
"add_spam(PyObject *module, int value)\n"
"{\n"
" PyObject *obj = PyLong_FromLong(value);\n"
" int res = PyModule_AddObjectRef(module, \"spam\", obj);\n"
" Py_XDECREF(obj);\n"
" return res;\n"
" }"
msgstr""
"static int\n"
"add_spam(PyObject *module, int value)\n"
"{\n"
" PyObject *obj = PyLong_FromLong(value);\n"
" int res = PyModule_AddObjectRef(module, \"spam\", obj);\n"
" Py_XDECREF(obj);\n"
" return res;\n"
" }"
msgid"Note that ``Py_XDECREF()`` should be used instead of ``Py_DECREF()`` in this case, since *obj* can be ``NULL``."
msgstr"توجه داشته باشید که در این مورد باید از ``Py_XDECREF()`` به جای ``Py_DECREF()`` استفاده شود، زیرا *obj* می‌تواند ``NULL`` باشد."
msgid"The number of different *name* strings passed to this function should be kept small, usually by only using statically allocated strings as *name*. For names that aren't known at compile time, prefer calling :c:func:`PyUnicode_FromString` and :c:func:`PyObject_SetAttr` directly. For more details, see :c:func:`PyUnicode_InternFromString`, which may be used internally to create a key object."
msgstr"تعداد رشته‌های *name* متفاوتی که به این تابع پاس داده می‌شوند باید کم نگه داشته شود؛ این کار معمولاً با استفاده فقط از رشته‌های با تخصیص ایستا به‌عنوان *name* انجام می‌شود. برای نام‌هایی که در زمان کامپایل معلوم نیستند، ترجیح دهید :c:func:`PyUnicode_FromString` و :c:func:`PyObject_SetAttr` را مستقیماً فراخوانی کنید. برای جزئیات بیشتر، :c:func:`PyUnicode_InternFromString` را ببینید که ممکن است به‌طور داخلی برای ایجاد یک شیء کلید استفاده شود."
msgid"Similar to :c:func:`PyModule_AddObjectRef`, but \":term:`steals <steal>`\" a reference to *value* (even on error). It can be called with a result of function that returns a new reference without bothering to check its result or even saving it to a variable."
msgstr"مشابه :c:func:`PyModule_AddObjectRef`، اما ارجاعی به *value* را \":term:`می‌دزدد <steal>`\" (حتی در صورت خطا). می‌توان آن را با نتیجه‌ی تابعی که ارجاع جدیدی برمی‌گرداند فراخوانی کرد، بدون نیاز به بررسی نتیجه‌ی آن یا حتی ذخیره‌ی آن در متغیری."
msgid"Similar to :c:func:`PyModule_AddObjectRef`, but :term:`steals <steal>` a reference to *value* on success (if it returns ``0``)."
msgstr"مشابه :c:func:`PyModule_AddObjectRef` است، اما در صورت موفقیت (اگر ``0`` را برگرداند) ارجاع به *value* را :term:`می‌دزدد <steal>`."
msgid"The new :c:func:`PyModule_Add` or :c:func:`PyModule_AddObjectRef` functions are recommended, since it is easy to introduce reference leaks by misusing the :c:func:`PyModule_AddObject` function."
msgstr"استفاده از توابع جدید :c:func:`PyModule_Add` یا :c:func:`PyModule_AddObjectRef` توصیه می‌شود، زیرا استفاده نادرست از تابع :c:func:`PyModule_AddObject` به‌راحتی می‌تواند منجر به نشتی ارجاع شود."
msgid"Unlike other functions that steal references, ``PyModule_AddObject()`` only releases the reference to *value* **on success**."
msgstr"برخلاف سایر توابعی که ارجاع‌ها را می‌دزدند، ``PyModule_AddObject()`` ارجاع به *value* را تنها **در صورت موفقیت** آزاد می‌کند."
msgid"This means that its return value must be checked, and calling code must :c:func:`Py_XDECREF` *value* manually on error."
msgstr"این بدان معناست که مقدار بازگشتی آن باید بررسی شود و کد فراخواننده باید در صورت خطا، :c:func:`Py_XDECREF` را به‌صورت دستی روی *value* فراخوانی کند."
" // If 'obj' is not NULL and PyModule_AddObject() failed,\n"
" // 'obj' strong reference must be deleted with Py_XDECREF().\n"
" // If 'obj' is NULL, Py_XDECREF() does nothing.\n"
" Py_XDECREF(obj);\n"
" goto error;\n"
"}\n"
"// PyModule_AddObject() stole a reference to obj:\n"
"// Py_XDECREF(obj) is not needed here."
msgid"Add an integer constant to *module* as *name*. This convenience function can be used from the module's initialization function. Return ``-1`` with an exception set on error, ``0`` on success."
msgstr"یک ثابت عدد صحیح را با نام *name* به *module* اضافه می‌کند. می‌توان از این تابع کمکی در تابع مقداردهی اولیهی ماژول استفاده کرد. در صورت خطا، ``-1`` همراه با تنظیم یک استثنا و در صورت موفقیت ``0`` برمی‌گرداند."
msgid"This is a convenience function that calls :c:func:`PyLong_FromLong` and :c:func:`PyModule_AddObjectRef`; see their documentation for details."
msgstr"این یک تابع کمکی است که :c:func:`PyLong_FromLong` و :c:func:`PyModule_AddObjectRef` را فراخوانی می‌کند؛ برای جزئیات به مستندات آن‌ها مراجعه کنید."
msgid"Add a string constant to *module* as *name*. This convenience function can be used from the module's initialization function. The string *value* must be ``NULL``-terminated. Return ``-1`` with an exception set on error, ``0`` on success."
msgstr"یک ثابت رشته‌ای را با نام *name* به *module* اضافه می‌کند. از این تابع کمکی می‌توان در تابع مقداردهی اولیهی ماژول استفاده کرد. رشته‌ی *value* باید با ``NULL`` پایان یابد. در صورت خطا ``-1`` همراه با تنظیم یک استثنا، و در صورت موفقیت ``0`` برمی‌گرداند."
msgid"This is a convenience function that calls :c:func:`PyUnicode_InternFromString` and :c:func:`PyModule_AddObjectRef`; see their documentation for details."
msgstr"این یک تابع کمکی است که :c:func:`PyUnicode_InternFromString` و :c:func:`PyModule_AddObjectRef` را فراخوانی می‌کند؛ برای جزئیات به مستندات آن‌ها مراجعه کنید."
msgid"Add an int constant to *module*. The name and the value are taken from *macro*. For example ``PyModule_AddIntMacro(module, AF_INET)`` adds the int constant *AF_INET* with the value of *AF_INET* to *module*. Return ``-1`` with an exception set on error, ``0`` on success."
msgstr"یک ثابت صحیح به *module* اضافه می‌کند. نام و مقدار از *macro* گرفته می‌شوند. برای مثال، ``PyModule_AddIntMacro(module, AF_INET)`` ثابت صحیح *AF_INET* را با مقدار *AF_INET* به *module* اضافه می‌کند. در صورت خطا ``-1`` همراه با تنظیم یک استثنا و در صورت موفقیت ``0`` را برمی‌گرداند."
msgid"Add a string constant to *module*."
msgstr"افزودن یک ثابت رشته‌ای به *module*."
msgid"Add a type object to *module*. The type object is finalized by calling internally :c:func:`PyType_Ready`. The name of the type object is taken from the last component of :c:member:`~PyTypeObject.tp_name` after dot. Return ``-1`` with an exception set on error, ``0`` on success."
msgstr"یک شیء نوع به *module* اضافه می‌کند. شیء نوع با فراخوانی داخلی :c:func:`PyType_Ready` نهایی‌سازی می‌شود. نام شیء نوع از آخرین جزء :c:member:`~PyTypeObject.tp_name` پس از نقطه گرفته می‌شود. در صورت خطا ``-1`` همراه با یک استثنای تنظیم‌شده و در صورت موفقیت ``0`` برمی‌گرداند."
msgid"Add the functions from the ``NULL`` terminated *functions* array to *module*. Refer to the :c:type:`PyMethodDef` documentation for details on individual entries (due to the lack of a shared module namespace, module level \"functions\" implemented in C typically receive the module as their first parameter, making them similar to instance methods on Python classes)."
msgstr"توابع را از آرایه‌ی *functions* که با ``NULL`` پایان می‌یابد به *module* اضافه می‌کند. برای جزئیات مربوط به ورودی‌های منفرد به مستندات :c:type:`PyMethodDef` مراجعه کنید (به دلیل نبود فضای نام ماژول مشترک، «توابع» سطح ماژول که در C پیاده‌سازی می‌شوند معمولاً ماژول را به‌عنوان نخستین پارامتر خود دریافت می‌کنند که این امر آن‌ها را مشابه متدهای نمونه در کلاس‌های پایتون می‌سازد)."
msgid"This function is called automatically when creating a module from ``PyModuleDef`` (such as when using :ref:`multi-phase-initialization`, ``PyModule_Create``, or ``PyModule_FromDefAndSpec``). Some module authors may prefer defining functions in multiple :c:type:`PyMethodDef` arrays; in that case they should call this function directly."
msgstr"این تابع هنگام ایجاد یک ماژول از ``PyModuleDef`` (مانند زمانی که از :ref:`multi-phase-initialization`، ``PyModule_Create`` یا ``PyModule_FromDefAndSpec`` استفاده می‌شود) به‌طور خودکار فراخوانی می‌شود. برخی از نویسندگان ماژول ممکن است ترجیح دهند توابع را در چندین آرایه‌ی :c:type:`PyMethodDef` تعریف کنند؛ در این صورت باید این تابع را مستقیماً فراخوانی کنند."
msgid"The *functions* array must be statically allocated (or otherwise guaranteed to outlive the module object)."
msgstr"آرایه‌ی *functions* باید به‌صورت ایستا تخصیص داده شود (یا به نحوی دیگر تضمین شود که عمرش از شیء ماژول طولانی‌تر باشد)."
msgid"Set the docstring for *module* to *docstring*. This function is called automatically when creating a module from ``PyModuleDef`` (such as when using :ref:`multi-phase-initialization`, ``PyModule_Create``, or ``PyModule_FromDefAndSpec``)."
msgstr"رشته مستند *module* را به *docstring* تنظیم می‌کند. این تابع هنگام ایجاد ماژول از روی ``PyModuleDef`` (مانند زمان استفاده از :ref:`multi-phase-initialization`، ``PyModule_Create`` یا ``PyModule_FromDefAndSpec``) به‌طور خودکار فراخوانی می‌شود."
msgid"Return ``0`` on success. Return ``-1`` with an exception set on error."
msgstr"در صورت موفقیت ``0`` را برمی‌گرداند. در صورت خطا ``-1`` همراه با تنظیم یک استثنا برمی‌گرداند."
msgid"Indicate that *module* does or does not support running without the global interpreter lock (GIL), using one of the values from :c:macro:`Py_mod_gil`. It must be called during *module*'s initialization function when using :ref:`single-phase-initialization`. If this function is not called during module initialization, the import machinery assumes the module does not support running without the GIL. This function is only available in Python builds configured with :option:`--disable-gil`. Return ``-1`` with an exception set on error, ``0`` on success."
msgstr"با استفاده از یکی از مقادیر :c:macro:`Py_mod_gil` نشان می‌دهد که *module* از اجرا بدون قفل مفسر سراسری (GIL) پشتیبانی می‌کند یا نمی‌کند. هنگام استفاده از :ref:`single-phase-initialization`، این تابع باید در طول تابع مقداردهی اولیهی *module* فراخوانی شود. اگر این تابع در طول مقداردهی اولیه ماژول فراخوانی نشود، سازوکار ایمپورت فرض می‌کند که ماژول از اجرا بدون GIL پشتیبانی نمی‌کند. این تابع فقط در ساخت‌های پایتون که با :option:`--disable-gil` پیکربندی شده‌اند در دسترس است. در صورت خطا ``-1`` را همراه با تنظیم یک استثنا و در صورت موفقیت ``0`` را برمی‌گرداند."
msgid"The legacy :ref:`single-phase initialization <single-phase-initialization>` initialization scheme creates singleton modules that can be looked up in the context of the current interpreter. This allows the module object to be retrieved later with only a reference to the module definition."
msgstr"طرح مقداردهی اولیهی :ref:`مقداردهی اولیه تک‌مرحله‌ای <single-phase-initialization>` قدیمی، ماژول‌های تک‌نمونه ایجاد می‌کند که می‌توان آن‌ها را در زمینه‌ی مفسر جاری جستجو کرد. این امکان را فراهم می‌کند که شیء ماژول بعداً تنها با یک ارجاع به تعریف ماژول بازیابی شود."
msgid"These functions will not work on modules created using multi-phase initialization, since multiple such modules can be created from a single definition."
msgstr"این توابع روی ماژول‌هایی که با استفاده از مقداردهی اولیه چندمرحله‌ای (multi-phase initialization) ایجاد شده‌اند کار نخواهند کرد، زیرا می‌توان چندین ماژول از این نوع را از یک تعریف واحد ایجاد کرد."
msgid"Returns the module object that was created from *def* for the current interpreter. This method requires that the module object has been attached to the interpreter state with :c:func:`PyState_AddModule` beforehand. In case the corresponding module object is not found or has not been attached to the interpreter state yet, it returns ``NULL``."
msgstr"شیء ماژولی که از *def* برای مفسر فعلی ایجاد شده است را برمی‌گرداند. این متد مستلزم آن است که شیء ماژول از قبل با :c:func:`PyState_AddModule` به وضعیت مفسر متصل شده باشد. در صورتی که شیء ماژول مربوطه یافت نشود یا هنوز به وضعیت مفسر متصل نشده باشد، ``NULL`` را برمی‌گرداند."
msgid"Attaches the module object passed to the function to the interpreter state. This allows the module object to be accessible via :c:func:`PyState_FindModule`."
msgstr"شیء ماژولِ پاس‌داده‌شده به تابع را به وضعیت مفسر متصل می‌کند. این کار امکان دسترسی به شیء ماژول از طریق :c:func:`PyState_FindModule` را فراهم می‌کند."
msgid"Only effective on modules created using single-phase initialization."
msgstr"تنها بر ماژول‌هایی که با استفاده از مقداردهی اولیه تک‌مرحله‌ای ایجاد شده‌اند مؤثر است."
msgid"Python calls ``PyState_AddModule`` automatically after importing a module that uses :ref:`single-phase initialization <single-phase-initialization>`, so it is unnecessary (but harmless) to call it from module initialization code. An explicit call is needed only if the module's own init code subsequently calls ``PyState_FindModule``. The function is mainly intended for implementing alternative import mechanisms (either by calling it directly, or by referring to its implementation for details of the required state updates)."
msgstr"پایتون پس از ایمپورت کردن ماژولی که از :ref:`راه‌اندازی تک‌فازی <single-phase-initialization>` استفاده می‌کند، ``PyState_AddModule`` را به‌طور خودکار فراخوانی می‌کند؛ بنابراین فراخوانی آن از کد راه‌اندازی ماژول ضروری نیست (اما بی‌ضرر است). تنها در صورتی به فراخوانی صریح آن نیاز است که کد راه‌اندازی خودِ ماژول در ادامه ``PyState_FindModule`` را فراخوانی کند. این تابع عمدتاً برای پیاده‌سازی سازوکارهای ایمپورت جایگزین در نظر گرفته شده است (چه با فراخوانی مستقیم آن، چه با مراجعه به پیاده‌سازی آن برای جزئیات به‌روزرسانی‌های وضعیت موردنیاز)."
msgid"If a module was attached previously using the same *def*, it is replaced by the new *module*."
msgstr"اگر پیش‌تر ماژولی با استفاده از همان *def* پیوست شده باشد، با *module* جدید جایگزین می‌شود."
msgid"The caller must have an :term:`attached thread state`."
msgstr"فراخوان‌کننده باید یک :term:`attached thread state` داشته باشد."
msgid"Return ``-1`` with an exception set on error, ``0`` on success."
msgstr"در صورت خطا، ``-1`` همراه با استثنای تنظیم‌شده و در صورت موفقیت ``0`` برمی‌گرداند."
msgid"Removes the module object created from *def* from the interpreter state. Return ``-1`` with an exception set on error, ``0`` on success."
msgstr"شیء ماژول ایجادشده از *def* را از وضعیت مفسر حذف می‌کند. در صورت خطا ``-1`` همراه با استثنای تنظیم‌شده و در صورت موفقیت ``0`` برمی‌گرداند."
msgid"object"
msgstr"شیء"
msgid"module"
msgstr"ماژول"
msgid"ModuleType (in module types)"
msgstr"ModuleType (در ماژول types)"
msgid"__name__ (module attribute)"
msgstr"__name__ (ویژگی ماژول)"
msgid"__doc__ (module attribute)"
msgstr"__doc__ (ویژگی ماژول)"
msgid"__file__ (module attribute)"
msgstr"__file__ (ویژگی ماژول)"
msgid"__package__ (module attribute)"
msgstr"__package__ (ویژگی ماژول)"
msgid"__loader__ (module attribute)"
msgstr"__loader__ (ویژگی ماژول)"
msgid"__dict__ (module attribute)"
msgstr"__dict__ (ویژگی ماژول)"
msgid"SystemError (built-in exception)"
msgstr"SystemError (استثنای توکار)"
#~ msgid "The functions in the previous section work on any module object, including modules imported from Python code."
#~ msgstr "توابع بخش قبلی روی هر شیء ماژول کار می‌کنند، از جمله ماژول‌هایی که از کد پایتون ایمپورت شده‌اند."
#~ msgid "Modules defined using the C API typically use a *module definition*, :c:type:`PyModuleDef` -- a statically allocated, constant “description\" of how a module should be created."
#~ msgstr "ماژول‌هایی که با استفاده از C API تعریف می‌شوند، معمولاً از یک *تعریف ماژول*، :c:type:`PyModuleDef`، استفاده می‌کنند -- یک «توصیف» ثابت و تخصیص‌یافته به‌صورت ایستا از چگونگی ایجاد یک ماژول."
#~ msgid "Unlike :c:func:`PyModule_New`, the definition allows management of *module state* -- a piece of memory that is allocated and cleared together with the module object. Unlike the module's Python attributes, Python code cannot replace or delete data stored in module state."
#~ msgstr "برخلاف :c:func:`PyModule_New`، این تعریف امکان مدیریت *وضعیت ماژول* را فراهم می‌کند -- تکه‌ای از حافظه که همراه با شیء ماژول تخصیص داده و پاکسازی می‌شود. برخلاف ویژگی‌های پایتونیِ ماژول، کد پایتون نمی‌تواند داده‌های ذخیره‌شده در وضعیت ماژول را جایگزین یا حذف کند."
#~ msgid "Name for the new module."
#~ msgstr "نام ماژول جدید."
#~ msgid "Module state may be kept in a per-module memory area that can be retrieved with :c:func:`PyModule_GetState`, rather than in static globals. This makes modules safe for use in multiple sub-interpreters."
#~ msgstr "وضعیت ماژول می‌تواند به‌جای متغیرهای سراسری ایستا، در ناحیه حافظه‌ی مخصوص هر ماژول نگهداری شود که می‌توان آن را با :c:func:`PyModule_GetState` بازیابی کرد. این کار باعث می‌شود ماژول‌ها برای استفاده در چندین زیرمفسر ایمن باشند."
#~ msgid "This memory area is allocated based on *m_size* on module creation, and freed when the module object is deallocated, after the :c:member:`~PyModuleDef.m_free` function has been called, if present."
#~ msgstr "این ناحیه حافظه هنگام ایجاد ماژول بر اساس *m_size* تخصیص داده می‌شود و هنگام تخصیص‌زدایی شیء ماژول، پس از فراخوانی تابع :c:member:`~PyModuleDef.m_free` (در صورت وجود)، آزاد می‌شود."
#~ msgid "Setting ``m_size`` to ``-1`` means that the module does not support sub-interpreters, because it has global state. Negative ``m_size`` is only allowed when using :ref:`legacy single-phase initialization <single-phase-initialization>` or when :ref:`creating modules dynamically <moduledef-dynamic>`."
#~ msgstr "تنظیم ``m_size`` روی ``-1`` به این معنی است که ماژول از زیرمفسرها پشتیبانی نمی‌کند، زیرا دارای وضعیت سراسری است. مقدار منفی ``m_size`` تنها هنگام استفاده از :ref:`راه‌اندازی تک‌فازی قدیمی <single-phase-initialization>` یا هنگام :ref:`ایجاد ماژول‌ها به‌صورت پویا <moduledef-dynamic>` مجاز است."
#~ msgid "An array of slot definitions for multi-phase initialization, terminated by a ``{0, NULL}`` entry. When using legacy single-phase initialization, *m_slots* must be ``NULL``."
#~ msgstr "آرایه‌ای از تعریف‌های جایگاه برای مقداردهی اولیه چندمرحله‌ای که با ورودی ``{0, NULL}`` پایان می‌یابد. هنگام استفاده از مقداردهی اولیه تک‌مرحله‌ای قدیمی، *m_slots* باید ``NULL`` باشد."
#~ msgid "No longer called before the module state is allocated."
#~ msgstr "دیگر پیش از تخصیص وضعیت ماژول فراخوانی نمی‌شود."
#~ msgid "A slot ID, chosen from the available values explained below."
#~ msgstr "شناسه‌ی جایگاه، که از میان مقادیر موجود توضیح‌داده‌شده در ادامه انتخاب می‌شود."
#~ msgid "Value of the slot, whose meaning depends on the slot ID."
#~ msgstr "مقدار جایگاه، که معنای آن به شناسه جایگاه بستگی دارد."
#~ msgid "The available slot types are:"
#~ msgstr "انواع جایگاه‌های موجود عبارت‌اند از:"
#~ msgid "The function receives a :py:class:`~importlib.machinery.ModuleSpec` instance, as defined in :PEP:`451`, and the module definition. It should return a new module object, or set an error and return ``NULL``."
#~ msgstr "این تابع یک نمونه‌ی :py:class:`~importlib.machinery.ModuleSpec` را که در :PEP:`451` تعریف شده است، و تعریف ماژول را دریافت می‌کند. این تابع باید یک شیء ماژول جدید برگرداند، یا خطا را تنظیم کرده و ``NULL`` را برگرداند."
#~ msgid "Multiple ``Py_mod_create`` slots may not be specified in one module definition."
#~ msgstr "نمی‌توان چند جایگاه ``Py_mod_create`` را در یک تعریف ماژول مشخص کرد."
#~ msgid "There is no requirement for the returned object to be an instance of :c:type:`PyModule_Type`. Any type can be used, as long as it supports setting and getting import-related attributes. However, only ``PyModule_Type`` instances may be returned if the ``PyModuleDef`` has non-``NULL`` ``m_traverse``, ``m_clear``, ``m_free``; non-zero ``m_size``; or slots other than ``Py_mod_create``."
#~ msgstr "هیچ الزامی وجود ندارد که شیء بازگردانده‌شده نمونه‌ای از :c:type:`PyModule_Type` باشد. می‌توان از هر نوعی استفاده کرد، به شرط آنکه از تنظیم و دریافت ویژگی‌های مرتبط با ایمپورت پشتیبانی کند. با این حال، تنها نمونه‌های ``PyModule_Type`` را می‌توان بازگرداند اگر ``PyModuleDef`` دارای ``m_traverse``، ``m_clear`` و ``m_free`` غیر ``NULL``؛ ``m_size`` غیرصفر؛ یا جایگاه‌هایی غیر از ``Py_mod_create`` باشد."
#~ msgid "If multiple ``Py_mod_exec`` slots are specified, they are processed in the order they appear in the *m_slots* array."
#~ msgstr "اگر چندین جایگاه ``Py_mod_exec`` مشخص شده باشند، به ترتیبی که در آرایه *m_slots* ظاهر شده‌اند پردازش می‌شوند."
#~ msgid "Specifies one of the following values:"
#~ msgstr "یکی از مقادیر زیر را مشخص می‌کند:"
#~ msgid "Multiple ``Py_mod_multiple_interpreters`` slots may not be specified in one module definition."
#~ msgstr "نمی‌توان چند جایگاه ``Py_mod_multiple_interpreters`` در یک تعریف ماژول مشخص کرد."
#~ msgid "Multiple ``Py_mod_gil`` slots may not be specified in one module definition."
#~ msgstr "تعیین چند جایگاه ``Py_mod_gil`` در یک تعریف ماژول مجاز نیست."
#~ msgid "The following functions may be used to create a module outside of an extension's :ref:`initialization function <extension-export-hook>`. They are also used in :ref:`single-phase initialization <single-phase-initialization>`."
#~ msgstr "از توابع زیر می‌توان برای ایجاد یک ماژول خارج از :ref:`تابع مقداردهی اولیه <extension-export-hook>` یک ماژول توسعه‌ای استفاده کرد. این توابع در :ref:`مقداردهی اولیه تک‌فازی <single-phase-initialization>` نیز به کار می‌روند."