tls.po

# Persian translations for Python package.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# Automatically generated, 2026.
#
# Translators:
# 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: 2026-07-25 12:59+0330\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: none\n"
"Language: fa\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

msgid "Thread-local storage support"
msgstr "پشتیبانی از ذخیره‌سازی نخ‌محلی"

msgid "The Python interpreter provides low-level support for thread-local storage (TLS) which wraps the underlying native TLS implementation to support the Python-level thread-local storage API (:class:`threading.local`).  The CPython C level APIs are similar to those offered by pthreads and Windows: use a thread key and functions to associate a :c:expr:`void*` value per thread."
msgstr "مفسر پایتون پشتیبانی سطح پایین برای ذخیره‌سازی نخ‌محلی (TLS) فراهم می‌کند که پیاده‌سازی بومی TLS در لایه زیرین را پوشش می‌دهد تا از API ذخیره‌سازی نخ‌محلی در سطح پایتون (:class:`threading.local`) پشتیبانی کند. APIهای سطح C سی‌پایتون مشابه APIهایی هستند که pthreads و ویندوز ارائه می‌دهند: از یک کلید نخ و توابعی برای مرتبط کردن یک مقدار :c:expr:`void*` به ازای هر نخ استفاده می‌کنند."

msgid "A :term:`thread state` does *not* need to be :term:`attached <attached thread state>` when calling these functions; they supply their own locking."
msgstr ":term:`وضعیت نخ <thread state>` هنگام فراخوانی این توابع *لازم نیست* :term:`متصل <attached thread state>` باشد؛ این توابع قفل‌گذاری خودشان را فراهم می‌کنند."

msgid "Note that :file:`Python.h` does not include the declaration of the TLS APIs, you need to include :file:`pythread.h` to use thread-local storage."
msgstr "توجه داشته‌باشید که :file:`Python.h` شامل اعلان API‌های TLS نیست؛ برای استفاده از ذخیره‌سازی نخ‌محلی، باید :file:`pythread.h` را include کنید."

msgid "None of these API functions handle memory management on behalf of the :c:expr:`void*` values.  You need to allocate and deallocate them yourself. If the :c:expr:`void*` values happen to be :c:expr:`PyObject*`, these functions don't do refcount operations on them either."
msgstr "هیچ‌یک از این توابع API مدیریت حافظه را برای مقادیر :c:expr:`void*` انجام نمی‌دهند. شما باید خودتان آن‌ها را تخصیص دهید و آزاد کنید. اگر مقادیر :c:expr:`void*` اتفاقاً :c:expr:`PyObject*` باشند، این توابع نیز هیچ عملیات شمارش ارجاعی روی آن‌ها انجام نمی‌دهند."

msgid "Thread-specific storage API"
msgstr "API ذخیره‌سازی ویژه‌ی نخ (Thread-Specific Storage)"

msgid "The thread-specific storage (TSS) API was introduced to supersede the use of the existing TLS API within the CPython interpreter.  This API uses a new type :c:type:`Py_tss_t` instead of :c:expr:`int` to represent thread keys."
msgstr "API ذخیره‌سازی اختصاصی نخ (TSS) برای جایگزینی استفاده از API موجود TLS در مفسر سی‌پایتون معرفی شد. این API از نوع جدید :c:type:`Py_tss_t` به‌جای :c:expr:`int` برای نمایش کلیدهای نخ استفاده می‌کند."

msgid "\"A New C-API for Thread-Local Storage in CPython\" (:pep:`539`)"
msgstr "«یک C-API جدید برای ذخیره‌سازی نخ‌محلی در سی‌پایتون» (:pep:`539`)"

msgid "This data structure represents the state of a thread key, the definition of which may depend on the underlying TLS implementation, and it has an internal field representing the key's initialization state.  There are no public members in this structure."
msgstr "این ساختار داده وضعیت یک کلید نخ را نشان می‌دهد که تعریف آن ممکن است به پیاده‌سازی زیربنایی TLS وابسته باشد، و دارای یک فیلد داخلی است که وضعیت مقداردهی اولیه‌ی کلید را نشان می‌دهد. هیچ عضو عمومی‌ای در این ساختار وجود ندارد."

