# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-08-24 09:01+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: c-api/typeobj.rst:6
msgid "Type Objects"
msgstr "Objets type"

#: 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-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 ""

#: c-api/typeobj.rst:23
msgid ""
"In addition to the following quick reference, the :ref:`typedef-examples` "
"section provides at-a-glance insight into the meaning and use of :c:type:"
"`PyTypeObject`."
msgstr ""

#: c-api/typeobj.rst:29
msgid "Quick Reference"
msgstr ""

#: c-api/typeobj.rst:34
msgid "\"tp slots\""
msgstr ""

#: c-api/typeobj.rst:40
msgid "PyTypeObject Slot [#slots]_"
msgstr ""

#: c-api/typeobj.rst:40 c-api/typeobj.rst:193
msgid ":ref:`Type <slot-typedefs-table>`"
msgstr ""

#: c-api/typeobj.rst:40
msgid "special methods/attrs"
msgstr ""

#: c-api/typeobj.rst:40
msgid "Info [#cols]_"
msgstr ""

#: c-api/typeobj.rst:42
msgid "O"
msgstr "O"

#: c-api/typeobj.rst:42
msgid "T"
msgstr "T"

#: c-api/typeobj.rst:42
msgid "D"
msgstr "D"

#: c-api/typeobj.rst:42
msgid "I"
msgstr ""

#: c-api/typeobj.rst:44
msgid "<R> :c:member:`~PyTypeObject.tp_name`"
msgstr ""

#: c-api/typeobj.rst:44 c-api/typeobj.rst:86 c-api/typeobj.rst:0
msgid "const char *"
msgstr ""

#: c-api/typeobj.rst:44
msgid "__name__"
msgstr "__name__"

#: c-api/typeobj.rst:44 c-api/typeobj.rst:46 c-api/typeobj.rst:48
#: c-api/typeobj.rst:50 c-api/typeobj.rst:52 c-api/typeobj.rst:62
#: c-api/typeobj.rst:70 c-api/typeobj.rst:72 c-api/typeobj.rst:74
#: c-api/typeobj.rst:76 c-api/typeobj.rst:79 c-api/typeobj.rst:84
#: c-api/typeobj.rst:86 c-api/typeobj.rst:88 c-api/typeobj.rst:90
#: c-api/typeobj.rst:92 c-api/typeobj.rst:99 c-api/typeobj.rst:101
#: c-api/typeobj.rst:103 c-api/typeobj.rst:105 c-api/typeobj.rst:107
#: c-api/typeobj.rst:109 c-api/typeobj.rst:111 c-api/typeobj.rst:115
#: c-api/typeobj.rst:117 c-api/typeobj.rst:120 c-api/typeobj.rst:122
#: c-api/typeobj.rst:124 c-api/typeobj.rst:126 c-api/typeobj.rst:128
#: c-api/typeobj.rst:130 c-api/typeobj.rst:146
msgid "X"
msgstr ""

#: c-api/typeobj.rst:46
msgid ":c:member:`~PyTypeObject.tp_basicsize`"
msgstr ""

#: c-api/typeobj.rst:46 c-api/typeobj.rst:48 c-api/typeobj.rst:52
#: c-api/typeobj.rst:99 c-api/typeobj.rst:120 c-api/typeobj.rst:0
#: c-api/typeobj.rst:406
msgid "Py_ssize_t"
msgstr ""

#: c-api/typeobj.rst:48
msgid ":c:member:`~PyTypeObject.tp_itemsize`"
msgstr ""

#: c-api/typeobj.rst:50
msgid ":c:member:`~PyTypeObject.tp_dealloc`"
msgstr ""

#: c-api/typeobj.rst:50 c-api/typeobj.rst:142 c-api/typeobj.rst:146
#: c-api/typeobj.rst:336
msgid ":c:type:`destructor`"
msgstr ""

#: c-api/typeobj.rst:52
msgid ":c:member:`~PyTypeObject.tp_vectorcall_offset`"
msgstr ""

#: c-api/typeobj.rst:54
msgid "(:c:member:`~PyTypeObject.tp_getattr`)"
msgstr ""

#: c-api/typeobj.rst:54 c-api/typeobj.rst:360
msgid ":c:type:`getattrfunc`"
msgstr ""

#: c-api/typeobj.rst:54 c-api/typeobj.rst:76
msgid "__getattribute__, __getattr__"
msgstr ""

#: c-api/typeobj.rst:54 c-api/typeobj.rst:57 c-api/typeobj.rst:70
#: c-api/typeobj.rst:76 c-api/typeobj.rst:79 c-api/typeobj.rst:88
#: c-api/typeobj.rst:90 c-api/typeobj.rst:92
msgid "G"
msgstr ""

#: c-api/typeobj.rst:57
msgid "(:c:member:`~PyTypeObject.tp_setattr`)"
msgstr ""

#: c-api/typeobj.rst:57 c-api/typeobj.rst:365
msgid ":c:type:`setattrfunc`"
msgstr ""

#: c-api/typeobj.rst:57 c-api/typeobj.rst:79
msgid "__setattr__, __delattr__"
msgstr ""

#: c-api/typeobj.rst:60
msgid ":c:member:`~PyTypeObject.tp_as_async`"
msgstr ""

#: c-api/typeobj.rst:60
msgid ":c:type:`PyAsyncMethods` *"
msgstr ""

#: c-api/typeobj.rst:60 c-api/typeobj.rst:64 c-api/typeobj.rst:66
#: c-api/typeobj.rst:68
msgid ":ref:`sub-slots`"
msgstr ""

#: c-api/typeobj.rst:60 c-api/typeobj.rst:64 c-api/typeobj.rst:66
#: c-api/typeobj.rst:68 c-api/typeobj.rst:82
msgid "%"
msgstr "%"

#: c-api/typeobj.rst:62
msgid ":c:member:`~PyTypeObject.tp_repr`"
msgstr ""

#: c-api/typeobj.rst:62 c-api/typeobj.rst:74 c-api/typeobj.rst:358
msgid ":c:type:`reprfunc`"
msgstr ""

#: c-api/typeobj.rst:62
msgid "__repr__"
msgstr ""

#: c-api/typeobj.rst:64
msgid ":c:member:`~PyTypeObject.tp_as_number`"
msgstr ""

#: c-api/typeobj.rst:64
msgid ":c:type:`PyNumberMethods` *"
msgstr ""

#: c-api/typeobj.rst:66
msgid ":c:member:`~PyTypeObject.tp_as_sequence`"
msgstr ""

#: c-api/typeobj.rst:66
msgid ":c:type:`PySequenceMethods` *"
msgstr ""

#: c-api/typeobj.rst:68
msgid ":c:member:`~PyTypeObject.tp_as_mapping`"
msgstr ""

#: c-api/typeobj.rst:68
msgid ":c:type:`PyMappingMethods` *"
msgstr ""

#: c-api/typeobj.rst:70
msgid ":c:member:`~PyTypeObject.tp_hash`"
msgstr ""

#: c-api/typeobj.rst:70 c-api/typeobj.rst:394
msgid ":c:type:`hashfunc`"
msgstr ""

#: c-api/typeobj.rst:70
msgid "__hash__"
msgstr ""

#: c-api/typeobj.rst:72
msgid ":c:member:`~PyTypeObject.tp_call`"
msgstr ""

#: c-api/typeobj.rst:72 c-api/typeobj.rst:227 c-api/typeobj.rst:230
#: c-api/typeobj.rst:430
msgid ":c:type:`ternaryfunc`"
msgstr ""

#: c-api/typeobj.rst:72
msgid "__call__"
msgstr ""

#: c-api/typeobj.rst:74
msgid ":c:member:`~PyTypeObject.tp_str`"
msgstr ""

#: c-api/typeobj.rst:74
msgid "__str__"
msgstr ""

#: c-api/typeobj.rst:76
msgid ":c:member:`~PyTypeObject.tp_getattro`"
msgstr ""

#: c-api/typeobj.rst:76 c-api/typeobj.rst:371
msgid ":c:type:`getattrofunc`"
msgstr ""

#: c-api/typeobj.rst:79
msgid ":c:member:`~PyTypeObject.tp_setattro`"
msgstr ""

#: c-api/typeobj.rst:79 c-api/typeobj.rst:376
msgid ":c:type:`setattrofunc`"
msgstr ""

#: c-api/typeobj.rst:82
msgid ":c:member:`~PyTypeObject.tp_as_buffer`"
msgstr ""

#: c-api/typeobj.rst:82
msgid ":c:type:`PyBufferProcs` *"
msgstr ""

#: c-api/typeobj.rst:84
msgid ":c:member:`~PyTypeObject.tp_flags`"
msgstr ""

#: c-api/typeobj.rst:84
msgid "unsigned long"
msgstr "``unsigned long``"

#: c-api/typeobj.rst:84 c-api/typeobj.rst:99 c-api/typeobj.rst:113
#: c-api/typeobj.rst:120 c-api/typeobj.rst:124 c-api/typeobj.rst:126
#: c-api/typeobj.rst:128
msgid "?"
msgstr ""

#: c-api/typeobj.rst:86
msgid ":c:member:`~PyTypeObject.tp_doc`"
msgstr ""

#: c-api/typeobj.rst:86
msgid "__doc__"
msgstr "__doc__"

#: c-api/typeobj.rst:88
msgid ":c:member:`~PyTypeObject.tp_traverse`"
msgstr ""

#: c-api/typeobj.rst:88 c-api/typeobj.rst:340
msgid ":c:type:`traverseproc`"
msgstr ""

#: c-api/typeobj.rst:90
msgid ":c:member:`~PyTypeObject.tp_clear`"
msgstr ""

#: c-api/typeobj.rst:90 c-api/typeobj.rst:130 c-api/typeobj.rst:238
#: c-api/typeobj.rst:419
msgid ":c:type:`inquiry`"
msgstr ""

#: c-api/typeobj.rst:92
msgid ":c:member:`~PyTypeObject.tp_richcompare`"
msgstr ""

#: c-api/typeobj.rst:92 c-api/typeobj.rst:396
msgid ":c:type:`richcmpfunc`"
msgstr ""

#: c-api/typeobj.rst:92
msgid "__lt__, __le__, __eq__, __ne__, __gt__, __ge__"
msgstr ""

#: c-api/typeobj.rst:99
msgid ":c:member:`~PyTypeObject.tp_weaklistoffset`"
msgstr ""

#: c-api/typeobj.rst:101
msgid ":c:member:`~PyTypeObject.tp_iter`"
msgstr ""

#: c-api/typeobj.rst:101 c-api/typeobj.rst:402
msgid ":c:type:`getiterfunc`"
msgstr ""

#: c-api/typeobj.rst:101
msgid "__iter__"
msgstr ""

#: c-api/typeobj.rst:103
msgid ":c:member:`~PyTypeObject.tp_iternext`"
msgstr ""

#: c-api/typeobj.rst:103 c-api/typeobj.rst:404
msgid ":c:type:`iternextfunc`"
msgstr ""

#: c-api/typeobj.rst:103
msgid "__next__"
msgstr ""

#: c-api/typeobj.rst:105
msgid ":c:member:`~PyTypeObject.tp_methods`"
msgstr ""

#: c-api/typeobj.rst:105
msgid ":c:type:`PyMethodDef` []"
msgstr ""

#: c-api/typeobj.rst:107
msgid ":c:member:`~PyTypeObject.tp_members`"
msgstr ""

#: c-api/typeobj.rst:107
msgid ":c:type:`PyMemberDef` []"
msgstr ""

#: c-api/typeobj.rst:109
msgid ":c:member:`~PyTypeObject.tp_getset`"
msgstr ""

#: c-api/typeobj.rst:109
msgid ":c:type:`PyGetSetDef` []"
msgstr ""

#: c-api/typeobj.rst:111
msgid ":c:member:`~PyTypeObject.tp_base`"
msgstr ""

#: c-api/typeobj.rst:111 c-api/typeobj.rst:0
msgid ":c:type:`PyTypeObject` *"
msgstr ""

#: c-api/typeobj.rst:111
msgid "__base__"
msgstr ""

