Repository navigation
Expand file tree
/
Copy pathexceptions.po
More file actions
699 lines (496 loc) · 85.7 KB
/
Copy pathexceptions.po
File metadata and controls
699 lines (496 loc) · 85.7 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
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
# 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-19 20:08+0330\n"
"PO-Revision-Date: 2026-09-19 20:08+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 "Built-in Exceptions"
msgstr "استثناهای توکار"
msgid "In Python, all exceptions must be instances of a class that derives from :class:`BaseException`. In a :keyword:`try` statement with an :keyword:`except` clause that mentions a particular class, that clause also handles any exception classes derived from that class (but not exception classes from which *it* is derived). Two exception classes that are not related via subclassing are never equivalent, even if they have the same name."
msgstr "در پایتون، همهی استثناها باید نمونههایی از کلاسی باشند که از :class:`BaseException` مشتق شده است. در یک دستور :keyword:`try` با یک بند :keyword:`except` که به کلاس خاصی اشاره میکند، آن بند همچنین هر کلاس استثنا را که از آن کلاس مشتق شده باشد مدیریت میکند (اما نه کلاسهای استثنا را که *آن* از آنها مشتق شده است). دو کلاس استثنا که از طریق زیرکلاسسازی با هم مرتبط نیستند، هرگز معادل نیستند، حتی اگر نام یکسانی داشته باشند."
msgid "The built-in exceptions listed in this chapter can be generated by the interpreter or built-in functions. Except where mentioned, they have an \"associated value\" indicating the detailed cause of the error. This may be a string or a tuple of several items of information (e.g., an error code and a string explaining the code). The associated value is usually passed as arguments to the exception class's constructor."
msgstr "استثناهای توکار فهرستشده در این فصل میتوانند توسط مفسر یا توابع توکار ایجاد شوند. مگر در مواردی که ذکر شده است، این استثناها دارای یک «مقدار مرتبط» هستند که علت دقیق خطا را نشان میدهد. این مقدار ممکن است یک رشته یا تاپلی از چند آیتم اطلاعات باشد (مثلاً یک کد خطا و یک رشته که آن کد را توضیح میدهد). مقدار مرتبط معمولاً بهصورت آرگومانهایی به سازندهی کلاس استثنا ارسال میشود."
msgid "User code can raise built-in exceptions. This can be used to test an exception handler or to report an error condition \"just like\" the situation in which the interpreter raises the same exception; but beware that there is nothing to prevent user code from raising an inappropriate error."
msgstr "کد کاربر میتواند استثناهای توکار را پرتاب کند. این کار میتواند برای آزمایش یک هندلر استثنا یا گزارش یک وضعیت خطا «دقیقاً مانند» شرایطی که مفسر همان استثنا را پرتاب میکند استفاده شود؛ اما توجه داشته باشید که هیچ چیز مانع از پرتاب یک خطای نامناسب توسط کد کاربر نمیشود."
msgid "The built-in exception classes can be subclassed to define new exceptions; programmers are encouraged to derive new exceptions from the :exc:`Exception` class or one of its subclasses, and not from :exc:`BaseException`. More information on defining exceptions is available in the Python Tutorial under :ref:`tut-userexceptions`."
msgstr "میتوان با ایجاد زیرکلاس از کلاسهای استثنای توکار، استثناهای جدید تعریف کرد؛ به برنامهنویسان توصیه میشود استثناهای جدید را از کلاس :exc:`Exception` یا یکی از زیرکلاسهای آن مشتق کنند، نه از :exc:`BaseException`. اطلاعات بیشتر در مورد تعریف استثناها در آموزش پایتون در :ref:`tut-userexceptions` در دسترس است."
msgid "Exception context"
msgstr "زمینه استثنا"
msgid "Three attributes on exception objects provide information about the context in which the exception was raised:"
msgstr "سه ویژگی در اشیای استثنا اطلاعاتی درباره زمینهای که استثنا در آن پرتاب شده است فراهم میکنند:"
msgid "When raising a new exception while another exception is already being handled, the new exception's :attr:`!__context__` attribute is automatically set to the handled exception. An exception may be handled when an :keyword:`except` or :keyword:`finally` clause, or a :keyword:`with` statement, is used."
msgstr "هنگام پرتاب یک استثنای جدید در حالی که استثنای دیگری از قبل در حال رسیدگی است، ویژگی :attr:`!__context__` استثنای جدید بهطور خودکار به استثنای در حال رسیدگی تنظیم میشود. یک استثنا ممکن است زمانی رسیدگی شود که از یک بند :keyword:`except` یا :keyword:`finally`، یا یک دستور :keyword:`with` استفاده شود."
msgid "This implicit exception context can be supplemented with an explicit cause by using :keyword:`!from` with :keyword:`raise`::"
msgstr "این زمینهی استثنای ضمنی را میتوان با استفاده از :keyword:`!from` همراه با :keyword:`raise` با یک علت صریح تکمیل کرد::"
msgid "raise new_exc from original_exc"
msgstr "raise new_exc from original_exc"
msgid "The expression following :keyword:`from<raise>` must be an exception or ``None``. It will be set as :attr:`!__cause__` on the raised exception. Setting :attr:`!__cause__` also implicitly sets the :attr:`!__suppress_context__` attribute to ``True``, so that using ``raise new_exc from None`` effectively replaces the old exception with the new one for display purposes (e.g. converting :exc:`KeyError` to :exc:`AttributeError`), while leaving the old exception available in :attr:`!__context__` for introspection when debugging."
msgstr "عبارت پس از :keyword:`from<raise>` باید یک استثنا یا ``None`` باشد. این مقدار بهعنوان :attr:`!__cause__` روی استثنای پرتابشده تنظیم میشود. تنظیم :attr:`!__cause__` همچنین بهصورت ضمنی ویژگی :attr:`!__suppress_context__` را روی ``True`` تنظیم میکند، بهطوری که استفاده از ``raise new_exc from None`` عملاً استثنای قدیمی را با استثنای جدید برای اهداف نمایش جایگزین میکند (برای مثال تبدیل :exc:`KeyError` به :exc:`AttributeError`)، در حالی که استثنای قدیمی را در :attr:`!__context__` برای دروننگری هنگام اشکالزدایی در دسترس نگه میدارد."
msgid "The default traceback display code shows these chained exceptions in addition to the traceback for the exception itself. An explicitly chained exception in :attr:`!__cause__` is always shown when present. An implicitly chained exception in :attr:`!__context__` is shown only if :attr:`!__cause__` is :const:`None` and :attr:`!__suppress_context__` is false."
msgstr "کد پیشفرض نمایش ردگیری پشته، این استثناهای زنجیرهای را علاوه بر ردگیری پشته خود استثنا نشان میدهد. یک استثنای زنجیرهای صریح در :attr:`!__cause__` همیشه در صورت وجود نمایش داده میشود. یک استثنای زنجیرهای ضمنی در :attr:`!__context__` تنها در صورتی نمایش داده میشود که :attr:`!__cause__` برابر :const:`None` و :attr:`!__suppress_context__` نادرست باشد."
msgid "In either case, the exception itself is always shown after any chained exceptions so that the final line of the traceback always shows the last exception that was raised."
msgstr "در هر صورت، خود استثنا همیشه پس از هرگونه استثنای زنجیرهای نمایش داده میشود، بهطوری که خط پایانی ردگیری پشته همیشه آخرین استثنایی را که پرتاب شده است نشان میدهد."
msgid "Inheriting from built-in exceptions"
msgstr "ارثبری از استثناهای توکار"
msgid "User code can create subclasses that inherit from an exception type. It's recommended to only subclass one exception type at a time to avoid any possible conflicts between how the bases handle the ``args`` attribute, as well as due to possible memory layout incompatibilities."
msgstr "کد کاربر میتواند زیرکلاسهایی بسازد که از یک نوع استثنا ارث میبرند. توصیه میشود برای جلوگیری از هرگونه تداخل احتمالی در نحوهی مدیریت ویژگی ``args`` توسط کلاسهای پایه، و نیز به دلیل ناسازگاریهای احتمالی در چیدمان حافظه، در هر زمان فقط از یک نوع استثنا زیرکلاسگیری کنید."
msgid "Most built-in exceptions are implemented in C for efficiency, see: :source:`Objects/exceptions.c`. Some have custom memory layouts which makes it impossible to create a subclass that inherits from multiple exception types. The memory layout of a type is an implementation detail and might change between Python versions, leading to new conflicts in the future. Therefore, it's recommended to avoid subclassing multiple exception types altogether."
msgstr "بیشتر استثناهای توکار برای کارایی به زبان C پیادهسازی شدهاند، ببینید: :source:`Objects/exceptions.c`. برخی از آنها چیدمانهای حافظه سفارشی دارند که ایجاد زیرکلاسی را که از چندین نوع استثنا ارث میبرد، غیرممکن میسازد. چیدمان حافظهی یک نوع، جزئیاتی از پیادهسازی است و ممکن است بین نسخههای پایتون تغییر کند و در آینده به تعارضهای جدیدی منجر شود. بنابراین، توصیه میشود بهطور کلی از ایجاد زیرکلاس از چندین نوع استثنا پرهیز کنید."
msgid "Base classes"
msgstr "کلاسهای پایه"
msgid "The following exceptions are used mostly as base classes for other exceptions."
msgstr "استثناهای زیر بیشتر بهعنوان کلاسهای پایه برای سایر استثناها استفاده میشوند."
msgid "The base class for all built-in exceptions. It is not meant to be directly inherited by user-defined classes (for that, use :exc:`Exception`). If :func:`str` is called on an instance of this class, the representation of the argument(s) to the instance are returned, or the empty string when there were no arguments."
msgstr "کلاس پایه برای تمام استثناهای توکار. این کلاس برای ارثبری مستقیم توسط کلاسهای تعریفشده توسط کاربر در نظر گرفته نشده است (برای این کار، از :exc:`Exception` استفاده کنید). اگر :func:`str` روی نمونهای از این کلاس فراخوانی شود، بازنمایی آرگومان(های) آن نمونه برگردانده میشود، یا رشته خالی در صورتی که هیچ آرگومانی وجود نداشته باشد."
msgid "The tuple of arguments given to the exception constructor. Some built-in exceptions (like :exc:`OSError`) expect a certain number of arguments and assign a special meaning to the elements of this tuple, while others are usually called only with a single string giving an error message."
msgstr "تاپل آرگومانهای دادهشده به سازندهی استثنا. برخی از استثناهای توکار (مانند :exc:`OSError`) تعداد معینی آرگومان را انتظار دارند و معنای خاصی به عناصر این تاپل نسبت میدهند، در حالی که سایر استثناها معمولاً فقط با یک رشته حاوی پیام خطا فراخوانی میشوند."
msgid "This method sets *tb* as the new traceback for the exception and returns the exception object. It was more commonly used before the exception chaining features of :pep:`3134` became available. The following example shows how we can convert an instance of ``SomeException`` into an instance of ``OtherException`` while preserving the traceback. Once raised, the current frame is pushed onto the traceback of the ``OtherException``, as would have happened to the traceback of the original ``SomeException`` had we allowed it to propagate to the caller. ::"
msgstr "این متد، *tb* را بهعنوان ردگیری پشتهی جدید برای استثنا تنظیم میکند و شیء استثنا را برمیگرداند. پیش از در دسترس قرار گرفتن قابلیتهای زنجیرهسازی استثنا در :pep:`3134`، این متد بیشتر استفاده میشد. مثال زیر نشان میدهد که چگونه میتوانیم یک نمونه از ``SomeException`` را به یک نمونه از ``OtherException`` تبدیل کنیم، در حالی که ردگیری پشته حفظ میشود. پس از پرتاب شدن، فریم جاری بر ردگیری پشتهی ``OtherException`` افزوده میشود، همانگونه که برای ردگیری پشتهی ``SomeException`` اصلی رخ میداد اگر اجازه میدادیم آن به فراخواننده منتشر شود. ::"
msgid ""
"try:\n"
" ...\n"
"except SomeException:\n"
" tb = sys.exception().__traceback__\n"
" raise OtherException(...).with_traceback(tb)"
msgstr ""
"try:\n"
" ...\n"
"except SomeException:\n"
" tb = sys.exception().__traceback__\n"
" raise OtherException(...).with_traceback(tb)"
msgid "A writable field that holds the :ref:`traceback object <traceback-objects>` associated with this exception. See also: :ref:`raise`."
msgstr "یک فیلد قابلنوشتن که :ref:`شیء ردگیری پشته <traceback-objects>` مرتبط با این استثنا را نگه میدارد. همچنین ببینید: :ref:`پرتاب <raise>`."
msgid "Add the string ``note`` to the exception's notes which appear in the standard traceback after the exception string. A :exc:`TypeError` is raised if ``note`` is not a string."
msgstr "رشته ``note`` را به یادداشتهای استثنا که در ردگیری پشتهی استاندارد پس از رشتهی استثنا نمایش داده میشوند، اضافه کنید. اگر ``note`` یک رشته نباشد، یک :exc:`TypeError` پرتاب میشود."
msgid "A list of the notes of this exception, which were added with :meth:`add_note`. This attribute is created when :meth:`add_note` is called."
msgstr "فهرستی از یادداشتهای این استثنا، که با :meth:`add_note` افزوده شدهاند. این ویژگی هنگام فراخوانی :meth:`add_note` ایجاد میشود."
msgid "All built-in, non-system-exiting exceptions are derived from this class. All user-defined exceptions should also be derived from this class."
msgstr "تمام استثناهای توکار که باعث خروج از سیستم نمیشوند، از این کلاس مشتق شدهاند. تمام استثناهای تعریفشده توسط کاربر نیز باید از این کلاس مشتق شده باشند."
msgid "The base class for those built-in exceptions that are raised for various arithmetic errors: :exc:`OverflowError`, :exc:`ZeroDivisionError`, :exc:`FloatingPointError`."
msgstr "کلاس پایه برای آن دسته از استثناهای توکار که برای خطاهای حسابی مختلف پرتاب میشوند: :exc:`OverflowError`، :exc:`ZeroDivisionError`، :exc:`FloatingPointError`."
msgid "Raised when a :ref:`buffer <bufferobjects>` related operation cannot be performed."
msgstr "هنگامی که یک عملیات مرتبط با :ref:`بافر <bufferobjects>` قابل انجام نباشد، پرتاب میشود."
msgid "The base class for the exceptions that are raised when a key or index used on a mapping or sequence is invalid: :exc:`IndexError`, :exc:`KeyError`. This can be raised directly by :func:`codecs.lookup`."
msgstr "کلاس پایه برای استثناهایی که هنگام نامعتبر بودن یک کلید یا اندیس استفادهشده در یک نگاشت یا دنباله پرتاب میشوند: :exc:`IndexError`، :exc:`KeyError`. این استثنا میتواند مستقیماً توسط :func:`codecs.lookup` پرتاب شود."
msgid "Concrete exceptions"
msgstr "استثناهای مشخص"
msgid "The following exceptions are the exceptions that are usually raised."
msgstr "استثناهای زیر، استثناهایی هستند که معمولاً پرتاب میشوند."
msgid "Raised when an :keyword:`assert` statement fails."
msgstr "هنگامی که دستور :keyword:`assert` شکست بخورد، پرتاب میشود."
msgid "Raised when an attribute reference (see :ref:`attribute-references`) or assignment fails. (When an object does not support attribute references or attribute assignments at all, :exc:`TypeError` is raised.)"
msgstr "هنگامی که ارجاع به ویژگی (به :ref:`attribute-references` مراجعه کنید) یا انتساب ناموفق باشد، پرتاب میشود. (هرگاه یک شیء بههیچوجه از ارجاع به ویژگی یا انتساب ویژگی پشتیبانی نکند، :exc:`TypeError` پرتاب میشود.)"
msgid "The optional *name* and *obj* keyword-only arguments set the corresponding attributes:"
msgstr "آرگومانهای اختیاری *name* و *obj* که فقط کلیدواژهای هستند، ویژگیهای متناظر را تنظیم میکنند:"
msgid "The name of the attribute that was attempted to be accessed."
msgstr "نام ویژگیای که برای دسترسی به آن تلاش شده است."
msgid "The object that was accessed for the named attribute."
msgstr "شیءای که برای ویژگی نامبردهشده به آن دسترسی پیدا شده است."
msgid "Added the :attr:`name` and :attr:`obj` attributes."
msgstr "ویژگیهای :attr:`name` و :attr:`obj` اضافه شدند."
msgid "Raised when the :func:`input` function hits an end-of-file condition (EOF) without reading any data. (Note: the :meth:`io.TextIOBase.read` and :meth:`io.IOBase.readline` methods return an empty string when they hit EOF.)"
msgstr "زمانی پرتاب میشود که تابع :func:`input` بدون خواندن هیچ دادهای به وضعیت پایان پرونده برسد. (توجه: متدهای :meth:`io.TextIOBase.read` و :meth:`io.IOBase.readline` هنگام رسیدن به EOF یک رشتهی خالی برمیگردانند.)"
msgid "Not currently used."
msgstr "در حال حاضر استفاده نمیشود."
msgid "Raised when a :term:`generator` or :term:`coroutine` is closed; see :meth:`generator.close` and :meth:`coroutine.close`. It directly inherits from :exc:`BaseException` instead of :exc:`Exception` since it is technically not an error."
msgstr "هنگامی ایجاد میشود که یک :term:`تولیدگر <generator>` یا :term:`همروال <coroutine>` بسته شود؛ :meth:`generator.close` و :meth:`coroutine.close` را ببینید. این استثنا مستقیماً از :exc:`BaseException` بهجای :exc:`Exception` ارث میبرد، زیرا از نظر فنی یک خطا نیست."
msgid "Raised when the :keyword:`import` statement has troubles trying to load a module. Also raised when the \"from list\" in ``from ... import`` has a name that cannot be found."
msgstr "هنگامی پرتاب میشود که دستور :keyword:`import` در تلاش برای بارگذاری یک ماژول دچار مشکل شود. همچنین هنگامی پرتاب میشود که «فهرست from» در ``from ... import`` شامل نامی باشد که نمیتوان آن را پیدا کرد."
msgid "The optional *name* and *path* keyword-only arguments set the corresponding attributes:"
msgstr "آرگومانهای اختیاری *name* و *path* که فقط کلیدواژهای هستند، ویژگیهای متناظر را تنظیم میکنند:"
msgid "The name of the module that was attempted to be imported."
msgstr "نام ماژولی که برای ایمپورت آن تلاش شد."
msgid "The path to any file which triggered the exception."
msgstr "مسیر هر پروندهای که باعث پرتاب استثنا شده است."
msgid "Added the :attr:`name` and :attr:`path` attributes."
msgstr "ویژگیهای :attr:`name` و :attr:`path` اضافه شدند."
msgid "A subclass of :exc:`ImportError` which is raised by :keyword:`import` when a module could not be located. It is also raised when ``None`` is found in :data:`sys.modules`."
msgstr "زیرکلاسی از :exc:`ImportError` که توسط :keyword:`import` زمانی پرتاب میشود که نتوان یک ماژول را یافت. همچنین زمانی که ``None`` در :data:`sys.modules` یافت شود نیز پرتاب میشود."
msgid "Raised when a sequence subscript is out of range. (Slice indices are silently truncated to fall in the allowed range; if an index is not an integer, :exc:`TypeError` is raised.)"
msgstr "زمانی پرتاب میشود که زیرنویس یک دنباله خارج از محدوده باشد. (اندیسهای اسلایس بهصورت خاموش محدود میشوند تا در محدوده مجاز قرار گیرند؛ اگر اندیس عدد صحیح نباشد، :exc:`TypeError` پرتاب میشود.)"
msgid "Raised when a mapping (dictionary) key is not found in the set of existing keys."
msgstr "زمانی پرتاب میشود که کلید یک نگاشت (دیکشنری) در مجموعهی کلیدهای موجود یافت نشود."
msgid "Raised when the user hits the interrupt key (normally :kbd:`Control-C` or :kbd:`Delete`). During execution, a check for interrupts is made regularly. The exception inherits from :exc:`BaseException` so as to not be accidentally caught by code that catches :exc:`Exception` and thus prevent the interpreter from exiting."
msgstr "این استثنا زمانی پرتاب میشود که کاربر کلید وقفه را فشار دهد (معمولاً :kbd:`Control-C` یا :kbd:`Delete`). در طول اجرا، بررسی وقفهها بهطور منظم انجام میشود. این استثنا از :exc:`BaseException` ارث میبرد تا بهطور تصادفی توسط کدی که :exc:`Exception` را میگیرد، گرفته نشود و در نتیجه مانع از خروج مفسر نگردد."
msgid "Catching a :exc:`KeyboardInterrupt` requires special consideration. Because it can be raised at unpredictable points, it may, in some circumstances, leave the running program in an inconsistent state. It is generally best to allow :exc:`KeyboardInterrupt` to end the program as quickly as possible or avoid raising it entirely. (See :ref:`handlers-and-exceptions`.)"
msgstr "گرفتن :exc:`KeyboardInterrupt` نیازمند ملاحظه ویژه است. از آنجا که ممکن است در نقاط غیرقابلپیشبینی پرتاب شود، در برخی شرایط ممکن است برنامهی در حال اجرا را در وضعیتی ناسازگار باقی بگذارد. معمولاً بهتر است اجازه دهید :exc:`KeyboardInterrupt` برنامه را هرچه سریعتر پایان دهد یا کلاً از پرتاب آن اجتناب کنید. (به :ref:`handlers-and-exceptions` مراجعه کنید.)"
msgid "Raised when an operation runs out of memory but the situation may still be rescued (by deleting some objects). The associated value is a string indicating what kind of (internal) operation ran out of memory. Note that because of the underlying memory management architecture (C's :c:func:`malloc` function), the interpreter may not always be able to completely recover from this situation; it nevertheless raises an exception so that a stack traceback can be printed, in case a run-away program was the cause."
msgstr "زمانی پرتاب میشود که یک عملیات با کمبود حافظه مواجه شود، اما وضعیت هنوز ممکن است قابل نجات باشد (با حذف برخی اشیاء). مقدار مرتبط، رشتهای است که نشان میدهد چه نوع عملیات (داخلی) با کمبود حافظه مواجه شده است. توجه داشته باشید که به دلیل معماری زیربنایی مدیریت حافظه (تابع :c:func:`malloc` در C)، مفسر ممکن است همیشه قادر به بازیابی کامل از این وضعیت نباشد؛ با این حال استثنایی پرتاب میکند تا در صورتی که علت، یک برنامه مهارنشدنی بوده باشد، بتوان ردگیری پشته را چاپ کرد."
msgid "Raised when a local or global name is not found. This applies only to unqualified names. The associated value is an error message that includes the name that could not be found."
msgstr "هنگامی پرتاب میشود که یک نام محلی یا سراسری یافت نشود. این مورد فقط برای نامهای فاقد صلاحیت (unqualified) صدق میکند. مقدار مرتبط، پیام خطایی است که شامل نامی است که یافت نشد."
msgid "The optional *name* keyword-only argument sets the attribute:"
msgstr "آرگومان اختیاری *name* که فقط بهصورت کلیدواژهای پذیرفته میشود، ویژگی را تنظیم میکند:"
msgid "The name of the variable that was attempted to be accessed."
msgstr "نام متغیری که تلاش شد به آن دسترسی پیدا شود."
msgid "Added the :attr:`name` attribute."
msgstr "ویژگی :attr:`name` اضافه شد."
msgid "This exception is derived from :exc:`RuntimeError`. In user defined base classes, abstract methods should raise this exception when they require derived classes to override the method, or while the class is being developed to indicate that the real implementation still needs to be added."
msgstr "این استثنا از :exc:`RuntimeError` مشتق شده است. در کلاسهای پایه تعریفشده توسط کاربر، متدهای انتزاعی باید این استثنا را زمانی پرتاب کنند که لازم باشد کلاسهای مشتقشده متد را بازنویسی کنند، یا هنگامی که کلاس در حال توسعه است تا نشان دهند پیادهسازی واقعی هنوز باید اضافه شود."
msgid "It should not be used to indicate that an operator or method is not meant to be supported at all -- in that case either leave the operator / method undefined or, if a subclass, set it to :data:`None`."
msgstr "نباید برای نشان دادن اینکه یک عملگر یا متد بههیچوجه قرار نیست پشتیبانی شود، استفاده شود — در این حالت یا عملگر / متد را تعریفنشده بگذارید یا، اگر یک زیرکلاس است، آن را روی :data:`None` قرار دهید."
msgid ":exc:`!NotImplementedError` and :data:`!NotImplemented` are not interchangeable. This exception should only be used as described above; see :data:`NotImplemented` for details on correct usage of the built-in constant."
msgstr ":exc:`!NotImplementedError` و :data:`!NotImplemented` قابل تعویض با یکدیگر نیستند. این استثنا باید فقط همانطور که در بالا توضیح داده شد استفاده شود؛ برای جزئیات دربارهی استفادهی صحیح از ثابت توکار، :data:`NotImplemented` را ببینید."
msgid "This exception is raised when a system function returns a system-related error, including I/O failures such as \"file not found\" or \"disk full\" (not for illegal argument types or other incidental errors)."
msgstr "این استثنا زمانی پرتاب میشود که یک تابع سیستمی خطایی مرتبط با سیستم را برگرداند، از جمله خطاهای ورودی/خروجی مانند «پرونده یافت نشد» یا «دیسک پر است» (نه برای انواع غیرمجاز آرگومان یا سایر خطاهای اتفاقی)."
msgid "The second form of the constructor sets the corresponding attributes, described below. The attributes default to :const:`None` if not specified. For backwards compatibility, if three arguments are passed, the :attr:`~BaseException.args` attribute contains only a 2-tuple of the first two constructor arguments."
msgstr "دومین شکل سازنده، ویژگیهای متناظر را که در ادامه توضیح داده شدهاند، تنظیم میکند. مقدار پیشفرض این ویژگیها در صورتی که مشخص نشده باشند، :const:`None` است. برای سازگاری با نسخههای پیشین، اگر سه آرگومان ارسال شود، ویژگی :attr:`~BaseException.args` فقط شامل یک تاپل دوتایی از دو آرگومان نخست سازنده خواهد بود."
msgid "The constructor often actually returns a subclass of :exc:`OSError`, as described in `OS exceptions`_ below. The particular subclass depends on the final :attr:`.errno` value. This behaviour only occurs when constructing :exc:`OSError` directly or via an alias, and is not inherited when subclassing."
msgstr "سازنده در واقع اغلب یک زیرکلاس از :exc:`OSError` را برمیگرداند، همانطور که در `OS exceptions`_ در ادامه توضیح داده شده است. زیرکلاس خاص به مقدار نهایی :attr:`.errno` بستگی دارد. این رفتار فقط زمانی رخ میدهد که :exc:`OSError` مستقیماً یا از طریق یک نام مستعار ساخته شود و هنگام ایجاد زیرکلاس به ارث نمیرسد."
msgid "A numeric error code from the C variable :c:data:`errno`."
msgstr "یک کد خطای عددی از متغیر C با نام :c:data:`errno`."
msgid "Under Windows, this gives you the native Windows error code. The :attr:`.errno` attribute is then an approximate translation, in POSIX terms, of that native error code."
msgstr "در ویندوز، این به شما کد خطای بومی ویندوز را میدهد. در این صورت، ویژگی :attr:`.errno` ترجمهای تقریبی، در اصطلاحات POSIX، از آن کد خطای بومی است."
msgid "Under Windows, if the *winerror* constructor argument is an integer, the :attr:`.errno` attribute is determined from the Windows error code, and the *errno* argument is ignored. On other platforms, the *winerror* argument is ignored, and the :attr:`winerror` attribute does not exist."
msgstr "در ویندوز، اگر آرگومان سازندهی *winerror* یک عدد صحیح باشد، ویژگی :attr:`.errno` از کد خطای ویندوز تعیین میشود و آرگومان *errno* نادیده گرفته میشود. در سکوهای دیگر، آرگومان *winerror* نادیده گرفته میشود و ویژگی :attr:`winerror` وجود ندارد."
msgid "The corresponding error message, as provided by the operating system. It is formatted by the C functions :c:func:`!perror` under POSIX, and :c:func:`!FormatMessage` under Windows."
msgstr "پیام خطای متناظر، همانطور که توسط سیستمعامل ارائه میشود. این پیام توسط توابع C :c:func:`!perror` در POSIX و :c:func:`!FormatMessage` در ویندوز قالببندی میشود."
msgid "For exceptions that involve a file system path (such as :func:`open` or :func:`os.unlink`), :attr:`filename` is the file name passed to the function. For functions that involve two file system paths (such as :func:`os.rename`), :attr:`filename2` corresponds to the second file name passed to the function."
msgstr "برای استثناهایی که شامل یک مسیر سامانه فایلبندی هستند (مانند :func:`open` یا :func:`os.unlink`)، :attr:`filename` نام پروندهای است که به تابع داده شده است. برای توابعی که شامل دو مسیر سامانه فایلبندی هستند (مانند :func:`os.rename`)، :attr:`filename2` متناظر با دومین نام پرونده دادهشده به تابع است."
msgid ":exc:`EnvironmentError`, :exc:`IOError`, :exc:`WindowsError`, :exc:`socket.error`, :exc:`select.error` and :exc:`!mmap.error` have been merged into :exc:`OSError`, and the constructor may return a subclass."
msgstr ":exc:`EnvironmentError`، :exc:`IOError`، :exc:`WindowsError`، :exc:`socket.error`، :exc:`select.error` و :exc:`!mmap.error` در :exc:`OSError` ادغام شدهاند و سازنده ممکن است یک زیرکلاس برگرداند."
msgid "The :attr:`filename` attribute is now the original file name passed to the function, instead of the name encoded to or decoded from the :term:`filesystem encoding and error handler`. Also, the *filename2* constructor argument and attribute was added."
msgstr "ویژگی :attr:`filename` اکنون نام اصلی پرونده ارسالشده به تابع است، بهجای نامی که به :term:`filesystem encoding and error handler` کدگذاری یا از آن کدگشایی شده است. همچنین، آرگومان سازنده و ویژگی *filename2* افزوده شد."
msgid "Raised when the result of an arithmetic operation is too large to be represented. This cannot occur for integers (which would rather raise :exc:`MemoryError` than give up). However, for historical reasons, OverflowError is sometimes raised for integers that are outside a required range. Because of the lack of standardization of floating-point exception handling in C, most floating-point operations are not checked."
msgstr "زمانی پرتاب میشود که نتیجهی یک عملیات حسابی آنقدر بزرگ باشد که نتوان آن را نمایش داد. این حالت برای اعداد صحیح رخ نمیدهد (که بهجای تسلیم شدن، :exc:`MemoryError` را پرتاب میکنند). با این حال، به دلایل تاریخی، گاهی OverflowError برای اعداد صحیحی که خارج از محدودهی مورد نیاز هستند پرتاب میشود. به دلیل نبود استانداردسازی در مدیریت استثناهای ممیز شناور در C، بیشتر عملیاتهای ممیز شناور بررسی نمیشوند."
msgid "This exception is derived from :exc:`RuntimeError`. It is raised when an operation is blocked during interpreter shutdown also known as :term:`Python finalization <interpreter shutdown>`."
msgstr "این استثنا از :exc:`RuntimeError` مشتق شده است. این استثنا زمانی پرتاب میشود که عملیاتی در حین خاموش شدن مفسر، که با عنوان :term:`نهاییسازی پایتون <interpreter shutdown>` نیز شناخته میشود، مسدود شده باشد."
msgid "Examples of operations which can be blocked with a :exc:`PythonFinalizationError` during the Python finalization:"
msgstr "نمونههایی از عملیاتهایی که ممکن است در طول نهاییسازی پایتون (Python finalization) با :exc:`PythonFinalizationError` مسدود شوند:"
msgid "Creating a new Python thread."
msgstr "ایجاد یک نخ پایتون جدید."
msgid ":meth:`Joining <threading.Thread.join>` a running daemon thread."
msgstr ":meth:`پیوستن <threading.Thread.join>` به یک نخ daemon در حال اجرا."
msgid ":func:`os.fork`."
msgstr ":func:`os.fork`."
msgid "See also the :func:`sys.is_finalizing` function."
msgstr "همچنین تابع :func:`sys.is_finalizing` را ببینید."
msgid "Previously, a plain :exc:`RuntimeError` was raised."
msgstr "پیش از این، یک :exc:`RuntimeError` ساده پرتاب میشد."
msgid ":meth:`threading.Thread.join` can now raise this exception."
msgstr ":meth:`threading.Thread.join` اکنون میتواند این استثنا را پرتاب کند."
msgid "This exception is derived from :exc:`RuntimeError`. It is raised when the interpreter detects that the maximum recursion depth (see :func:`sys.getrecursionlimit`) is exceeded."
msgstr "این استثنا از :exc:`RuntimeError` مشتق شده است. این استثنا زمانی پرتاب میشود که مفسر تشخیص دهد که از حداکثر عمق بازگشت (به :func:`sys.getrecursionlimit` مراجعه کنید) فراتر رفته است."
msgid "This exception is raised when a weak reference proxy, created by the :func:`weakref.proxy` function, is used to access an attribute of the referent after it has been garbage collected. For more information on weak references, see the :mod:`weakref` module."
msgstr "این استثنا زمانی پرتاب میشود که از یک پراکسی ارجاع ضعیف، که توسط تابع :func:`weakref.proxy` ایجاد شده است، برای دسترسی به ویژگیای از شیء مورد ارجاع پس از زبالهروبی شدن آن استفاده شود. برای اطلاعات بیشتر دربارهی ارجاعهای ضعیف، ماژول :mod:`weakref` را ببینید."
msgid "Raised when an error is detected that doesn't fall in any of the other categories. The associated value is a string indicating what precisely went wrong."
msgstr "زمانی پرتاب میشود که خطایی تشخیص داده شود که در هیچیک از دستههای دیگر قرار نمیگیرد. مقدار مرتبط، رشتهای است که نشان میدهد دقیقاً چه چیزی اشتباه پیش رفت."
msgid "Raised by built-in function :func:`next` and an :term:`iterator`\\'s :meth:`~iterator.__next__` method to signal that there are no further items produced by the iterator."
msgstr "توسط تابع توکار :func:`next` و متد :meth:`~iterator.__next__` از یک :term:`iterator` پرتاب میشود تا نشان دهد که دیگر آیتمی از آن تولید نمیشود."
msgid "The exception object has a single attribute :attr:`!value`, which is given as an argument when constructing the exception, and defaults to :const:`None`."
msgstr "شیء استثنا دارای یک ویژگی واحد به نام :attr:`!value` است که بهعنوان آرگومان هنگام ساخت استثنا داده میشود و مقدار پیشفرض آن :const:`None` است."
msgid "When a :term:`generator` or :term:`coroutine` function returns, a new :exc:`StopIteration` instance is raised, and the value returned by the function is used as the :attr:`value` parameter to the constructor of the exception."
msgstr "هنگامی که یک تابع :term:`تولیدگر <generator>` یا :term:`همروال <coroutine>` بازگشت میکند، نمونهی جدیدی از :exc:`StopIteration` پرتاب میشود، و مقدار برگرداندهشده توسط تابع بهعنوان پارامتر :attr:`value` برای سازندهی استثنا استفاده میشود."
msgid "If a generator code directly or indirectly raises :exc:`StopIteration`, it is converted into a :exc:`RuntimeError` (retaining the :exc:`StopIteration` as the new exception's cause)."
msgstr "اگر کد یک تولیدگر بهطور مستقیم یا غیرمستقیم :exc:`StopIteration` را پرتاب کند، این استثنا به :exc:`RuntimeError` تبدیل میشود (در حالی که :exc:`StopIteration` بهعنوان علت استثنای جدید حفظ میشود)."
msgid "Added ``value`` attribute and the ability for generator functions to use it to return a value."
msgstr "ویژگی ``value`` و توانایی توابع تولیدگر برای استفاده از آن جهت برگرداندن یک مقدار افزوده شد."
msgid "Introduced the RuntimeError transformation via ``from __future__ import generator_stop``, see :pep:`479`."
msgstr "تبدیل RuntimeError از طریق ``from __future__ import generator_stop`` معرفی شد، :pep:`479` را ببینید."
msgid "Enable :pep:`479` for all code by default: a :exc:`StopIteration` error raised in a generator is transformed into a :exc:`RuntimeError`."
msgstr "فعالسازی :pep:`479` برای تمام کدها بهصورت پیشفرض: خطای :exc:`StopIteration` که در یک تولیدگر پرتاب میشود، به :exc:`RuntimeError` تبدیل میشود."
msgid "Must be raised by :meth:`~object.__anext__` method of an :term:`asynchronous iterator` object to stop the iteration."
msgstr "باید توسط متد :meth:`~object.__anext__` یک شیء :term:`asynchronous iterator` پرتاب شود تا تکرار متوقف شود."
msgid "Raised when the parser encounters a syntax error. This may occur in an :keyword:`import` statement, in a call to the built-in functions :func:`compile`, :func:`exec`, or :func:`eval`, or when reading the initial script or standard input (also interactively)."
msgstr "زمانی که پارسر با یک خطای نحوی مواجه شود، پرتاب میشود. این ممکن است در یک دستور :keyword:`import`، در فراخوانی توابع توکار :func:`compile`، :func:`exec`، یا :func:`eval`، یا هنگام خواندن اسکریپت اولیه یا ورودی استاندارد (همچنین بهصورت تعاملی) رخ دهد."
msgid "The :func:`str` of the exception instance returns only the error message. Details is a tuple whose members are also available as separate attributes."
msgstr ":func:`str` از نمونهی استثنا فقط پیام خطا را برمیگرداند. جزئیات یک تاپل است که اعضای آن بهعنوان ویژگیهای جداگانه نیز در دسترس هستند."
msgid "The name of the file the syntax error occurred in."
msgstr "نام پروندهای که خطای سینتکسی در آن رخ داد."
msgid "Which line number in the file the error occurred in. This is 1-indexed: the first line in the file has a ``lineno`` of 1."
msgstr "شماره سطری در پرونده که خطا در آن رخ داده است. این اندیسگذاری ۱-مبنا است: اولین خط پرونده دارای ``lineno`` برابر ۱ است."
msgid "The column in the line where the error occurred. This is 1-indexed: the first character in the line has an ``offset`` of 1."
msgstr "ستون در سطری که خطا در آن رخ داده است. این مقدار ۱-اندیسگذاریشده است: اولین نویسهی خط دارای ``offset`` برابر با ۱ است."
msgid "The source code text involved in the error."
msgstr "متن کد منبعی که در خطا دخیل است."
msgid "Which line number in the file the error occurred ends in. This is 1-indexed: the first line in the file has a ``lineno`` of 1."
msgstr "شماره سطری در پرونده که خطای رخداده در آن به پایان میرسد. این مقدار از ۱ اندیسگذاری شده است: اولین خط پرونده ``lineno`` برابر ۱ دارد."
msgid "The column in the end line where the error occurred finishes. This is 1-indexed: the first character in the line has an ``offset`` of 1."
msgstr "ستونی در خط پایانی که خطا در آن پایان مییابد. این مقدار ۱-اندیسدار است: نخستین نویسهی خط دارای ``offset`` برابر با ۱ است."
msgid "For errors in f-string fields, the message is prefixed by \"f-string: \" and the offsets are offsets in a text constructed from the replacement expression. For example, compiling f'Bad {a b} field' results in this args attribute: ('f-string: ...', ('', 1, 2, '(a b)\\n', 1, 5))."
msgstr "برای خطاهای فیلدهای افاسترینگ، پیام با پیشوند \"f-string: \" آغاز میشود و آفستها، آفستهایی در متنی هستند که از عبارت جایگزینی ساخته میشود. برای مثال، کامپایل کردن f'Bad {a b} field' منجر به این ویژگی args میشود: ('f-string: ...', ('', 1, 2, '(a b)\\n', 1, 5))."
msgid "Added the :attr:`end_lineno` and :attr:`end_offset` attributes."
msgstr "ویژگیهای :attr:`end_lineno` و :attr:`end_offset` افزوده شدند."
msgid "Base class for syntax errors related to incorrect indentation. This is a subclass of :exc:`SyntaxError`."
msgstr "کلاس پایه برای خطاهای سینتکسی مربوط به تورفتگی نادرست. این یک زیرکلاس از :exc:`SyntaxError` است."
msgid "Raised when indentation contains an inconsistent use of tabs and spaces. This is a subclass of :exc:`IndentationError`."
msgstr "هنگامی که تورفتگی شامل استفادهی ناسازگار از تبها و فاصلهها باشد، پرتاب میشود. این یک زیرکلاس از :exc:`IndentationError` است."
msgid "Raised when the interpreter finds an internal error, but the situation does not look so serious to cause it to abandon all hope. The associated value is a string indicating what went wrong (in low-level terms). In :term:`CPython`, this could be raised by incorrectly using Python's C API, such as returning a ``NULL`` value without an exception set."
msgstr "زمانی پرتاب میشود که مفسر یک خطای داخلی پیدا کند، اما وضعیت آنقدر جدی به نظر نمیرسد که باعث شود همه امید را از دست بدهد. مقدار مرتبط، رشتهای است که نشان میدهد چه مشکلی پیش آمده است (در اصطلاحات سطح پایین). در :term:`CPython`، این استثنا ممکن است به دلیل استفاده نادرست از C API پایتون پرتاب شود، مانند برگرداندن مقدار ``NULL`` بدون تنظیم استثنا."
msgid "If you're confident that this exception wasn't your fault, or the fault of a package you're using, you should report this to the author or maintainer of your Python interpreter. Be sure to report the version of the Python interpreter (``sys.version``; it is also printed at the start of an interactive Python session), the exact error message (the exception's associated value) and if possible the source of the program that triggered the error."
msgstr "اگر مطمئن هستید که این استثنا تقصیر شما یا تقصیر بستهای که استفاده میکنید نیست، باید آن را به نویسنده یا نگهدارنده مفسر پایتون خود گزارش دهید. حتماً نسخه مفسر پایتون (``sys.version``؛ این نسخه در ابتدای یک نشست تعاملی پایتون نیز چاپ میشود)، پیام خطای دقیق (مقدار مرتبط با استثنا) و در صورت امکان کد منبع برنامهای که باعث بروز خطا شده است را گزارش دهید."
msgid "This exception is raised by the :func:`sys.exit` function. It inherits from :exc:`BaseException` instead of :exc:`Exception` so that it is not accidentally caught by code that catches :exc:`Exception`. This allows the exception to properly propagate up and cause the interpreter to exit. When it is not handled, the Python interpreter exits; no stack traceback is printed. The constructor accepts the same optional argument passed to :func:`sys.exit`. If the value is an integer, it specifies the system exit status (passed to C's :c:func:`!exit` function); if it is ``None``, the exit status is zero; if it has another type (such as a string), the object's value is printed and the exit status is one."
msgstr "این استثنا توسط تابع :func:`sys.exit` پرتاب میشود. این استثنا به جای :exc:`Exception` از :exc:`BaseException` ارث میبرد تا بهطور تصادفی توسط کدی که :exc:`Exception` را میگیرد، گرفته نشود. این امکان را میدهد که استثنا بهدرستی به بالا منتشر شود و باعث خروج مفسر شود. هنگامی که این استثنا مدیریت نشود، مفسر پایتون خارج میشود؛ هیچ ردگیری پشتهای چاپ نمیشود. سازنده همان آرگومان اختیاری منتقلشده به :func:`sys.exit` را میپذیرد. اگر مقدار یک عدد صحیح باشد، وضعیت خروج سیستم را مشخص میکند (که به تابع :c:func:`!exit` در C منتقل میشود)؛ اگر ``None`` باشد، وضعیت خروج ۰ است؛ اگر نوع دیگری داشته باشد (مانند یک رشته)، مقدار شیء چاپ میشود و وضعیت خروج ۱ است."
msgid "A call to :func:`sys.exit` is translated into an exception so that clean-up handlers (:keyword:`finally` clauses of :keyword:`try` statements) can be executed, and so that a debugger can execute a script without running the risk of losing control. The :func:`os._exit` function can be used if it is absolutely positively necessary to exit immediately (for example, in the child process after a call to :func:`os.fork`)."
msgstr "فراخوانی :func:`sys.exit` به یک استثنا تبدیل میشود تا هندلرهای پاکسازی (بندهای :keyword:`finally` از دستورات :keyword:`try`) بتوانند اجرا شوند، و تا یک اشکالزدا بتواند یک اسکریپت را بدون خطر از دست دادن کنترل اجرا کند. اگر خروج فوری بهطور مطلق و قطعی ضروری باشد، میتوان از تابع :func:`os._exit` استفاده کرد (برای مثال، در فرایند فرزند پس از فراخوانی :func:`os.fork`)."
msgid "The exit status or error message that is passed to the constructor. (Defaults to ``None``.)"
msgstr "وضعیت خروج یا پیام خطایی که به سازنده داده میشود. (پیشفرض ``None`` است.)"
msgid "Raised when an operation or function is applied to an object of inappropriate type. The associated value is a string giving details about the type mismatch."
msgstr "هنگامی که یک عملیات یا تابع بر شیءای با نوع نامناسب اعمال شود، پرتاب میشود. مقدار مرتبط، رشتهای است که جزئیاتی دربارهی عدم تطابق نوع ارائه میدهد."
msgid "This exception may be raised by user code to indicate that an attempted operation on an object is not supported, and is not meant to be. If an object is meant to support a given operation but has not yet provided an implementation, :exc:`NotImplementedError` is the proper exception to raise."
msgstr "این استثنا ممکن است توسط کد کاربر پرتاب شود تا نشان دهد که عملیات تلاششده روی یک شیء پشتیبانی نمیشود، و قرار نیست پشتیبانی شود. اگر قرار باشد یک شیء از عملیات مشخصی پشتیبانی کند اما هنوز پیادهسازی آن را ارائه نکرده باشد، :exc:`NotImplementedError` استثنای مناسب برای پرتاب است."
msgid "Passing arguments of the wrong type (e.g. passing a :class:`list` when an :class:`int` is expected) should result in a :exc:`TypeError`, but passing arguments with the wrong value (e.g. a number outside expected boundaries) should result in a :exc:`ValueError`."
msgstr "ارسال آرگومانهایی با نوع نادرست (برای مثال، ارسال یک :class:`list` هنگامی که یک :class:`int` انتظار میرود) باید منجر به :exc:`TypeError` شود، اما ارسال آرگومانهایی با مقدار نادرست (برای مثال، عددی خارج از محدودههای مورد انتظار) باید منجر به :exc:`ValueError` شود."
msgid "Raised when a reference is made to a local variable in a function or method, but no value has been bound to that variable. This is a subclass of :exc:`NameError`."
msgstr "هنگامی پرتاب میشود که در یک تابع یا متد، به یک متغیر محلی ارجاع داده شود، اما هیچ مقداری به آن متغیر اختصاص نیافته باشد. این استثنا زیرکلاسی از :exc:`NameError` است."
msgid "Raised when a Unicode-related encoding or decoding error occurs. It is a subclass of :exc:`ValueError`."
msgstr "هنگامی که خطای کدگذاری یا کدگشایی مرتبط با یونیکد رخ میدهد، پرتاب میشود. این یک زیرکلاس از :exc:`ValueError` است."
msgid ":exc:`UnicodeError` has attributes that describe the encoding or decoding error. For example, ``err.object[err.start:err.end]`` gives the particular invalid input that the codec failed on."
msgstr ":exc:`UnicodeError` دارای ویژگیهایی است که خطای کدگذاری یا کدگشایی را توصیف میکنند. برای مثال، ``err.object[err.start:err.end]`` ورودی نامعتبر خاصی را میدهد که کدک در پردازش آن ناموفق بوده است."
msgid "The name of the encoding that raised the error."
msgstr "نام کدگذاریای که خطا را پرتاب کرد."
msgid "A string describing the specific codec error."
msgstr "رشتهای که خطای خاص کدک را توصیف میکند."
msgid "The object the codec was attempting to encode or decode."
msgstr "شیءای که کدک در حال تلاش برای کدگذاری یا کدگشایی آن بود."
msgid "The first index of invalid data in :attr:`object`."
msgstr "اولین اندیس دادههای نامعتبر در :attr:`object`."
msgid "This value should not be negative as it is interpreted as an absolute offset but this constraint is not enforced at runtime."
msgstr "این مقدار نباید منفی باشد، زیرا بهعنوان یک آفست مطلق (absolute offset) تفسیر میشود، اما این محدودیت در رانتایم اعمال نمیشود."
msgid "The index after the last invalid data in :attr:`object`."
msgstr "اندیس پس از آخرین دادهی نامعتبر در :attr:`object`."
msgid "Raised when a Unicode-related error occurs during encoding. It is a subclass of :exc:`UnicodeError`."
msgstr "هنگامی که خطایی مرتبط با Unicode در حین کدگذاری رخ دهد، پرتاب میشود. این، زیرکلاسی از :exc:`UnicodeError` است."
msgid "Raised when a Unicode-related error occurs during decoding. It is a subclass of :exc:`UnicodeError`."
msgstr "هنگامی که یک خطای مرتبط با یونیکد در حین کدگشایی رخ دهد، پرتاب میشود. این یک زیرکلاس از :exc:`UnicodeError` است."
msgid "Raised when a Unicode-related error occurs during translating. It is a subclass of :exc:`UnicodeError`."
msgstr "هنگامی که خطای مرتبط با یونیکد در حین ترجمه رخ میدهد، پرتاب میشود. این یک زیرکلاس از :exc:`UnicodeError` است."
msgid "Raised when an operation or function receives an argument that has the right type but an inappropriate value, and the situation is not described by a more precise exception such as :exc:`IndexError`."
msgstr "هنگامی پرتاب میشود که یک عملیات یا تابع آرگومانی دریافت کند که نوع آن درست است اما مقدار آن نامناسب است، و این وضعیت با استثنای دقیقتری مانند :exc:`IndexError` توصیف نشود."
msgid "Raised when the second argument of a division or modulo operation is zero. The associated value is a string indicating the type of the operands and the operation."
msgstr "هنگامی پرتاب میشود که دومین آرگومان یک عمل تقسیم یا پیمانه صفر باشد. مقدار مرتبط، رشتهای است که نوع عملوندها و عمل را نشان میدهد."
msgid "The following exceptions are kept for compatibility with previous versions; starting from Python 3.3, they are aliases of :exc:`OSError`."
msgstr "استثناهای زیر برای سازگاری با نسخههای پیشین حفظ شدهاند؛ از پایتون 3.3 به بعد، آنها نامهای مستعارِ :exc:`OSError` هستند."
msgid "Only available on Windows."
msgstr "فقط در ویندوز در دسترس است."
msgid "OS exceptions"
msgstr "استثناهای سیستمعاملی"
msgid "The following exceptions are subclasses of :exc:`OSError`, they get raised depending on the system error code."
msgstr "استثناهای زیر زیرکلاسهایی از :exc:`OSError` هستند و بسته به کد خطای سیستم پرتاب میشوند."
msgid "Raised when an operation would block on an object (e.g. socket) set for non-blocking operation. Corresponds to :c:data:`errno` :py:const:`~errno.EAGAIN`, :py:const:`~errno.EALREADY`, :py:const:`~errno.EWOULDBLOCK` and :py:const:`~errno.EINPROGRESS`."
msgstr "هنگامی پرتاب میشود که یک عملیات روی شیء (مثلاً سوکت) که برای عملیات غیرمسدودکننده تنظیم شده است، مسدود شود. متناظر است با :c:data:`errno` :py:const:`~errno.EAGAIN`، :py:const:`~errno.EALREADY`، :py:const:`~errno.EWOULDBLOCK` و :py:const:`~errno.EINPROGRESS`."
msgid "In addition to those of :exc:`OSError`, :exc:`BlockingIOError` can have one more attribute:"
msgstr "علاوه بر ویژگیهای :exc:`OSError`، :exc:`BlockingIOError` میتواند یک ویژگی دیگر نیز داشته باشد:"
msgid "An integer containing the number of **bytes** written to the stream before it blocked. This attribute is available when using the buffered I/O classes from the :mod:`io` module."
msgstr "یک عدد صحیح حاوی تعداد **بایتهای** نوشتهشده در جریان پیش از مسدود شدن آن است. این ویژگی هنگام استفاده از کلاسهای I/O بافرشده در ماژول :mod:`io` در دسترس است."
msgid "Raised when an operation on a child process failed. Corresponds to :c:data:`errno` :py:const:`~errno.ECHILD`."
msgstr "هنگامی پرتاب میشود که عملیاتی روی یک فرایند فرزند ناموفق باشد. با :c:data:`errno` :py:const:`~errno.ECHILD` متناظر است."
msgid "A base class for connection-related issues."
msgstr "کلاس پایهای برای مشکلات مرتبط با اتصال."
msgid "Subclasses are :exc:`BrokenPipeError`, :exc:`ConnectionAbortedError`, :exc:`ConnectionRefusedError` and :exc:`ConnectionResetError`."
msgstr "زیرکلاسها عبارتند از :exc:`BrokenPipeError`، :exc:`ConnectionAbortedError`، :exc:`ConnectionRefusedError` و :exc:`ConnectionResetError`."
msgid "A subclass of :exc:`ConnectionError`, raised when trying to write on a pipe while the other end has been closed, or trying to write on a socket which has been shutdown for writing. Corresponds to :c:data:`errno` :py:const:`~errno.EPIPE` and :py:const:`~errno.ESHUTDOWN`."
msgstr "زیرکلاسی از :exc:`ConnectionError`، که هنگام تلاش برای نوشتن روی یک پایپ، در حالی که سر دیگر آن بسته شده است، یا تلاش برای نوشتن روی سوکتی که برای نوشتن خاموش شده است، پرتاب میشود. با :c:data:`errno` :py:const:`~errno.EPIPE` و :py:const:`~errno.ESHUTDOWN` متناظر است."
msgid "A subclass of :exc:`ConnectionError`, raised when a connection attempt is aborted by the peer. Corresponds to :c:data:`errno` :py:const:`~errno.ECONNABORTED`."
msgstr "یک زیرکلاس از :exc:`ConnectionError` است که هنگامی پرتاب میشود که تلاش برای اتصال از سوی طرف مقابل قطع شود. متناظر با :c:data:`errno` :py:const:`~errno.ECONNABORTED` است."
msgid "A subclass of :exc:`ConnectionError`, raised when a connection attempt is refused by the peer. Corresponds to :c:data:`errno` :py:const:`~errno.ECONNREFUSED`."
msgstr "زیرکلاسی از :exc:`ConnectionError` که هنگامی پرتاب میشود که تلاش برای اتصال از سوی طرف مقابل رد شود. معادل :c:data:`errno` :py:const:`~errno.ECONNREFUSED` است."
msgid "A subclass of :exc:`ConnectionError`, raised when a connection is reset by the peer. Corresponds to :c:data:`errno` :py:const:`~errno.ECONNRESET`."
msgstr "زیرکلاسی از :exc:`ConnectionError`، که هنگامی پرتاب میشود که اتصال توسط همتا بازنشانی شود. با :c:data:`errno` :py:const:`~errno.ECONNRESET` متناظر است."
msgid "Raised when trying to create a file or directory which already exists. Corresponds to :c:data:`errno` :py:const:`~errno.EEXIST`."
msgstr "هنگام تلاش برای ایجاد پرونده یا پوشهای که از قبل وجود دارد، پرتاب میشود. متناظر با :c:data:`errno` :py:const:`~errno.EEXIST` است."
msgid "Raised when a file or directory is requested but doesn't exist. Corresponds to :c:data:`errno` :py:const:`~errno.ENOENT`."
msgstr "هنگامی که پرونده یا پوشهای درخواست شود اما وجود نداشته باشد، پرتاب میشود. متناظر با :c:data:`errno` :py:const:`~errno.ENOENT` است."
msgid "Raised when a system call is interrupted by an incoming signal. Corresponds to :c:data:`errno` :py:const:`~errno.EINTR`."
msgstr "هنگامی پرتاب میشود که یک فراخوانی سیستمی توسط یک سیگنال ورودی قطع شود. متناظر با :c:data:`errno` :py:const:`~errno.EINTR` است."
msgid "Python now retries system calls when a syscall is interrupted by a signal, except if the signal handler raises an exception (see :pep:`475` for the rationale), instead of raising :exc:`InterruptedError`."
msgstr "پایتون اکنون بهجای پرتاب :exc:`InterruptedError`، فراخوانیهای سیستمی را هنگامی که با سیگنالی قطع شوند دوباره امتحان میکند، مگر اینکه هندلر سیگنال استثنایی را پرتاب کند (برای دلیل آن :pep:`475` را ببینید)."
msgid "Raised when a file operation (such as :func:`os.remove`) is requested on a directory. Corresponds to :c:data:`errno` :py:const:`~errno.EISDIR`."
msgstr "هنگامی که یک عملیات پرونده (مانند :func:`os.remove`) روی یک پوشه درخواست شود، پرتاب میشود. با :c:data:`errno` :py:const:`~errno.EISDIR` متناظر است."
msgid "Raised when a directory operation (such as :func:`os.listdir`) is requested on something which is not a directory. On most POSIX platforms, it may also be raised if an operation attempts to open or traverse a non-directory file as if it were a directory. Corresponds to :c:data:`errno` :py:const:`~errno.ENOTDIR`."
msgstr "هنگامی پرتاب میشود که یک عملیات پوشه (مانند :func:`os.listdir`) روی چیزی که پوشه نیست درخواست شود. در بیشتر پلتفرمهای POSIX، ممکن است همچنین در صورتی پرتاب شود که یک عملیات تلاش کند یک پرونده غیرپوشهای را بهعنوان یک پوشه باز کند یا پیمایش کند. متناظر با :c:data:`errno` :py:const:`~errno.ENOTDIR` است."
msgid "Raised when trying to run an operation without the adequate access rights - for example filesystem permissions. Corresponds to :c:data:`errno` :py:const:`~errno.EACCES`, :py:const:`~errno.EPERM`, and :py:const:`~errno.ENOTCAPABLE`."
msgstr "هنگام تلاش برای اجرای یک عملیات بدون حق دسترسی کافی، برای مثال مجوزهای سامانه فایلبندی، پرتاب میشود. متناظر با :c:data:`errno` :py:const:`~errno.EACCES`، :py:const:`~errno.EPERM` و :py:const:`~errno.ENOTCAPABLE` است."
msgid "WASI's :py:const:`~errno.ENOTCAPABLE` is now mapped to :exc:`PermissionError`."
msgstr ":py:const:`~errno.ENOTCAPABLE` در WASI اکنون به :exc:`PermissionError` نگاشت میشود."
msgid "Raised when a given process doesn't exist. Corresponds to :c:data:`errno` :py:const:`~errno.ESRCH`."
msgstr "هنگامی که یک فرایند مشخص وجود ندارد، پرتاب میشود. متناظر با :c:data:`errno` :py:const:`~errno.ESRCH` است."
msgid "Raised when a system function timed out at the system level. Corresponds to :c:data:`errno` :py:const:`~errno.ETIMEDOUT`."
msgstr "هنگامی که یک تابع سیستمی در سطح سیستم دچار مهلت زمانی شود، پرتاب میشود. متناظر با :c:data:`errno` :py:const:`~errno.ETIMEDOUT` است."
msgid "All the above :exc:`OSError` subclasses were added."
msgstr "همهی زیرکلاسهای :exc:`OSError` فوق افزوده شدند."
msgid ":pep:`3151` - Reworking the OS and IO exception hierarchy"
msgstr ":pep:`3151` - بازطراحی سلسلهمراتب استثناهای OS و IO"
msgid "Warnings"
msgstr "هشدارها"
msgid "The following exceptions are used as warning categories; see the :ref:`warning-categories` documentation for more details."
msgstr "استثناهای زیر بهعنوان دستههای هشدار استفاده میشوند؛ برای جزئیات بیشتر، مستندات :ref:`warning-categories` را ببینید."
msgid "Base class for warning categories."
msgstr "کلاس پایه برای دستههای هشدار."
msgid "Base class for warnings generated by user code."
msgstr "کلاس پایه برای هشدارهای تولیدشده توسط کد کاربر."
msgid "Base class for warnings about deprecated features when those warnings are intended for other Python developers."
msgstr "کلاس پایه برای هشدارهای مربوط به ویژگیهای منسوخ، وقتی آن هشدارها برای سایر توسعهدهندگان پایتون در نظر گرفته شدهاند."
msgid "Ignored by the default warning filters, except in the ``__main__`` module (:pep:`565`). Enabling the :ref:`Python Development Mode <devmode>` shows this warning."
msgstr "توسط فیلترهای هشدار پیشفرض نادیده گرفته میشود، مگر در ماژول ``__main__`` (:pep:`565`). فعالسازی :ref:`حالت توسعه پایتون <devmode>` این هشدار را نمایش میدهد."
msgid "The deprecation policy is described in :pep:`387`."
msgstr "سیاست منسوخسازی در :pep:`387` توضیح داده شده است."
msgid "Base class for warnings about features which are obsolete and expected to be deprecated in the future, but are not deprecated at the moment."
msgstr "کلاس پایه برای هشدارهای مربوط به قابلیتهایی که قدیمی شدهاند و انتظار میرود در آینده منسوخ شوند، اما در حال حاضر منسوخ نیستند."
msgid "This class is rarely used as emitting a warning about a possible upcoming deprecation is unusual, and :exc:`DeprecationWarning` is preferred for already active deprecations."
msgstr "این کلاس بهندرت استفاده میشود، زیرا صدور هشدار دربارهی یک منسوخسازی احتمالی در آینده غیرمعمول است و برای موارد منسوخشدهی از قبل فعال، :exc:`DeprecationWarning` ترجیح داده میشود."
msgid "Ignored by the default warning filters. Enabling the :ref:`Python Development Mode <devmode>` shows this warning."
msgstr "توسط فیلترهای هشدار پیشفرض نادیده گرفته میشود. فعالسازی :ref:`حالت توسعه پایتون <devmode>` این هشدار را نمایش میدهد."
msgid "Base class for warnings about dubious syntax."
msgstr "کلاس پایه برای هشدارهای مربوط به سینتکس مشکوک."
msgid "This warning is typically emitted when compiling Python source code, and usually won't be reported when running already compiled code."
msgstr "این هشدار معمولاً هنگام کامپایل کد منبع پایتون نشان داده میشود و معمولاً هنگام اجرای کد از پیش کامپایلشده گزارش نمیشود."
msgid "Base class for warnings about dubious runtime behavior."
msgstr "کلاس پایه برای هشدارهای مربوط به رفتار مشکوک در رانتایم."
msgid "Base class for warnings about deprecated features when those warnings are intended for end users of applications that are written in Python."
msgstr "کلاس پایه برای هشدارهای مربوط به قابلیتهای منسوخ، زمانی که آن هشدارها برای کاربران نهایی برنامههایی که به زبان پایتون نوشته شدهاند در نظر گرفته شدهاند."
msgid "Base class for warnings about probable mistakes in module imports."
msgstr "کلاس پایه برای هشدارها در مورد اشتباهات احتمالی در ایمپورت ماژولها."
msgid "Base class for warnings related to Unicode."
msgstr "کلاس پایه برای هشدارهای مرتبط با یونیکد."
msgid "Base class for warnings related to encodings."
msgstr "کلاس پایه برای هشدارهای مرتبط با کدگذاریها."
msgid "See :ref:`io-encoding-warning` for details."
msgstr "برای جزئیات، :ref:`io-encoding-warning` را ببینید."
msgid "Base class for warnings related to :class:`bytes` and :class:`bytearray`."
msgstr "کلاس پایه برای هشدارهای مرتبط با :class:`bytes` و :class:`bytearray`."
msgid "Base class for warnings related to resource usage."
msgstr "کلاس پایه برای هشدارهای مربوط به مصرف منابع."
msgid "Exception groups"
msgstr "گروههای استثنا"
msgid "The following are used when it is necessary to raise multiple unrelated exceptions. They are part of the exception hierarchy so they can be handled with :keyword:`except` like all other exceptions. In addition, they are recognised by :keyword:`except*<except_star>`, which matches their subgroups based on the types of the contained exceptions."
msgstr "موارد زیر زمانی استفاده میشوند که لازم باشد چندین استثنای غیرمرتبط پرتاب شوند. این موارد بخشی از سلسلهمراتب استثناها هستند، بنابراین میتوان آنها را مانند تمام استثناهای دیگر با :keyword:`except` مدیریت کرد. علاوه بر این، :keyword:`except*<except_star>` آنها را شناسایی میکند و زیرگروههای آنها را بر اساس انواع استثناهای موجود در آنها تطبیق میدهد."
msgid "Both of these exception types wrap the exceptions in the sequence ``excs``. The ``msg`` parameter must be a string. The difference between the two classes is that :exc:`BaseExceptionGroup` extends :exc:`BaseException` and it can wrap any exception, while :exc:`ExceptionGroup` extends :exc:`Exception` and it can only wrap subclasses of :exc:`Exception`. This design is so that ``except Exception`` catches an :exc:`ExceptionGroup` but not :exc:`BaseExceptionGroup`."
msgstr "هر دوی این انواع استثنا، استثناهای موجود در دنباله ``excs`` را دربر میگیرند. پارامتر ``msg`` باید یک رشته باشد. تفاوت این دو کلاس در این است که :exc:`BaseExceptionGroup` از :exc:`BaseException` ارث میبرد و میتواند هر استثنایی را دربر بگیرد، در حالی که :exc:`ExceptionGroup` از :exc:`Exception` ارث میبرد و فقط میتواند زیرکلاسهای :exc:`Exception` را دربر بگیرد. این طراحی به این منظور است که ``except Exception`` :exc:`ExceptionGroup` را بگیرد، اما :exc:`BaseExceptionGroup` را نگیرد."
msgid "The :exc:`BaseExceptionGroup` constructor returns an :exc:`ExceptionGroup` rather than a :exc:`BaseExceptionGroup` if all contained exceptions are :exc:`Exception` instances, so it can be used to make the selection automatic. The :exc:`ExceptionGroup` constructor, on the other hand, raises a :exc:`TypeError` if any contained exception is not an :exc:`Exception` subclass."
msgstr "سازندهی :exc:`BaseExceptionGroup` اگر همهی استثناهای درون آن نمونههایی از :exc:`Exception` باشند، یک :exc:`ExceptionGroup` را بهجای یک :exc:`BaseExceptionGroup` برمیگرداند، بنابراین میتوان از آن برای خودکار کردن انتخاب استفاده کرد. از سوی دیگر، سازندهی :exc:`ExceptionGroup` اگر یکی از استثناهای درون آن زیرکلاسی از :exc:`Exception` نباشد، یک :exc:`TypeError` را پرتاب میکند."
msgid "Exception groups are :ref:`generic <generics>` over the type of their contained exceptions."
msgstr "گروههای استثنا نسبت به نوع استثناهای درون خود :ref:`عام <generics>` هستند."
msgid "The ``excs`` parameter may be any sequence, but lists and tuples are specifically processed more efficiently here. For optimal performance, pass a tuple as ``excs``."
msgstr "پارامتر ``excs`` میتواند هر دنبالهای باشد، اما فهرستها و تاپلها بهطور خاص در اینجا با کارایی بیشتری پردازش میشوند. برای عملکرد بهینه، یک تاپل را بهعنوان ``excs`` ارسال کنید."
msgid "The ``msg`` argument to the constructor. This is a read-only attribute."
msgstr "آرگومان ``msg`` برای سازنده. این یک ویژگی فقطخواندنی است."
msgid "A tuple of the exceptions in the ``excs`` sequence given to the constructor. This is a read-only attribute."
msgstr "تاپلی از استثناهای موجود در دنبالهی ``excs`` که به سازنده دادهشده است. این ویژگی فقطخواندنی است."
msgid "Returns an exception group that contains only the exceptions from the current group that match *condition*, or ``None`` if the result is empty."
msgstr "یک گروه استثنا برمیگرداند که فقط شامل استثناهایی از گروه فعلی است که با *condition* مطابقت دارند، یا اگر نتیجه خالی باشد ``None`` برمیگرداند."
msgid "The condition can be an exception type or tuple of exception types, in which case each exception is checked for a match using the same check that is used in an ``except`` clause. The condition can also be a callable (other than a type object) that accepts an exception as its single argument and returns true for the exceptions that should be in the subgroup."
msgstr "شرط میتواند یک نوع استثنا یا تاپلی از انواع استثنا باشد، که در این صورت هر استثنا با استفاده از همان بررسیای که در بند ``except`` استفاده میشود، برای تطابق بررسی میشود. شرط همچنین میتواند یک شیء فراخوانیپذیر (بهجز یک شیء نوع) باشد که یک استثنا را بهعنوان تنها آرگومان خود میپذیرد و برای استثناهایی که باید در زیرگروه باشند، مقدار true برمیگرداند."
msgid "The nesting structure of the current exception is preserved in the result, as are the values of its :attr:`message`, :attr:`~BaseException.__traceback__`, :attr:`~BaseException.__cause__`, :attr:`~BaseException.__context__` and :attr:`~BaseException.__notes__` fields. Empty nested groups are omitted from the result."
msgstr "ساختار تودرتوی استثنای جاری در نتیجه حفظ میشود؛ مقادیر فیلدهای :attr:`message`، :attr:`~BaseException.__traceback__`، :attr:`~BaseException.__cause__`، :attr:`~BaseException.__context__` و :attr:`~BaseException.__notes__` آن نیز حفظ میشوند. گروههای تودرتوی خالی از نتیجه حذف میشوند."
msgid "The condition is checked for all exceptions in the nested exception group, including the top-level and any nested exception groups. If the condition is true for such an exception group, it is included in the result in full."
msgstr "شرط برای تمام استثناهای درون گروه استثنای تودرتو بررسی میشود، از جمله گروه استثنای سطح بالا و هر گروه استثنای تودرتویی. اگر شرط برای چنین گروه استثنایی برقرار باشد، آن گروه بهطور کامل در نتیجه گنجانده میشود."
msgid "``condition`` can be any callable which is not a type object."
msgstr "``condition`` میتواند هر شیء فراخوانیپذیر باشد که یک شیء نوع نباشد."
msgid "Like :meth:`subgroup`, but returns the pair ``(match, rest)`` where ``match`` is ``subgroup(condition)`` and ``rest`` is the remaining non-matching part."
msgstr "مانند :meth:`subgroup`، اما جفت ``(match, rest)`` را برمیگرداند که در آن ``match`` برابر با ``subgroup(condition)`` است و ``rest`` بخش باقیماندهی غیرمنطبق است."
msgid "Returns an exception group with the same :attr:`message`, but which wraps the exceptions in ``excs``."
msgstr "یک گروه استثنا با همان :attr:`message` برمیگرداند، اما استثناهای درون ``excs`` را در بر میگیرد."
msgid "This method is used by :meth:`subgroup` and :meth:`split`, which are used in various contexts to break up an exception group. A subclass needs to override it in order to make :meth:`subgroup` and :meth:`split` return instances of the subclass rather than :exc:`ExceptionGroup`."
msgstr "این متد توسط :meth:`subgroup` و :meth:`split` استفاده میشود، که در زمینههای مختلف برای تجزیه یک گروه استثنا به کار میروند. یک زیرکلاس باید آن را بازنویسی کند تا :meth:`subgroup` و :meth:`split` بهجای :exc:`ExceptionGroup` نمونههایی از زیرکلاس را برگردانند."
msgid ":meth:`subgroup` and :meth:`split` copy the :attr:`~BaseException.__traceback__`, :attr:`~BaseException.__cause__`, :attr:`~BaseException.__context__` and :attr:`~BaseException.__notes__` fields from the original exception group to the one returned by :meth:`derive`, so these fields do not need to be updated by :meth:`derive`."
msgstr ":meth:`subgroup` و :meth:`split` ویژگیهای :attr:`~BaseException.__traceback__`، :attr:`~BaseException.__cause__`، :attr:`~BaseException.__context__` و :attr:`~BaseException.__notes__` را از گروه استثنای اصلی به گروهی که :meth:`derive` آن را برمیگرداند کپی میکنند، بنابراین نیازی نیست این ویژگیها توسط :meth:`derive` بهروزرسانی شوند."
msgid ""
">>> class MyGroup(ExceptionGroup):\n"
"... def derive(self, excs):\n"
"... return MyGroup(self.message, excs)\n"
"...\n"
">>> e = MyGroup(\"eg\", [ValueError(1), TypeError(2)])\n"
">>> e.add_note(\"a note\")\n"
">>> e.__context__ = Exception(\"context\")\n"
">>> e.__cause__ = Exception(\"cause\")\n"
">>> try:\n"
"... raise e\n"
"... except Exception as e:\n"
"... exc = e\n"
"...\n"
">>> match, rest = exc.split(ValueError)\n"
">>> exc, exc.__context__, exc.__cause__, exc.__notes__\n"
"(MyGroup('eg', [ValueError(1), TypeError(2)]), Exception('context'), Exception('cause'), ['a note'])\n"
">>> match, match.__context__, match.__cause__, match.__notes__\n"
"(MyGroup('eg', [ValueError(1)]), Exception('context'), Exception('cause'), ['a note'])\n"
">>> rest, rest.__context__, rest.__cause__, rest.__notes__\n"
"(MyGroup('eg', [TypeError(2)]), Exception('context'), Exception('cause'), ['a note'])\n"
">>> exc.__traceback__ is match.__traceback__ is rest.__traceback__\n"
"True"
msgstr ""
">>> class MyGroup(ExceptionGroup):\n"
"... def derive(self, excs):\n"
"... return MyGroup(self.message, excs)\n"
"...\n"
">>> e = MyGroup(\"eg\", [ValueError(1), TypeError(2)])\n"
">>> e.add_note(\"a note\")\n"
">>> e.__context__ = Exception(\"context\")\n"
">>> e.__cause__ = Exception(\"cause\")\n"
">>> try:\n"
"... raise e\n"
"... except Exception as e:\n"
"... exc = e\n"
"...\n"
">>> match, rest = exc.split(ValueError)\n"
">>> exc, exc.__context__, exc.__cause__, exc.__notes__\n"
"(MyGroup('eg', [ValueError(1), TypeError(2)]), Exception('context'), Exception('cause'), ['a note'])\n"
">>> match, match.__context__, match.__cause__, match.__notes__\n"
"(MyGroup('eg', [ValueError(1)]), Exception('context'), Exception('cause'), ['a note'])\n"
">>> rest, rest.__context__, rest.__cause__, rest.__notes__\n"
"(MyGroup('eg', [TypeError(2)]), Exception('context'), Exception('cause'), ['a note'])\n"
">>> exc.__traceback__ is match.__traceback__ is rest.__traceback__\n"
"True"
msgid "Note that :exc:`BaseExceptionGroup` defines :meth:`~object.__new__`, so subclasses that need a different constructor signature need to override that rather than :meth:`~object.__init__`. For example, the following defines an exception group subclass which accepts an exit_code and constructs the group's message from it. ::"
msgstr "توجه داشته باشید که :exc:`BaseExceptionGroup`، :meth:`~object.__new__` را تعریف میکند، بنابراین زیرکلاسهایی که به امضای سازندهای متفاوت نیاز دارند، باید بهجای :meth:`~object.__init__`، آن را بازنویسی کنند. برای مثال، کد زیر یک زیرکلاس از گروه استثنا تعریف میکند که یک exit_code میپذیرد و پیام گروه را از روی آن میسازد. ::"
msgid ""
"class Errors(ExceptionGroup):\n"
" def __new__(cls, errors, exit_code):\n"
" self = super().__new__(Errors, f\"exit code: {exit_code}\", errors)\n"
" self.exit_code = exit_code\n"
" return self\n"
"\n"
" def derive(self, excs):\n"
" return Errors(excs, self.exit_code)"
msgstr ""
"class Errors(ExceptionGroup):\n"
" def __new__(cls, errors, exit_code):\n"
" self = super().__new__(Errors, f\"exit code: {exit_code}\", errors)\n"
" self.exit_code = exit_code\n"
" return self\n"
"\n"
" def derive(self, excs):\n"
" return Errors(excs, self.exit_code)"
msgid "Like :exc:`ExceptionGroup`, any subclass of :exc:`BaseExceptionGroup` which is also a subclass of :exc:`Exception` can only wrap instances of :exc:`Exception`."
msgstr "مانند :exc:`ExceptionGroup`، هر زیرکلاسی از :exc:`BaseExceptionGroup` که همچنین زیرکلاسی از :exc:`Exception` باشد، فقط میتواند نمونههایی از :exc:`Exception` را در بر بگیرد."
msgid "Exception hierarchy"
msgstr "سلسلهمراتب استثنا"
msgid "The class hierarchy for built-in exceptions is:"
msgstr "سلسلهمراتب کلاس برای استثناهای توکار به صورت زیر است:"
msgid "statement"
msgstr "دستور"
msgid "try"
msgstr "try"
msgid "except"
msgstr "except"
msgid "raise"
msgstr "پرتاب"
msgid "exception"
msgstr "استثنا"
msgid "chaining"
msgstr "زنجیرهسازی"
msgid "__cause__ (exception attribute)"
msgstr "__cause__ (ویژگی استثنا)"
msgid "__context__ (exception attribute)"
msgstr "__context__ (صفت استثنا)"
msgid "__suppress_context__ (exception attribute)"
msgstr "__suppress_context__ (ویژگی استثنا)"
msgid "assert"
msgstr "assert"
msgid "module"
msgstr "ماژول"
msgid "errno"
msgstr "errno"