msgid "When :ref:`Py_LIMITED_API <stable>` is not defined, static allocation of this type by :c:macro:`Py_tss_NEEDS_INIT` is allowed."
msgstr "وقتی :ref:`Py_LIMITED_API <stable>` تعریف نشده باشد، تخصیص ایستای این نوع با :c:macro:`Py_tss_NEEDS_INIT` مجاز است."

msgid "This macro expands to the initializer for :c:type:`Py_tss_t` variables. Note that this macro won't be defined with :ref:`Py_LIMITED_API <stable>`."
msgstr "این ماکرو به مقداردهنده‌ی اولیه‌ی متغیرهای :c:type:`Py_tss_t` بسط می‌یابد. توجه داشته باشید که این ماکرو همراه با :ref:`Py_LIMITED_API <stable>` تعریف نخواهد شد."

msgid "Dynamic allocation"
msgstr "تخصیص پویا"

msgid "Dynamic allocation of the :c:type:`Py_tss_t`, required in extension modules built with :ref:`Py_LIMITED_API <stable>`, where static allocation of this type is not possible due to its implementation being opaque at build time."
msgstr "تخصیص پویای :c:type:`Py_tss_t`، که در ماژول‌های توسعه‌ای ساخته‌شده با :ref:`Py_LIMITED_API <stable>` لازم است؛ جایی که تخصیص ایستای این نوع به دلیل مات بودن پیاده‌سازی آن در زمان ساخت ممکن نیست."

msgid "Return a value which is the same state as a value initialized with :c:macro:`Py_tss_NEEDS_INIT`, or ``NULL`` in the case of dynamic allocation failure."
msgstr "مقداری را برمی‌گرداند که در همان وضعیتِ مقدارِ مقداردهی‌شده با :c:macro:`Py_tss_NEEDS_INIT` است، یا ``NULL`` در صورت شکست تخصیص پویا."

msgid "Free the given *key* allocated by :c:func:`PyThread_tss_alloc`, after first calling :c:func:`PyThread_tss_delete` to ensure any associated thread locals have been unassigned. This is a no-op if the *key* argument is ``NULL``."
msgstr "*کلید* داده‌شده که توسط :c:func:`PyThread_tss_alloc` تخصیص یافته است را آزاد می‌کند، پس از آنکه ابتدا :c:func:`PyThread_tss_delete` را برای اطمینان از اینکه هر متغیر نخ‌محلی مرتبطی لغو تخصیص شده باشد فراخوانی کرده است. اگر آرگومان *کلید* ``NULL`` باشد، این یک عملیات بی‌اثر است."

msgid "A freed key becomes a dangling pointer. You should reset the key to ``NULL``."
msgstr "کلید آزادشده به یک اشاره‌گر معلق تبدیل می‌شود. شما باید کلید را به ``NULL`` بازنشانی کنید."

msgid "Methods"
msgstr "متدها"

msgid "The parameter *key* of these functions must not be ``NULL``.  Moreover, the behaviors of :c:func:`PyThread_tss_set` and :c:func:`PyThread_tss_get` are undefined if the given :c:type:`Py_tss_t` has not been initialized by :c:func:`PyThread_tss_create`."
msgstr "پارامتر *key* این توابع نباید ``NULL`` باشد. علاوه بر این، رفتار :c:func:`PyThread_tss_set` و :c:func:`PyThread_tss_get` در صورتی تعریف‌نشده است که :c:type:`Py_tss_t` داده‌شده با :c:func:`PyThread_tss_create` مقداردهی اولیه نشده باشد."

msgid "Return a non-zero value if the given :c:type:`Py_tss_t` has been initialized by :c:func:`PyThread_tss_create`."
msgstr "اگر :c:type:`Py_tss_t` داده‌شده توسط :c:func:`PyThread_tss_create` مقداردهی اولیه شده باشد، مقداری غیر صفر برمی‌گرداند."

