Repository navigation
Expand file tree
/
Copy pathsys.po
More file actions
819 lines (724 loc) · 38.9 KB
/
Copy pathsys.po
File metadata and controls
819 lines (724 loc) · 38.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
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
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
# 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:
# python-doc bot, 2025
# Inada Naoki <songofacandy@gmail.com>, 2026
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.15\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-10-25 17:19+0000\n"
"PO-Revision-Date: 2025-09-16 00:00+0000\n"
"Last-Translator: Inada Naoki <songofacandy@gmail.com>, 2026\n"
"Language-Team: Japanese (https://app.transifex.com/python-doc/teams/5390/"
"ja/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: ja\n"
"Plural-Forms: nplurals=1; plural=0;\n"
#: ../../c-api/sys.rst:6
msgid "Operating System Utilities"
msgstr "オペレーティングシステム関連のユーティリティ"
msgid ""
"Return the file system representation for *path*. If the object is "
"a :class:`str` or :class:`bytes` object, then a new :term:`strong reference` "
"is returned. If the object implements the :class:`os.PathLike` interface, "
"then :meth:`~os.PathLike.__fspath__` is returned as long as it is "
"a :class:`str` or :class:`bytes` object. Otherwise :exc:`TypeError` is "
"raised and ``NULL`` is returned."
msgstr ""
"``path`` のファイルシステム表現を返します。\n"
"オブジェクトが :class:`str` または :class:`bytes` の場合は、新しい :term:`強"
"参照 <strong reference>` を返します。\n"
":class:`os.PathLike` インターフェースを実装している場合"
"は、:meth:`~os.PathLike.__fspath__` の戻り値が :class:`str` また"
"は :class:`bytes` ならそれを返します。\n"
"それ以外の場合は :exc:`TypeError` を送出し、``NULL`` を返します。"
msgid ""
"Return true (nonzero) if the standard I/O file *fp* with name *filename* is "
"deemed interactive. This is the case for files for which "
"``isatty(fileno(fp))`` is true. If the :c:member:`PyConfig.interactive` is "
"non-zero, this function also returns true if the *filename* pointer is "
"``NULL`` or if the name is equal to one of the strings ``'<stdin>'`` or "
"``'???'``."
msgstr ""
"名前が ``filename`` の標準 I/O ファイル ``fp`` が対話的と判定される場合に、"
"真 (非ゼロ) を返します。\n"
"``isatty(fileno(fp))`` が真となるファイルが該当します。\n"
":c:member:`PyConfig.interactive` が非ゼロの場合は、``filename`` ポインタが "
"``NULL``、または名前が ``'<stdin>'`` か ``'???'`` の場合にも真を返します。"
msgid "This function must not be called before Python is initialized."
msgstr "Python が初期化される前に呼び出してはいけません。"
#: ../../c-api/sys.rst:35
msgid ""
"Function to prepare some internal state before a process fork. This should "
"be called before calling :c:func:`fork` or any similar function that clones "
"the current process. Only available on systems where :c:func:`fork` is "
"defined."
msgstr ""
"プロセスがフォークする前に、いくつかの内部状態を準備するための関数で"
"す。:c:func:`fork` や現在のプロセスを複製するその他の類似の関数を呼び出す前に"
"この関数を呼びださなければなりません。:c:func:`fork` が定義されているシステム"
"でのみ利用できます。"
msgid ""
"The C :c:func:`fork` call should only be made from the :ref:`\"main\" thread "
"<fork-and-threads>` (of the :ref:`\"main\" interpreter <sub-interpreter-"
"support>`). The same is true for ``PyOS_BeforeFork()``."
msgstr ""
"C の :c:func:`fork` は、:ref:`メインインタープリタ <sub-interpreter-"
"support>` の :ref:`メインスレッド <fork-and-threads>` からだけ呼び出してくだ"
"さい。\n"
"``PyOS_BeforeFork()`` も同様です。"
#: ../../c-api/sys.rst:51
msgid ""
"Function to update some internal state after a process fork. This should be "
"called from the parent process after calling :c:func:`fork` or any similar "
"function that clones the current process, regardless of whether process "
"cloning was successful. Only available on systems where :c:func:`fork` is "
"defined."
msgstr ""
"プロセスがフォークした後に内部状態を更新するための関数です。 :c:func:`fork` "
"や、現在のプロセスを複製するその他の類似の関数を呼び出した後に、プロセスの複"
"製が成功したかどうかにかかわらず、親プロセスからこの関数を呼び出さなければな"
"りません。:c:func:`fork` が定義されているシステムでのみ利用できます。"
msgid ""
"The C :c:func:`fork` call should only be made from the :ref:`\"main\" thread "
"<fork-and-threads>` (of the :ref:`\"main\" interpreter <sub-interpreter-"
"support>`). The same is true for ``PyOS_AfterFork_Parent()``."
msgstr ""
"C の :c:func:`fork` は、:ref:`メインインタープリタ <sub-interpreter-"
"support>` の :ref:`メインスレッド <fork-and-threads>` からだけ呼び出してくだ"
"さい。\n"
"``PyOS_AfterFork_Parent()`` も同様です。"
msgid ""
"Function to update internal interpreter state after a process fork. This "
"must be called from the child process after calling :c:func:`fork`, or any "
"similar function that clones the current process, if there is any chance the "
"process will call back into the Python interpreter. Only available on "
"systems where :c:func:`fork` is defined."
msgstr ""
"プロセスのフォーク後にインタープリタの内部状態を更新する関数です。\n"
":c:func:`fork` や、現在のプロセスを複製する同様の関数を呼び出した後、そのプロ"
"セスから Python インタープリタを再び呼び出す可能性が少しでもあるなら、子プロ"
"セスからこの関数を呼び出す必要があります。\n"
":c:func:`fork` が定義されているシステムでのみ利用できます。"
msgid ""
"The C :c:func:`fork` call should only be made from the :ref:`\"main\" thread "
"<fork-and-threads>` (of the :ref:`\"main\" interpreter <sub-interpreter-"
"support>`). The same is true for ``PyOS_AfterFork_Child()``."
msgstr ""
"C の :c:func:`fork` は、:ref:`メインインタープリタ <sub-interpreter-"
"support>` の :ref:`メインスレッド <fork-and-threads>` からだけ呼び出してくだ"
"さい。\n"
"``PyOS_AfterFork_Child()`` も同様です。"
#: ../../c-api/sys.rst:83
msgid ""
":func:`os.register_at_fork` allows registering custom Python functions to be "
"called by :c:func:`PyOS_BeforeFork()`, :c:func:`PyOS_AfterFork_Parent` "
"and :c:func:`PyOS_AfterFork_Child`."
msgstr ""
":func:`os.register_at_fork` を利用する"
"と :c:func:`PyOS_BeforeFork()`、:c:func:`PyOS_AfterFork_Parent` :c:func:`PyOS_AfterFork_Child` "
"によって呼び出されるカスタムのPython関数を登録できます。"
#: ../../c-api/sys.rst:90
msgid ""
"Function to update some internal state after a process fork; this should be "
"called in the new process if the Python interpreter will continue to be "
"used. If a new executable is loaded into the new process, this function does "
"not need to be called."
msgstr ""
"プロセスが fork した後の内部状態を更新するための関数です; fork 後 Python イン"
"タプリタを使い続ける場合、新たなプロセス内でこの関数を呼び出さねばなりませ"
"ん。新たなプロセスに新たな実行可能物をロードする場合、この関数を呼び出す必要"
"はありません。"
#: ../../c-api/sys.rst:95
msgid "This function is superseded by :c:func:`PyOS_AfterFork_Child()`."
msgstr ""
"この関数は :c:func:`PyOS_AfterFork_Child()` によって置き換えられました。"
msgid ""
"Return true when the interpreter runs out of stack space. This is a "
"reliable check, but is only available when :c:macro:`!USE_STACKCHECK` is "
"defined (currently on certain versions of Windows using the Microsoft Visual "
"C++ compiler). :c:macro:`!USE_STACKCHECK` will be defined automatically; you "
"should never change the definition in your own code."
msgstr ""
"インタープリタのスタック領域が足りなくなった場合に真を返します。\n"
"これは信頼できるチェックですが、:c:macro:`!USE_STACKCHECK` が定義されている場"
"合 (現在は Microsoft Visual C++ コンパイラを使う一部の Windows バージョン) だ"
"け利用できます。\n"
":c:macro:`!USE_STACKCHECK` は自動的に定義されます。\n"
"自分のコードで定義を変更してはいけません。"
msgid ""
"Return the current signal handler for signal *i*. This is a thin wrapper "
"around either :c:func:`!sigaction` or :c:func:`!signal`. Do not call those "
"functions directly!"
msgstr ""
"シグナル ``i`` の現在のシグナルハンドラを返します。\n"
":c:func:`!sigaction` または :c:func:`!signal` の薄いラッパーです。\n"
"それらの関数を直接呼び出してはいけません。"
msgid ""
"Set the signal handler for signal *i* to be *h*; return the old signal "
"handler. This is a thin wrapper around either :c:func:`!sigaction` "
"or :c:func:`!signal`. Do not call those functions directly!"
msgstr ""
"シグナル ``i`` のシグナルハンドラを ``h`` に設定し、以前のハンドラを返しま"
"す。\n"
":c:func:`!sigaction` または :c:func:`!signal` の薄いラッパーです。\n"
"それらの関数を直接呼び出してはいけません。"
msgid "Check if a :c:macro:`!SIGINT` signal has been received."
msgstr ":c:macro:`!SIGINT` シグナルを受信したかどうかを調べます。"
msgid ""
"Returns ``1`` if a :c:macro:`!SIGINT` has occurred and clears the signal "
"flag, or ``0`` otherwise."
msgstr ""
":c:macro:`!SIGINT` が発生していればシグナルフラグをクリアして ``1`` を返し、"
"それ以外の場合は ``0`` を返します。"
msgid ""
"In most cases, you should prefer :c:func:`PyErr_CheckSignals` over this "
"function. :c:func:`!PyErr_CheckSignals` invokes the appropriate signal "
"handlers for all pending signals, allowing Python code to handle the signal "
"properly. This function only detects :c:macro:`!SIGINT` and does not invoke "
"any Python signal handlers."
msgstr ""
"ほとんどの場合、この関数よりも :c:func:`PyErr_CheckSignals` を使う方が適切で"
"す。\n"
":c:func:`!PyErr_CheckSignals` は、保留中のすべてのシグナルに対応するシグナル"
"ハンドラを呼び出し、Python コードがシグナルを適切に処理できるようにします。\n"
"この関数は :c:macro:`!SIGINT` の検出だけを行い、Python のシグナルハンドラは呼"
"び出しません。"
msgid ""
"This function is async-signal-safe and this function cannot fail. The caller "
"must hold an :term:`attached thread state`."
msgstr ""
"この関数は非同期シグナルセーフで、失敗しません。\n"
"呼び出し元には :term:`アタッチされたスレッド状態 <attached thread state>` が"
"必要です。"
msgid ""
"This function should not be called directly: use the :c:type:`PyConfig` API "
"with the :c:func:`PyConfig_SetBytesString` function which ensures "
"that :ref:`Python is preinitialized <c-preinit>`."
msgstr ""
"この関数は直接呼び出さないでください。\n"
"代わりに :c:type:`PyConfig` API と :c:func:`PyConfig_SetBytesString` 関数を"
"使ってください。\n"
"これにより、:ref:`Python の事前初期化 <c-preinit>` が保証されます。"
msgid ""
"This function must not be called before :ref:`Python is preinitialized <c-"
"preinit>` and so that the LC_CTYPE locale is properly configured: see "
"the :c:func:`Py_PreInitialize` function."
msgstr ""
"LC_CTYPE ロケールを適切に設定するため、:ref:`Python が事前初期化される <c-"
"preinit>` 前にこの関数を呼び出してはいけません。\n"
":c:func:`Py_PreInitialize` 関数を参照してください。"
#: ../../c-api/sys.rst:155
msgid ""
"Decode a byte string from the :term:`filesystem encoding and error handler`. "
"If the error handler is :ref:`surrogateescape error handler "
"<surrogateescape>`, undecodable bytes are decoded as characters in range "
"U+DC80..U+DCFF; and if a byte sequence can be decoded as a surrogate "
"character, the bytes are escaped using the surrogateescape error handler "
"instead of decoding them."
msgstr ""
":term:`ファイルシステムのエンコーディングとエラーハンドラ <filesystem "
"encoding and error handler>` からバイト文字列をデコードします。エラーハンドラ"
"が :ref:`surrogateescape エラーハンドラ <surrogateescape>` なら、\n"
"デコードできないバイトは U+DC80 から U+DCFF までの範囲の文字としてデコードさ"
"れ、バイト列がサロゲート文字としてデコードできる場合は、デコードするのではな"
"く surrogateescape エラーハンドラを使ってバイト列がエスケープされます。"
#: ../../c-api/sys.rst:162
msgid ""
"Return a pointer to a newly allocated wide character string, "
"use :c:func:`PyMem_RawFree` to free the memory. If size is not ``NULL``, "
"write the number of wide characters excluding the null character into "
"``*size``"
msgstr ""
"新しくメモリ確保されたワイドキャラクター文字列へのポインタを返します。\n"
"このメモリを解放するのには :c:func:`PyMem_RawFree` を使ってください。\n"
"引数 size が ``NULL`` でない場合は、 null 文字以外のワイドキャラクターの数を "
"``*size`` へ書き込みます。"
#: ../../c-api/sys.rst:166
msgid ""
"Return ``NULL`` on decoding error or memory allocation error. If *size* is "
"not ``NULL``, ``*size`` is set to ``(size_t)-1`` on memory error or set to "
"``(size_t)-2`` on decoding error."
msgstr ""
"デコードもしくはメモリ確保でエラーが起きると ``NULL`` を返します。\n"
"*size* が ``NULL`` でない場合は、メモリエラーのときは ``(size_t)-1`` を、デ"
"コードでのエラーのときは ``(size_t)-2`` を ``*size`` に設定します。"
msgid ""
"The :term:`filesystem encoding and error handler` are selected "
"by :c:func:`PyConfig_Read`: see :c:member:`~PyConfig.filesystem_encoding` "
"and :c:member:`~PyConfig.filesystem_errors` members of :c:type:`PyConfig`."
msgstr ""
":term:`ファイルシステムのエンコーディングとエラーハンドラ <filesystem "
"encoding and error handler>` は :c:func:`PyConfig_Read` が選択します。\n"
":c:type:`PyConfig` の :c:member:`~PyConfig.filesystem_encoding` "
"と :c:member:`~PyConfig.filesystem_errors` メンバを参照してください。"
#: ../../c-api/sys.rst:174
msgid ""
"Decoding errors should never happen, unless there is a bug in the C library."
msgstr "C ライブラリーにバグがない限り、デコードでのエラーは起こりえません。"
#: ../../c-api/sys.rst:177
msgid ""
"Use the :c:func:`Py_EncodeLocale` function to encode the character string "
"back to a byte string."
msgstr ""
"キャラクター文字列をバイト文字列に戻すには :c:func:`Py_EncodeLocale` 関数を"
"使ってください。"
#: ../../c-api/sys.rst:182
msgid ""
"The :c:func:`PyUnicode_DecodeFSDefaultAndSize` "
"and :c:func:`PyUnicode_DecodeLocaleAndSize` functions."
msgstr ""
":c:func:`PyUnicode_DecodeFSDefaultAndSize` およ"
"び :c:func:`PyUnicode_DecodeLocaleAndSize` 関数。"
#: ../../c-api/sys.rst:187 ../../c-api/sys.rst:229
msgid ""
"The function now uses the UTF-8 encoding in the :ref:`Python UTF-8 Mode "
"<utf8-mode>`."
msgstr ""
"この関数は、:ref:`Python UTF-8 Mode <utf8-mode>` ではUTF-8エンコーディングを"
"利用するようになりました。"
msgid ""
"The function now uses the UTF-8 encoding on Windows "
"if :c:member:`PyPreConfig.legacy_windows_fs_encoding` is zero;"
msgstr ""
":c:member:`PyPreConfig.legacy_windows_fs_encoding` がゼロの場合、Windows で"
"は UTF-8 エンコーディングを使うようになりました。"
#: ../../c-api/sys.rst:198
msgid ""
"Encode a wide character string to the :term:`filesystem encoding and error "
"handler`. If the error handler is :ref:`surrogateescape error handler "
"<surrogateescape>`, surrogate characters in the range U+DC80..U+DCFF are "
"converted to bytes 0x80..0xFF."
msgstr ""
"ワイドキャラクター文字列を :term:`ファイルシステムのエンコーディングとエラー"
"ハンドラ <filesystem encoding and error handler>` にエンコードします。エラー"
"ハンドラが :ref:`surrogateescape エラーハンドラ <surrogateescape>` なら、\n"
"U+DC80 から U+DCFF までの範囲のサロゲート文字は 0x80 から 0xFF までのバイトに"
"変換されます。"
#: ../../c-api/sys.rst:203
msgid ""
"Return a pointer to a newly allocated byte string, use :c:func:`PyMem_Free` "
"to free the memory. Return ``NULL`` on encoding error or memory allocation "
"error."
msgstr ""
"新しくメモリ確保されたバイト文字列へのポインタを返します。\n"
"このメモリを解放するのには :c:func:`PyMem_Free` を使ってください。\n"
"エンコードエラーかメモリ確保エラーのときは ``NULL`` を返します。"
msgid ""
"If error_pos is not ``NULL``, ``*error_pos`` is set to ``(size_t)-1`` on "
"success, or set to the index of the invalid character on encoding error."
msgstr ""
"``error_pos`` が ``NULL`` でなければ、成功した場合は ``*error_pos`` を "
"``(size_t)-1`` に、エンコードエラーの場合は無効な文字のインデックスに設定しま"
"す。"
#: ../../c-api/sys.rst:214
msgid ""
"Use the :c:func:`Py_DecodeLocale` function to decode the bytes string back "
"to a wide character string."
msgstr ""
"バイト文字列をワイドキャラクター文字列に戻すには :c:func:`Py_DecodeLocale` 関"
"数を使ってください。"
#: ../../c-api/sys.rst:224
msgid ""
"The :c:func:`PyUnicode_EncodeFSDefault` and :c:func:`PyUnicode_EncodeLocale` "
"functions."
msgstr ""
":c:func:`PyUnicode_EncodeFSDefault` および :c:func:`PyUnicode_EncodeLocale` "
"関数。"
msgid ""
"The function now uses the UTF-8 encoding on Windows "
"if :c:member:`PyPreConfig.legacy_windows_fs_encoding` is zero."
msgstr ""
":c:member:`PyPreConfig.legacy_windows_fs_encoding` がゼロの場合、Windows で"
"は UTF-8 エンコーディングを使うようになりました。"
msgid ""
"Similar to :c:func:`!fopen`, but *path* is a Python object and an exception "
"is set on error."
msgstr ""
":c:func:`!fopen` と同様ですが、``path`` は Python オブジェクトで、エラーの場"
"合は例外を設定します。"
msgid ""
"*path* must be a :class:`str` object, a :class:`bytes` object, or "
"a :term:`path-like object`."
msgstr ""
"``path`` は :class:`str` オブジェクト、:class:`bytes` オブジェクト、また"
"は :term:`パス風オブジェクト <path-like object>` でなければなりません。"
msgid ""
"On success, return the new file pointer. On error, set an exception and "
"return ``NULL``."
msgstr ""
"成功した場合は新しいファイルポインタを返します。\n"
"エラーの場合は例外を設定して ``NULL`` を返します。"
msgid ""
"The file must be closed by :c:func:`Py_fclose` rather than calling "
"directly :c:func:`!fclose`."
msgstr ""
"ファイルを閉じるには :c:func:`!fclose` を直接呼び出さず、:c:func:`Py_fclose` "
"を使う必要があります。"
msgid "The file descriptor is created non-inheritable (:pep:`446`)."
msgstr "ファイル記述子は継承不可として作成されます (:pep:`446`)。"
msgid "The caller must have an :term:`attached thread state`."
msgstr ""
"呼び出し元には :term:`アタッチされたスレッド状態 <attached thread state>` が"
"必要です。"
msgid "Close a file that was opened by :c:func:`Py_fopen`."
msgstr ":c:func:`Py_fopen` で開いたファイルを閉じます。"
msgid ""
"On success, return ``0``. On error, return ``EOF`` and ``errno`` is set to "
"indicate the error. In either case, any further access (including another "
"call to :c:func:`Py_fclose`) to the stream results in undefined behavior."
msgstr ""
"成功した場合は ``0`` を返します。\n"
"エラーの場合は ``EOF`` を返し、エラーを示す ``errno`` を設定します。\n"
"どちらの場合も、その後ストリームにアクセスすると (:c:func:`Py_fclose` をもう"
"一度呼び出すことも含めて)、動作は未定義です。"
#: ../../c-api/sys.rst:273
msgid "System Functions"
msgstr "システム関数"
#: ../../c-api/sys.rst:275
msgid ""
"These are utility functions that make functionality from the :mod:`sys` "
"module accessible to C code. They all work with the current interpreter "
"thread's :mod:`sys` module's dict, which is contained in the internal thread "
"state structure."
msgstr ""
":mod:`sys` モジュールが提供している機能にCのコードからアクセスする関数です。"
"すべての関数は現在のインタプリタスレッドの :mod:`sys` モジュールの辞書に対し"
"て動作します。この辞書は内部のスレッド状態構造体に格納されています。"
msgid ""
"Get the attribute *name* of the :mod:`sys` module. Return a :term:`strong "
"reference`. Raise :exc:`RuntimeError` and return ``NULL`` if it does not "
"exist or if the :mod:`sys` module cannot be found."
msgstr ""
":mod:`sys` モジュールの属性 ``name`` を取得し、:term:`強参照 <strong "
"reference>` を返します。\n"
"属性が存在しない場合や :mod:`sys` モジュールが見つからない場合"
"は :exc:`RuntimeError` を送出し、``NULL`` を返します。"
msgid ""
"If the non-existing object should not be treated as a failure, you can "
"use :c:func:`PySys_GetOptionalAttr` instead."
msgstr ""
"オブジェクトが存在しない場合を失敗として扱う必要がなければ、代わり"
"に :c:func:`PySys_GetOptionalAttr` を使えます。"
msgid ""
"This is the same as :c:func:`PySys_GetAttr`, but *name* is specified as "
"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than "
"a :c:expr:`PyObject*`."
msgstr ""
":c:func:`PySys_GetAttr` と同じですが、``name`` は :c:expr:`PyObject*` ではな"
"く、UTF-8 エンコードの :c:expr:`const char*` バイト列で指定します。"
msgid ""
"If the non-existing object should not be treated as a failure, you can "
"use :c:func:`PySys_GetOptionalAttrString` instead."
msgstr ""
"オブジェクトが存在しない場合を失敗として扱う必要がなければ、代わり"
"に :c:func:`PySys_GetOptionalAttrString` を使えます。"
msgid ""
"Variant of :c:func:`PySys_GetAttr` which doesn't raise exception if the "
"object does not exist."
msgstr ""
"オブジェクトが存在しない場合に例外を送出しない :c:func:`PySys_GetAttr` の変種"
"です。"
msgid ""
"Set *\\*result* to a new :term:`strong reference` to the object and return "
"``1`` if the object exists."
msgstr ""
"オブジェクトが存在する場合は、そのオブジェクトへの新しい :term:`強参照 "
"<strong reference>` を ``*result`` に設定し、``1`` を返します。"
msgid ""
"Set *\\*result* to ``NULL`` and return ``0`` without setting an exception if "
"the object does not exist."
msgstr ""
"オブジェクトが存在しない場合は、``*result`` を ``NULL`` に設定し、例外を設定"
"せずに ``0`` を返します。"
msgid ""
"Set an exception, set *\\*result* to ``NULL``, and return ``-1``, if an "
"error occurred."
msgstr ""
"エラーの場合は、例外を設定し、``*result`` を ``NULL`` にして ``-1`` を返しま"
"す。"
msgid ""
"This is the same as :c:func:`PySys_GetOptionalAttr`, but *name* is specified "
"as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than "
"a :c:expr:`PyObject*`."
msgstr ""
":c:func:`PySys_GetOptionalAttr` と同じですが、``name`` "
"は :c:expr:`PyObject*` ではなく、UTF-8 エンコードの :c:expr:`const char*` バ"
"イト列で指定します。"
msgid ""
"Similar to :c:func:`PySys_GetAttrString`, but return a :term:`borrowed "
"reference` and return ``NULL`` *without* setting exception on failure."
msgstr ""
":c:func:`PySys_GetAttrString` と同様ですが、:term:`借用参照 <borrowed "
"reference>` を返し、失敗した場合は例外を設定 *せずに* ``NULL`` を返します。"
msgid "Preserves exception that was set before the call."
msgstr "呼び出し前に設定されていた例外を保持します。"
#: ../../c-api/sys.rst:333
msgid ""
"Set *name* in the :mod:`sys` module to *v* unless *v* is ``NULL``, in which "
"case *name* is deleted from the sys module. Returns ``0`` on success, ``-1`` "
"on error."
msgstr ""
"*v* が ``NULL`` で無い場合、 :mod:`sys` モジュールの *name* に *v* を設定しま"
"す。 *v* が ``NULL`` なら、 sys モジュールから *name* を削除します。成功した"
"ら ``0`` を、エラー時は ``-1`` を返します。"
#: ../../c-api/sys.rst:339
msgid ""
"Write the output string described by *format* to :data:`sys.stdout`. No "
"exceptions are raised, even if truncation occurs (see below)."
msgstr ""
"*format* で指定された出力文字列を :data:`sys.stdout` に出力します。切り詰めが"
"起こった場合を含め、例外は一切発生しません (後述)。"
#: ../../c-api/sys.rst:342
msgid ""
"*format* should limit the total size of the formatted output string to 1000 "
"bytes or less -- after 1000 bytes, the output string is truncated. In "
"particular, this means that no unrestricted \"%s\" formats should occur; "
"these should be limited using \"%.<N>s\" where <N> is a decimal number "
"calculated so that <N> plus the maximum size of other formatted text does "
"not exceed 1000 bytes. Also watch out for \"%f\", which can print hundreds "
"of digits for very large numbers."
msgstr ""
"*format* は、フォーマット後の出力文字列のトータルの大きさを1000バイト以下に抑"
"えるべきです。-- 1000 バイト以降の出力文字列は切り詰められます。特に、制限の"
"ない \"%s\" フォーマットを使うべきではありません。\"%.<N>s\" のようにして N "
"に10進数の値を指定し、<N> + その他のフォーマット後の最大サイズが1000を超えな"
"いように設定するべきです。同じように \"%f\" にも気を付ける必要があります。非"
"常に大きい数値に対して、数百の数字を出力する可能性があります。"
#: ../../c-api/sys.rst:350
msgid ""
"If a problem occurs, or :data:`sys.stdout` is unset, the formatted message "
"is written to the real (C level) *stdout*."
msgstr ""
"問題が発生したり、 :data:`sys.stdout` が設定されていなかった場合、フォーマッ"
"ト後のメッセージは本物の(Cレベルの) *stdout* に出力されます。"
#: ../../c-api/sys.rst:355
msgid ""
"As :c:func:`PySys_WriteStdout`, but write to :data:`sys.stderr` or *stderr* "
"instead."
msgstr ""
":c:func:`PySys_WriteStdout` と同じですが、 :data:`sys.stderr` もしくは "
"*stderr* に出力します。"
#: ../../c-api/sys.rst:360
msgid ""
"Function similar to PySys_WriteStdout() but format the message "
"using :c:func:`PyUnicode_FromFormatV` and don't truncate the message to an "
"arbitrary length."
msgstr ""
"PySys_WriteStdout() に似た関数ですが、 :c:func:`PyUnicode_FromFormatV` を使っ"
"てメッセージをフォーマットし、メッセージを任意の長さに切り詰めたりはしませ"
"ん。"
#: ../../c-api/sys.rst:368
msgid ""
"As :c:func:`PySys_FormatStdout`, but write to :data:`sys.stderr` or *stderr* "
"instead."
msgstr ""
":c:func:`PySys_FormatStdout` と同じですが、 :data:`sys.stderr` もしくは "
"*stderr* に出力します。"
#: ../../c-api/sys.rst:375
msgid ""
"Return the current dictionary of :option:`-X` options, similarly "
"to :data:`sys._xoptions`. On error, ``NULL`` is returned and an exception "
"is set."
msgstr ""
":data:`sys._xoptions` と同様、 :option:`-X` オプションの現在の辞書を返しま"
"す。エラーが起きると、 ``NULL`` が返され、例外がセットされます。"
msgid ""
"Raise an auditing event with any active hooks. Return zero for success and "
"non-zero with an exception set on failure."
msgstr ""
"有効なフックに監査イベントを通知します。\n"
"成功した場合はゼロを返し、失敗した場合は例外を設定して非ゼロを返します。"
msgid "The *event* string argument must not be *NULL*."
msgstr "文字列引数 ``event`` は ``NULL`` であってはいけません。"
msgid ""
"If any hooks have been added, *format* and other arguments will be used to "
"construct a tuple to pass. Apart from ``N``, the same format characters as "
"used in :c:func:`Py_BuildValue` are available. If the built value is not a "
"tuple, it will be added into a single-element tuple."
msgstr ""
"フックが追加されている場合、``format`` とほかの引数を使って、渡すタプルを作成"
"します。\n"
"``N`` を除き、:c:func:`Py_BuildValue` と同じ書式文字を使えます。\n"
"作成した値がタプルでない場合は、1 要素のタプルに格納します。"
msgid ""
"The ``N`` format option must not be used. It consumes a reference, but since "
"there is no way to know whether arguments to this function will be consumed, "
"using it may cause reference leaks."
msgstr ""
"書式オプション ``N`` を使ってはいけません。\n"
"このオプションは参照を消費しますが、この関数への引数が消費されるかどうかを知"
"る方法がないため、使うと参照がリークする可能性があります。"
msgid ""
"Note that ``#`` format characters should always be treated "
"as :c:type:`Py_ssize_t`, regardless of whether ``PY_SSIZE_T_CLEAN`` was "
"defined."
msgstr ""
"``#`` 書式文字の引数は、``PY_SSIZE_T_CLEAN`` の定義の有無にかかわらず、常"
"に :c:type:`Py_ssize_t` として扱ってください。"
msgid ":func:`sys.audit` performs the same function from Python code."
msgstr ":func:`sys.audit` は Python コードから同じ機能を提供します。"
msgid "See also :c:func:`PySys_AuditTuple`."
msgstr ":c:func:`PySys_AuditTuple` も参照してください。"
msgid ""
"Require :c:type:`Py_ssize_t` for ``#`` format characters. Previously, an "
"unavoidable deprecation warning was raised."
msgstr ""
"``#`` 書式文字で :c:type:`Py_ssize_t` が必須になりました。\n"
"以前は、回避できない非推奨の警告が発生していました。"
msgid ""
"Similar to :c:func:`PySys_Audit`, but pass arguments as a Python object. "
"*args* must be a :class:`tuple`. To pass no arguments, *args* can be *NULL*."
msgstr ""
":c:func:`PySys_Audit` と同様ですが、引数を Python オブジェクトとして渡しま"
"す。\n"
"``args`` は :class:`tuple` でなければなりません。\n"
"引数を渡さない場合は ``NULL`` でも構いません。"
msgid ""
"Append the callable *hook* to the list of active auditing hooks. Return zero "
"on success and non-zero on failure. If the runtime has been initialized, "
"also set an error on failure. Hooks added through this API are called for "
"all interpreters created by the runtime."
msgstr ""
"有効な監査フックのリストに、呼び出し可能な ``hook`` を追加します。\n"
"成功した場合はゼロを返し、失敗した場合は非ゼロを返します。\n"
"ランタイムが初期化済みなら、失敗時にはエラーも設定します。\n"
"この API で追加したフックは、ランタイムが作成するすべてのインタープリタで呼び"
"出されます。"
#: ../../c-api/sys.rst:429
msgid ""
"The *userData* pointer is passed into the hook function. Since hook "
"functions may be called from different runtimes, this pointer should not "
"refer directly to Python state."
msgstr ""
"*userData* ポインタはフック関数に渡されます。\n"
"フック関数は別なランタイムから呼び出されるかもしれないので、このポインタは直"
"接 Python の状態を参照すべきではありません。"
msgid ""
"This function is safe to call before :c:func:`Py_Initialize`. When called "
"after runtime initialization, existing audit hooks are notified and may "
"silently abort the operation by raising an error subclassed "
"from :class:`Exception` (other errors will not be silenced)."
msgstr ""
"この関数は :c:func:`Py_Initialize` より前でも安全に呼び出せます。\n"
"ランタイムの初期化後に呼び出すと、既存の監査フックに通知されます。\n"
"フックは :class:`Exception` のサブクラスのエラーを送出して、通知せずにこの操"
"作を中止させることがあります (それ以外のエラーは抑制されません)。"
msgid ""
"The hook function is always called with an :term:`attached thread state` by "
"the Python interpreter that raised the event."
msgstr ""
"フック関数は、イベントを発生させた Python インタープリタによって、常"
"に :term:`スレッド状態がアタッチされた <attached thread state>` 状態で呼び出"
"されます。"
msgid ""
"See :pep:`578` for a detailed description of auditing. Functions in the "
"runtime and standard library that raise events are listed in the :ref:`audit "
"events table <audit-events>`. Details are in each function's documentation."
msgstr ""
"監査の詳しい説明は :pep:`578` を参照してください。\n"
"イベントを発生させるランタイムと標準ライブラリの関数は :ref:`監査イベントの"
"表 <audit-events>` に一覧されています。\n"
"詳細は各関数のドキュメントを参照してください。"
msgid ""
"If the interpreter is initialized, this function raises an auditing event "
"``sys.addaudithook`` with no arguments. If any existing hooks raise an "
"exception derived from :class:`Exception`, the new hook will not be added "
"and the exception is cleared. As a result, callers cannot assume that their "
"hook has been added unless they control all existing hooks."
msgstr ""
"インタープリタが初期化済みの場合、この関数は引数なしの監査イベント "
"``sys.addaudithook`` を発生させます。\n"
"既存のフックが :class:`Exception` の派生例外を送出した場合、新しいフックは追"
"加されず、例外はクリアされます。\n"
"そのため、既存のフックをすべて制御できない限り、呼び出し側は自分のフックが追"
"加されたと仮定できません。"
msgid ""
"The type of the hook function. *event* is the C string event argument passed "
"to :c:func:`PySys_Audit` or :c:func:`PySys_AuditTuple`. *args* is guaranteed "
"to be a :c:type:`PyTupleObject`. *userData* is the argument passed to "
"PySys_AddAuditHook()."
msgstr ""
"フック関数の型です。\n"
"``event`` は :c:func:`PySys_Audit` または :c:func:`PySys_AuditTuple` に渡され"
"た C 文字列のイベント引数です。\n"
"``args`` は :c:type:`PyTupleObject` であることが保証されます。\n"
"``userData`` は ``PySys_AddAuditHook()`` に渡された引数です。"
#: ../../c-api/sys.rst:469
msgid "Process Control"
msgstr "プロセス制御"
msgid ""
"Print a fatal error message and kill the process. No cleanup is performed. "
"This function should only be invoked when a condition is detected that would "
"make it dangerous to continue using the Python interpreter; e.g., when the "
"object administration appears to be corrupted. On Unix, the standard C "
"library function :c:func:`!abort` is called which will attempt to produce "
"a :file:`core` file."
msgstr ""
"致命的なエラーメッセージを表示してプロセスを終了します。\n"
"後片付けは一切行いません。\n"
"オブジェクトの管理情報が破損した場合など、Python インタープリタを使い続けると"
"危険な状況を検出したときだけ呼び出してください。\n"
"Unix では標準 C ライブラリ関数 :c:func:`!abort` を呼び出し、:file:`core` ファ"
"イルの生成を試みます。"
msgid ""
"The ``Py_FatalError()`` function is replaced with a macro which logs "
"automatically the name of the current function, unless the "
"``Py_LIMITED_API`` macro is defined."
msgstr ""
"``Py_LIMITED_API`` マクロが定義されていない限り、``Py_FatalError()`` 関数は現"
"在の関数名を自動的に記録するマクロに置き換えられます。"
msgid "Log the function name automatically."
msgstr "関数名を自動的に記録するようになりました。"
#: ../../c-api/sys.rst:497
msgid ""
"Exit the current process. This calls :c:func:`Py_FinalizeEx` and then calls "
"the standard C library function ``exit(status)``. "
"If :c:func:`Py_FinalizeEx` indicates an error, the exit status is set to 120."
msgstr ""
"現在のプロセスを終了します。:c:func:`Py_FinalizeEx` を呼び出した後、標準Cライ"
"ブラリ関数の ``exit(status)`` を呼び出します。:c:func:`Py_FinalizeEx` がエ"
"ラーになった場合、終了ステータスは 120に設定されます。"
#: ../../c-api/sys.rst:501
msgid "Errors from finalization no longer ignored."
msgstr "終了処理のエラーは無視されなくなりました。"
#: ../../c-api/sys.rst:511
msgid ""
"Register a cleanup function to be called by :c:func:`Py_FinalizeEx`. The "
"cleanup function will be called with no arguments and should return no "
"value. At most 32 cleanup functions can be registered. When the "
"registration is successful, :c:func:`Py_AtExit` returns ``0``; on failure, "
"it returns ``-1``. The cleanup function registered last is called first. "
"Each cleanup function will be called at most once. Since Python's internal "
"finalization will have completed before the cleanup function, no Python APIs "
"should be called by *func*."
msgstr ""
":c:func:`Py_FinalizeEx` から呼び出される後始末処理を行う関数 (cleanup "
"function) を登録します。後始末関数は引数無しで呼び出され、値を返しません。最"
"大で 32 の後始末処理関数を登録できます。登録に成功する"
"と、 :c:func:`Py_AtExit` は ``0`` を返します; 失敗すると ``-1`` を返します。"
"最後に登録した後始末処理関数から先に呼び出されます。各関数は高々一度しか呼び"
"出されません。 Python の内部的な終了処理は後始末処理関数より以前に完了してい"
"るので、 *func* からはいかなる Python API も呼び出してはなりません。"
msgid ":c:func:`PyUnstable_AtExit` for passing a ``void *data`` argument."
msgstr ""
"``void *data`` 引数を渡すには :c:func:`PyUnstable_AtExit` を参照してくださ"
"い。"
msgid "USE_STACKCHECK (C macro)"
msgstr "USE_STACKCHECK (C マクロ)"
msgid "abort (C function)"
msgstr "abort (C 関数)"
msgid "Py_FinalizeEx (C function)"
msgstr "Py_FinalizeEx (C 関数)"
msgid "exit (C function)"
msgstr "exit (C 関数)"
msgid "cleanup functions"
msgstr "後始末関数"