#: c-api/typeobj.rst:113
msgid ":c:member:`~PyTypeObject.tp_dict`"
msgstr ""

#: c-api/typeobj.rst:113 c-api/typeobj.rst:132 c-api/typeobj.rst:134
#: c-api/typeobj.rst:136 c-api/typeobj.rst:138 c-api/typeobj.rst:140
#: c-api/typeobj.rst:331 c-api/typeobj.rst:0 c-api/typeobj.rst:346
#: c-api/typeobj.rst:358 c-api/typeobj.rst:360 c-api/typeobj.rst:371
#: c-api/typeobj.rst:382 c-api/typeobj.rst:394 c-api/typeobj.rst:396
#: c-api/typeobj.rst:402 c-api/typeobj.rst:404 c-api/typeobj.rst:406
#: c-api/typeobj.rst:421 c-api/typeobj.rst:425 c-api/typeobj.rst:430
#: c-api/typeobj.rst:436
msgid ":c:type:`PyObject` *"
msgstr ""

#: c-api/typeobj.rst:113
msgid "__dict__"
msgstr ""

#: c-api/typeobj.rst:115
msgid ":c:member:`~PyTypeObject.tp_descr_get`"
msgstr ""

#: c-api/typeobj.rst:115 c-api/typeobj.rst:382
msgid ":c:type:`descrgetfunc`"
msgstr ""

#: c-api/typeobj.rst:115
msgid "__get__"
msgstr ""

#: c-api/typeobj.rst:117
msgid ":c:member:`~PyTypeObject.tp_descr_set`"
msgstr ""

#: c-api/typeobj.rst:117 c-api/typeobj.rst:388
msgid ":c:type:`descrsetfunc`"
msgstr ""

#: c-api/typeobj.rst:117
msgid "__set__, __delete__"
msgstr ""

#: c-api/typeobj.rst:120
msgid ":c:member:`~PyTypeObject.tp_dictoffset`"
msgstr ""

#: c-api/typeobj.rst:122
msgid ":c:member:`~PyTypeObject.tp_init`"
msgstr ""

#: c-api/typeobj.rst:122 c-api/typeobj.rst:352
msgid ":c:type:`initproc`"
msgstr ""

#: c-api/typeobj.rst:122
msgid "__init__"
msgstr ""

#: c-api/typeobj.rst:124
msgid ":c:member:`~PyTypeObject.tp_alloc`"
msgstr ""

#: c-api/typeobj.rst:124 c-api/typeobj.rst:331
msgid ":c:type:`allocfunc`"
msgstr ""

#: c-api/typeobj.rst:126
msgid ":c:member:`~PyTypeObject.tp_new`"
msgstr ""

#: c-api/typeobj.rst:126 c-api/typeobj.rst:346
msgid ":c:type:`newfunc`"
msgstr ""

#: c-api/typeobj.rst:126
msgid "__new__"
msgstr ""

#: c-api/typeobj.rst:128
msgid ":c:member:`~PyTypeObject.tp_free`"
msgstr ""

#: c-api/typeobj.rst:128 c-api/typeobj.rst:338
msgid ":c:type:`freefunc`"
msgstr ""

#: c-api/typeobj.rst:130
msgid ":c:member:`~PyTypeObject.tp_is_gc`"
msgstr ""

#: c-api/typeobj.rst:132
msgid "<:c:member:`~PyTypeObject.tp_bases`>"
msgstr ""

#: c-api/typeobj.rst:132
msgid "__bases__"
msgstr ""

#: c-api/typeobj.rst:132 c-api/typeobj.rst:134
msgid "~"
msgstr ""

#: c-api/typeobj.rst:134
msgid "<:c:member:`~PyTypeObject.tp_mro`>"
msgstr ""

#: c-api/typeobj.rst:134
msgid "__mro__"
msgstr ""

#: c-api/typeobj.rst:136
msgid "[:c:member:`~PyTypeObject.tp_cache`]"
msgstr ""

#: c-api/typeobj.rst:138
msgid "[:c:member:`~PyTypeObject.tp_subclasses`]"
msgstr ""

#: c-api/typeobj.rst:138
msgid "__subclasses__"
msgstr ""

#: c-api/typeobj.rst:140
msgid "[:c:member:`~PyTypeObject.tp_weaklist`]"
msgstr ""

#: c-api/typeobj.rst:142
msgid "(:c:member:`~PyTypeObject.tp_del`)"
msgstr ""

#: c-api/typeobj.rst:144
msgid "[:c:member:`~PyTypeObject.tp_version_tag`]"
msgstr ""

#: c-api/typeobj.rst:144
msgid "unsigned int"
msgstr "``unsigned int``"

#: c-api/typeobj.rst:146
msgid ":c:member:`~PyTypeObject.tp_finalize`"
msgstr ""

#: c-api/typeobj.rst:146
msgid "__del__"
msgstr ""

#: c-api/typeobj.rst:148
msgid ":c:member:`~PyTypeObject.tp_vectorcall`"
msgstr ""

#: c-api/typeobj.rst:148
msgid ":c:type:`vectorcallfunc`"
msgstr ""

#: c-api/typeobj.rst:152
msgid ""
"A slot name in parentheses indicates it is (effectively) deprecated. Names "
"in angle brackets should be treated as read-only. Names in square brackets "
"are for internal use only. \"<R>\" (as a prefix) means the field is required "
"(must be non-``NULL``)."
msgstr ""

#: c-api/typeobj.rst:156
msgid "Columns:"
msgstr ""

#: c-api/typeobj.rst:158
msgid "**\"O\"**:  set on :c:type:`PyBaseObject_Type`"
msgstr ""

#: c-api/typeobj.rst:160
msgid "**\"T\"**:  set on :c:type:`PyType_Type`"
msgstr ""

#: c-api/typeobj.rst:162
msgid "**\"D\"**:  default (if slot is set to ``NULL``)"
msgstr ""

#: c-api/typeobj.rst:172
msgid "**\"I\"**:  inheritance"
msgstr ""

#: c-api/typeobj.rst:181
msgid ""
"Note that some slots are effectively inherited through the normal attribute "
"lookup chain."
msgstr ""

#: c-api/typeobj.rst:187
msgid "sub-slots"
msgstr ""

#: c-api/typeobj.rst:193
msgid "Slot"
msgstr ""

#: c-api/typeobj.rst:193
#, fuzzy
msgid "special methods"
msgstr "méthode spéciale"

#: c-api/typeobj.rst:196
msgid ":c:member:`~PyAsyncMethods.am_await`"
msgstr ""

#: c-api/typeobj.rst:196 c-api/typeobj.rst:198 c-api/typeobj.rst:200
#: c-api/typeobj.rst:232 c-api/typeobj.rst:234 c-api/typeobj.rst:236
#: c-api/typeobj.rst:240 c-api/typeobj.rst:267 c-api/typeobj.rst:271
#: c-api/typeobj.rst:281 c-api/typeobj.rst:421
msgid ":c:type:`unaryfunc`"
msgstr ""

#: c-api/typeobj.rst:196
msgid "__await__"
msgstr ""

#: c-api/typeobj.rst:198
msgid ":c:member:`~PyAsyncMethods.am_aiter`"
msgstr ""

#: c-api/typeobj.rst:198
msgid "__aiter__"
msgstr ""

#: c-api/typeobj.rst:200
msgid ":c:member:`~PyAsyncMethods.am_anext`"
msgstr ""

#: c-api/typeobj.rst:200
msgid "__anext__"
msgstr ""

#: c-api/typeobj.rst:204
msgid ":c:member:`~PyNumberMethods.nb_add`"
msgstr ""

#: c-api/typeobj.rst:204 c-api/typeobj.rst:207 c-api/typeobj.rst:209
#: c-api/typeobj.rst:212 c-api/typeobj.rst:214 c-api/typeobj.rst:217
#: c-api/typeobj.rst:219 c-api/typeobj.rst:222 c-api/typeobj.rst:224
#: c-api/typeobj.rst:242 c-api/typeobj.rst:245 c-api/typeobj.rst:247
#: c-api/typeobj.rst:250 c-api/typeobj.rst:252 c-api/typeobj.rst:255
#: c-api/typeobj.rst:257 c-api/typeobj.rst:260 c-api/typeobj.rst:262
#: c-api/typeobj.rst:265 c-api/typeobj.rst:273 c-api/typeobj.rst:275
#: c-api/typeobj.rst:277 c-api/typeobj.rst:279 c-api/typeobj.rst:283
#: c-api/typeobj.rst:286 c-api/typeobj.rst:292 c-api/typeobj.rst:301
#: c-api/typeobj.rst:312 c-api/typeobj.rst:425
msgid ":c:type:`binaryfunc`"
msgstr ""

#: c-api/typeobj.rst:204
msgid "__add__ __radd__"
msgstr ""

#: c-api/typeobj.rst:207
msgid ":c:member:`~PyNumberMethods.nb_inplace_add`"
msgstr ""

#: c-api/typeobj.rst:207 c-api/typeobj.rst:312
msgid "__iadd__"
msgstr ""

#: c-api/typeobj.rst:209
msgid ":c:member:`~PyNumberMethods.nb_subtract`"
msgstr ""

#: c-api/typeobj.rst:209
msgid "__sub__ __rsub__"
msgstr ""

#: c-api/typeobj.rst:212
msgid ":c:member:`~PyNumberMethods.nb_inplace_subtract`"
msgstr ""

#: c-api/typeobj.rst:212
msgid "__sub__"
msgstr ""

#: c-api/typeobj.rst:214
msgid ":c:member:`~PyNumberMethods.nb_multiply`"
msgstr ""

#: c-api/typeobj.rst:214
msgid "__mul__ __rmul__"
msgstr ""

#: c-api/typeobj.rst:217
msgid ":c:member:`~PyNumberMethods.nb_inplace_multiply`"
msgstr ""

#: c-api/typeobj.rst:217 c-api/typeobj.rst:303
msgid "__mul__"
msgstr ""

#: c-api/typeobj.rst:219
msgid ":c:member:`~PyNumberMethods.nb_remainder`"
msgstr ""

#: c-api/typeobj.rst:219
msgid "__mod__ __rmod__"
msgstr ""

#: c-api/typeobj.rst:222
msgid ":c:member:`~PyNumberMethods.nb_inplace_remainder`"
msgstr ""

#: c-api/typeobj.rst:222
msgid "__mod__"
msgstr ""

#: c-api/typeobj.rst:224
msgid ":c:member:`~PyNumberMethods.nb_divmod`"
msgstr ""

#: c-api/typeobj.rst:224
msgid "__divmod__ __rdivmod__"
msgstr ""

#: c-api/typeobj.rst:227
msgid ":c:member:`~PyNumberMethods.nb_power`"
msgstr ""

#: c-api/typeobj.rst:227
msgid "__pow__ __rpow__"
msgstr ""

#: c-api/typeobj.rst:230
msgid ":c:member:`~PyNumberMethods.nb_inplace_power`"
msgstr ""

#: c-api/typeobj.rst:230
msgid "__pow__"
msgstr ""

#: c-api/typeobj.rst:232
msgid ":c:member:`~PyNumberMethods.nb_negative`"
msgstr ""

#: c-api/typeobj.rst:232
msgid "__neg__"
msgstr ""

#: c-api/typeobj.rst:234
msgid ":c:member:`~PyNumberMethods.nb_positive`"
msgstr ""

#: c-api/typeobj.rst:234
msgid "__pos__"
msgstr ""

#: c-api/typeobj.rst:236
msgid ":c:member:`~PyNumberMethods.nb_absolute`"
msgstr ""

#: c-api/typeobj.rst:236
msgid "__abs__"
msgstr ""

#: c-api/typeobj.rst:238
msgid ":c:member:`~PyNumberMethods.nb_bool`"
msgstr ""

#: c-api/typeobj.rst:238
msgid "__bool__"
msgstr ""

#: c-api/typeobj.rst:240
msgid ":c:member:`~PyNumberMethods.nb_invert`"
msgstr ""

#: c-api/typeobj.rst:240
msgid "__invert__"
msgstr ""