msgid "Return a zero value on successful initialization of a TSS key.  The behavior is undefined if the value pointed to by the *key* argument is not initialized by :c:macro:`Py_tss_NEEDS_INIT`.  This function can be called repeatedly on the same key -- calling it on an already initialized key is a no-op and immediately returns success."
msgstr "در صورت موفقیت‌آمیز بودن مقداردهی اولیه‌ی یک کلید TSS، مقدار صفر را برمی‌گرداند. اگر مقداری که آرگومان *key* به آن اشاره می‌کند با :c:macro:`Py_tss_NEEDS_INIT` مقداردهی اولیه نشده باشد، رفتار تعریف‌نشده خواهد بود. می‌توان این تابع را به طور مکرر روی همان کلید فراخوانی کرد -- فراخوانی آن روی کلیدی که از قبل مقداردهی اولیه شده است، یک عملیات بی‌اثر است و بلافاصله موفقیت را برمی‌گرداند."

msgid "Destroy a TSS key to forget the values associated with the key across all threads, and change the key's initialization state to uninitialized.  A destroyed key is able to be initialized again by :c:func:`PyThread_tss_create`. This function can be called repeatedly on the same key -- calling it on an already destroyed key is a no-op."
msgstr "یک کلید TSS را نابود می‌کند تا مقدارهای مرتبط با آن کلید در همه‌ی نخ‌ها فراموش شوند، و وضعیت مقداردهی اولیه‌ی کلید را به مقداردهی‌نشده تغییر می‌دهد. یک کلید نابودشده می‌تواند دوباره توسط :c:func:`PyThread_tss_create` مقداردهی اولیه شود. این تابع را می‌توان به‌طور مکرر روی همان کلید فراخوانی کرد -- فراخوانی آن روی کلیدی که از قبل نابود شده، یک عملیات بی‌اثر است."

msgid "Return a zero value to indicate successfully associating a :c:expr:`void*` value with a TSS key in the current thread.  Each thread has a distinct mapping of the key to a :c:expr:`void*` value."
msgstr "مقدار صفر را برای نشان دادن موفقیت در مرتبط کردن یک مقدار :c:expr:`void*` با کلید TSS در نخ جاری برمی‌گرداند. هر نخ نگاشت متمایزی از کلید به یک مقدار :c:expr:`void*` دارد."

msgid "Return the :c:expr:`void*` value associated with a TSS key in the current thread.  This returns ``NULL`` if no value is associated with the key in the current thread."
msgstr "مقدار :c:expr:`void*` مرتبط با کلید TSS در نخ جاری را برمی‌گرداند. اگر هیچ مقداری با کلید در نخ جاری مرتبط نباشد، این تابع ``NULL`` را برمی‌گرداند."

msgid "Legacy APIs"
msgstr "API‌های قدیمی"

msgid "This API is superseded by the :ref:`thread-specific storage (TSS) API <thread-specific-storage-api>`."
msgstr "این API توسط :ref:`API ذخیره‌سازی اختصاصی نخ (TSS) <thread-specific-storage-api>` جایگزین شده است."

msgid "This version of the API does not support platforms where the native TLS key is defined in a way that cannot be safely cast to ``int``.  On such platforms, :c:func:`PyThread_create_key` will return immediately with a failure status, and the other TLS functions will all be no-ops on such platforms."
msgstr "این نسخه از API از پلتفرم‌هایی پشتیبانی نمی‌کند که در آن‌ها کلید بومی TLS به شکلی تعریف شده باشد که نتوان آن را به‌طور امن به ``int`` قالب‌ریزی کرد. در چنین پلتفرم‌هایی، :c:func:`PyThread_create_key` بلافاصله وضعیت شکست برخواهد گرداند و سایر توابع TLS همگی در چنین پلتفرم‌هایی عملیات بی‌اثر خواهند بود."

msgid "Due to the compatibility problem noted above, this version of the API should not be used in new code."
msgstr "به دلیل مشکل سازگاری ذکرشده در بالا، نباید از این نسخه از API در کد جدید استفاده شود."