python-docs-fa/c-api/contextvars.po at 3.14 · python/python-docs-fa · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
# 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:
# Danial Behzadi <dani.behzi@ubuntu.com>, 2025
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
# Revisto <theRevisto@gmail.com>, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-09-16 12:56+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/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 "Context Variables Objects"
msgstr "اشیاء متغیرهای زمینه"

msgid "In Python 3.7.1 the signatures of all context variables C APIs were **changed** to use :c:type:`PyObject` pointers instead of :c:type:`PyContext`, :c:type:`PyContextVar`, and :c:type:`PyContextToken`, e.g.::"
msgstr "در پایتون 3.7.1، امضاهای تمام APIهای C مربوط به متغیرهای زمینه **تغییر یافتند** تا از اشاره‌گرهای :c:type:`PyObject` به‌جای :c:type:`PyContext`، :c:type:`PyContextVar` و :c:type:`PyContextToken` استفاده کنند، مثلاً::"

msgid ""
"// in 3.7.0:\n"
"PyContext *PyContext_New(void);\n"
"\n"
"// in 3.7.1+:\n"
"PyObject *PyContext_New(void);"
msgstr ""
"// in 3.7.0:\n"
"PyContext *PyContext_New(void);\n"
"\n"
"// in 3.7.1+:\n"
"PyObject *PyContext_New(void);"

msgid "See :issue:`34762` for more details."
msgstr "برای جزئیات بیشتر به :issue:`34762` مراجعه کنید."

msgid "This section details the public C API for the :mod:`contextvars` module."
msgstr "این بخش API عمومی C را برای ماژول :mod:`contextvars` به تفصیل شرح می‌دهد."

msgid "The C structure used to represent a :class:`contextvars.Context` object."
msgstr "ساختار C که برای بازنمایی یک شیء :class:`contextvars.Context` استفاده می‌شود."

msgid "The C structure used to represent a :class:`contextvars.ContextVar` object."
msgstr "ساختار C که برای نمایش یک شیء :class:`contextvars.ContextVar` استفاده می‌شود."

msgid "The C structure used to represent a :class:`contextvars.Token` object."
msgstr "ساختار C که برای نمایش یک شیء :class:`contextvars.Token` استفاده می‌شود."

msgid "The type object representing the *context* type."
msgstr "شیء نوعی که نوع *زمینه* را نشان می‌دهد."

msgid "The type object representing the *context variable* type."
msgstr "شیء نوعی که نوع *متغیر زمینه* را نشان می‌دهد."

msgid "The type object representing the *context variable token* type."
msgstr "شیء نوعی که نوع *توکن متغیر زمینه* را نشان می‌دهد."

msgid "Type-check macros:"
msgstr "ماکروهای بررسی نوع:"

msgid "Return true if *o* is of type :c:data:`PyContext_Type`. *o* must not be ``NULL``.  This function always succeeds."
msgstr "اگر *o* از نوع :c:data:`PyContext_Type` باشد، مقدار true را برمی‌گرداند. *o* نباید ``NULL`` باشد. این تابع همیشه با موفقیت اجرا می‌شود."

msgid "Return true if *o* is of type :c:data:`PyContextVar_Type`. *o* must not be ``NULL``.  This function always succeeds."
msgstr "اگر *o* از نوع :c:data:`PyContextVar_Type` باشد، مقدار true را برمی‌گرداند. *o* نباید ``NULL`` باشد. این تابع همیشه با موفقیت اجرا می‌شود."

msgid "Return true if *o* is of type :c:data:`PyContextToken_Type`. *o* must not be ``NULL``.  This function always succeeds."
msgstr "اگر *o* از نوع :c:data:`PyContextToken_Type` باشد، مقدار true را برمی‌گرداند. *o* نباید ``NULL`` باشد. این تابع همیشه موفق می‌شود."

msgid "Context object management functions:"
msgstr "توابع مدیریت شیء زمینه:"

msgid "Create a new empty context object.  Returns ``NULL`` if an error has occurred."
msgstr "یک شیء زمینه‌ی خالی جدید ایجاد می‌کند. اگر خطایی رخ داده باشد، ``NULL`` را برمی‌گرداند."

msgid "Create a shallow copy of the passed *ctx* context object. Returns ``NULL`` if an error has occurred."
msgstr "یک کپی سطحی از شیء زمینه‌ی *ctx* ارسال‌شده ایجاد می‌کند. اگر خطایی رخ داده باشد، ``NULL`` برمی‌گرداند."

msgid "Create a shallow copy of the current thread context. Returns ``NULL`` if an error has occurred."
msgstr "یک کپی سطحی از زمینه نخ فعلی ایجاد می‌کند. اگر خطایی رخ داده باشد، ``NULL`` را برمی‌گرداند."

msgid "Set *ctx* as the current context for the current thread. Returns ``0`` on success, and ``-1`` on error."
msgstr "*ctx* را به‌عنوان زمینه جاری برای نخ جاری تنظیم می‌کند. در صورت موفقیت ``0`` و در صورت خطا ``-1`` برمی‌گرداند."