#: c-api/typeobj.rst:242
msgid ":c:member:`~PyNumberMethods.nb_lshift`"
msgstr ""

#: c-api/typeobj.rst:242
msgid "__lshift__ __rlshift__"
msgstr ""

#: c-api/typeobj.rst:245
msgid ":c:member:`~PyNumberMethods.nb_inplace_lshift`"
msgstr ""

#: c-api/typeobj.rst:245
msgid "__lshift__"
msgstr ""

#: c-api/typeobj.rst:247
msgid ":c:member:`~PyNumberMethods.nb_rshift`"
msgstr ""

#: c-api/typeobj.rst:247
msgid "__rshift__ __rrshift__"
msgstr ""

#: c-api/typeobj.rst:250
msgid ":c:member:`~PyNumberMethods.nb_inplace_rshift`"
msgstr ""

#: c-api/typeobj.rst:250
msgid "__rshift__"
msgstr ""

#: c-api/typeobj.rst:252
msgid ":c:member:`~PyNumberMethods.nb_and`"
msgstr ""

#: c-api/typeobj.rst:252
msgid "__and__ __rand__"
msgstr ""

#: c-api/typeobj.rst:255
msgid ":c:member:`~PyNumberMethods.nb_inplace_and`"
msgstr ""

#: c-api/typeobj.rst:255
msgid "__and__"
msgstr ""

#: c-api/typeobj.rst:257
msgid ":c:member:`~PyNumberMethods.nb_xor`"
msgstr ""

#: c-api/typeobj.rst:257
msgid "__xor__ __rxor__"
msgstr ""

#: c-api/typeobj.rst:260
msgid ":c:member:`~PyNumberMethods.nb_inplace_xor`"
msgstr ""

#: c-api/typeobj.rst:260
msgid "__xor__"
msgstr ""

#: c-api/typeobj.rst:262
msgid ":c:member:`~PyNumberMethods.nb_or`"
msgstr ""

#: c-api/typeobj.rst:262
msgid "__or__ __ror__"
msgstr ""

#: c-api/typeobj.rst:265
msgid ":c:member:`~PyNumberMethods.nb_inplace_or`"
msgstr ""

#: c-api/typeobj.rst:265
msgid "__or__"
msgstr ""

#: c-api/typeobj.rst:267
msgid ":c:member:`~PyNumberMethods.nb_int`"
msgstr ""

#: c-api/typeobj.rst:267
msgid "__int__"
msgstr ""

#: c-api/typeobj.rst:269
msgid ":c:member:`~PyNumberMethods.nb_reserved`"
msgstr ""

#: c-api/typeobj.rst:269 c-api/typeobj.rst:336 c-api/typeobj.rst:338
#: c-api/typeobj.rst:0 c-api/typeobj.rst:419
msgid "void *"
msgstr ""

#: c-api/typeobj.rst:271
msgid ":c:member:`~PyNumberMethods.nb_float`"
msgstr ""

#: c-api/typeobj.rst:271
msgid "__float__"
msgstr ""

#: c-api/typeobj.rst:273
msgid ":c:member:`~PyNumberMethods.nb_floor_divide`"
msgstr ""

#: c-api/typeobj.rst:273 c-api/typeobj.rst:275
msgid "__floordiv__"
msgstr ""

#: c-api/typeobj.rst:275
msgid ":c:member:`~PyNumberMethods.nb_inplace_floor_divide`"
msgstr ""

#: c-api/typeobj.rst:277
msgid ":c:member:`~PyNumberMethods.nb_true_divide`"
msgstr ""

#: c-api/typeobj.rst:277 c-api/typeobj.rst:279
msgid "__truediv__"
msgstr ""

#: c-api/typeobj.rst:279
msgid ":c:member:`~PyNumberMethods.nb_inplace_true_divide`"
msgstr ""

#: c-api/typeobj.rst:281
msgid ":c:member:`~PyNumberMethods.nb_index`"
msgstr ""

#: c-api/typeobj.rst:281
msgid "__index__"
msgstr ""

#: c-api/typeobj.rst:283
msgid ":c:member:`~PyNumberMethods.nb_matrix_multiply`"
msgstr ""

#: c-api/typeobj.rst:283
msgid "__matmul__ __rmatmul__"
msgstr ""

#: c-api/typeobj.rst:286
msgid ":c:member:`~PyNumberMethods.nb_inplace_matrix_multiply`"
msgstr ""

#: c-api/typeobj.rst:286
msgid "__matmul__"
msgstr ""

#: c-api/typeobj.rst:290
msgid ":c:member:`~PyMappingMethods.mp_length`"
msgstr ""

#: c-api/typeobj.rst:290 c-api/typeobj.rst:299 c-api/typeobj.rst:406
msgid ":c:type:`lenfunc`"
msgstr ""

#: c-api/typeobj.rst:290 c-api/typeobj.rst:299
msgid "__len__"
msgstr ""

#: c-api/typeobj.rst:292
msgid ":c:member:`~PyMappingMethods.mp_subscript`"
msgstr ""

#: c-api/typeobj.rst:292 c-api/typeobj.rst:305
msgid "__getitem__"
msgstr ""

#: c-api/typeobj.rst:294
msgid ":c:member:`~PyMappingMethods.mp_ass_subscript`"
msgstr ""

#: c-api/typeobj.rst:294 c-api/typeobj.rst:451
msgid ":c:type:`objobjargproc`"
msgstr ""

#: c-api/typeobj.rst:294
msgid "__setitem__, __delitem__"
msgstr ""

#: c-api/typeobj.rst:299
msgid ":c:member:`~PySequenceMethods.sq_length`"
msgstr ""

#: c-api/typeobj.rst:301
msgid ":c:member:`~PySequenceMethods.sq_concat`"
msgstr ""

#: c-api/typeobj.rst:301
msgid "__add__"
msgstr ""

#: c-api/typeobj.rst:303
msgid ":c:member:`~PySequenceMethods.sq_repeat`"
msgstr ""

#: c-api/typeobj.rst:303 c-api/typeobj.rst:305 c-api/typeobj.rst:314
#: c-api/typeobj.rst:436
msgid ":c:type:`ssizeargfunc`"
msgstr ""

#: c-api/typeobj.rst:305
msgid ":c:member:`~PySequenceMethods.sq_item`"
msgstr ""

#: c-api/typeobj.rst:307
msgid ":c:member:`~PySequenceMethods.sq_ass_item`"
msgstr ""

#: c-api/typeobj.rst:307 c-api/typeobj.rst:441
msgid ":c:type:`ssizeobjargproc`"
msgstr ""

#: c-api/typeobj.rst:307
msgid "__setitem__ __delitem__"
msgstr ""

#: c-api/typeobj.rst:310
msgid ":c:member:`~PySequenceMethods.sq_contains`"
msgstr ""

#: c-api/typeobj.rst:310 c-api/typeobj.rst:446
msgid ":c:type:`objobjproc`"
msgstr ""

#: c-api/typeobj.rst:310
msgid "__contains__"
msgstr ""

#: c-api/typeobj.rst:312
msgid ":c:member:`~PySequenceMethods.sq_inplace_concat`"
msgstr ""

#: c-api/typeobj.rst:314
msgid ":c:member:`~PySequenceMethods.sq_inplace_repeat`"
msgstr ""

#: c-api/typeobj.rst:314
msgid "__imul__"
msgstr ""

#: c-api/typeobj.rst:318
msgid ":c:member:`~PyBufferProcs.bf_getbuffer`"
msgstr ""

#: c-api/typeobj.rst:318
msgid ":c:func:`getbufferproc`"
msgstr ""

#: c-api/typeobj.rst:320
msgid ":c:member:`~PyBufferProcs.bf_releasebuffer`"
msgstr ""

#: c-api/typeobj.rst:320
msgid ":c:func:`releasebufferproc`"
msgstr ""

#: c-api/typeobj.rst:326
msgid "slot typedefs"
msgstr ""

#: c-api/typeobj.rst:329
msgid "typedef"
msgstr ""

#: c-api/typeobj.rst:329
msgid "Parameter Types"
msgstr ""

#: c-api/typeobj.rst:329
msgid "Return Type"
msgstr ""

#: c-api/typeobj.rst:336 c-api/typeobj.rst:338 c-api/typeobj.rst:414
msgid "void"
msgstr ""

#: c-api/typeobj.rst:0
msgid ":c:type:`visitproc`"
msgstr ""

#: c-api/typeobj.rst:340 c-api/typeobj.rst:352 c-api/typeobj.rst:365
#: c-api/typeobj.rst:376 c-api/typeobj.rst:388 c-api/typeobj.rst:0
#: c-api/typeobj.rst:408 c-api/typeobj.rst:419 c-api/typeobj.rst:441
#: c-api/typeobj.rst:446 c-api/typeobj.rst:451
msgid "int"
msgstr "*int*"

#: c-api/typeobj.rst:394
msgid "Py_hash_t"
msgstr ""

#: c-api/typeobj.rst:408
msgid ":c:type:`getbufferproc`"
msgstr ""

#: c-api/typeobj.rst:0
msgid ":c:type:`Py_buffer` *"
msgstr ""

#: c-api/typeobj.rst:414
msgid ":c:type:`releasebufferproc`"
msgstr ""

#: c-api/typeobj.rst:458
msgid "See :ref:`slot-typedefs` below for more detail."
msgstr ""

#: c-api/typeobj.rst:462
msgid "PyTypeObject Definition"
msgstr ""

#: c-api/typeobj.rst:464
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-api/typeobj.rst:474
#, fuzzy
msgid "PyObject Slots"
msgstr "Objets type"

#: c-api/typeobj.rst:476
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-api/typeobj.rst:486
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 ""

#: c-api/typeobj.rst:495 c-api/typeobj.rst:508 c-api/typeobj.rst:531
#: c-api/typeobj.rst:544 c-api/typeobj.rst:586 c-api/typeobj.rst:629
#: c-api/typeobj.rst:675 c-api/typeobj.rst:719 c-api/typeobj.rst:738
#: c-api/typeobj.rst:755 c-api/typeobj.rst:773 c-api/typeobj.rst:797
#: c-api/typeobj.rst:814 c-api/typeobj.rst:826 c-api/typeobj.rst:838
#: c-api/typeobj.rst:871 c-api/typeobj.rst:889 c-api/typeobj.rst:909
#: c-api/typeobj.rst:930 c-api/typeobj.rst:956 c-api/typeobj.rst:975
#: c-api/typeobj.rst:991 c-api/typeobj.rst:1028 c-api/typeobj.rst:1039
#: c-api/typeobj.rst:1049 c-api/typeobj.rst:1059 c-api/typeobj.rst:1073
#: c-api/typeobj.rst:1092 c-api/typeobj.rst:1115 c-api/typeobj.rst:1162
#: c-api/typeobj.rst:1177 c-api/typeobj.rst:1245 c-api/typeobj.rst:1306
#: c-api/typeobj.rst:1365 c-api/typeobj.rst:1395 c-api/typeobj.rst:1427
#: c-api/typeobj.rst:1450 c-api/typeobj.rst:1463 c-api/typeobj.rst:1478
#: c-api/typeobj.rst:1492 c-api/typeobj.rst:1522 c-api/typeobj.rst:1542
#: c-api/typeobj.rst:1568 c-api/typeobj.rst:1586 c-api/typeobj.rst:1626
#: c-api/typeobj.rst:1677 c-api/typeobj.rst:1694 c-api/typeobj.rst:1732
#: c-api/typeobj.rst:1753 c-api/typeobj.rst:1785 c-api/typeobj.rst:1802
#: c-api/typeobj.rst:1813 c-api/typeobj.rst:1823 c-api/typeobj.rst:1832
#: c-api/typeobj.rst:1842 c-api/typeobj.rst:1856 c-api/typeobj.rst:1894
#: c-api/typeobj.rst:1911
msgid "**Inheritance:**"
msgstr ""

#: c-api/typeobj.rst:497
msgid "These fields are not inherited by subtypes."
msgstr ""

#: c-api/typeobj.rst:502
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 ""

#: c-api/typeobj.rst:510 c-api/typeobj.rst:546 c-api/typeobj.rst:588
msgid "This field is not inherited by subtypes."
msgstr ""

