capsule.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
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-09-16 12:56+0000\n"
"PO-Revision-Date: 2021-06-28 00:47+0000\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/python/python-docs-fa/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 "Capsules"
msgstr "کپسول‌ها (Capsules)"

msgid "Refer to :ref:`using-capsules` for more information on using these objects."
msgstr "برای اطلاعات بیشتر درباره استفاده از این اشیاء، به :ref:`using-capsules` مراجعه کنید."

msgid "This subtype of :c:type:`PyObject` represents an opaque value, useful for C extension modules which need to pass an opaque value (as a :c:expr:`void*` pointer) through Python code to other C code.  It is often used to make a C function pointer defined in one module available to other modules, so the regular import mechanism can be used to access C APIs defined in dynamically loaded modules."
msgstr "این زیرنوع از :c:type:`PyObject` نمایانگر یک مقدار مات است و برای ماژول‌های توسعه‌ای C که نیاز دارند مقداری مات را (به‌صورت اشاره‌گر :c:expr:`void*`) از طریق کد پایتون به کد C دیگری منتقل کنند، مفید است. این نوع اغلب برای در اختیار ماژول‌های دیگر قرار دادن اشاره‌گر تابع C تعریف‌شده در یک ماژول استفاده می‌شود، به‌طوری که بتوان از سازوکار ایمپورت معمول برای دسترسی به APIهای C تعریف‌شده در ماژول‌های بارگذاری‌شده به‌صورت پویا استفاده کرد."

msgid "The type object corresponding to capsule objects. This is the same object as :class:`types.CapsuleType` in the Python layer."
msgstr "شیء نوعِ متناظر با شیءهای کپسول. این همان شیء :class:`types.CapsuleType` در لایه‌ی پایتون است."

msgid "The type of a destructor callback for a capsule.  Defined as::"
msgstr "نوع کال‌بک مخرب برای یک کپسول. به صورت زیر تعریف می‌شود::"

msgid "typedef void (*PyCapsule_Destructor)(PyObject *);"
msgstr "typedef void (*PyCapsule_Destructor)(PyObject *);"

msgid "See :c:func:`PyCapsule_New` for the semantics of PyCapsule_Destructor callbacks."
msgstr "برای آگاهی از معناشناسی کال‌بک‌های PyCapsule_Destructor به :c:func:`PyCapsule_New` مراجعه کنید."

msgid "Return true if its argument is a :c:type:`PyCapsule`.  This function always succeeds."
msgstr "اگر آرگومان آن یک :c:type:`PyCapsule` باشد، مقدار true را برمی‌گرداند. این تابع همیشه با موفقیت اجرا می‌شود."

msgid "Create a :c:type:`PyCapsule` encapsulating the *pointer*.  The *pointer* argument may not be ``NULL``."
msgstr "یک :c:type:`PyCapsule` ایجاد می‌کند که *اشاره‌گر* را کپسوله می‌کند. آرگومان *اشاره‌گر* نمی‌تواند ``NULL`` باشد."

msgid "On failure, set an exception and return ``NULL``."
msgstr "در صورت شکست، یک استثنا تنظیم کرده و ``NULL`` را برگردانید."

msgid "The *name* string may either be ``NULL`` or a pointer to a valid C string.  If non-``NULL``, this string must outlive the capsule.  (Though it is permitted to free it inside the *destructor*.)"
msgstr "رشته *name* می‌تواند ``NULL`` یا اشاره‌گری به یک رشته C معتبر باشد. اگر ``NULL`` نباشد، این رشته باید بیشتر از کپسول عمر کند. (هرچند آزاد کردن آن درون *مخرب* مجاز است.)"

msgid "If the *destructor* argument is not ``NULL``, it will be called with the capsule as its argument when it is destroyed."
msgstr "اگر آرگومان *مخرب* ``NULL`` نباشد، هنگامی که کپسول نابود می‌شود، با کپسول به‌عنوان آرگومان آن فراخوانی خواهد شد."

msgid "If this capsule will be stored as an attribute of a module, the *name* should be specified as ``modulename.attributename``.  This will enable other modules to import the capsule using :c:func:`PyCapsule_Import`."
msgstr "اگر این کپسول قرار است به‌عنوان ویژگی یک ماژول ذخیره شود، *نام* باید به‌صورت ``modulename.attributename`` مشخص شود. این کار به ماژول‌های دیگر امکان می‌دهد کپسول را با استفاده از :c:func:`PyCapsule_Import` ایمپورت کنند."

