-
-
Notifications
You must be signed in to change notification settings - Fork 37
Expand file tree
/
Copy pathtypeobj.po
More file actions
2364 lines (2127 loc) · 123 KB
/
typeobj.po
File metadata and controls
2364 lines (2127 loc) · 123 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
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2021, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# tomo, 2020
# Osamu NAKAMURA, 2021
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-01-01 16:02+0000\n"
"PO-Revision-Date: 2019-09-01 03:38+0000\n"
"Last-Translator: Osamu NAKAMURA, 2021\n"
"Language-Team: Japanese (https://www.transifex.com/python-doc/teams/5390/"
"ja/)\n"
"Language: ja\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=1; plural=0;\n"
#: ../../c-api/typeobj.rst:6
msgid "Type Objects"
msgstr "型オブジェクト"
#: ../../c-api/typeobj.rst:8
msgid ""
"Perhaps one of the most important structures of the Python object system is "
"the structure that defines a new type: the :c:type:`PyTypeObject` "
"structure. Type objects can be handled using any of the :c:func:"
"`PyObject_\\*` or :c:func:`PyType_\\*` functions, but do not offer much "
"that's interesting to most Python applications. These objects are "
"fundamental to how objects behave, so they are very important to the "
"interpreter itself and to any extension module that implements new types."
msgstr ""
"新スタイルの型を定義する構造体: :c:type:`PyTypeObject` 構造体は、おそらく "
"Python オブジェクトシステムの中で最も重要な構造体の1つでしょう。型オブジェク"
"トは :c:func:`PyObject_\\*` 系や :c:func:`PyType_\\*` 系の関数で扱えますが、"
"ほとんどの Python アプリケーションにとって、さして面白みのある機能を提供しま"
"せん。型オブジェクトはオブジェクトがどのように振舞うかを決める基盤ですから、"
"インタプリタ自体や新たな型を定義する拡張モジュールでは非常に重要な存在です。"
#: ../../c-api/typeobj.rst:16
msgid ""
"Type objects are fairly large compared to most of the standard types. The "
"reason for the size is that each type object stores a large number of "
"values, mostly C function pointers, each of which implements a small part of "
"the type's functionality. The fields of the type object are examined in "
"detail in this section. The fields will be described in the order in which "
"they occur in the structure."
msgstr ""
"型オブジェクトは標準の型 (standard type) に比べるとかなり大きな構造体です。各"
"型オブジェクトは多くの値を保持しており、そのほとんどは C 関数へのポインタで、"
"それぞれの関数はその型の機能の小さい部分を実装しています。この節では、型オブ"
"ジェクトの各フィールドについて詳細を説明します。各フィールドは、構造体内で出"
"現する順番に説明されています。"
#: ../../c-api/typeobj.rst:23
msgid ""
"Typedefs: unaryfunc, binaryfunc, ternaryfunc, inquiry, intargfunc, "
"intintargfunc, intobjargproc, intintobjargproc, objobjargproc, destructor, "
"freefunc, printfunc, getattrfunc, getattrofunc, setattrfunc, setattrofunc, "
"reprfunc, hashfunc"
msgstr ""
"Typedefs: unaryfunc, binaryfunc, ternaryfunc, inquiry, intargfunc, "
"intintargfunc, intobjargproc, intintobjargproc, objobjargproc, destructor, "
"freefunc, printfunc, getattrfunc, getattrofunc, setattrfunc, setattrofunc, "
"cmpfunc, reprfunc, hashfunc"
#: ../../c-api/typeobj.rst:28
msgid ""
"The structure definition for :c:type:`PyTypeObject` can be found in :file:"
"`Include/object.h`. For convenience of reference, this repeats the "
"definition found there:"
msgstr ""
":c:type:`PyTypeObject` の構造体定義は :file:`Include/object.h` で見つけられる"
"はずです。参照の手間を省くために、ここでは定義を繰り返します:"
#: ../../c-api/typeobj.rst:35
msgid ""
"The type object structure extends the :c:type:`PyVarObject` structure. The :"
"attr:`ob_size` field is used for dynamic types (created by :func:"
"`type_new`, usually called from a class statement). Note that :c:data:"
"`PyType_Type` (the metatype) initializes :c:member:`~PyTypeObject."
"tp_itemsize`, which means that its instances (i.e. type objects) *must* have "
"the :attr:`ob_size` field."
msgstr ""
"型オブジェクト構造体は :c:type:`PyVarObject` 構造体を拡張したものです。 :"
"attr:`ob_size` フィールドは、(通常 class 文が呼び出す :func:`type_new` で生成"
"される) 動的な型に使います。 :c:data:`PyType_Type` (メタタイプ) は :c:member:"
"`~PyTypeObject.tp_itemsize` を初期化するので注意してください。すなわち、 イン"
"スタンス (つまり型オブジェクト) には :attr:`ob_size` フィールドが存在しなけれ"
"ば *なりません* 。"
#: ../../c-api/typeobj.rst:45
msgid ""
"These fields are only present when the macro ``Py_TRACE_REFS`` is defined. "
"Their initialization to ``NULL`` is taken care of by the "
"``PyObject_HEAD_INIT`` macro. For statically allocated objects, these "
"fields always remain ``NULL``. For dynamically allocated objects, these two "
"fields are used to link the object into a doubly-linked list of *all* live "
"objects on the heap. This could be used for various debugging purposes; "
"currently the only use is to print the objects that are still alive at the "
"end of a run when the environment variable :envvar:`PYTHONDUMPREFS` is set."
msgstr ""
"これらのフィールドはマクロ ``Py_TRACE_REFS`` が定義されている場合のみ存在しま"
"す。 ``PyObject_HEAD_INIT`` マクロを使うと、フィールドを ``NULL`` に初期化し"
"ます。静的にメモリ確保されているオブジェクトでは、これらのフィールドは常に "
"``NULL`` のままです。動的にメモリ確保されるオブジェクトの場合、これら二つの"
"フィールドは、ヒープ上の *全ての* 存続中のオブジェクトからなる二重リンクリス"
"トでオブジェクトをリンクする際に使われます。このことは様々なデバッグ目的に利"
"用できます; 現状では、環境変数 :envvar:`PYTHONDUMPREFS` が設定されているとき"
"に、プログラムの実行終了時点で存続しているオブジェクトを出力するのが唯一の用"
"例です。"
#: ../../c-api/typeobj.rst:54
msgid "These fields are not inherited by subtypes."
msgstr "サブタイプはこのフィールドを継承しません。"
#: ../../c-api/typeobj.rst:59
msgid ""
"This is the type object's reference count, initialized to ``1`` by the "
"``PyObject_HEAD_INIT`` macro. Note that for statically allocated type "
"objects, the type's instances (objects whose :attr:`ob_type` points back to "
"the type) do *not* count as references. But for dynamically allocated type "
"objects, the instances *do* count as references."
msgstr ""
"型オブジェクトの参照カウントで、 ``PyObject_HEAD_INIT`` はこの値を ``1`` に初"
"期化します。静的にメモリ確保された型オブジェクトでは、型のインスタンス (:"
"attr:`ob_type` が該当する型を指しているオブジェクト) は参照をカウントする対象"
"には *なりません* 。動的にメモリ確保される型オブジェクトの場合、インスタンス"
"は参照カウントの対象に *なります* 。"
#: ../../c-api/typeobj.rst:65 ../../c-api/typeobj.rst:94
#: ../../c-api/typeobj.rst:122
msgid "This field is not inherited by subtypes."
msgstr "サブタイプはこのフィールドを継承しません。"
#: ../../c-api/typeobj.rst:70
msgid ""
"This is the type's type, in other words its metatype. It is initialized by "
"the argument to the ``PyObject_HEAD_INIT`` macro, and its value should "
"normally be ``&PyType_Type``. However, for dynamically loadable extension "
"modules that must be usable on Windows (at least), the compiler complains "
"that this is not a valid initializer. Therefore, the convention is to pass "
"``NULL`` to the ``PyObject_HEAD_INIT`` macro and to initialize this field "
"explicitly at the start of the module's initialization function, before "
"doing anything else. This is typically done like this::"
msgstr ""
"型自体の型、別の言い方をするとメタタイプです。 ``PyObject_HEAD_INIT`` マクロ"
"で初期化され、通常は ``&PyType_Type`` になります。しかし、(少なくとも) "
"Windows で利用できる動的ロード可能な拡張モジュールでは、コンパイラは有効な初"
"期化ではないと文句をつけます。そこで、ならわしとして、 "
"``PyObject_HEAD_INIT`` には ``NULL`` を渡して初期化しておき、他の操作を行う前"
"にモジュールの初期化関数で明示的にこのフィールドを初期化することになっていま"
"す。この操作は以下のように行います::"
#: ../../c-api/typeobj.rst:81
msgid ""
"This should be done before any instances of the type are created. :c:func:"
"`PyType_Ready` checks if :attr:`ob_type` is ``NULL``, and if so, initializes "
"it to the :attr:`ob_type` field of the base class. :c:func:`PyType_Ready` "
"will not change this field if it is non-zero."
msgstr ""
"上の操作は、該当する型のいかなるインスタンス生成よりも前にしておかなければな"
"りません。 :c:func:`PyType_Ready` は :attr:`ob_type` が ``NULL`` かどうか調"
"べ、 ``NULL`` の場合には基底クラスの :attr:`ob_type` フィールドで初期化しま"
"す。 ob_type フィールドがゼロでない場合、 :c:func:`PyType_Ready` はこのフィー"
"ルドを変更しません。"
#: ../../c-api/typeobj.rst:86 ../../c-api/typeobj.rst:188
#: ../../c-api/typeobj.rst:255 ../../c-api/typeobj.rst:322
#: ../../c-api/typeobj.rst:340 ../../c-api/typeobj.rst:694
#: ../../c-api/typeobj.rst:711 ../../c-api/typeobj.rst:791
#: ../../c-api/typeobj.rst:886 ../../c-api/typeobj.rst:979
#: ../../c-api/typeobj.rst:1034
msgid "This field is inherited by subtypes."
msgstr "サブタイプはこのフィールドを継承します。"
#: ../../c-api/typeobj.rst:91
msgid ""
"For statically allocated type objects, this should be initialized to zero. "
"For dynamically allocated type objects, this field has a special internal "
"meaning."
msgstr ""
"静的にメモリ確保されている型オブジェクトの場合、このフィールドはゼロに初期化"
"されます。動的にメモリ確保されている型オブジェクトの場合、このフィールドは内"
"部使用される特殊な意味を持ちます。"
#: ../../c-api/typeobj.rst:99
msgid ""
"Pointer to a NUL-terminated string containing the name of the type. For "
"types that are accessible as module globals, the string should be the full "
"module name, followed by a dot, followed by the type name; for built-in "
"types, it should be just the type name. If the module is a submodule of a "
"package, the full package name is part of the full module name. For "
"example, a type named :class:`T` defined in module :mod:`M` in subpackage :"
"mod:`Q` in package :mod:`P` should have the :c:member:`~PyTypeObject."
"tp_name` initializer ``\"P.Q.M.T\"``."
msgstr ""
"型の名前が入っている NUL 終端された文字列へのポインタです。モジュールのグロー"
"バル変数としてアクセスできる型の場合、この文字列は完全なモジュール名、ドッ"
"ト、そして型の名前と続く文字列になります; 組み込み型の場合、ただの型の名前で"
"す。モジュールがあるパッケージのサブモジュールの場合、完全なパッケージ名が完"
"全なモジュール名の一部になっています。例えば、パッケージ :mod:`P` 内のサブモ"
"ジュール :mod:`Q` に入っているモジュール :mod:`M` 内で定義されている :class:"
"`T` は、 :c:member:`~PyTypeObject.tp_name` を ``\"P.Q.M.T\"`` に初期化しま"
"す。"
#: ../../c-api/typeobj.rst:107
msgid ""
"For dynamically allocated type objects, this should just be the type name, "
"and the module name explicitly stored in the type dict as the value for key "
"``'__module__'``."
msgstr ""
"動的にメモリ確保される型オブジェクトの場合、このフィールドは単に型の名前にな"
"り、モジュール名は型の辞書内でキー ``'__module__'`` に対する値として明示的に"
"保存されます。"
#: ../../c-api/typeobj.rst:111
msgid ""
"For statically allocated type objects, the tp_name field should contain a "
"dot. Everything before the last dot is made accessible as the :attr:"
"`__module__` attribute, and everything after the last dot is made accessible "
"as the :attr:`~definition.__name__` attribute."
msgstr ""
"静的にメモリ確保される型オブジェクトの場合、 tp_name フィールドにはドットが含"
"まれているはずです。\n"
"最後のドットよりも前にある部分文字列全体は :attr:`__module__` 属性として、ま"
"たドットよりも後ろにある部分は :attr:`~definition.__name__` 属性としてアクセ"
"スできます。"
#: ../../c-api/typeobj.rst:116
msgid ""
"If no dot is present, the entire :c:member:`~PyTypeObject.tp_name` field is "
"made accessible as the :attr:`~definition.__name__` attribute, and the :attr:"
"`__module__` attribute is undefined (unless explicitly set in the "
"dictionary, as explained above). This means your type will be impossible to "
"pickle. Additionally, it will not be listed in module documentations "
"created with pydoc."
msgstr ""
"ドットが入っていない場合、 :c:member:`~PyTypeObject.tp_name` フィールドの内容"
"全てが :attr:`~definition.__name__` 属性になり、 :attr:`__module__` 属性は "
"(前述のように型の辞書内で明示的にセットしないかぎり) 未定義になります。\n"
"このため、その型は pickle 化できないことになります。\n"
"さらに、 pydoc が作成するモジュールドキュメントのリストにも載らなくなります。"
#: ../../c-api/typeobj.rst:128
msgid ""
"These fields allow calculating the size in bytes of instances of the type."
msgstr ""
"これらのフィールドは、型インスタンスのバイトサイズを計算できるようにします。"
#: ../../c-api/typeobj.rst:130
msgid ""
"There are two kinds of types: types with fixed-length instances have a zero :"
"c:member:`~PyTypeObject.tp_itemsize` field, types with variable-length "
"instances have a non-zero :c:member:`~PyTypeObject.tp_itemsize` field. For "
"a type with fixed-length instances, all instances have the same size, given "
"in :c:member:`~PyTypeObject.tp_basicsize`."
msgstr ""
"型には二つの種類があります: 固定長インスタンスの型は、 :c:member:"
"`~PyTypeObject.tp_itemsize` フィールドがゼロで、可変長インスタンスの方は :c:"
"member:`~PyTypeObject.tp_itemsize` フィールドが非ゼロの値になります。固定長イ"
"ンスタンスの型の場合、全てのインスタンスは等しく :c:member:`~PyTypeObject."
"tp_basicsize` で与えられたサイズになります。"
#: ../../c-api/typeobj.rst:135
msgid ""
"For a type with variable-length instances, the instances must have an :attr:"
"`ob_size` field, and the instance size is :c:member:`~PyTypeObject."
"tp_basicsize` plus N times :c:member:`~PyTypeObject.tp_itemsize`, where N is "
"the \"length\" of the object. The value of N is typically stored in the "
"instance's :attr:`ob_size` field. There are exceptions: for example, ints "
"use a negative :attr:`ob_size` to indicate a negative number, and N is "
"``abs(ob_size)`` there. Also, the presence of an :attr:`ob_size` field in "
"the instance layout doesn't mean that the instance structure is variable-"
"length (for example, the structure for the list type has fixed-length "
"instances, yet those instances have a meaningful :attr:`ob_size` field)."
msgstr ""
"可変長インスタンスの型の場合、インスタンスには :attr:`ob_size` フィールドが"
"なくてはならず、インスタンスのサイズは N をオブジェクトの \"長さ\" として、 :"
"c:member:`~PyTypeObject.tp_basicsize` と :c:member:`~PyTypeObject."
"tp_itemsize` の N 倍を足したものになります。 N の値は通常、インスタンスの :"
"attr:`ob_size` フィールドに記憶されます。ただし例外がいくつかあります: 例え"
"ば、整数では負の値を :attr:`ob_size` に使って、インスタンスの表す値が負である"
"ことを示し、 N 自体は ``abs(ob_size)`` になります。また、 :attr:`ob_size` "
"フィールドがあるからといって、必ずしもインスタンスが可変長であることを意味し"
"ません (例えば、 リスト型の構造体は固定長のインスタンスになるにもかかわらず、"
"インスタンスにはちゃんと意味を持った :attr:`ob_size` フィールドがあります)。"
#: ../../c-api/typeobj.rst:146
msgid ""
"The basic size includes the fields in the instance declared by the macro :c:"
"macro:`PyObject_HEAD` or :c:macro:`PyObject_VAR_HEAD` (whichever is used to "
"declare the instance struct) and this in turn includes the :attr:`_ob_prev` "
"and :attr:`_ob_next` fields if they are present. This means that the only "
"correct way to get an initializer for the :c:member:`~PyTypeObject."
"tp_basicsize` is to use the ``sizeof`` operator on the struct used to "
"declare the instance layout. The basic size does not include the GC header "
"size."
msgstr ""
"基本サイズには、 :c:macro:`PyObject_HEAD` マクロまたは :c:macro:"
"`PyObject_VAR_HEAD` マクロ (インスタンス構造体を宣言するのに使ったどちらかの"
"マクロ) で宣言されているフィールドが入っています。さらに、 :attr:`_ob_prev` "
"および :attr:`_ob_next` フィールドがある場合、これらのフィールドもサイズに加"
"算されます。従って、 :c:member:`~PyTypeObject.tp_basicsize` の正しい初期化値"
"を得るには、インスタンスデータのレイアウトを宣言するのに使う構造体に対して "
"``sizeof`` 演算子を使うしかありません。基本サイズには、GC ヘッダサイズは入っ"
"ていません。"
#: ../../c-api/typeobj.rst:154
msgid ""
"These fields are inherited separately by subtypes. If the base type has a "
"non-zero :c:member:`~PyTypeObject.tp_itemsize`, it is generally not safe to "
"set :c:member:`~PyTypeObject.tp_itemsize` to a different non-zero value in a "
"subtype (though this depends on the implementation of the base type)."
msgstr ""
"これらのフィールドはサブタイプに別々に継承されます。基底タイプが 0 でない :c:"
"member:`~PyTypeObject.tp_itemsize` を持っていた場合、基底タイプの実装に依存し"
"ますが、一般的にはサブタイプで別の 0 で無い値を :c:member:`~PyTypeObject."
"tp_itemsize` に設定するのは安全ではありません。"
#: ../../c-api/typeobj.rst:159
msgid ""
"A note about alignment: if the variable items require a particular "
"alignment, this should be taken care of by the value of :c:member:"
"`~PyTypeObject.tp_basicsize`. Example: suppose a type implements an array "
"of ``double``. :c:member:`~PyTypeObject.tp_itemsize` is ``sizeof(double)``. "
"It is the programmer's responsibility that :c:member:`~PyTypeObject."
"tp_basicsize` is a multiple of ``sizeof(double)`` (assuming this is the "
"alignment requirement for ``double``)."
msgstr ""
"アラインメントに関する注釈: 変数の各要素を配置する際に特定のアラインメントが"
"必要となる場合、 :c:member:`~PyTypeObject.tp_basicsize` の値に気をつけなけれ"
"ばなりません。例: ある型が ``double`` の配列を実装しているとします。 :c:"
"member:`~PyTypeObject.tp_itemsize` は ``sizeof(double)`` です。 :c:member:"
"`~PyTypeObject.tp_basicsize` が ``sizeof(double)`` (ここではこれを "
"``double`` のアラインメントが要求するサイズと仮定する) の個数分のサイズになる"
"ようにするのはプログラマの責任です。"
#: ../../c-api/typeobj.rst:169
msgid ""
"A pointer to the instance destructor function. This function must be "
"defined unless the type guarantees that its instances will never be "
"deallocated (as is the case for the singletons ``None`` and ``Ellipsis``)."
msgstr ""
"インスタンスのデストラクタ関数へのポインタです。この関数は (単量子 ``None`` "
"や ``Ellipsis`` の場合のように) インスタンスが決してメモリ解放されない型でな"
"い限り必ず定義しなければなりません。"
#: ../../c-api/typeobj.rst:173
msgid ""
"The destructor function is called by the :c:func:`Py_DECREF` and :c:func:"
"`Py_XDECREF` macros when the new reference count is zero. At this point, "
"the instance is still in existence, but there are no references to it. The "
"destructor function should free all references which the instance owns, free "
"all memory buffers owned by the instance (using the freeing function "
"corresponding to the allocation function used to allocate the buffer), and "
"finally (as its last action) call the type's :c:member:`~PyTypeObject."
"tp_free` function. If the type is not subtypable (doesn't have the :const:"
"`Py_TPFLAGS_BASETYPE` flag bit set), it is permissible to call the object "
"deallocator directly instead of via :c:member:`~PyTypeObject.tp_free`. The "
"object deallocator should be the one used to allocate the instance; this is "
"normally :c:func:`PyObject_Del` if the instance was allocated using :c:func:"
"`PyObject_New` or :c:func:`PyObject_VarNew`, or :c:func:`PyObject_GC_Del` if "
"the instance was allocated using :c:func:`PyObject_GC_New` or :c:func:"
"`PyObject_GC_NewVar`."
msgstr ""
"デストラクタ関数は、参照カウントが新たにゼロになった際に :c:func:`Py_DECREF` "
"や :c:func:`Py_XDECREF` マクロから呼び出されます。呼び出された時点では、イン"
"スタンスはまだ存在しますが、インスタンスに対する参照は全くない状態です。デス"
"トラクタ関数はインスタンスが保持している全ての参照を解放し、インスタンスが確"
"保している全てのメモリバッファを (バッファの確保時に使った関数に対応するメモ"
"リ解放関数を使って) 解放し、最後に (デストラクタ関数の最後の操作として) その"
"型の :c:member:`~PyTypeObject.tp_free` 関数を呼び出します。ある型がサブタイ"
"プを作成できない (:const:`Py_TPFLAGS_BASETYPE` フラグがセットされていない) 場"
"合、 :c:member:`~PyTypeObject.tp_free` の代わりにオブジェクトのメモリ解放関"
"数 (deallocator) を直接呼び出してもかまいません。オブジェクトのメモリ解放関数"
"は、インスタンスのメモリ確保を行う際に使った関数に対応したものでなければなり"
"ません; インスタンスを :c:func:`PyObject_New` や :c:func:`PyObject_VarNew` で"
"メモリ 確保した場合には、通常 :c:func:`PyObject_Del` を使い、 :c:func:"
"`PyObject_GC_New` や :c:func:`PyObject_GC_NewVar` で確保した場合には :c:func:"
"`PyObject_GC_Del` を使います。"
#: ../../c-api/typeobj.rst:193
msgid "Reserved slot, formerly used for print formatting in Python 2.x."
msgstr ""
"予約済みのスロットです。\n"
"以前は Python 2.x でオブジェクトのフォーマット出力をするのに使われていまし"
"た。"
#: ../../c-api/typeobj.rst:198
msgid "An optional pointer to the get-attribute-string function."
msgstr "オプションのポインタで、get-attribute-string を行う関数を指します。"
#: ../../c-api/typeobj.rst:200
msgid ""
"This field is deprecated. When it is defined, it should point to a function "
"that acts the same as the :c:member:`~PyTypeObject.tp_getattro` function, "
"but taking a C string instead of a Python string object to give the "
"attribute name. The signature is ::"
msgstr ""
"このフィールドは非推奨です。\n"
"このフィールドを定義するときは、 :c:member:`~PyTypeObject.tp_getattro` 関数と"
"同じように動作し、属性名は Python 文字列 オブジェクトではなく C 文字列で指定"
"するような関数を指すようにしなければなりません。\n"
"シグネチャは次の通りです::"
#: ../../c-api/typeobj.rst:206
msgid ""
"This field is inherited by subtypes together with :c:member:`~PyTypeObject."
"tp_getattro`: a subtype inherits both :c:member:`~PyTypeObject.tp_getattr` "
"and :c:member:`~PyTypeObject.tp_getattro` from its base type when the "
"subtype's :c:member:`~PyTypeObject.tp_getattr` and :c:member:`~PyTypeObject."
"tp_getattro` are both ``NULL``."
msgstr ""
"このフィールドは :c:member:`~PyTypeObject.tp_getattro` と共にサブタイプに継承"
"されます: すなわち、サブタイプの :c:member:`~PyTypeObject.tp_getattr` およ"
"び :c:member:`~PyTypeObject.tp_getattro` が共に ``NULL`` の場合、サブタイプは"
"基底タイプから :c:member:`~PyTypeObject.tp_getattr` と :c:member:"
"`~PyTypeObject.tp_getattro` を両方とも継承します。"
#: ../../c-api/typeobj.rst:213 ../../c-api/typeobj.rst:358
msgid ""
"An optional pointer to the function for setting and deleting attributes."
msgstr "オプションのポインタで、属性の設定と削除を行う関数を指します。"
#: ../../c-api/typeobj.rst:215
msgid ""
"This field is deprecated. When it is defined, it should point to a function "
"that acts the same as the :c:member:`~PyTypeObject.tp_setattro` function, "
"but taking a C string instead of a Python string object to give the "
"attribute name. The signature is ::"
msgstr ""
"このフィールドは非推奨です。\n"
"このフィールドを定義するときは、 :c:member:`~PyTypeObject.tp_setattro` 関数と"
"同じように動作し、属性名は Python 文字列 オブジェクトではなく C 文字列で指定"
"するような関数を指すようにしなければなりません。\n"
"シグネチャは次の通りです::"
#: ../../c-api/typeobj.rst:221
msgid ""
"The *v* argument is set to ``NULL`` to delete the attribute. This field is "
"inherited by subtypes together with :c:member:`~PyTypeObject.tp_setattro`: a "
"subtype inherits both :c:member:`~PyTypeObject.tp_setattr` and :c:member:"
"`~PyTypeObject.tp_setattro` from its base type when the subtype's :c:member:"
"`~PyTypeObject.tp_setattr` and :c:member:`~PyTypeObject.tp_setattro` are "
"both ``NULL``."
msgstr ""
#: ../../c-api/typeobj.rst:229
msgid ""
"Pointer to an additional structure that contains fields relevant only to "
"objects which implement :term:`awaitable` and :term:`asynchronous iterator` "
"protocols at the C-level. See :ref:`async-structs` for details."
msgstr ""
"追加の構造体を指すポインタです。\n"
"この構造体は、 C レベルで :term:`awaitable` プロトコルと :term:`asynchronous "
"iterator` プロトコルを実装するオブジェクトだけに関係するフィールドを持ちま"
"す。\n"
"詳しいことは :ref:`async-structs` を参照してください。"
#: ../../c-api/typeobj.rst:233
msgid "Formerly known as ``tp_compare`` and ``tp_reserved``."
msgstr "以前は ``tp_compare`` や ``tp_reserved`` として知られていました。"
#: ../../c-api/typeobj.rst:241
msgid ""
"An optional pointer to a function that implements the built-in function :"
"func:`repr`."
msgstr ""
"オプションのポインタで、組み込み関数 :func:`repr` を実装している関数を指しま"
"す。"
#: ../../c-api/typeobj.rst:244
msgid ""
"The signature is the same as for :c:func:`PyObject_Repr`; it must return a "
"string or a Unicode object. Ideally, this function should return a string "
"that, when passed to :func:`eval`, given a suitable environment, returns an "
"object with the same value. If this is not feasible, it should return a "
"string starting with ``'<'`` and ending with ``'>'`` from which both the "
"type and the value of the object can be deduced."
msgstr ""
"シグネチャは :c:func:`PyObject_Repr` と同じです。この関数は文字列オブジェクト"
"か Unicode オブジェクトを返さなければなりません。理想的には、この関数が返す文"
"字列は、適切な環境で :func:`eval` に渡した場合、同じ値を持つオブジェクトにな"
"るような文字列でなければなりません。不可能な場合には、オブジェクトの型と値か"
"ら導出した内容の入った ``'<'`` から始まって ``'>'`` で終わる文字列を返さなけ"
"ればなりません。"
#: ../../c-api/typeobj.rst:251
msgid ""
"When this field is not set, a string of the form ``<%s object at %p>`` is "
"returned, where ``%s`` is replaced by the type name, and ``%p`` by the "
"object's memory address."
msgstr ""
"このフィールドが設定されていない場合、 ``<%s object at %p>`` の形式をとる文字"
"列が返されます。 ``%s`` は型の名前に、 ``%p`` はオブジェクトのメモリアドレス"
"に置き換えられます。"
#: ../../c-api/typeobj.rst:259
msgid ""
"Pointer to an additional structure that contains fields relevant only to "
"objects which implement the number protocol. These fields are documented "
"in :ref:`number-structs`."
msgstr ""
"数値プロトコルを実装した追加の構造体を指すポインタです。これらのフィールドに"
"ついては :ref:`number-structs` で説明されています。"
#: ../../c-api/typeobj.rst:263
msgid ""
"The :c:member:`~PyTypeObject.tp_as_number` field is not inherited, but the "
"contained fields are inherited individually."
msgstr ""
":c:member:`~PyTypeObject.tp_as_number` フィールドは継承されませんが、そこの含"
"まれるフィールドが個別に継承されます。"
#: ../../c-api/typeobj.rst:269
msgid ""
"Pointer to an additional structure that contains fields relevant only to "
"objects which implement the sequence protocol. These fields are documented "
"in :ref:`sequence-structs`."
msgstr ""
"シーケンスプロトコルを実装した追加の構造体を指すポインタです。これらのフィー"
"ルドについては :ref:`sequence-structs` で説明されています。"
#: ../../c-api/typeobj.rst:273
msgid ""
"The :c:member:`~PyTypeObject.tp_as_sequence` field is not inherited, but the "
"contained fields are inherited individually."
msgstr ""
":c:member:`~PyTypeObject.tp_as_sequence` フィールドは継承されませんが、これに"
"含まれるフィールドが個別に継承されます。"
#: ../../c-api/typeobj.rst:279
msgid ""
"Pointer to an additional structure that contains fields relevant only to "
"objects which implement the mapping protocol. These fields are documented "
"in :ref:`mapping-structs`."
msgstr ""
"マッピングプロトコルを実装した追加の構造体を指すポインタです。これらのフィー"
"ルドについては :ref:`mapping-structs` で説明されています。"
#: ../../c-api/typeobj.rst:283
msgid ""
"The :c:member:`~PyTypeObject.tp_as_mapping` field is not inherited, but the "
"contained fields are inherited individually."
msgstr ""
":c:member:`~PyTypeObject.tp_as_mapping` フィールドは継承されませんが、これに"
"含まれるフィールドが個別に継承されます。"
#: ../../c-api/typeobj.rst:291
msgid ""
"An optional pointer to a function that implements the built-in function :"
"func:`hash`."
msgstr ""
"オプションのポインタで、組み込み関数 :func:`hash` を実装している関数を指しま"
"す。"
#: ../../c-api/typeobj.rst:294
msgid ""
"The signature is the same as for :c:func:`PyObject_Hash`; it must return a "
"value of the type Py_hash_t. The value ``-1`` should not be returned as a "
"normal return value; when an error occurs during the computation of the hash "
"value, the function should set an exception and return ``-1``."
msgstr ""
"シグネチャは :c:func:`PyObject_Hash` と同じです。この関数は型 Py_hash_t の値"
"を返さなければなりません。通常時には ``-1`` を戻り値にしてはなりません; ハッ"
"シュ値の計算中にエラーが生じた場合、関数は例外をセットして ``-1`` を返さなけ"
"ればなりません。"
#: ../../c-api/typeobj.rst:299
msgid ""
"This field can be set explicitly to :c:func:`PyObject_HashNotImplemented` to "
"block inheritance of the hash method from a parent type. This is interpreted "
"as the equivalent of ``__hash__ = None`` at the Python level, causing "
"``isinstance(o, collections.Hashable)`` to correctly return ``False``. Note "
"that the converse is also true - setting ``__hash__ = None`` on a class at "
"the Python level will result in the ``tp_hash`` slot being set to :c:func:"
"`PyObject_HashNotImplemented`."
msgstr ""
"このフィールドは明示的に :c:func:`PyObject_HashNotImplemented` に設定すること"
"で、親 type からのハッシュメソッドの継承をブロックすることができます。これは "
"Python レベルでの ``__hash__ = None`` と同等に解釈され、 ``isinstance(o, "
"collections.Hashable)`` が正しく ``False`` を返すようになります。逆もまた可能"
"であることに注意してください - Python レベルで ``__hash__ = None`` を設定する"
"ことで ``tp_hash`` スロットは :c:func:`PyObject_HashNotImplemented` に設定さ"
"れます。"
#: ../../c-api/typeobj.rst:307
msgid ""
"When this field is not set, an attempt to take the hash of the object "
"raises :exc:`TypeError`."
msgstr ""
"このフィールドがセットされていないときに、オブジェクトのハッシュ値を取ろうと"
"すると :exc:`TypeError` が送出されます。"
#: ../../c-api/typeobj.rst:310
msgid ""
"This field is inherited by subtypes together with :c:member:`~PyTypeObject."
"tp_richcompare`: a subtype inherits both of :c:member:`~PyTypeObject."
"tp_richcompare` and :c:member:`~PyTypeObject.tp_hash`, when the subtype's :c:"
"member:`~PyTypeObject.tp_richcompare` and :c:member:`~PyTypeObject.tp_hash` "
"are both ``NULL``."
msgstr ""
"このフィールドは :c:member:`~PyTypeObject.tp_richcompare` と共にサブタイプに"
"継承されます: すなわち、サブタイプの :c:member:`~PyTypeObject."
"tp_richcompare` および :c:member:`~PyTypeObject.tp_hash` が両方とも ``NULL`` "
"のとき、サブタイプは基底タイプから :c:member:`~PyTypeObject.tp_richcompare` "
"と :c:member:`~PyTypeObject.tp_hash` を両方とも継承します。"
#: ../../c-api/typeobj.rst:318
msgid ""
"An optional pointer to a function that implements calling the object. This "
"should be ``NULL`` if the object is not callable. The signature is the same "
"as for :c:func:`PyObject_Call`."
msgstr ""
#: ../../c-api/typeobj.rst:327
msgid ""
"An optional pointer to a function that implements the built-in operation :"
"func:`str`. (Note that :class:`str` is a type now, and :func:`str` calls "
"the constructor for that type. This constructor calls :c:func:"
"`PyObject_Str` to do the actual work, and :c:func:`PyObject_Str` will call "
"this handler.)"
msgstr ""
"オプションのポインタで、組み込みの演算 :func:`str` を実装している関数を指しま"
"す。(:class:`str` が型の一つになったため、 :func:`str` は :class:`str` のコン"
"ストラクタを呼び出すことに注意してください。このコンストラクタは実際の処理を"
"行う上で :c:func:`PyObject_Str` を呼び出し、さらに :c:func:`PyObject_Str` が"
"このハンドラを呼び出すことになります。)"
#: ../../c-api/typeobj.rst:332
msgid ""
"The signature is the same as for :c:func:`PyObject_Str`; it must return a "
"string or a Unicode object. This function should return a \"friendly\" "
"string representation of the object, as this is the representation that will "
"be used, among other things, by the :func:`print` function."
msgstr ""
"シグネチャは :c:func:`PyObject_Str` と同じです; この関数は文字列オブジェクト"
"か Unicode オブジェクトを返さなければなりません。また、この関数はオブジェクト"
"を \"分かりやすく (friendly)\" 表現した文字列を返さなければなりません。という"
"のは、この文字列はとりわけ :func:`print` 関数で使われることになる表記だからで"
"す。"
#: ../../c-api/typeobj.rst:337
msgid ""
"When this field is not set, :c:func:`PyObject_Repr` is called to return a "
"string representation."
msgstr ""
"このフィールドが設定されていない場合、文字列表現を返すためには :c:func:"
"`PyObject_Repr` が呼び出されます。"
#: ../../c-api/typeobj.rst:345
msgid "An optional pointer to the get-attribute function."
msgstr "オプションのポインタで、get-attribute を実装している関数を指します。"
#: ../../c-api/typeobj.rst:347
msgid ""
"The signature is the same as for :c:func:`PyObject_GetAttr`. It is usually "
"convenient to set this field to :c:func:`PyObject_GenericGetAttr`, which "
"implements the normal way of looking for object attributes."
msgstr ""
"シグネチャは :c:func:`PyObject_GetAttr` と同じです。\n"
"通常の属性検索を実装している :c:func:`PyObject_GenericGetAttr` をこのフィー"
"ルドに設定しておくとたいていの場合は便利です。"
#: ../../c-api/typeobj.rst:351
msgid ""
"This field is inherited by subtypes together with :c:member:`~PyTypeObject."
"tp_getattr`: a subtype inherits both :c:member:`~PyTypeObject.tp_getattr` "
"and :c:member:`~PyTypeObject.tp_getattro` from its base type when the "
"subtype's :c:member:`~PyTypeObject.tp_getattr` and :c:member:`~PyTypeObject."
"tp_getattro` are both ``NULL``."
msgstr ""
"このフィールドは :c:member:`~PyTypeObject.tp_getattr` と共にサブタイプに継承"
"されます: すなわち、サブタイプの :c:member:`~PyTypeObject.tp_getattr` およ"
"び :c:member:`~PyTypeObject.tp_getattro` が共に ``NULL`` の場合、サブタイプは"
"基底タイプから :c:member:`~PyTypeObject.tp_getattr` と :c:member:"
"`~PyTypeObject.tp_getattro` を両方とも継承します。"
#: ../../c-api/typeobj.rst:360
msgid ""
"The signature is the same as for :c:func:`PyObject_SetAttr`, but setting *v* "
"to ``NULL`` to delete an attribute must be supported. It is usually "
"convenient to set this field to :c:func:`PyObject_GenericSetAttr`, which "
"implements the normal way of setting object attributes."
msgstr ""
#: ../../c-api/typeobj.rst:365
msgid ""
"This field is inherited by subtypes together with :c:member:`~PyTypeObject."
"tp_setattr`: a subtype inherits both :c:member:`~PyTypeObject.tp_setattr` "
"and :c:member:`~PyTypeObject.tp_setattro` from its base type when the "
"subtype's :c:member:`~PyTypeObject.tp_setattr` and :c:member:`~PyTypeObject."
"tp_setattro` are both ``NULL``."
msgstr ""
"このフィールドは :c:member:`~PyTypeObject.tp_setattr` と共にサブタイプに継承"
"されます: すなわち、サブタイプの :c:member:`~PyTypeObject.tp_setattr` およ"
"び :c:member:`~PyTypeObject.tp_setattro` が共に ``NULL`` の場合、サブタイプは"
"基底タイプから :c:member:`~PyTypeObject.tp_setattr` と :c:member:"
"`~PyTypeObject.tp_setattro` を両方とも継承します。"
#: ../../c-api/typeobj.rst:372
msgid ""
"Pointer to an additional structure that contains fields relevant only to "
"objects which implement the buffer interface. These fields are documented "
"in :ref:`buffer-structs`."
msgstr ""
"バッファインタフェースを実装しているオブジェクトにのみ関連する、一連のフィー"
"ルド群が入った別の構造体を指すポインタです。構造体内の各フィールドは :ref:"
"`buffer-structs` で説明します。"
#: ../../c-api/typeobj.rst:376
msgid ""
"The :c:member:`~PyTypeObject.tp_as_buffer` field is not inherited, but the "
"contained fields are inherited individually."
msgstr ""
":c:member:`~PyTypeObject.tp_as_buffer` フィールド自体は継承されませんが、これ"
"に含まれるフィールドは個別に継承されます。"
#: ../../c-api/typeobj.rst:382
msgid ""
"This field is a bit mask of various flags. Some flags indicate variant "
"semantics for certain situations; others are used to indicate that certain "
"fields in the type object (or in the extension structures referenced via :c:"
"member:`~PyTypeObject.tp_as_number`, :c:member:`~PyTypeObject."
"tp_as_sequence`, :c:member:`~PyTypeObject.tp_as_mapping`, and :c:member:"
"`~PyTypeObject.tp_as_buffer`) that were historically not always present are "
"valid; if such a flag bit is clear, the type fields it guards must not be "
"accessed and must be considered to have a zero or ``NULL`` value instead."
msgstr ""
"このフィールドは様々なフラグからなるビットマスクです。いくつかのフラグは、特"
"定の状況において変則的なセマンティクスが適用されることを示します; その他のフ"
"ラグは、型オブジェクト (あるいは :c:member:`~PyTypeObject.tp_as_number` 、 :"
"c:member:`~PyTypeObject.tp_as_sequence` 、 :c:member:`~PyTypeObject."
"tp_as_mapping` 、 および :c:member:`~PyTypeObject.tp_as_buffer` が参照してい"
"る拡張機能構造体) の特定のフィールドのうち、過去から現在までずっと存在してい"
"たわけではないものが有効になっていることを示すために使われます; フラグビット"
"がクリアされていれば、フラグが保護しているフィールドにはアクセスしない代わり"
"に、その値はゼロか ``NULL`` になっているとみなさなければなりません。"
#: ../../c-api/typeobj.rst:390
msgid ""
"Inheritance of this field is complicated. Most flag bits are inherited "
"individually, i.e. if the base type has a flag bit set, the subtype inherits "
"this flag bit. The flag bits that pertain to extension structures are "
"strictly inherited if the extension structure is inherited, i.e. the base "
"type's value of the flag bit is copied into the subtype together with a "
"pointer to the extension structure. The :const:`Py_TPFLAGS_HAVE_GC` flag "
"bit is inherited together with the :c:member:`~PyTypeObject.tp_traverse` "
"and :c:member:`~PyTypeObject.tp_clear` fields, i.e. if the :const:"
"`Py_TPFLAGS_HAVE_GC` flag bit is clear in the subtype and the :c:member:"
"`~PyTypeObject.tp_traverse` and :c:member:`~PyTypeObject.tp_clear` fields in "
"the subtype exist and have ``NULL`` values."
msgstr ""
"このフィールドの継承は込み入っています。ほとんどのフラグは個別に継承されま"
"す。すなわち、基底タイプのフラグビットが設定されていたら、サブタイプのフラグ"
"ビットもそれを引き継ぎます。拡張機能構造体が継承される場合は、拡張機能構造体"
"に関係するフラグビットは厳密に継承されます。すなわち、基底タイプのフラグビッ"
"トの値は、拡張機能構造体へのポインタと共に、サブタイプにコピーされます。 :"
"const:`Py_TPFLAGS_HAVE_GC` フラグビットは :c:member:`~PyTypeObject."
"tp_traverse` フィールドと :c:member:`~PyTypeObject.tp_clear` フィールドと共に"
"継承されます。すなわち、サブタイプにおいて、 :const:`Py_TPFLAGS_HAVE_GC` フラ"
"グビットがクリアされていて、 :c:member:`~PyTypeObject.tp_traverse` フィールド"
"と :c:member:`~PyTypeObject.tp_clear` フィールドが存在し ``NULL`` になってい"
"る場合に継承されます。"
#: ../../c-api/typeobj.rst:401
msgid ""
"The following bit masks are currently defined; these can be ORed together "
"using the ``|`` operator to form the value of the :c:member:`~PyTypeObject."
"tp_flags` field. The macro :c:func:`PyType_HasFeature` takes a type and a "
"flags value, *tp* and *f*, and checks whether ``tp->tp_flags & f`` is non-"
"zero."
msgstr ""
"以下に挙げるビットマスクは現在定義されているものです; フラグは ``|`` 演算子で"
"論理和を取って :c:member:`~PyTypeObject.tp_flags` フィールドの値を作成できま"
"す。 :c:func:`PyType_HasFeature` マクロは型とフラグ値、 *tp* および *f* をと"
"り、 ``tp->tp_flags & f`` が非ゼロかどうか調べます。"
#: ../../c-api/typeobj.rst:409
msgid ""
"This bit is set when the type object itself is allocated on the heap. In "
"this case, the :attr:`ob_type` field of its instances is considered a "
"reference to the type, and the type object is INCREF'ed when a new instance "
"is created, and DECREF'ed when an instance is destroyed (this does not apply "
"to instances of subtypes; only the type referenced by the instance's ob_type "
"gets INCREF'ed or DECREF'ed)."
msgstr ""
"型オブジェクト自体がヒープにメモリ確保される場合にセットされるビットです。型"
"オブジェクト自体がヒープにメモリ確保される場合、インスタンスの :attr:"
"`ob_type` フィールドは型オブジェクトへの参照とみなされます。この場合、新たな"
"インスタンスを生成する度に型オブジェクトを INCREF し、インスタンスを解放する"
"たびに DECREF します (サブタイプのインスタンスには適用されません; インスタン"
"スが :attr:`ob_type` で参照している型だけが INCREF および DECREF されます)。"
#: ../../c-api/typeobj.rst:419
msgid ""
"This bit is set when the type can be used as the base type of another type. "
"If this bit is clear, the type cannot be subtyped (similar to a \"final\" "
"class in Java)."
msgstr ""
"型を別の型の基底タイプとして使える場合にセットされるビットです。このビットが"
"クリアならば、この型のサブタイプは生成できません (Java における \"final\" ク"
"ラスに似たクラスになります)。"
#: ../../c-api/typeobj.rst:426
msgid ""
"This bit is set when the type object has been fully initialized by :c:func:"
"`PyType_Ready`."
msgstr ""
"型オブジェクトが :c:func:`PyType_Ready` で完全に初期化されるとセットされる"
"ビットです。"
#: ../../c-api/typeobj.rst:432
msgid ""
"This bit is set while :c:func:`PyType_Ready` is in the process of "
"initializing the type object."
msgstr ""
":c:func:`PyType_Ready` による型オブジェクトの初期化処理中にセットされるビット"
"です。"
#: ../../c-api/typeobj.rst:438
msgid ""
"This bit is set when the object supports garbage collection. If this bit is "
"set, instances must be created using :c:func:`PyObject_GC_New` and destroyed "
"using :c:func:`PyObject_GC_Del`. More information in section :ref:"
"`supporting-cycle-detection`. This bit also implies that the GC-related "
"fields :c:member:`~PyTypeObject.tp_traverse` and :c:member:`~PyTypeObject."
"tp_clear` are present in the type object."
msgstr ""
"オブジェクトがガベージコレクション (GC) をサポートする場合にセットされるビッ"
"トです。このビットがセットされている場合、インスタンスは :c:func:"
"`PyObject_GC_New` を使って生成し、 :c:func:`PyObject_GC_Del` を使って破棄しな"
"ければなりません。詳しい情報は :ref:`supporting-cycle-detection` にあります。"
"このビットは、GC に関連するフィールド :c:member:`~PyTypeObject.tp_traverse` "
"および :c:member:`~PyTypeObject.tp_clear` が型オブジェクト内に存在することも"
"示しています。"
#: ../../c-api/typeobj.rst:448
msgid ""
"This is a bitmask of all the bits that pertain to the existence of certain "
"fields in the type object and its extension structures. Currently, it "
"includes the following bits: :const:`Py_TPFLAGS_HAVE_STACKLESS_EXTENSION`, :"
"const:`Py_TPFLAGS_HAVE_VERSION_TAG`."
msgstr ""
"型オブジェクトおよび拡張機能構造体の特定のフィールドの存在の有無に関連する全"
"てのビットからなるビットマスクです。現状では、このビットマスクには以下のビッ"
"ト: :const:`Py_TPFLAGS_HAVE_STACKLESS_EXTENSION` および :const:"
"`Py_TPFLAGS_HAVE_VERSION_TAG` が入っています。"
#: ../../c-api/typeobj.rst:463
msgid ""
"These flags are used by functions such as :c:func:`PyLong_Check` to quickly "
"determine if a type is a subclass of a built-in type; such specific checks "
"are faster than a generic check, like :c:func:`PyObject_IsInstance`. Custom "
"types that inherit from built-ins should have their :c:member:`~PyTypeObject."
"tp_flags` set appropriately, or the code that interacts with such types will "
"behave differently depending on what kind of check is used."
msgstr ""
"これらのフラグは :c:func:`PyLong_Check` のような関数が、型がとある組み込み型"
"のサブクラスかどうかを素早く判断するのに使われます;\n"
"この専用のチェックは :c:func:`PyObject_IsInstance` のような汎用的なチェックよ"
"りも高速です。\n"
"組み込み型を継承した独自の型では :c:member:`~PyTypeObject.tp_flags` を適切に"
"設定すべきで、そうしないとその型が関わるコードでは、どんなチェックの方法が使"
"われるかによって振る舞いが異なってしまうでしょう。"
#: ../../c-api/typeobj.rst:474
msgid ""
"This bit is set when the :c:member:`~PyTypeObject.tp_finalize` slot is "
"present in the type structure."
msgstr ""
"型構造体に :c:member:`~PyTypeObject.tp_finalize` スロットが存在しているときに"
"セットされるビットです。"
#: ../../c-api/typeobj.rst:482
msgid ""
"An optional pointer to a NUL-terminated C string giving the docstring for "
"this type object. This is exposed as the :attr:`__doc__` attribute on the "
"type and instances of the type."
msgstr ""
"オプションのポインタで、この型オブジェクトの docstring を与える NUL 終端され"
"た C の文字列を指します。この値は型オブジェクトと型のインスタンスにおける :"
"attr:`__doc__` 属性として公開されます。"
#: ../../c-api/typeobj.rst:486
msgid "This field is *not* inherited by subtypes."
msgstr "サブタイプはこのフィールドを継承 *しません* 。"
#: ../../c-api/typeobj.rst:491
msgid ""
"An optional pointer to a traversal function for the garbage collector. This "
"is only used if the :const:`Py_TPFLAGS_HAVE_GC` flag bit is set. More "
"information about Python's garbage collection scheme can be found in "
"section :ref:`supporting-cycle-detection`."
msgstr ""
"オプションのポインタで、ガベージコレクタのためのトラバーサル関数 (traversal "
"function) を指します。 :const:`Py_TPFLAGS_HAVE_GC` がセットされている場合にの"
"み使われます。Pythonのガベージコレクションの枠組みに関する詳細は :ref:"
"`supporting-cycle-detection` にあります。"
#: ../../c-api/typeobj.rst:496
msgid ""
"The :c:member:`~PyTypeObject.tp_traverse` pointer is used by the garbage "
"collector to detect reference cycles. A typical implementation of a :c:"
"member:`~PyTypeObject.tp_traverse` function simply calls :c:func:`Py_VISIT` "
"on each of the instance's members that are Python objects that the instance "
"owns. For example, this is function :c:func:`local_traverse` from the :mod:"
"`_thread` extension module::"
msgstr ""
#: ../../c-api/typeobj.rst:511
msgid ""
"Note that :c:func:`Py_VISIT` is called only on those members that can "
"participate in reference cycles. Although there is also a ``self->key`` "
"member, it can only be ``NULL`` or a Python string and therefore cannot be "
"part of a reference cycle."
msgstr ""
":c:func:`Py_VISIT` が循環参照になる恐れのあるメンバにだけ呼び出されていること"
"に注目してください。 ``self->key`` メンバもありますが、それは ``NULL`` か "
"Python文字列なので、循環参照の一部になることはありません。"
#: ../../c-api/typeobj.rst:515
msgid ""
"On the other hand, even if you know a member can never be part of a cycle, "
"as a debugging aid you may want to visit it anyway just so the :mod:`gc` "
"module's :func:`~gc.get_referents` function will include it."
msgstr ""
"一方、メンバが循環参照の一部になり得ないと判っていても、デバッグ目的で巡回し"
"たい場合があるかもしれないので、 :mod:`gc` モジュールの :func:`~gc."
"get_referents` 関数は循環参照になり得ないメンバも返します。"
#: ../../c-api/typeobj.rst:520
msgid ""
"When implementing :c:member:`~PyTypeObject.tp_traverse`, only the members "
"that the instance *owns* (by having strong references to them) must be "
"visited. For instance, if an object supports weak references via the :c:"
"member:`~PyTypeObject.tp_weaklist` slot, the pointer supporting the linked "
"list (what *tp_weaklist* points to) must **not** be visited as the instance "
"does not directly own the weak references to itself (the weakreference list "
"is there to support the weak reference machinery, but the instance has no "
"strong reference to the elements inside it, as they are allowed to be "
"removed even if the instance is still alive)."
msgstr ""
#: ../../c-api/typeobj.rst:531
msgid ""
"Note that :c:func:`Py_VISIT` requires the *visit* and *arg* parameters to :c:"
"func:`local_traverse` to have these specific names; don't name them just "
"anything."
msgstr ""
":c:func:`Py_VISIT` は :c:func:`local_traverse` が *visit* と *arg* という決"
"まった名前の引数を持つことを要求します。"
#: ../../c-api/typeobj.rst:535
msgid ""
"This field is inherited by subtypes together with :c:member:`~PyTypeObject."
"tp_clear` and the :const:`Py_TPFLAGS_HAVE_GC` flag bit: the flag bit, :c:"
"member:`~PyTypeObject.tp_traverse`, and :c:member:`~PyTypeObject.tp_clear` "
"are all inherited from the base type if they are all zero in the subtype."
msgstr ""
"このフィールドは :c:member:`~PyTypeObject.tp_clear` および :const:"
"`Py_TPFLAGS_HAVE_GC` フラグビットと共にサブタイプに継承されます: すなわち、サ"
"ブタイプの :c:member:`~PyTypeObject.tp_traverse` および :c:member:"
"`~PyTypeObject.tp_clear` が両方ともゼロの場合、サブタイプは基底タイプから :c:"
"member:`~PyTypeObject.tp_traverse` と :c:member:`~PyTypeObject.tp_clear` を両"
"方とも継承します。"
#: ../../c-api/typeobj.rst:543
msgid ""
"An optional pointer to a clear function for the garbage collector. This is "
"only used if the :const:`Py_TPFLAGS_HAVE_GC` flag bit is set."
msgstr ""
"オプションのポインタで、ガベージコレクタにおける消去関数 (clear function) を"
"指します。 :const:`Py_TPFLAGS_HAVE_GC` がセットされている場合にのみ使われま"
"す。"
#: ../../c-api/typeobj.rst:546
msgid ""
"The :c:member:`~PyTypeObject.tp_clear` member function is used to break "
"reference cycles in cyclic garbage detected by the garbage collector. Taken "
"together, all :c:member:`~PyTypeObject.tp_clear` functions in the system "
"must combine to break all reference cycles. This is subtle, and if in any "
"doubt supply a :c:member:`~PyTypeObject.tp_clear` function. For example, "
"the tuple type does not implement a :c:member:`~PyTypeObject.tp_clear` "
"function, because it's possible to prove that no reference cycle can be "
"composed entirely of tuples. Therefore the :c:member:`~PyTypeObject."
"tp_clear` functions of other types must be sufficient to break any cycle "
"containing a tuple. This isn't immediately obvious, and there's rarely a "
"good reason to avoid implementing :c:member:`~PyTypeObject.tp_clear`."
msgstr ""
":c:member:`~PyTypeObject.tp_clear` メンバ関数は GC が検出した循環しているゴミ"
"の循環参照を壊すために用いられます。総合的な視点で考えると、システム内の全て"