#: c-api/typeobj.rst:515
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 ""

#: c-api/typeobj.rst:526
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-api/typeobj.rst:533 c-api/typeobj.rst:677 c-api/typeobj.rst:799
#: c-api/typeobj.rst:891 c-api/typeobj.rst:911 c-api/typeobj.rst:1429
#: c-api/typeobj.rst:1452 c-api/typeobj.rst:1570 c-api/typeobj.rst:1588
#: c-api/typeobj.rst:1679 c-api/typeobj.rst:1787 c-api/typeobj.rst:1896
msgid "This field is inherited by subtypes."
msgstr ""

#: c-api/typeobj.rst:537
msgid "PyVarObject Slots"
msgstr ""

#: c-api/typeobj.rst:541
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:550
#, fuzzy
msgid "PyTypeObject Slots"
msgstr "Objets type"

#: c-api/typeobj.rst:552
msgid ""
"Each slot has a section describing inheritance.  If :c:func:`PyType_Ready` "
"may set a value when the field is set to ``NULL`` then there will also be a "
"\"Default\" section.  (Note that many fields set on :c:type:"
"`PyBaseObject_Type` and :c:type:`PyType_Type` effectively act as defaults.)"
msgstr ""

#: c-api/typeobj.rst:559
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 ""

#: c-api/typeobj.rst:567
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 ""

#: c-api/typeobj.rst:571
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 ""

#: c-api/typeobj.rst:576
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-api/typeobj.rst:582
msgid ""
"This field must not be ``NULL``.  It is the only required field in :c:func:"
"`PyTypeObject` (other than potentially :c:member:`~PyTypeObject."
"tp_itemsize`)."
msgstr ""

#: c-api/typeobj.rst:594
msgid ""
"These fields allow calculating the size in bytes of instances of the type."
msgstr ""

#: c-api/typeobj.rst:596
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-api/typeobj.rst:601
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 ""

#: c-api/typeobj.rst:612
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-api/typeobj.rst:620
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-api/typeobj.rst:627
msgid ""
"For any type with variable-length instances, this field must not be ``NULL``."
msgstr ""

#: c-api/typeobj.rst:631
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 ""

#: c-api/typeobj.rst:639
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``).  "
"The function signature is::"
msgstr ""

#: c-api/typeobj.rst:645
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 "
"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-api/typeobj.rst:660
msgid ""
"Finally, if the type is heap allocated (:const:`Py_TPFLAGS_HEAPTYPE`), the "
"deallocator should decrement the reference count for its type object after "
"calling the type deallocator. In order to avoid dangling pointers, the "
"recommended way to achieve this is:"
msgstr ""

#: c-api/typeobj.rst:682
msgid ""
"An optional offset to a per-instance function that implements calling the "
"object using the :ref:`vectorcall protocol <vectorcall>`, a more efficient "
"alternative of the simpler :c:member:`~PyTypeObject.tp_call`."
msgstr ""

#: c-api/typeobj.rst:687
msgid ""
"This field is only used if the flag :const:`Py_TPFLAGS_HAVE_VECTORCALL` is "
"set. If so, this must be a positive integer containing the offset in the "
"instance of a :c:type:`vectorcallfunc` pointer."
msgstr ""

#: c-api/typeobj.rst:691
msgid ""
"The *vectorcallfunc* pointer may be ``NULL``, in which case the instance "
"behaves as if :const:`Py_TPFLAGS_HAVE_VECTORCALL` was not set: calling the "
"instance falls back to :c:member:`~PyTypeObject.tp_call`."
msgstr ""

#: c-api/typeobj.rst:695
msgid ""
"Any class that sets ``Py_TPFLAGS_HAVE_VECTORCALL`` must also set :c:member:"
"`~PyTypeObject.tp_call` and make sure its behaviour is consistent with the "
"*vectorcallfunc* function. This can be done by setting *tp_call* to :c:func:"
"`PyVectorcall_Call`."
msgstr ""

#: c-api/typeobj.rst:702
msgid ""
"It is not recommended for :ref:`heap types <heap-types>` to implement the "
"vectorcall protocol. When a user sets :attr:`__call__` in Python code, only "
"*tp_call* is updated, likely making it inconsistent with the vectorcall "
"function."
msgstr ""

#: c-api/typeobj.rst:709
msgid ""
"The semantics of the ``tp_vectorcall_offset`` slot are provisional and "
"expected to be finalized in Python 3.9. If you use vectorcall, plan for "
"updating your code for Python 3.9."
msgstr ""

#: c-api/typeobj.rst:715
msgid ""
"Before version 3.8, this slot was named ``tp_print``. In Python 2.x, it was "
"used for printing to a file. In Python 3.0 to 3.7, it was unused."
msgstr ""

#: c-api/typeobj.rst:721
msgid ""
"This field is always inherited. However, the :const:"
"`Py_TPFLAGS_HAVE_VECTORCALL` flag is not always inherited. If it's not, then "
"the subclass won't use :ref:`vectorcall <vectorcall>`, except when :c:func:"
"`PyVectorcall_Call` is explicitly called. This is in particular the case for "
"`heap types`_ (including subclasses defined in Python)."
msgstr ""

#: c-api/typeobj.rst:732
msgid "An optional pointer to the get-attribute-string function."
msgstr ""

#: c-api/typeobj.rst:734
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."
msgstr ""

#: c-api/typeobj.rst:740 c-api/typeobj.rst:932
msgid "Group: :attr:`tp_getattr`, :attr:`tp_getattro`"
msgstr ""

#: c-api/typeobj.rst:742
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-api/typeobj.rst:749 c-api/typeobj.rst:945
msgid ""
"An optional pointer to the function for setting and deleting attributes."
msgstr ""

#: c-api/typeobj.rst:751
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."
msgstr ""

#: c-api/typeobj.rst:757 c-api/typeobj.rst:958
msgid "Group: :attr:`tp_setattr`, :attr:`tp_setattro`"
msgstr ""

#: c-api/typeobj.rst:759
msgid ""
"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:766
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 ""

#: c-api/typeobj.rst:770
msgid "Formerly known as ``tp_compare`` and ``tp_reserved``."
msgstr ""

#: c-api/typeobj.rst:775
msgid ""
"The :c:member:`~PyTypeObject.tp_as_async` field is not inherited, but the "
"contained fields are inherited individually."
msgstr ""

#: c-api/typeobj.rst:783
msgid ""
"An optional pointer to a function that implements the built-in function :"
"func:`repr`."
msgstr ""

#: c-api/typeobj.rst:786
msgid "The signature is the same as for :c:func:`PyObject_Repr`::"
msgstr ""

#: c-api/typeobj.rst:790
msgid ""
"The function 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-api/typeobj.rst:801 c-api/typeobj.rst:913 c-api/typeobj.rst:938
#: c-api/typeobj.rst:964 c-api/typeobj.rst:1006 c-api/typeobj.rst:1374
#: c-api/typeobj.rst:1526 c-api/typeobj.rst:1547 c-api/typeobj.rst:1645
#: c-api/typeobj.rst:1681 c-api/typeobj.rst:1699 c-api/typeobj.rst:1737
#: c-api/typeobj.rst:1758 c-api/typeobj.rst:1789
msgid "**Default:**"
msgstr ""

#: c-api/typeobj.rst:803
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 ""

#: c-api/typeobj.rst:810
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 ""

#: c-api/typeobj.rst:816
msgid ""
"The :c:member:`~PyTypeObject.tp_as_number` field is not inherited, but the "
"contained fields are inherited individually."
msgstr ""

#: c-api/typeobj.rst:822
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 ""

#: c-api/typeobj.rst:828
msgid ""
"The :c:member:`~PyTypeObject.tp_as_sequence` field is not inherited, but the "
"contained fields are inherited individually."
msgstr ""

#: c-api/typeobj.rst:834
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 ""

#: c-api/typeobj.rst:840
msgid ""
"The :c:member:`~PyTypeObject.tp_as_mapping` field is not inherited, but the "
"contained fields are inherited individually."
msgstr ""

#: c-api/typeobj.rst:848
msgid ""
"An optional pointer to a function that implements the built-in function :"
"func:`hash`."
msgstr ""

#: c-api/typeobj.rst:851
msgid "The signature is the same as for :c:func:`PyObject_Hash`::"
msgstr ""

#: c-api/typeobj.rst:855
msgid ""
"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-api/typeobj.rst:859
msgid ""
"When this field is not set (*and* :attr:`tp_richcompare` is not set), an "
"attempt to take the hash of the object raises :exc:`TypeError`. This is the "
"same as setting it to :c:func:`PyObject_HashNotImplemented`."
msgstr ""

#: c-api/typeobj.rst:863
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-api/typeobj.rst:873 c-api/typeobj.rst:1367
msgid "Group: :attr:`tp_hash`, :attr:`tp_richcompare`"
msgstr ""

#: c-api/typeobj.rst:875
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-api/typeobj.rst:883
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:896
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 ""

#: c-api/typeobj.rst:901
msgid "The signature is the same as for :c:func:`PyObject_Str`::"
msgstr ""

#: c-api/typeobj.rst:905
msgid ""
"The function must return a string or a Unicode object.  It should be 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-api/typeobj.rst:915
msgid ""
"When this field is not set, :c:func:`PyObject_Repr` is called to return a "
"string representation."
msgstr ""

#: c-api/typeobj.rst:921
msgid "An optional pointer to the get-attribute function."
msgstr ""

#: c-api/typeobj.rst:923
msgid "The signature is the same as for :c:func:`PyObject_GetAttr`::"
msgstr ""

#: c-api/typeobj.rst:927
msgid ""
"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-api/typeobj.rst:934
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-api/typeobj.rst:940
msgid ":c:type:`PyBaseObject_Type` uses :c:func:`PyObject_GenericGetAttr`."
msgstr ""

#: c-api/typeobj.rst:947
msgid "The signature is the same as for :c:func:`PyObject_SetAttr`::"
msgstr ""

#: c-api/typeobj.rst:951
msgid ""
"In addition, setting *value* 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:960
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-api/typeobj.rst:966
msgid ":c:type:`PyBaseObject_Type` uses :c:func:`PyObject_GenericSetAttr`."
msgstr ""

#: c-api/typeobj.rst:971
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 ""

#: c-api/typeobj.rst:977
msgid ""
"The :c:member:`~PyTypeObject.tp_as_buffer` field is not inherited, but the "
"contained fields are inherited individually."
msgstr ""

#: c-api/typeobj.rst:983
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-api/typeobj.rst:993
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 ""

#: c-api/typeobj.rst:1008
msgid ""
":c:type:`PyBaseObject_Type` uses ``Py_TPFLAGS_DEFAULT | "
"Py_TPFLAGS_BASETYPE``."
msgstr ""

#: c-api/typeobj.rst:1011
msgid "**Bit Masks:**"
msgstr ""

#: c-api/typeobj.rst:1013
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-api/typeobj.rst:1020
msgid ""
"This bit is set when the type object itself is allocated on the heap, for "
"example, types created dynamically using :c:func:`PyType_FromSpec`.  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 ""

#: c-api/typeobj.rst:1030 c-api/typeobj.rst:1041 c-api/typeobj.rst:1051
#: c-api/typeobj.rst:1061 c-api/typeobj.rst:1094
msgid "???"
msgstr ""

#: c-api/typeobj.rst:1035
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 ""

#: c-api/typeobj.rst:1046
msgid ""
"This bit is set when the type object has been fully initialized by :c:func:"
"`PyType_Ready`."
msgstr ""

#: c-api/typeobj.rst:1056
msgid ""
"This bit is set while :c:func:`PyType_Ready` is in the process of "
"initializing the type object."
msgstr ""

#: c-api/typeobj.rst:1066
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 ""

#: c-api/typeobj.rst:1075 c-api/typeobj.rst:1247 c-api/typeobj.rst:1308
msgid ""
"Group: :const:`Py_TPFLAGS_HAVE_GC`, :attr:`tp_traverse`, :attr:`tp_clear`"
msgstr ""

