-
Notifications
You must be signed in to change notification settings - Fork 13
Expand file tree
/
Copy pathmodule.po
More file actions
492 lines (357 loc) · 54.9 KB
/
Copy pathmodule.po
File metadata and controls
492 lines (357 loc) · 54.9 KB
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
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-09-16 12:56+0000\n"
"PO-Revision-Date: 2021-06-28 00:49+0000\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/python/python-docs-fa/)\n"
"Language: fa\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
msgid "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 the \"state\" of the module, that is, a pointer to the block of memory allocated at module creation time, or ``NULL``. See :c:member:`PyModuleDef.m_size`."
msgstr "«وضعیت» ماژول را برمیگرداند، یعنی اشارهگری به بلوک حافظهای که در زمان ایجاد ماژول تخصیص یافته است، یا ``NULL``. :c:member:`PyModuleDef.m_size` را ببینید."
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 definitions"
msgstr "تعریفهای ماژول"
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 "The definition is usually used to define an extension's “main” module object (see :ref:`extension-modules` for details). It is also used to :ref:`create extension modules dynamically <moduledef-dynamic>`."
msgstr "این تعریف معمولاً برای تعریف شیء ماژول «اصلی» یک ماژول توسعهای استفاده میشود (برای جزئیات به :ref:`extension-modules` مراجعه کنید). همچنین برای :ref:`ایجاد ماژولهای توسعهای بهصورت پویا <moduledef-dynamic>` استفاده میشود."
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 "The module definition struct, which holds all information needed to create a module object. 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."
msgstr "ساختار تعریف ماژول که تمام اطلاعات مورد نیاز برای ایجاد یک شیء ماژول را در خود نگه میدارد. این ساختار باید بهصورت ایستا تخصیص داده شود (یا به نحوی تضمین شود که تا زمانی که هر یک از ماژولهای ایجادشده از روی آن وجود دارد، معتبر بماند). معمولاً برای هر ماژول توسعهای تنها یک متغیر از این نوع وجود دارد."
msgid "Always initialize this member to :c:macro:`PyModuleDef_HEAD_INIT`."
msgstr "این عضو را همیشه به :c:macro:`PyModuleDef_HEAD_INIT` مقداردهی اولیه کنید."
msgid "Name for the new module."
msgstr "نام ماژول جدید."
msgid "Docstring for the module; usually a docstring variable created with :c:macro:`PyDoc_STRVAR` is used."
msgstr "رشته مستند ماژول؛ معمولاً از متغیر رشته مستند ایجادشده با :c:macro:`PyDoc_STRVAR` استفاده میشود."
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 it 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 "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 "See :PEP:`3121` for more details."
msgstr "برای جزئیات بیشتر به :PEP:`3121` مراجعه کنید."
msgid "A pointer to a table of module-level functions, described by :c:type:`PyMethodDef` values. Can be ``NULL`` if no functions are present."
msgstr "اشارهگری به جدولی از توابع در سطح ماژول که توسط مقادیر :c:type:`PyMethodDef` توصیف میشوند. اگر هیچ تابعی وجود نداشته باشد، میتواند ``NULL`` باشد."
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 "Prior to version 3.5, this member was always set to ``NULL``, and was defined as:"
msgstr "پیش از نسخه 3.5، این عضو همیشه روی ``NULL`` تنظیم میشد و به این صورت تعریف میشد:"
msgid "A traversal function to call during GC traversal of the module object, or ``NULL`` if not needed."
msgstr "تابع پیمایشی که در حین پیمایش شیء ماژول توسط GC فراخوانی میشود، یا ``NULL`` در صورت عدم نیاز."
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 :c:member:`~PyModuleDef.m_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:member:`~PyModuleDef.m_size` بزرگتر از ۰ باشد و وضعیت ماژول (همانطور که :c:func:`PyModule_GetState` برمیگرداند) برابر ``NULL`` باشد."
msgid "No longer called before the module state is allocated."
msgstr "دیگر پیش از تخصیص وضعیت ماژول فراخوانی نمیشود."
msgid "A clear function to call during GC clearing of the module object, or ``NULL`` if not needed."
msgstr "تابعی برای پاکسازی که در حین پاکسازی زبالهروبی شیء ماژول فراخوانی میشود، یا ``NULL`` در صورت عدم نیاز."
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 :c:member:`~PyModuleDef.m_free` is called directly."
msgstr "مانند :c:member:`PyTypeObject.tp_clear`، این تابع *همیشه* پیش از آزادسازی یک ماژول فراخوانی نمیشود. برای مثال، وقتی شمارش ارجاع برای تعیین اینکه یک شیء دیگر استفاده نمیشود کافی باشد، زبالهروب چرخهای دخالتی ندارد و :c:member:`~PyModuleDef.m_free` مستقیماً فراخوانی میشود."
msgid "A function to call during deallocation of the module object, or ``NULL`` if not needed."
msgstr "تابعی که هنگام آزادسازی شیء ماژول فراخوانی میشود، یا ``NULL`` در صورت عدم نیاز."
msgid "The type of ``PyModuleDef`` objects."
msgstr "نوع اشیاء ``PyModuleDef``."
msgid "Module slots"
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 "Specifies a function that is called to create the module object itself. The *value* pointer of this slot must point to a function of the signature:"
msgstr "تابعی را مشخص میکند که برای ایجاد خودِ شیء ماژول فراخوانی میشود. اشارهگر *value* این جایگاه باید به تابعی با امضای زیر اشاره کند:"
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 "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 "Multiple ``Py_mod_create`` slots may not be specified in one module definition."
msgstr "نمیتوان چند جایگاه ``Py_mod_create`` را در یک تعریف ماژول مشخص کرد."
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`. 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 "Specifies a function that is called to *execute* the module. This is equivalent to executing the code of a Python module: typically, this function adds classes and constants to the module. The signature of the function is:"
msgstr "تابعی را مشخص میکند که برای *اجرا* کردن ماژول فراخوانی میشود. این معادل اجرای کد یک ماژول پایتون است: بهطور معمول، این تابع کلاسها و ثابتها را به ماژول اضافه میکند. امضای تابع به این صورت است:"
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 "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 "Multiple ``Py_mod_multiple_interpreters`` slots may not be specified in one module definition."
msgstr "نمیتوان چند جایگاه ``Py_mod_multiple_interpreters`` در یک تعریف ماژول مشخص کرد."
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 "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 "Multiple ``Py_mod_gil`` slots may not be specified in one module definition."
msgstr "تعیین چند جایگاه ``Py_mod_gil`` در یک تعریف ماژول مجاز نیست."
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 "Creating extension modules dynamically"
msgstr "ایجاد ماژولهای توسعهای بهصورت پویا"
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>` نیز به کار میروند."
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 "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 "The C API version. Defined for backwards compatibility."
msgstr "نسخهی C API. برای سازگاری با نسخههای پیشین تعریفشده است."
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`` for backwards compatibility."
msgstr "برای سازگاری با نسخههای پیشین بهصورت ``3`` تعریفشده است."
msgid "Support functions"
msgstr "توابع پشتیبانی"
msgid "The following functions are provided to help initialize a module state. They are intended for a module's execution slots (: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>` قدیمی، یا کدی که ماژولها را بهصورت پویا ایجاد میکند، در نظر گرفته شدهاند."
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 ""
"if (PyModule_Add(module, \"spam\", PyBytes_FromString(value)) < 0) {\n"
" goto error;\n"
"}"
msgstr ""
"if (PyModule_Add(module, \"spam\", PyBytes_FromString(value)) < 0) {\n"
" goto error;\n"
"}"
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* فراخوانی کند."
msgid ""
"PyObject *obj = PyBytes_FromString(value);\n"
"if (PyModule_AddObject(module, \"spam\", obj) < 0) {\n"
" // 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."
msgstr ""
"PyObject *obj = PyBytes_FromString(value);\n"
"if (PyModule_AddObject(module, \"spam\", obj) < 0) {\n"
" // 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 "Module lookup (single-phase initialization)"
msgstr "جستجوی ماژول (مقداردهی اولیه تکفازی)"
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 (استثنای توکار)"