msgid "Retrieve the *pointer* stored in the capsule.  On failure, set an exception and return ``NULL``."
msgstr "*اشاره‌گر* ذخیره‌شده در کپسول را بازیابی می‌کند. در صورت شکست، یک استثنا تنظیم می‌کند و ``NULL`` را برمی‌گرداند."

msgid "The *name* parameter must compare exactly to the name stored in the capsule. If the name stored in the capsule is ``NULL``, the *name* passed in must also be ``NULL``.  Python uses the C function :c:func:`!strcmp` to compare capsule names."
msgstr "پارامتر *name* باید دقیقاً با نام ذخیره‌شده در کپسول مقایسه شود. اگر نام ذخیره‌شده در کپسول ``NULL`` باشد، *name* گذرانده‌شده نیز باید ``NULL`` باشد. پایتون برای مقایسه‌ی نام کپسول‌ها از تابع C :c:func:`!strcmp` استفاده می‌کند."

msgid "Return the current destructor stored in the capsule.  On failure, set an exception and return ``NULL``."
msgstr "مخرب فعلی ذخیره‌شده در کپسول را بازمی‌گرداند. در صورت شکست، یک استثنا تنظیم کرده و ``NULL`` را بازمی‌گرداند."

msgid "It is legal for a capsule to have a ``NULL`` destructor.  This makes a ``NULL`` return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :c:func:`PyErr_Occurred` to disambiguate."
msgstr "داشتن مخرب ``NULL`` برای یک کپسول مجاز است. این امر کد بازگشتی ``NULL`` را تا حدی مبهم می‌کند؛ برای رفع ابهام، از :c:func:`PyCapsule_IsValid` یا :c:func:`PyErr_Occurred` استفاده کنید."

msgid "Return the current context stored in the capsule.  On failure, set an exception and return ``NULL``."
msgstr "زمینه فعلی ذخیره‌شده در کپسول را بازمی‌گرداند. در صورت شکست، یک استثنا تنظیم کرده و ``NULL`` را بازمی‌گرداند."

msgid "It is legal for a capsule to have a ``NULL`` context.  This makes a ``NULL`` return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :c:func:`PyErr_Occurred` to disambiguate."
msgstr "داشتن زمینه ``NULL`` برای یک کپسول مجاز است. این امر کد بازگشتی ``NULL`` را تا حدی مبهم می‌کند؛ برای رفع ابهام از :c:func:`PyCapsule_IsValid` یا :c:func:`PyErr_Occurred` استفاده کنید."

msgid "Return the current name stored in the capsule.  On failure, set an exception and return ``NULL``."
msgstr "نام فعلی ذخیره‌شده در کپسول را برمی‌گرداند.  در صورت شکست، یک استثنا تنظیم کرده و ``NULL`` را برمی‌گرداند."

msgid "It is legal for a capsule to have a ``NULL`` name.  This makes a ``NULL`` return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :c:func:`PyErr_Occurred` to disambiguate."
msgstr "مجاز است که یک کپسول نام ``NULL`` داشته باشد. این امر کد بازگشتی ``NULL`` را تا حدی مبهم می‌کند؛ برای رفع ابهام، از :c:func:`PyCapsule_IsValid` یا :c:func:`PyErr_Occurred` استفاده کنید."

msgid "Import a pointer to a C object from a capsule attribute in a module.  The *name* parameter should specify the full name to the attribute, as in ``module.attribute``.  The *name* stored in the capsule must match this string exactly."
msgstr "اشاره‌گر به یک شیء C را از یک ویژگی کپسول در یک ماژول ایمپورت می‌کند. پارامتر *name* باید نام کامل ویژگی را مشخص کند، مانند ``module.attribute``. *name* ذخیره‌شده در کپسول باید دقیقاً با این رشته مطابقت داشته باشد."

msgid "This function splits *name* on the ``.`` character, and imports the first element. It then processes further elements using attribute lookups."
msgstr "این تابع *name* را بر اساس نویسه‌ی ``.`` تجزیه می‌کند و اولین عنصر را ایمپورت می‌کند. سپس عناصر بعدی را با استفاده از جستجوهای ویژگی پردازش می‌کند."