#: c-api/typeobj.rst:1077
msgid ""
"The :const:`Py_TPFLAGS_HAVE_GC` flag bit is inherited together with the :"
"attr:`tp_traverse` and :attr:`tp_clear` fields, i.e.  if the :const:"
"`Py_TPFLAGS_HAVE_GC` flag bit is clear in the subtype and the :attr:"
"`tp_traverse` and :attr:`tp_clear` fields in the subtype exist and have "
"``NULL`` values."
msgstr ""

#: c-api/typeobj.rst:1087
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 ""

#: c-api/typeobj.rst:1099
msgid "This bit indicates that objects behave like unbound methods."
msgstr ""

#: c-api/typeobj.rst:1101
msgid "If this flag is set for ``type(meth)``, then:"
msgstr ""

#: c-api/typeobj.rst:1103
msgid ""
"``meth.__get__(obj, cls)(*args, **kwds)`` (with ``obj`` not None) must be "
"equivalent to ``meth(obj, *args, **kwds)``."
msgstr ""

#: c-api/typeobj.rst:1106
msgid ""
"``meth.__get__(None, cls)(*args, **kwds)`` must be equivalent to "
"``meth(*args, **kwds)``."
msgstr ""

#: c-api/typeobj.rst:1109
msgid ""
"This flag enables an optimization for typical method calls like ``obj."
"meth()``: it avoids creating a temporary \"bound method\" object for ``obj."
"meth``."
msgstr ""

#: c-api/typeobj.rst:1117
msgid ""
"This flag is never inherited by heap types. For extension types, it is "
"inherited whenever :c:member:`~PyTypeObject.tp_descr_get` is inherited."
msgstr ""

#: c-api/typeobj.rst:1134
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-api/typeobj.rst:1145
msgid ""
"This bit is set when the :c:member:`~PyTypeObject.tp_finalize` slot is "
"present in the type structure."
msgstr ""

#: c-api/typeobj.rst:1150
msgid ""
"This flag isn't necessary anymore, as the interpreter assumes the :c:member:"
"`~PyTypeObject.tp_finalize` slot is always present in the type structure."
msgstr ""

#: c-api/typeobj.rst:1158
msgid ""
"This bit is set when the class implements the :ref:`vectorcall protocol "
"<vectorcall>`. See :c:member:`~PyTypeObject.tp_vectorcall_offset` for "
"details."
msgstr ""

#: c-api/typeobj.rst:1164
msgid ""
"This bit is inherited for *static* subtypes if :c:member:`~PyTypeObject."
"tp_call` is also inherited. `Heap types`_ do not inherit "
"``Py_TPFLAGS_HAVE_VECTORCALL``."
msgstr ""

#: c-api/typeobj.rst:1173
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 ""

#: c-api/typeobj.rst:1179
msgid "This field is *not* inherited by subtypes."
msgstr ""

#: c-api/typeobj.rst:1184
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.  The "
"signature is::"
msgstr ""

#: c-api/typeobj.rst:1189 c-api/typeobj.rst:1303
msgid ""
"More information about Python's garbage collection scheme can be found in "
"section :ref:`supporting-cycle-detection`."
msgstr ""

#: c-api/typeobj.rst:1192
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:1207
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-api/typeobj.rst:1211
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 ""

#: c-api/typeobj.rst:1216
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:1226
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-api/typeobj.rst:1230
msgid ""
"Heap-allocated types (:const:`Py_TPFLAGS_HEAPTYPE`, such as those created "
"with :c:func:`PyType_FromSpec` and similar APIs) hold a reference to their "
"type. Their traversal function must therefore either visit :c:func:"
"`Py_TYPE(self) <Py_TYPE>`, or delegate this responsibility by calling "
"``tp_traverse`` of another heap-allocated type (such as a heap-allocated "
"superclass). If they do not, the type object may not be garbage-collected."
msgstr ""

#: c-api/typeobj.rst:1240
msgid ""
"Heap-allocated types are expected to visit ``Py_TYPE(self)`` in "
"``tp_traverse``.  In earlier versions of Python, due to `bug 40217 <https://"
"bugs.python.org/issue40217>`_, doing this may lead to crashes in subclasses."
msgstr ""

#: c-api/typeobj.rst:1249
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-api/typeobj.rst:1257
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.  The signature "
"is::"
msgstr ""

#: c-api/typeobj.rst:1262
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-api/typeobj.rst:1272
msgid ""
"Implementations of :c:member:`~PyTypeObject.tp_clear` should drop the "
"instance's references to those of its members that may be Python objects, "
"and set its pointers to those members to ``NULL``, as in the following "
"example::"
msgstr ""

#: c-api/typeobj.rst:1286
msgid ""
"The :c:func:`Py_CLEAR` macro should be used, because clearing references is "
"delicate:  the reference to the contained object must not be decremented "
"until after the pointer to the contained object is set to ``NULL``.  This is "
"because decrementing the reference count may cause the contained object to "
"become trash, triggering a chain of reclamation activity that may include "
"invoking arbitrary Python code (due to finalizers, or weakref callbacks, "
"associated with the contained object). If it's possible for such code to "
"reference *self* again, it's important that the pointer to the contained "
"object be ``NULL`` at that time, so that *self* knows the contained object "
"can no longer be used.  The :c:func:`Py_CLEAR` macro performs the operations "
"in a safe order."
msgstr ""

#: c-api/typeobj.rst:1297
msgid ""
"Because the goal of :c:member:`~PyTypeObject.tp_clear` functions is to break "
"reference cycles, it's not necessary to clear contained objects like Python "
"strings or Python integers, which can't participate in reference cycles. On "
"the other hand, it may be convenient to clear all contained Python objects, "
"and write the type's :c:member:`~PyTypeObject.tp_dealloc` function to "
"invoke :c:member:`~PyTypeObject.tp_clear`."
msgstr ""

#: c-api/typeobj.rst:1310
msgid ""
"This field is inherited by subtypes together with :c:member:`~PyTypeObject."
"tp_traverse` 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-api/typeobj.rst:1318
msgid ""
"An optional pointer to the rich comparison function, whose signature is::"
msgstr ""

#: c-api/typeobj.rst:1322
msgid ""
"The first parameter is guaranteed to be an instance of the type that is "
"defined by :c:type:`PyTypeObject`."
msgstr ""

#: c-api/typeobj.rst:1325
msgid ""
"The function should return the result of the comparison (usually ``Py_True`` "
"or ``Py_False``).  If the comparison is undefined, it must return "
"``Py_NotImplemented``, if another error occurred it must return ``NULL`` and "
"set an exception condition."
msgstr ""

#: c-api/typeobj.rst:1330
msgid ""
"The following constants are defined to be used as the third argument for :c:"
"member:`~PyTypeObject.tp_richcompare` and for :c:func:`PyObject_RichCompare`:"
msgstr ""

#: c-api/typeobj.rst:1334
msgid "Constant"
msgstr "Constante"

#: c-api/typeobj.rst:1334
msgid "Comparison"
msgstr "Comparaison"

#: c-api/typeobj.rst:1336
msgid ":const:`Py_LT`"
msgstr ""

#: c-api/typeobj.rst:1336
msgid "``<``"
msgstr "``<``"

#: c-api/typeobj.rst:1338
msgid ":const:`Py_LE`"
msgstr ""

#: c-api/typeobj.rst:1338
msgid "``<=``"
msgstr "``<=``"

#: c-api/typeobj.rst:1340
msgid ":const:`Py_EQ`"
msgstr ""

#: c-api/typeobj.rst:1340
msgid "``==``"
msgstr "``==``"

#: c-api/typeobj.rst:1342
msgid ":const:`Py_NE`"
msgstr ""

#: c-api/typeobj.rst:1342
msgid "``!=``"
msgstr "``!=``"

#: c-api/typeobj.rst:1344
msgid ":const:`Py_GT`"
msgstr ""

#: c-api/typeobj.rst:1344
msgid "``>``"
msgstr "``>``"

#: c-api/typeobj.rst:1346
msgid ":const:`Py_GE`"
msgstr ""

#: c-api/typeobj.rst:1346
msgid "``>=``"
msgstr "``>=``"

#: c-api/typeobj.rst:1349
msgid ""
"The following macro is defined to ease writing rich comparison functions:"
msgstr ""

#: c-api/typeobj.rst:1353
msgid ""
"Return ``Py_True`` or ``Py_False`` from the function, depending on the "
"result of a comparison. VAL_A and VAL_B must be orderable by C comparison "
"operators (for example, they may be C ints or floats). The third argument "
"specifies the requested operation, as for :c:func:`PyObject_RichCompare`."
msgstr ""

#: c-api/typeobj.rst:1359
msgid "The return value's reference count is properly incremented."
msgstr ""

#: c-api/typeobj.rst:1361
msgid "On error, sets an exception and returns ``NULL`` from the function."
msgstr ""

#: c-api/typeobj.rst:1369
msgid ""
"This field is inherited by subtypes together with :c:member:`~PyTypeObject."
"tp_hash`: a subtype inherits :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-api/typeobj.rst:1376
msgid ""
":c:type:`PyBaseObject_Type` provides a :attr:`tp_richcompare` "
"implementation, which may be inherited.  However, if only :attr:`tp_hash` is "
"defined, not even the inherited function is used and instances of the type "
"will not be able to participate in any comparisons."
msgstr ""

#: c-api/typeobj.rst:1385
msgid ""
"If the instances of this type are weakly referenceable, this field is "
"greater than zero and contains the offset in the instance structure of the "
"weak reference list head (ignoring the GC header, if present); this offset "
"is used by :c:func:`PyObject_ClearWeakRefs` and the :c:func:`PyWeakref_\\*` "
"functions.  The instance structure needs to include a field of type :c:type:"
"`PyObject*` which is initialized to ``NULL``."
msgstr ""

#: c-api/typeobj.rst:1392
msgid ""
"Do not confuse this field with :c:member:`~PyTypeObject.tp_weaklist`; that "
"is the list head for weak references to the type object itself."
msgstr ""

#: c-api/typeobj.rst:1397
msgid ""
"This field is inherited by subtypes, but see the rules listed below. A "
"subtype may override this offset; this means that the subtype uses a "
"different weak reference list head than the base type.  Since the list head "
"is always found via :c:member:`~PyTypeObject.tp_weaklistoffset`, this should "
"not be a problem."
msgstr ""

#: c-api/typeobj.rst:1402
msgid ""
"When a type defined by a class statement has no :attr:`~object.__slots__` "
"declaration, and none of its base types are weakly referenceable, the type "
"is made weakly referenceable by adding a weak reference list head slot to "
"the instance layout and setting the :c:member:`~PyTypeObject."
"tp_weaklistoffset` of that slot's offset."
msgstr ""

#: c-api/typeobj.rst:1407
msgid ""
"When a type's :attr:`__slots__` declaration contains a slot named :attr:"
"`__weakref__`, that slot becomes the weak reference list head for instances "
"of the type, and the slot's offset is stored in the type's :c:member:"
"`~PyTypeObject.tp_weaklistoffset`."
msgstr ""

#: c-api/typeobj.rst:1412
msgid ""
"When a type's :attr:`__slots__` declaration does not contain a slot named :"
"attr:`__weakref__`, the type inherits its :c:member:`~PyTypeObject."
"tp_weaklistoffset` from its base type."
msgstr ""

#: c-api/typeobj.rst:1419
msgid ""
"An optional pointer to a function that returns an iterator for the object.  "
"Its presence normally signals that the instances of this type are iterable "
"(although sequences may be iterable without this function)."
msgstr ""

#: c-api/typeobj.rst:1423
msgid "This function has the same signature as :c:func:`PyObject_GetIter`::"
msgstr ""

#: c-api/typeobj.rst:1434
msgid ""
"An optional pointer to a function that returns the next item in an iterator. "
"The signature is::"
msgstr ""

#: c-api/typeobj.rst:1439
msgid ""
"When the iterator is exhausted, it must return ``NULL``; a :exc:"
"`StopIteration` exception may or may not be set.  When another error occurs, "
"it must return ``NULL`` too.  Its presence signals that the instances of "
"this type are iterators."
msgstr ""