msgid "Deactivate the *ctx* context and restore the previous context as the current context for the current thread.  Returns ``0`` on success, and ``-1`` on error."
msgstr "زمینه‌ی *ctx* را غیرفعال می‌کند و زمینه‌ی قبلی را به‌عنوان زمینه‌ی جاری برای نخ جاری بازگردانی می‌کند. در صورت موفقیت ``0`` و در صورت خطا ``-1`` برمی‌گرداند."

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

msgid "Clear watcher identified by *watcher_id* previously returned from :c:func:`PyContext_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_id* که پیش‌تر از :c:func:`PyContext_AddWatcher` برگردانده شده است را برای مفسر جاری حذف می‌کند. در صورت موفقیت ``0`` را برمی‌گرداند، یا در صورت خطا ``-1`` را برمی‌گرداند و یک استثنا تنظیم می‌کند (برای مثال، اگر *watcher_id* داده‌شده هرگز ثبت نشده باشد.)"

msgid "Enumeration of possible context object watcher events:"
msgstr "شمارش رویدادهای ممکن دیده‌بان (watcher) شیء زمینه:"

msgid "``Py_CONTEXT_SWITCHED``: The :term:`current context` has switched to a different context.  The object passed to the watch callback is the now-current :class:`contextvars.Context` object, or None if no context is current."
msgstr "``Py_CONTEXT_SWITCHED``: :term:`current context` به زمینه‌ای متفاوت تغییر کرده است.  شیء پاس‌داده‌شده به کال‌بک نظارت، شیء :class:`contextvars.Context` است که اکنون فعلی است، یا در صورتی که هیچ زمینه‌ای فعلی نباشد، None است."

msgid "Context object watcher callback function.  The object passed to the callback is event-specific; see :c:type:`PyContextEvent` for details."
msgstr "تابع کال‌بک ناظر شیء زمینه. شیء پاس‌داده‌شده به کال‌بک مختص رویداد است؛ برای جزئیات به :c:type:`PyContextEvent` مراجعه کنید."

msgid "If the callback returns with an exception set, it must return ``-1``; this exception will be printed as an unraisable exception using :c:func:`PyErr_FormatUnraisable`. Otherwise it should return ``0``."
msgstr "اگر کال‌بک همراه با استثنای تنظیم‌شده بازگردد، باید ``-1`` را برگرداند؛ این استثنا با استفاده از :c:func:`PyErr_FormatUnraisable` به‌عنوان یک استثنای غیرقابل‌پرتاب (unraisable exception) چاپ خواهد شد. در غیر این صورت، باید ``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 "Context variable functions:"
msgstr "توابع متغیر زمینه:"

msgid "Create a new ``ContextVar`` object.  The *name* parameter is used for introspection and debug purposes.  The *def* parameter specifies a default value for the context variable, or ``NULL`` for no default. If an error has occurred, this function returns ``NULL``."
msgstr "یک شیء ``ContextVar`` جدید ایجاد می‌کند. پارامتر *name* برای اهداف درون‌نگری و اشکال‌زدایی استفاده می‌شود. پارامتر *def* یک مقدار پیش‌فرض برای متغیر زمینه مشخص می‌کند، یا ``NULL`` در صورت نبود مقدار پیش‌فرض. اگر خطایی رخ داده باشد، این تابع ``NULL`` برمی‌گرداند."

msgid "Get the value of a context variable.  Returns ``-1`` if an error has occurred during lookup, and ``0`` if no error occurred, whether or not a value was found."
msgstr "گرفتن مقدار یک متغیر زمینه. اگر در حین جستجو خطایی رخ داده باشد، ``-1`` و اگر خطایی رخ نداده باشد، ``0`` برمی‌گرداند؛ صرف‌نظر از اینکه مقداری یافت شده است یا نه."

msgid "If the context variable was found, *value* will be a pointer to it. If the context variable was *not* found, *value* will point to:"
msgstr "اگر متغیر زمینه یافته شود، *value* اشاره‌گری به آن خواهد بود. اگر متغیر زمینه یافته *نشود*، *value* به موارد زیر اشاره خواهد کرد:"

msgid "*default_value*, if not ``NULL``;"
msgstr "*default_value*، اگر ``NULL`` نباشد؛"

msgid "the default value of *var*, if not ``NULL``;"
msgstr "مقدار پیش‌فرض *var*، اگر ``NULL`` نباشد؛"

msgid "``NULL``"
msgstr "``NULL``"

msgid "Except for ``NULL``, the function returns a new reference."
msgstr "به‌جز ``NULL``، تابع یک ارجاع جدید برمی‌گرداند."

msgid "Set the value of *var* to *value* in the current context.  Returns a new token object for this change, or ``NULL`` if an error has occurred."
msgstr "مقدار *var* را در زمینه‌ی فعلی به *value* تنظیم می‌کند. یک شیء توکن جدید برای این تغییر برمی‌گرداند، یا در صورت وقوع خطا ``NULL``."

msgid "Reset the state of the *var* context variable to that it was in before :c:func:`PyContextVar_Set` that returned the *token* was called. This function returns ``0`` on success and ``-1`` on error."
msgstr "وضعیت متغیر زمینه *var* را به وضعیت پیش از فراخوانی :c:func:`PyContextVar_Set` (که *token* را برگردانده بود) بازنشانی می‌کند. این تابع در صورت موفقیت ``0`` و در صورت خطا ``-1`` برمی‌گرداند."