msgid "Return the capsule's internal *pointer* on success.  On failure, set an exception and return ``NULL``."
msgstr "در صورت موفقیت، *اشاره‌گر* داخلی کپسول را برمی‌گرداند. در صورت شکست، یک استثنا تنظیم کرده و ``NULL`` برمی‌گرداند."

msgid "If *name* points to an attribute of some submodule or subpackage, this submodule or subpackage must be previously imported using other means (for example, by using :c:func:`PyImport_ImportModule`) for the attribute lookups to succeed."
msgstr "اگر *name* به ویژگی‌ای از یک زیرماژول یا زیربسته اشاره کند، این زیرماژول یا زیربسته باید پیش‌تر به روشی دیگر ایمپورت شده باشد (برای مثال، با استفاده از :c:func:`PyImport_ImportModule`) تا جستجوی ویژگی‌ها با موفقیت انجام شود."

msgid "*no_block* has no effect anymore."
msgstr "*no_block* دیگر هیچ تأثیری ندارد."

msgid "Determines whether or not *capsule* is a valid capsule.  A valid capsule is non-``NULL``, passes :c:func:`PyCapsule_CheckExact`, has a non-``NULL`` pointer stored in it, and its internal name matches the *name* parameter.  (See :c:func:`PyCapsule_GetPointer` for information on how capsule names are compared.)"
msgstr "تعیین می‌کند که *capsule* یک کپسول معتبر است یا خیر. یک کپسول معتبر غیر ``NULL`` است، از :c:func:`PyCapsule_CheckExact` عبور می‌کند، اشاره‌گری غیر ``NULL`` در آن ذخیره شده است، و نام داخلی آن با پارامتر *name* مطابقت دارد. (برای اطلاعات درباره‌ی نحوه‌ی مقایسه‌ی نام‌های کپسول، :c:func:`PyCapsule_GetPointer` را ببینید.)"

msgid "In other words, if :c:func:`PyCapsule_IsValid` returns a true value, calls to any of the accessors (any function starting with ``PyCapsule_Get``) are guaranteed to succeed."
msgstr "به عبارت دیگر، اگر :c:func:`PyCapsule_IsValid` مقداری درست برگرداند، موفقیت فراخوانی هر یک از دسترسی‌دهنده‌ها (accessor) (هر تابعی که با ``PyCapsule_Get`` شروع می‌شود) تضمین می‌شود."

msgid "Return a nonzero value if the object is valid and matches the name passed in. Return ``0`` otherwise.  This function will not fail."
msgstr "اگر شیء معتبر باشد و با نام ارسال‌شده مطابقت داشته باشد، مقدار ناصفر بازگردانده می‌شود. در غیر این صورت ``0`` بازگردانده می‌شود.  این تابع شکست نخواهد خورد."

msgid "Set the context pointer inside *capsule* to *context*."
msgstr "اشاره‌گر زمینه درون *capsule* را برابر *context* قرار می‌دهد."

msgid "Return ``0`` on success.  Return nonzero and set an exception on failure."
msgstr "در صورت موفقیت ``0`` را برمی‌گرداند. در صورت شکست، مقداری غیر از صفر برمی‌گرداند و یک استثنا تنظیم می‌کند."

msgid "Set the destructor inside *capsule* to *destructor*."
msgstr "مخرب درون *capsule* را برابر *destructor* قرار دهید."

msgid "Set the name inside *capsule* to *name*.  If non-``NULL``, the name must outlive the capsule.  If the previous *name* stored in the capsule was not ``NULL``, no attempt is made to free it."
msgstr "نام داخل *capsule* را برابر *name* قرار می‌دهد. اگر ``NULL`` نباشد، نام باید از کپسول عمر بیشتری داشته باشد. اگر *name* قبلیِ ذخیره‌شده در کپسول ``NULL`` نبوده باشد، هیچ تلاشی برای آزاد کردن آن صورت نمی‌گیرد."

msgid "Set the void pointer inside *capsule* to *pointer*.  The pointer may not be ``NULL``."
msgstr "اشاره‌گر void درون *capsule* را برابر *pointer* قرار می‌دهد.  این اشاره‌گر نمی‌تواند ``NULL`` باشد."

msgid "object"
msgstr "شیء"

msgid "Capsule"
msgstr "کپسول"