#: c-api/typeobj.rst:1444
msgid ""
"Iterator types should also define the :c:member:`~PyTypeObject.tp_iter` "
"function, and that function should return the iterator instance itself (not "
"a new iterator instance)."
msgstr ""

#: c-api/typeobj.rst:1448
msgid "This function has the same signature as :c:func:`PyIter_Next`."
msgstr ""

#: c-api/typeobj.rst:1457
msgid ""
"An optional pointer to a static ``NULL``-terminated array of :c:type:"
"`PyMethodDef` structures, declaring regular methods of this type."
msgstr ""

#: c-api/typeobj.rst:1460
msgid ""
"For each entry in the array, an entry is added to the type's dictionary "
"(see :c:member:`~PyTypeObject.tp_dict` below) containing a method descriptor."
msgstr ""

#: c-api/typeobj.rst:1465
msgid ""
"This field is not inherited by subtypes (methods are inherited through a "
"different mechanism)."
msgstr ""

#: c-api/typeobj.rst:1471
msgid ""
"An optional pointer to a static ``NULL``-terminated array of :c:type:"
"`PyMemberDef` structures, declaring regular data members (fields or slots) "
"of instances of this type."
msgstr ""

#: c-api/typeobj.rst:1475
msgid ""
"For each entry in the array, an entry is added to the type's dictionary "
"(see :c:member:`~PyTypeObject.tp_dict` below) containing a member descriptor."
msgstr ""

#: c-api/typeobj.rst:1480
msgid ""
"This field is not inherited by subtypes (members are inherited through a "
"different mechanism)."
msgstr ""

#: c-api/typeobj.rst:1486
msgid ""
"An optional pointer to a static ``NULL``-terminated array of :c:type:"
"`PyGetSetDef` structures, declaring computed attributes of instances of this "
"type."
msgstr ""

#: c-api/typeobj.rst:1489
msgid ""
"For each entry in the array, an entry is added to the type's dictionary "
"(see :c:member:`~PyTypeObject.tp_dict` below) containing a getset descriptor."
msgstr ""

#: c-api/typeobj.rst:1494
msgid ""
"This field is not inherited by subtypes (computed attributes are inherited "
"through a different mechanism)."
msgstr ""

#: c-api/typeobj.rst:1500
msgid ""
"An optional pointer to a base type from which type properties are "
"inherited.  At this level, only single inheritance is supported; multiple "
"inheritance require dynamically creating a type object by calling the "
"metatype."
msgstr ""

#: c-api/typeobj.rst:1508
msgid ""
"Slot initialization is subject to the rules of initializing globals. C99 "
"requires the initializers to be \"address constants\".  Function designators "
"like :c:func:`PyType_GenericNew`, with implicit conversion to a pointer, are "
"valid C99 address constants."
msgstr ""

#: c-api/typeobj.rst:1513
msgid ""
"However, the unary '&' operator applied to a non-static variable like :c:"
"func:`PyBaseObject_Type` is not required to produce an address constant.  "
"Compilers may support this (gcc does), MSVC does not. Both compilers are "
"strictly standard conforming in this particular behavior."
msgstr ""

#: c-api/typeobj.rst:1519
msgid ""
"Consequently, :c:member:`~PyTypeObject.tp_base` should be set in the "
"extension module's init function."
msgstr ""

#: c-api/typeobj.rst:1524
msgid "This field is not inherited by subtypes (obviously)."
msgstr ""

#: c-api/typeobj.rst:1528
msgid ""
"This field defaults to ``&PyBaseObject_Type`` (which to Python programmers "
"is known as the type :class:`object`)."
msgstr ""

#: c-api/typeobj.rst:1534
msgid "The type's dictionary is stored here by :c:func:`PyType_Ready`."
msgstr ""

#: c-api/typeobj.rst:1536
msgid ""
"This field should normally be initialized to ``NULL`` before PyType_Ready is "
"called; it may also be initialized to a dictionary containing initial "
"attributes for the type.  Once :c:func:`PyType_Ready` has initialized the "
"type, extra attributes for the type may be added to this dictionary only if "
"they don't correspond to overloaded operations (like :meth:`__add__`)."
msgstr ""

#: c-api/typeobj.rst:1544
msgid ""
"This field is not inherited by subtypes (though the attributes defined in "
"here are inherited through a different mechanism)."
msgstr ""

#: c-api/typeobj.rst:1549
msgid ""
"If this field is ``NULL``, :c:func:`PyType_Ready` will assign a new "
"dictionary to it."
msgstr ""

#: c-api/typeobj.rst:1554
msgid ""
"It is not safe to use :c:func:`PyDict_SetItem` on or otherwise modify :c:"
"member:`~PyTypeObject.tp_dict` with the dictionary C-API."
msgstr ""

#: c-api/typeobj.rst:1560
msgid "An optional pointer to a \"descriptor get\" function."
msgstr ""

#: c-api/typeobj.rst:1562 c-api/typeobj.rst:1578 c-api/typeobj.rst:1660
#: c-api/typeobj.rst:1690 c-api/typeobj.rst:1714
msgid "The function signature is::"
msgstr ""

#: c-api/typeobj.rst:1575
msgid ""
"An optional pointer to a function for setting and deleting a descriptor's "
"value."
msgstr ""

#: c-api/typeobj.rst:1582
msgid "The *value* argument is set to ``NULL`` to delete the value."
msgstr ""

#: c-api/typeobj.rst:1593
msgid ""
"If the instances of this type have a dictionary containing instance "
"variables, this field is non-zero and contains the offset in the instances "
"of the type of the instance variable dictionary; this offset is used by :c:"
"func:`PyObject_GenericGetAttr`."
msgstr ""

#: c-api/typeobj.rst:1598
msgid ""
"Do not confuse this field with :c:member:`~PyTypeObject.tp_dict`; that is "
"the dictionary for attributes of the type object itself."
msgstr ""

#: c-api/typeobj.rst:1601
msgid ""
"If the value of this field is greater than zero, it specifies the offset "
"from the start of the instance structure.  If the value is less than zero, "
"it specifies the offset from the *end* of the instance structure.  A "
"negative offset is more expensive to use, and should only be used when the "
"instance structure contains a variable-length part.  This is used for "
"example to add an instance variable dictionary to subtypes of :class:`str` "
"or :class:`tuple`. Note that the :c:member:`~PyTypeObject.tp_basicsize` "
"field should account for the dictionary added to the end in that case, even "
"though the dictionary is not included in the basic object layout.  On a "
"system with a pointer size of 4 bytes, :c:member:`~PyTypeObject."
"tp_dictoffset` should be set to ``-4`` to indicate that the dictionary is at "
"the very end of the structure."
msgstr ""

#: c-api/typeobj.rst:1613
msgid ""
"The real dictionary offset in an instance can be computed from a negative :c:"
"member:`~PyTypeObject.tp_dictoffset` as follows::"
msgstr ""

#: c-api/typeobj.rst:1620
msgid ""
"where :c:member:`~PyTypeObject.tp_basicsize`, :c:member:`~PyTypeObject."
"tp_itemsize` and :c:member:`~PyTypeObject.tp_dictoffset` are taken from the "
"type object, and :attr:`ob_size` is taken from the instance.  The absolute "
"value is taken because ints use the sign of :attr:`ob_size` to store the "
"sign of the number.  (There's never a need to do this calculation yourself; "
"it is done for you by :c:func:`_PyObject_GetDictPtr`.)"
msgstr ""

#: c-api/typeobj.rst:1628
msgid ""
"This field is inherited by subtypes, but see the rules listed below. A "
"subtype may override this offset; this means that the subtype instances "
"store the dictionary at a difference offset than the base type.  Since the "
"dictionary is always found via :c:member:`~PyTypeObject.tp_dictoffset`, this "
"should not be a problem."
msgstr ""

#: c-api/typeobj.rst:1633
msgid ""
"When a type defined by a class statement has no :attr:`~object.__slots__` "
"declaration, and none of its base types has an instance variable dictionary, "
"a dictionary slot is added to the instance layout and the :c:member:"
"`~PyTypeObject.tp_dictoffset` is set to that slot's offset."
msgstr ""

#: c-api/typeobj.rst:1638
msgid ""
"When a type defined by a class statement has a :attr:`__slots__` "
"declaration, the type inherits its :c:member:`~PyTypeObject.tp_dictoffset` "
"from its base type."
msgstr ""

#: c-api/typeobj.rst:1641
msgid ""
"(Adding a slot named :attr:`~object.__dict__` to the :attr:`__slots__` "
"declaration does not have the expected effect, it just causes confusion.  "
"Maybe this should be added as a feature just like :attr:`__weakref__` "
"though.)"
msgstr ""

#: c-api/typeobj.rst:1647
msgid ""
"This slot has no default.  For static types, if the field is ``NULL`` then "
"no :attr:`__dict__` gets created for instances."
msgstr ""

#: c-api/typeobj.rst:1653
msgid "An optional pointer to an instance initialization function."
msgstr ""

#: c-api/typeobj.rst:1655
msgid ""
"This function corresponds to the :meth:`__init__` method of classes.  Like :"
"meth:`__init__`, it is possible to create an instance without calling :meth:"
"`__init__`, and it is possible to reinitialize an instance by calling its :"
"meth:`__init__` method again."
msgstr ""

#: c-api/typeobj.rst:1664
msgid ""
"The self argument is the instance to be initialized; the *args* and *kwds* "
"arguments represent positional and keyword arguments of the call to :meth:"
"`__init__`."
msgstr ""

#: c-api/typeobj.rst:1668
msgid ""
"The :c:member:`~PyTypeObject.tp_init` function, if not ``NULL``, is called "
"when an instance is created normally by calling its type, after the type's :"
"c:member:`~PyTypeObject.tp_new` function has returned an instance of the "
"type.  If the :c:member:`~PyTypeObject.tp_new` function returns an instance "
"of some other type that is not a subtype of the original type, no :c:member:"
"`~PyTypeObject.tp_init` function is called; if :c:member:`~PyTypeObject."
"tp_new` returns an instance of a subtype of the original type, the "
"subtype's :c:member:`~PyTypeObject.tp_init` is called."
msgstr ""

#: c-api/typeobj.rst:1675
msgid "Returns ``0`` on success, ``-1`` and sets an exception on error."
msgstr ""

#: c-api/typeobj.rst:1683
msgid "For static types this field does not have a default."
msgstr ""

#: c-api/typeobj.rst:1688
msgid "An optional pointer to an instance allocation function."
msgstr ""

#: c-api/typeobj.rst:1696
msgid ""
"This field is inherited by static subtypes, but not by dynamic subtypes "
"(subtypes created by a class statement)."
msgstr ""

#: c-api/typeobj.rst:1701
msgid ""
"For dynamic subtypes, this field is always set to :c:func:"
"`PyType_GenericAlloc`, to force a standard heap allocation strategy."
msgstr ""

#: c-api/typeobj.rst:1705
msgid ""
"For static subtypes, :c:type:`PyBaseObject_Type` uses :c:func:"
"`PyType_GenericAlloc`.  That is the recommended value for all statically "
"defined types."
msgstr ""

#: c-api/typeobj.rst:1712
msgid "An optional pointer to an instance creation function."
msgstr ""

#: c-api/typeobj.rst:1718
msgid ""
"The *subtype* argument is the type of the object being created; the *args* "
"and *kwds* arguments represent positional and keyword arguments of the call "
"to the type.  Note that *subtype* doesn't have to equal the type whose :c:"
"member:`~PyTypeObject.tp_new` function is called; it may be a subtype of "
"that type (but not an unrelated type)."
msgstr ""

#: c-api/typeobj.rst:1724
msgid ""
"The :c:member:`~PyTypeObject.tp_new` function should call ``subtype-"
">tp_alloc(subtype, nitems)`` to allocate space for the object, and then do "
"only as much further initialization as is absolutely necessary.  "
"Initialization that can safely be ignored or repeated should be placed in "
"the :c:member:`~PyTypeObject.tp_init` handler.  A good rule of thumb is that "
"for immutable types, all initialization should take place in :c:member:"
"`~PyTypeObject.tp_new`, while for mutable types, most initialization should "
"be deferred to :c:member:`~PyTypeObject.tp_init`."
msgstr ""

#: c-api/typeobj.rst:1734
msgid ""
"This field is inherited by subtypes, except it is not inherited by static "
"types whose :c:member:`~PyTypeObject.tp_base` is ``NULL`` or "
"``&PyBaseObject_Type``."
msgstr ""

#: c-api/typeobj.rst:1739
msgid ""
"For static types this field has no default.  This means if the slot is "
"defined as ``NULL``, the type cannot be called to create new instances; "
"presumably there is some other way to create instances, like a factory "
"function."
msgstr ""

#: c-api/typeobj.rst:1747
msgid ""
"An optional pointer to an instance deallocation function.  Its signature is::"
msgstr ""

#: c-api/typeobj.rst:1751
msgid ""
"An initializer that is compatible with this signature is :c:func:"
"`PyObject_Free`."
msgstr ""

#: c-api/typeobj.rst:1755
msgid ""
"This field is inherited by static subtypes, but not by dynamic subtypes "
"(subtypes created by a class statement)"
msgstr ""

#: c-api/typeobj.rst:1760
msgid ""
"In dynamic subtypes, this field is set to a deallocator suitable to match :c:"
"func:`PyType_GenericAlloc` and the value of the :const:`Py_TPFLAGS_HAVE_GC` "
"flag bit."
msgstr ""

#: c-api/typeobj.rst:1764
msgid "For static subtypes, :c:type:`PyBaseObject_Type` uses PyObject_Del."
msgstr ""

#: c-api/typeobj.rst:1769
msgid "An optional pointer to a function called by the garbage collector."
msgstr ""

#: c-api/typeobj.rst:1771
msgid ""
"The garbage collector needs to know whether a particular object is "
"collectible or not.  Normally, it is sufficient to look at the object's "
"type's :c:member:`~PyTypeObject.tp_flags` field, and check the :const:"
"`Py_TPFLAGS_HAVE_GC` flag bit.  But some types have a mixture of statically "
"and dynamically allocated instances, and the statically allocated instances "
"are not collectible.  Such types should define this function; it should "
"return ``1`` for a collectible instance, and ``0`` for a non-collectible "
"instance. The signature is::"
msgstr ""

#: c-api/typeobj.rst:1781
msgid ""
"(The only example of this are types themselves.  The metatype, :c:data:"
"`PyType_Type`, defines this function to distinguish between statically and "
"dynamically allocated types.)"
msgstr ""

#: c-api/typeobj.rst:1791
msgid ""
"This slot has no default.  If this field is ``NULL``, :const:"
"`Py_TPFLAGS_HAVE_GC` is used as the functional equivalent."
msgstr ""

#: c-api/typeobj.rst:1797
msgid "Tuple of base types."
msgstr ""

#: c-api/typeobj.rst:1799
msgid ""
"This is set for types created by a class statement.  It should be ``NULL`` "
"for statically defined types."
msgstr ""

#: c-api/typeobj.rst:1804 c-api/typeobj.rst:1825 c-api/typeobj.rst:1834
#: c-api/typeobj.rst:1844 c-api/typeobj.rst:1858
msgid "This field is not inherited."
msgstr ""

#: c-api/typeobj.rst:1809
msgid ""
"Tuple containing the expanded set of base types, starting with the type "
"itself and ending with :class:`object`, in Method Resolution Order."
msgstr ""

#: c-api/typeobj.rst:1815
msgid ""
"This field is not inherited; it is calculated fresh by :c:func:"
"`PyType_Ready`."
msgstr ""

#: c-api/typeobj.rst:1821
msgid "Unused.  Internal use only."
msgstr ""

#: c-api/typeobj.rst:1830
msgid "List of weak references to subclasses.  Internal use only."
msgstr ""

#: c-api/typeobj.rst:1839
msgid ""
"Weak reference list head, for weak references to this type object.  Not "
"inherited.  Internal use only."
msgstr ""

#: c-api/typeobj.rst:1849
msgid ""
"This field is deprecated.  Use :c:member:`~PyTypeObject.tp_finalize` instead."
msgstr ""

#: c-api/typeobj.rst:1854
msgid "Used to index into the method cache.  Internal use only."
msgstr ""

#: c-api/typeobj.rst:1863
msgid ""
"An optional pointer to an instance finalization function.  Its signature is::"
msgstr ""

#: c-api/typeobj.rst:1867
msgid ""
"If :c:member:`~PyTypeObject.tp_finalize` is set, the interpreter calls it "
"once when finalizing an instance.  It is called either from the garbage "
"collector (if the instance is part of an isolated reference cycle) or just "
"before the object is deallocated.  Either way, it is guaranteed to be called "
"before attempting to break reference cycles, ensuring that it finds the "
"object in a sane state."
msgstr ""

#: c-api/typeobj.rst:1874
msgid ""
":c:member:`~PyTypeObject.tp_finalize` should not mutate the current "
"exception status; therefore, a recommended way to write a non-trivial "
"finalizer is::"
msgstr ""

#: c-api/typeobj.rst:1891
msgid ""
"For this field to be taken into account (even through inheritance), you must "
"also set the :const:`Py_TPFLAGS_HAVE_FINALIZE` flags bit."
msgstr ""

#: c-api/typeobj.rst:1900
msgid "\"Safe object finalization\" (:pep:`442`)"
msgstr ""

#: c-api/typeobj.rst:1905
msgid ""
"Vectorcall function to use for calls of this type object. In other words, it "
"is used to implement :ref:`vectorcall <vectorcall>` for ``type.__call__``. "
"If ``tp_vectorcall`` is ``NULL``, the default call implementation using :"
"attr:`__new__` and :attr:`__init__` is used."
msgstr ""

#: c-api/typeobj.rst:1913
msgid "This field is never inherited."
msgstr ""

#: c-api/typeobj.rst:1915
msgid "(the field exists since 3.8 but it's only used since 3.9)"
msgstr ""

#: c-api/typeobj.rst:1918
msgid ""
"Also, note that, in a garbage collected Python, :c:member:`~PyTypeObject."
"tp_dealloc` may be called from any Python thread, not just the thread which "
"created the object (if the object becomes part of a refcount cycle, that "
"cycle might be collected by a garbage collection on any thread).  This is "
"not a problem for Python API calls, since the thread on which tp_dealloc is "
"called will own the Global Interpreter Lock (GIL). However, if the object "
"being destroyed in turn destroys objects from some other C or C++ library, "
"care should be taken to ensure that destroying those objects on the thread "
"which called tp_dealloc will not violate any assumptions of the library."
msgstr ""

#: c-api/typeobj.rst:1932
msgid "Heap Types"
msgstr ""

#: c-api/typeobj.rst:1934
msgid ""
"Traditionally, types defined in C code are *static*, that is, a static :c:"
"type:`PyTypeObject` structure is defined directly in code and initialized "
"using :c:func:`PyType_Ready`."
msgstr ""

#: c-api/typeobj.rst:1938
msgid ""
"This results in types that are limited relative to types defined in Python:"
msgstr ""

#: c-api/typeobj.rst:1940
msgid ""
"Static types are limited to one base, i.e. they cannot use multiple "
"inheritance."
msgstr ""

#: c-api/typeobj.rst:1942
msgid ""
"Static type objects (but not necessarily their instances) are immutable. It "
"is not possible to add or modify the type object's attributes from Python."
msgstr ""

#: c-api/typeobj.rst:1944
msgid ""
"Static type objects are shared across :ref:`sub-interpreters <sub-"
"interpreter-support>`, so they should not include any subinterpreter-"
"specific state."
msgstr ""

#: c-api/typeobj.rst:1948
msgid ""
"Also, since :c:type:`PyTypeObject` is not part of the :ref:`stable ABI "
"<stable>`, any extension modules using static types must be compiled for a "
"specific Python minor version."
msgstr ""

#: c-api/typeobj.rst:1952
msgid ""
"An alternative to static types is *heap-allocated types*, or *heap types* "
"for short, which correspond closely to classes created by Python's ``class`` "
"statement."
msgstr ""

#: c-api/typeobj.rst:1956
msgid ""
"This is done by filling a :c:type:`PyType_Spec` structure and calling :c:"
"func:`PyType_FromSpecWithBases`."
msgstr ""

#: c-api/typeobj.rst:1963
msgid "Number Object Structures"
msgstr ""

#: c-api/typeobj.rst:1970
msgid ""
"This structure holds pointers to the functions which an object uses to "
"implement the number protocol.  Each function is used by the function of "
"similar name documented in the :ref:`number` section."
msgstr ""

#: c-api/typeobj.rst:1976 c-api/typeobj.rst:2300
msgid "Here is the structure definition::"
msgstr ""

#: c-api/typeobj.rst:2023
msgid ""
"Binary and ternary functions must check the type of all their operands, and "
"implement the necessary conversions (at least one of the operands is an "
"instance of the defined type).  If the operation is not defined for the "
"given operands, binary and ternary functions must return "
"``Py_NotImplemented``, if another error occurred they must return ``NULL`` "
"and set an exception."
msgstr ""

#: c-api/typeobj.rst:2032
msgid ""
"The :c:data:`nb_reserved` field should always be ``NULL``.  It was "
"previously called :c:data:`nb_long`, and was renamed in Python 3.0.1."
msgstr ""

#: c-api/typeobj.rst:2077
msgid "Mapping Object Structures"
msgstr ""

#: c-api/typeobj.rst:2084
msgid ""
"This structure holds pointers to the functions which an object uses to "
"implement the mapping protocol.  It has three members:"
msgstr ""

#: c-api/typeobj.rst:2089
msgid ""
"This function is used by :c:func:`PyMapping_Size` and :c:func:"
"`PyObject_Size`, and has the same signature.  This slot may be set to "
"``NULL`` if the object has no defined length."
msgstr ""

#: c-api/typeobj.rst:2095
msgid ""
"This function is used by :c:func:`PyObject_GetItem` and :c:func:"
"`PySequence_GetSlice`, and has the same signature as :c:func:`!"
"PyObject_GetItem`.  This slot must be filled for the :c:func:"
"`PyMapping_Check` function to return ``1``, it can be ``NULL`` otherwise."
msgstr ""

#: c-api/typeobj.rst:2103
msgid ""
"This function is used by :c:func:`PyObject_SetItem`, :c:func:"
"`PyObject_DelItem`, :c:func:`PyObject_SetSlice` and :c:func:"
"`PyObject_DelSlice`.  It has the same signature as :c:func:`!"
"PyObject_SetItem`, but *v* can also be set to ``NULL`` to delete an item.  "
"If this slot is ``NULL``, the object does not support item assignment and "
"deletion."
msgstr ""

#: c-api/typeobj.rst:2114
msgid "Sequence Object Structures"
msgstr ""

#: c-api/typeobj.rst:2121
msgid ""
"This structure holds pointers to the functions which an object uses to "
"implement the sequence protocol."
msgstr ""

#: c-api/typeobj.rst:2126
msgid ""
"This function is used by :c:func:`PySequence_Size` and :c:func:"
"`PyObject_Size`, and has the same signature.  It is also used for handling "
"negative indices via the :c:member:`~PySequenceMethods.sq_item` and the :c:"
"member:`~PySequenceMethods.sq_ass_item` slots."
msgstr ""

#: c-api/typeobj.rst:2133
msgid ""
"This function is used by :c:func:`PySequence_Concat` and has the same "
"signature.  It is also used by the ``+`` operator, after trying the numeric "
"addition via the :c:member:`~PyNumberMethods.nb_add` slot."
msgstr ""

#: c-api/typeobj.rst:2139
msgid ""
"This function is used by :c:func:`PySequence_Repeat` and has the same "
"signature.  It is also used by the ``*`` operator, after trying numeric "
"multiplication via the :c:member:`~PyNumberMethods.nb_multiply` slot."
msgstr ""

#: c-api/typeobj.rst:2145
msgid ""
"This function is used by :c:func:`PySequence_GetItem` and has the same "
"signature.  It is also used by :c:func:`PyObject_GetItem`, after trying the "
"subscription via the :c:member:`~PyMappingMethods.mp_subscript` slot. This "
"slot must be filled for the :c:func:`PySequence_Check` function to return "
"``1``, it can be ``NULL`` otherwise."
msgstr ""

#: c-api/typeobj.rst:2151
msgid ""
"Negative indexes are handled as follows: if the :attr:`sq_length` slot is "
"filled, it is called and the sequence length is used to compute a positive "
"index which is passed to :attr:`sq_item`.  If :attr:`sq_length` is ``NULL``, "
"the index is passed as is to the function."
msgstr ""

#: c-api/typeobj.rst:2158
msgid ""
"This function is used by :c:func:`PySequence_SetItem` and has the same "
"signature.  It is also used by :c:func:`PyObject_SetItem` and :c:func:"
"`PyObject_DelItem`, after trying the item assignment and deletion via the :c:"
"member:`~PyMappingMethods.mp_ass_subscript` slot. This slot may be left to "
"``NULL`` if the object does not support item assignment and deletion."
msgstr ""

#: c-api/typeobj.rst:2167
msgid ""
"This function may be used by :c:func:`PySequence_Contains` and has the same "
"signature.  This slot may be left to ``NULL``, in this case :c:func:`!"
"PySequence_Contains` simply traverses the sequence until it finds a match."
msgstr ""

#: c-api/typeobj.rst:2174
msgid ""
"This function is used by :c:func:`PySequence_InPlaceConcat` and has the same "
"signature.  It should modify its first operand, and return it.  This slot "
"may be left to ``NULL``, in this case :c:func:`!PySequence_InPlaceConcat` "
"will fall back to :c:func:`PySequence_Concat`.  It is also used by the "
"augmented assignment ``+=``, after trying numeric in-place addition via the :"
"c:member:`~PyNumberMethods.nb_inplace_add` slot."
msgstr ""

#: c-api/typeobj.rst:2183
msgid ""
"This function is used by :c:func:`PySequence_InPlaceRepeat` and has the same "
"signature.  It should modify its first operand, and return it.  This slot "
"may be left to ``NULL``, in this case :c:func:`!PySequence_InPlaceRepeat` "
"will fall back to :c:func:`PySequence_Repeat`.  It is also used by the "
"augmented assignment ``*=``, after trying numeric in-place multiplication "
"via the :c:member:`~PyNumberMethods.nb_inplace_multiply` slot."
msgstr ""

#: c-api/typeobj.rst:2194
msgid "Buffer Object Structures"
msgstr ""

#: c-api/typeobj.rst:2202
msgid ""
"This structure holds pointers to the functions required by the :ref:`Buffer "
"protocol <bufferobjects>`. The protocol defines how an exporter object can "
"expose its internal data to consumer objects."
msgstr ""

#: c-api/typeobj.rst:2208 c-api/typeobj.rst:2257 c-api/typeobj.rst:2310
#: c-api/typeobj.rst:2321 c-api/typeobj.rst:2332
msgid "The signature of this function is::"
msgstr ""

#: c-api/typeobj.rst:2212
msgid ""
"Handle a request to *exporter* to fill in *view* as specified by *flags*. "
"Except for point (3), an implementation of this function MUST take these "
"steps:"
msgstr ""

#: c-api/typeobj.rst:2216
msgid ""
"Check if the request can be met. If not, raise :c:data:`PyExc_BufferError`, "
"set :c:data:`view->obj` to ``NULL`` and return ``-1``."
msgstr ""

#: c-api/typeobj.rst:2219
msgid "Fill in the requested fields."
msgstr ""

#: c-api/typeobj.rst:2221
msgid "Increment an internal counter for the number of exports."
msgstr ""

#: c-api/typeobj.rst:2223
msgid ""
"Set :c:data:`view->obj` to *exporter* and increment :c:data:`view->obj`."
msgstr ""

#: c-api/typeobj.rst:2225
msgid "Return ``0``."
msgstr ""

#: c-api/typeobj.rst:2227
msgid ""
"If *exporter* is part of a chain or tree of buffer providers, two main "
"schemes can be used:"
msgstr ""

#: c-api/typeobj.rst:2230
msgid ""
"Re-export: Each member of the tree acts as the exporting object and sets :c:"
"data:`view->obj` to a new reference to itself."
msgstr ""

#: c-api/typeobj.rst:2233
msgid ""
"Redirect: The buffer request is redirected to the root object of the tree. "
"Here, :c:data:`view->obj` will be a new reference to the root object."
msgstr ""

#: c-api/typeobj.rst:2237
msgid ""
"The individual fields of *view* are described in section :ref:`Buffer "
"structure <buffer-structure>`, the rules how an exporter must react to "
"specific requests are in section :ref:`Buffer request types <buffer-request-"
"types>`."
msgstr ""

#: c-api/typeobj.rst:2242
msgid ""
"All memory pointed to in the :c:type:`Py_buffer` structure belongs to the "
"exporter and must remain valid until there are no consumers left. :c:member:"
"`~Py_buffer.format`, :c:member:`~Py_buffer.shape`, :c:member:`~Py_buffer."
"strides`, :c:member:`~Py_buffer.suboffsets` and :c:member:`~Py_buffer."
"internal` are read-only for the consumer."
msgstr ""

#: c-api/typeobj.rst:2249
msgid ""
":c:func:`PyBuffer_FillInfo` provides an easy way of exposing a simple bytes "
"buffer while dealing correctly with all request types."
msgstr ""

#: c-api/typeobj.rst:2252
msgid ""
":c:func:`PyObject_GetBuffer` is the interface for the consumer that wraps "
"this function."
msgstr ""

#: c-api/typeobj.rst:2261
msgid ""
"Handle a request to release the resources of the buffer. If no resources "
"need to be released, :c:member:`PyBufferProcs.bf_releasebuffer` may be "
"``NULL``. Otherwise, a standard implementation of this function will take "
"these optional steps:"
msgstr ""

#: c-api/typeobj.rst:2266
msgid "Decrement an internal counter for the number of exports."
msgstr ""

#: c-api/typeobj.rst:2268
msgid "If the counter is ``0``, free all memory associated with *view*."
msgstr ""

#: c-api/typeobj.rst:2270
msgid ""
"The exporter MUST use the :c:member:`~Py_buffer.internal` field to keep "
"track of buffer-specific resources. This field is guaranteed to remain "
"constant, while a consumer MAY pass a copy of the original buffer as the "
"*view* argument."
msgstr ""

#: c-api/typeobj.rst:2276
msgid ""
"This function MUST NOT decrement :c:data:`view->obj`, since that is done "
"automatically in :c:func:`PyBuffer_Release` (this scheme is useful for "
"breaking reference cycles)."
msgstr ""

#: c-api/typeobj.rst:2281
msgid ""
":c:func:`PyBuffer_Release` is the interface for the consumer that wraps this "
"function."
msgstr ""

#: c-api/typeobj.rst:2289
msgid "Async Object Structures"
msgstr ""

#: c-api/typeobj.rst:2297
msgid ""
"This structure holds pointers to the functions required to implement :term:"
"`awaitable` and :term:`asynchronous iterator` objects."
msgstr ""

#: c-api/typeobj.rst:2314
msgid ""
"The returned object must be an iterator, i.e. :c:func:`PyIter_Check` must "
"return ``1`` for it."
msgstr ""

#: c-api/typeobj.rst:2317
msgid ""
"This slot may be set to ``NULL`` if an object is not an :term:`awaitable`."
msgstr ""

#: c-api/typeobj.rst:2325
msgid ""
"Must return an :term:`awaitable` object.  See :meth:`__anext__` for details."
msgstr ""

#: c-api/typeobj.rst:2327
msgid ""
"This slot may be set to ``NULL`` if an object does not implement "
"asynchronous iteration protocol."
msgstr ""

#: c-api/typeobj.rst:2336
msgid ""
"Must return an :term:`awaitable` object.  See :meth:`__anext__` for details. "
"This slot may be set to ``NULL``."
msgstr ""

#: c-api/typeobj.rst:2343
msgid "Slot Type typedefs"
msgstr ""

#: c-api/typeobj.rst:2347
msgid ""
"The purpose of this function is to separate memory allocation from memory "
"initialization.  It should return a pointer to a block of memory of adequate "
"length for the instance, suitably aligned, and initialized to zeros, but "
"with :attr:`ob_refcnt` set to ``1`` and :attr:`ob_type` set to the type "
"argument.  If the type's :c:member:`~PyTypeObject.tp_itemsize` is non-zero, "
"the object's :attr:`ob_size` field should be initialized to *nitems* and the "
"length of the allocated memory block should be ``tp_basicsize + "
"nitems*tp_itemsize``, rounded up to a multiple of ``sizeof(void*)``; "
"otherwise, *nitems* is not used and the length of the block should be :c:"
"member:`~PyTypeObject.tp_basicsize`."
msgstr ""

#: c-api/typeobj.rst:2357
msgid ""
"This function should not do any other instance initialization, not even to "
"allocate additional memory; that should be done by :c:member:`~PyTypeObject."
"tp_new`."
msgstr ""

#: c-api/typeobj.rst:2364
msgid "See :c:member:`~PyTypeObject.tp_free`."
msgstr ""

#: c-api/typeobj.rst:2368
msgid "See :c:member:`~PyTypeObject.tp_new`."
msgstr ""

#: c-api/typeobj.rst:2372
msgid "See :c:member:`~PyTypeObject.tp_init`."
msgstr ""

#: c-api/typeobj.rst:2376
msgid "See :c:member:`~PyTypeObject.tp_repr`."
msgstr ""

#: c-api/typeobj.rst:2380 c-api/typeobj.rst:2389
msgid "Return the value of the named attribute for the object."
msgstr ""

#: c-api/typeobj.rst:2384 c-api/typeobj.rst:2395
msgid ""
"Set the value of the named attribute for the object. The value argument is "
"set to ``NULL`` to delete the attribute."
msgstr ""

#: c-api/typeobj.rst:2391
msgid "See :c:member:`~PyTypeObject.tp_getattro`."
msgstr ""

#: c-api/typeobj.rst:2398
msgid "See :c:member:`~PyTypeObject.tp_setattro`."
msgstr ""

#: c-api/typeobj.rst:2402
msgid "See :c:member:`~PyTypeObject.tp_descrget`."
msgstr ""

#: c-api/typeobj.rst:2406
msgid "See :c:member:`~PyTypeObject.tp_descrset`."
msgstr ""

#: c-api/typeobj.rst:2410
msgid "See :c:member:`~PyTypeObject.tp_hash`."
msgstr ""

#: c-api/typeobj.rst:2414
msgid "See :c:member:`~PyTypeObject.tp_richcompare`."
msgstr ""

#: c-api/typeobj.rst:2418
msgid "See :c:member:`~PyTypeObject.tp_iter`."
msgstr ""

#: c-api/typeobj.rst:2422
msgid "See :c:member:`~PyTypeObject.tp_iternext`."
msgstr ""

#: c-api/typeobj.rst:2448
msgid "Examples"
msgstr "Exemples"

#: c-api/typeobj.rst:2450
msgid ""
"The following are simple examples of Python type definitions.  They include "
"common usage you may encounter.  Some demonstrate tricky corner cases.  For "
"more examples, practical info, and a tutorial, see :ref:`defining-new-types` "
"and :ref:`new-types-topics`."
msgstr ""

#: c-api/typeobj.rst:2455
msgid "A basic static type::"
msgstr ""

#: c-api/typeobj.rst:2472
msgid ""
"You may also find older code (especially in the CPython code base) with a "
"more verbose initializer::"
msgstr ""

#: c-api/typeobj.rst:2516
msgid "A type that supports weakrefs, instance dicts, and hashing::"
msgstr ""

#: c-api/typeobj.rst:2543
msgid ""
"A str subclass that cannot be subclassed and cannot be called to create "
"instances (e.g. uses a separate factory func)::"
msgstr ""

#: c-api/typeobj.rst:2562
msgid "The simplest static type (with fixed-length instances)::"
msgstr ""

#: c-api/typeobj.rst:2573
msgid "The simplest static type (with variable-length instances)::"
msgstr ""