# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001 Python Software Foundation

# This file is distributed under the same license as the Python package.

# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.14\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2026-09-15 09:12+0000\n"

"PO-Revision-Date: 2025-09-16 00:00+0000\n"

"Language-Team: German (https://app.transifex.com/python-doc/teams/5390/de/)\n"

"Language: de\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Plural-Forms: nplurals=2; plural=(n != 1);\n"

#: ../../c-api/structures.rst:6

msgid "Common Object Structures"

msgstr ""

#: ../../c-api/structures.rst:8

msgid ""

"There are a large number of structures which are used in the definition of "

"object types for Python. This section describes these structures and how "

"they are used."

msgstr ""

#: ../../c-api/structures.rst:14

msgid "Base object types and macros"

msgstr ""

#: ../../c-api/structures.rst:16

msgid ""

"All Python objects ultimately share a small number of fields at the "

"beginning of the object's representation in memory. These are represented "

"by the :c:type:`PyObject` and :c:type:`PyVarObject` types, which are "

"defined, in turn, by the expansions of some macros also used, whether "

"directly or indirectly, in the definition of all other Python objects. "

"Additional macros can be found under :ref:`reference counting "

"<countingrefs>`."

msgstr ""

#: ../../c-api/structures.rst:26

msgid ""

"All object types are extensions of this type. This is a type which contains "

"the information Python needs to treat a pointer to an object as an object. "

"In a normal \"release\" build, it contains only the object's reference count "

"and a pointer to the corresponding type object. Nothing is actually declared "

"to be a :c:type:`PyObject`, but every pointer to a Python object can be cast "

"to a :c:expr:`PyObject*`."

msgstr ""

#: ../../c-api/structures.rst:33

msgid ""

"The members must not be accessed directly; instead use macros such as :c:"

"macro:`Py_REFCNT` and :c:macro:`Py_TYPE`."

msgstr ""

#: ../../c-api/structures.rst:38

msgid ""

"The object's reference count, as returned by :c:macro:`Py_REFCNT`. Do not "

"use this field directly; instead use functions and macros such as :c:macro:`!"

"Py_REFCNT`, :c:func:`Py_INCREF` and :c:func:`Py_DecRef`."

msgstr ""

#: ../../c-api/structures.rst:42

msgid ""

"The field type may be different from ``Py_ssize_t``, depending on build "

"configuration and platform."

msgstr ""

#: ../../c-api/structures.rst:47

msgid ""

"The object's type. Do not use this field directly; use :c:macro:`Py_TYPE` "

"and :c:func:`Py_SET_TYPE` instead."

msgstr ""

#: ../../c-api/structures.rst:54

msgid ""

"An extension of :c:type:`PyObject` that adds the :c:member:`~PyVarObject."

"ob_size` field. This is intended for objects that have some notion of "

"*length*."

msgstr ""

#: ../../c-api/structures.rst:58

msgid ""

"As with :c:type:`!PyObject`, the members must not be accessed directly; "

"instead use macros such as :c:macro:`Py_SIZE`, :c:macro:`Py_REFCNT` and :c:"

"macro:`Py_TYPE`."

msgstr ""

#: ../../c-api/structures.rst:64

msgid ""

"A size field, whose contents should be considered an object's internal "

"implementation detail."

msgstr ""

#: ../../c-api/structures.rst:67

msgid "Do not use this field directly; use :c:macro:`Py_SIZE` instead."

msgstr ""

#: ../../c-api/structures.rst:69

msgid ""

"Object creation functions such as :c:func:`PyObject_NewVar` will generally "

"set this field to the requested size (number of items). After creation, "

"arbitrary values can be stored in :c:member:`!ob_size` using :c:macro:"

"`Py_SET_SIZE`."

msgstr ""

#: ../../c-api/structures.rst:74

msgid ""

"To get an object's publicly exposed length, as returned by the Python "

"function :py:func:`len`, use :c:func:`PyObject_Length` instead."

msgstr ""

#: ../../c-api/structures.rst:81

msgid ""

"This is a macro used when declaring new types which represent objects "

"without a varying length. The PyObject_HEAD macro expands to::"

msgstr ""

#: ../../c-api/structures.rst:84

msgid "PyObject ob_base;"

msgstr ""

#: ../../c-api/structures.rst:86

msgid "See documentation of :c:type:`PyObject` above."

msgstr ""

#: ../../c-api/structures.rst:91

msgid ""

"This is a macro used when declaring new types which represent objects with a "

"length that varies from instance to instance. The PyObject_VAR_HEAD macro "

"expands to::"

msgstr ""

#: ../../c-api/structures.rst:95

msgid "PyVarObject ob_base;"

msgstr ""

#: ../../c-api/structures.rst:97

msgid "See documentation of :c:type:`PyVarObject` above."

msgstr ""

#: ../../c-api/structures.rst:102

msgid ""

"The base class of all other objects, the same as :class:`object` in Python."

msgstr ""

#: ../../c-api/structures.rst:107

msgid ""

"Test if the *x* object is the *y* object, the same as ``x is y`` in Python."

msgstr ""

#: ../../c-api/structures.rst:114

msgid ""

"Test if an object is the ``None`` singleton, the same as ``x is None`` in "

"Python."

msgstr ""

#: ../../c-api/structures.rst:122

msgid ""

"Test if an object is the ``True`` singleton, the same as ``x is True`` in "

"Python."

msgstr ""

#: ../../c-api/structures.rst:130

msgid ""

"Test if an object is the ``False`` singleton, the same as ``x is False`` in "

"Python."

msgstr ""

#: ../../c-api/structures.rst:138

msgid "Get the type of the Python object *o*."

msgstr ""

#: ../../c-api/structures.rst:140

msgid ""

"The returned reference is :term:`borrowed <borrowed reference>` from *o*. Do "

"not release it with :c:func:`Py_DECREF` or similar."

msgstr ""

#: ../../c-api/structures.rst:143

msgid ""

":c:func:`Py_TYPE()` is changed to an inline static function. The parameter "

"type is no longer :c:expr:`const PyObject*`."

msgstr ""

#: ../../c-api/structures.rst:150

msgid ""

"Return non-zero if the object *o* type is *type*. Return zero otherwise. "

"Equivalent to: ``Py_TYPE(o) == type``."

msgstr ""

#: ../../c-api/structures.rst:158

msgid ""

"Set the type of object *o* to *type*, without any checking or reference "

"counting."

msgstr ""

#: ../../c-api/structures.rst:161

msgid ""

"This is a very low-level operation. Consider instead setting the Python "

"attribute :attr:`~object.__class__` using :c:func:`PyObject_SetAttrString` "

"or similar."

msgstr ""

#: ../../c-api/structures.rst:165

msgid ""

"Note that assigning an incompatible type can lead to undefined behavior."

msgstr ""

#: ../../c-api/structures.rst:167

msgid ""

"If *type* is a :ref:`heap type <heap-types>`, the caller must create a new "

"reference to it. Similarly, if the old type of *o* is a heap type, the "

"caller must release a reference to that type."

msgstr ""

#: ../../c-api/structures.rst:177

msgid "Get the :c:member:`~PyVarObject.ob_size` field of *o*."

msgstr ""

#: ../../c-api/structures.rst:179

msgid ""

":c:func:`Py_SIZE()` is changed to an inline static function. The parameter "

"type is no longer :c:expr:`const PyVarObject*`."

msgstr ""

#: ../../c-api/structures.rst:186

msgid "Set the :c:member:`~PyVarObject.ob_size` field of *o* to *size*."

msgstr ""

#: ../../c-api/structures.rst:193

msgid ""

"This is a macro which expands to initialization values for a new :c:type:"

"`PyObject` type. This macro expands to::"

msgstr ""

#: ../../c-api/structures.rst:196

msgid ""

"_PyObject_EXTRA_INIT\n"

"1, type,"

msgstr ""

#: ../../c-api/structures.rst:202

msgid ""

"This is a macro which expands to initialization values for a new :c:type:"

"`PyVarObject` type, including the :c:member:`~PyVarObject.ob_size` field. "

"This macro expands to::"

msgstr ""

#: ../../c-api/structures.rst:206

msgid ""

"_PyObject_EXTRA_INIT\n"

"1, type, size,"

msgstr ""

#: ../../c-api/structures.rst:211

msgid "Implementing functions and methods"

msgstr ""

#: ../../c-api/structures.rst:215

msgid ""

"Type of the functions used to implement most Python callables in C. "

"Functions of this type take two :c:expr:`PyObject*` parameters and return "

"one such value. If the return value is ``NULL``, an exception shall have "

"been set. If not ``NULL``, the return value is interpreted as the return "

"value of the function as exposed in Python. The function must return a new "

"reference."

msgstr ""

#: ../../c-api/structures.rst:222

msgid "The function signature is::"

msgstr ""

#: ../../c-api/structures.rst:224

msgid ""

"PyObject *PyCFunction(PyObject *self,\n"

" PyObject *args);"

msgstr ""

#: ../../c-api/structures.rst:229

msgid ""

"Type of the functions used to implement Python callables in C with "

"signature :ref:`METH_VARARGS | METH_KEYWORDS <METH_VARARGS-METH_KEYWORDS>`. "

"The function signature is::"

msgstr ""

#: ../../c-api/structures.rst:233

msgid ""

"PyObject *PyCFunctionWithKeywords(PyObject *self,\n"

" PyObject *args,\n"

" PyObject *kwargs);"

msgstr ""

#: ../../c-api/structures.rst:240

msgid ""

"Type of the functions used to implement Python callables in C with "

"signature :c:macro:`METH_FASTCALL`. The function signature is::"

msgstr ""

#: ../../c-api/structures.rst:244

msgid ""

"PyObject *PyCFunctionFast(PyObject *self,\n"

" PyObject *const *args,\n"

" Py_ssize_t nargs);"

msgstr ""

#: ../../c-api/structures.rst:250

msgid ""

"Type of the functions used to implement Python callables in C with "

"signature :ref:`METH_FASTCALL | METH_KEYWORDS <METH_FASTCALL-"

"METH_KEYWORDS>`. The function signature is::"

msgstr ""

#: ../../c-api/structures.rst:254

msgid ""

"PyObject *PyCFunctionFastWithKeywords(PyObject *self,\n"

" PyObject *const *args,\n"

" Py_ssize_t nargs,\n"

" PyObject *kwnames);"

msgstr ""

#: ../../c-api/structures.rst:261

msgid ""

"Type of the functions used to implement Python callables in C with "

"signature :ref:`METH_METHOD | METH_FASTCALL | METH_KEYWORDS <METH_METHOD-"

"METH_FASTCALL-METH_KEYWORDS>`. The function signature is::"

msgstr ""

#: ../../c-api/structures.rst:265

msgid ""

"PyObject *PyCMethod(PyObject *self,\n"

" PyTypeObject *defining_class,\n"

" PyObject *const *args,\n"

" Py_ssize_t nargs,\n"

" PyObject *kwnames)"

msgstr ""

#: ../../c-api/structures.rst:276

msgid ""

"Structure used to describe a method of an extension type. This structure "

"has four fields:"

msgstr ""

#: ../../c-api/structures.rst:281

msgid "Name of the method."

msgstr ""

#: ../../c-api/structures.rst:285

msgid "Pointer to the C implementation."

msgstr ""

#: ../../c-api/structures.rst:289

msgid "Flags bits indicating how the call should be constructed."

msgstr ""

#: ../../c-api/structures.rst:293

msgid "Points to the contents of the docstring."

msgstr ""

#: ../../c-api/structures.rst:295

msgid ""

"The :c:member:`~PyMethodDef.ml_meth` is a C function pointer. The functions "

"may be of different types, but they always return :c:expr:`PyObject*`. If "

"the function is not of the :c:type:`PyCFunction`, the compiler will require "

"a cast in the method table. Even though :c:type:`PyCFunction` defines the "

"first parameter as :c:expr:`PyObject*`, it is common that the method "

"implementation uses the specific C type of the *self* object."

msgstr ""

#: ../../c-api/structures.rst:303

msgid ""

"The :c:member:`~PyMethodDef.ml_flags` field is a bitfield which can include "

"the following flags. The individual flags indicate either a calling "

"convention or a binding convention."

msgstr ""

#: ../../c-api/structures.rst:308

msgid "There are these calling conventions:"

msgstr ""

#: ../../c-api/structures.rst:312

msgid ""

"This is the typical calling convention, where the methods have the type :c:"

"type:`PyCFunction`. The function expects two :c:expr:`PyObject*` values. The "

"first one is the *self* object for methods; for module functions, it is the "

"module object. The second parameter (often called *args*) is a tuple object "

"representing all arguments. This parameter is typically processed using :c:"

"func:`PyArg_ParseTuple` or :c:func:`PyArg_UnpackTuple`."

msgstr ""

#: ../../c-api/structures.rst:322

msgid ""

"Can only be used in certain combinations with other flags: :ref:"

"`METH_VARARGS | METH_KEYWORDS <METH_VARARGS-METH_KEYWORDS>`, :ref:"

"`METH_FASTCALL | METH_KEYWORDS <METH_FASTCALL-METH_KEYWORDS>` and :ref:"

"`METH_METHOD | METH_FASTCALL | METH_KEYWORDS <METH_METHOD-METH_FASTCALL-"

"METH_KEYWORDS>`."

msgstr ""

#: ../../c-api/structures.rst:330

msgid ":c:expr:`METH_VARARGS | METH_KEYWORDS`"

msgstr ""

#: ../../c-api/structures.rst:331

msgid ""

"Methods with these flags must be of type :c:type:`PyCFunctionWithKeywords`. "

"The function expects three parameters: *self*, *args*, *kwargs* where "

"*kwargs* is a dictionary of all the keyword arguments or possibly ``NULL`` "

"if there are no keyword arguments. The parameters are typically processed "

"using :c:func:`PyArg_ParseTupleAndKeywords`."

msgstr ""

#: ../../c-api/structures.rst:340

msgid ""

"Fast calling convention supporting only positional arguments. The methods "

"have the type :c:type:`PyCFunctionFast`. The first parameter is *self*, the "

"second parameter is a C array of :c:expr:`PyObject*` values indicating the "

"arguments and the third parameter is the number of arguments (the length of "

"the array)."

msgstr ""

#: ../../c-api/structures.rst:350

msgid "``METH_FASTCALL`` is now part of the :ref:`stable ABI <stable-abi>`."

msgstr ""

#: ../../c-api/structures.rst:355

msgid ":c:expr:`METH_FASTCALL | METH_KEYWORDS`"

msgstr ""

#: ../../c-api/structures.rst:356

msgid ""

"Extension of :c:macro:`METH_FASTCALL` supporting also keyword arguments, "

"with methods of type :c:type:`PyCFunctionFastWithKeywords`. Keyword "

"arguments are passed the same way as in the :ref:`vectorcall protocol "

"<vectorcall>`: there is an additional fourth :c:expr:`PyObject*` parameter "

"which is a tuple representing the names of the keyword arguments (which are "

"guaranteed to be strings) or possibly ``NULL`` if there are no keywords. "

"The values of the keyword arguments are stored in the *args* array, after "

"the positional arguments."

msgstr ""

#: ../../c-api/structures.rst:371

msgid ""

"Can only be used in the combination with other flags: :ref:`METH_METHOD | "

"METH_FASTCALL | METH_KEYWORDS <METH_METHOD-METH_FASTCALL-METH_KEYWORDS>`."

msgstr ""

#: ../../c-api/structures.rst:377

msgid ":c:expr:`METH_METHOD | METH_FASTCALL | METH_KEYWORDS`"

msgstr ""

#: ../../c-api/structures.rst:378

msgid ""

"Extension of :ref:`METH_FASTCALL | METH_KEYWORDS <METH_FASTCALL-"

"METH_KEYWORDS>` supporting the *defining class*, that is, the class that "

"contains the method in question. The defining class might be a superclass of "

"``Py_TYPE(self)``."

msgstr ""

#: ../../c-api/structures.rst:383

msgid ""

"The method needs to be of type :c:type:`PyCMethod`, the same as for "

"``METH_FASTCALL | METH_KEYWORDS`` with ``defining_class`` argument added "

"after ``self``."

msgstr ""

#: ../../c-api/structures.rst:392

msgid ""

"Methods without parameters don't need to check whether arguments are given "

"if they are listed with the :c:macro:`METH_NOARGS` flag. They need to be of "

"type :c:type:`PyCFunction`. The first parameter is typically named *self* "

"and will hold a reference to the module or object instance. In all cases "

"the second parameter will be ``NULL``."

msgstr ""

#: ../../c-api/structures.rst:398

msgid ""

"The function must have 2 parameters. Since the second parameter is unused, :"

"c:macro:`Py_UNUSED` can be used to prevent a compiler warning."

msgstr ""

#: ../../c-api/structures.rst:404

msgid ""

"Methods with a single object argument can be listed with the :c:macro:"

"`METH_O` flag, instead of invoking :c:func:`PyArg_ParseTuple` with a "

"``\"O\"`` argument. They have the type :c:type:`PyCFunction`, with the "

"*self* parameter, and a :c:expr:`PyObject*` parameter representing the "

"single argument."

msgstr ""

#: ../../c-api/structures.rst:410

msgid ""

"These two constants are not used to indicate the calling convention but the "

"binding when used with methods of classes. These may not be used for "

"functions defined for modules. At most one of these flags may be set for "

"any given method."

msgstr ""

#: ../../c-api/structures.rst:420

msgid ""

"The method will be passed the type object as the first parameter rather than "

"an instance of the type. This is used to create *class methods*, similar to "

"what is created when using the :deco:`classmethod` built-in decorator."

msgstr ""

#: ../../c-api/structures.rst:430

msgid ""

"The method will be passed ``NULL`` as the first parameter rather than an "

"instance of the type. This is used to create *static methods*, similar to "

"what is created when using the :deco:`staticmethod` built-in decorator."

msgstr ""

#: ../../c-api/structures.rst:434

msgid ""

"One other constant controls whether a method is loaded in place of another "

"definition with the same method name."

msgstr ""

#: ../../c-api/structures.rst:440

msgid ""

"The method will be loaded in place of existing definitions. Without "

"*METH_COEXIST*, the default is to skip repeated definitions. Since slot "

"wrappers are loaded before the method table, the existence of a "

"*sq_contains* slot, for example, would generate a wrapped method named :meth:"

"`~object.__contains__` and preclude the loading of a corresponding "

"PyCFunction with the same name. With the flag defined, the PyCFunction will "

"be loaded in place of the wrapper object and will co-exist with the slot. "

"This is helpful because calls to PyCFunctions are optimized more than "

"wrapper object calls."

msgstr ""

#: ../../c-api/structures.rst:453

msgid ""

"The type object corresponding to Python C method objects. This is available "

"as :class:`types.BuiltinMethodType` in the Python layer."

msgstr ""

#: ../../c-api/structures.rst:459

msgid ""

"Return true if *op* is an instance of the :c:type:`PyCMethod_Type` type or a "

"subtype of it. This function always succeeds."

msgstr ""

#: ../../c-api/structures.rst:465

msgid ""

"This is the same as :c:func:`PyCMethod_Check`, but does not account for "

"subtypes."

msgstr ""

#: ../../c-api/structures.rst:471

msgid ""

"Turn *ml* into a Python :term:`callable` object. The caller must ensure that "

"*ml* outlives the :term:`callable`. Typically, *ml* is defined as a static "

"variable."

msgstr ""

#: ../../c-api/structures.rst:475

msgid ""

"The *self* parameter will be passed as the *self* argument to the C function "

"in ``ml->ml_meth`` when invoked. *self* can be ``NULL``."

msgstr ""

#: ../../c-api/structures.rst:479

msgid ""

"The :term:`callable` object's ``__module__`` attribute can be set from the "

"given *module* argument. *module* should be a Python string, which will be "

"used as name of the module the function is defined in. If unavailable, it "

"can be set to :const:`None` or ``NULL``."

msgstr ""

#: ../../c-api/structures.rst:485

msgid ":attr:`function.__module__`"

msgstr ""

#: ../../c-api/structures.rst:487

msgid ""

"The *cls* parameter will be passed as the *defining_class* argument to the C "

"function. Must be set if :c:macro:`METH_METHOD` is set on ``ml->ml_flags``."

msgstr ""

#: ../../c-api/structures.rst:496

msgid ""

"The type object corresponding to Python C function objects. This is "

"available as :class:`types.BuiltinFunctionType` in the Python layer."

msgstr ""

#: ../../c-api/structures.rst:502

msgid ""

"Return true if *op* is an instance of the :c:type:`PyCFunction_Type` type or "

"a subtype of it. This function always succeeds."

msgstr ""

#: ../../c-api/structures.rst:508

msgid ""

"This is the same as :c:func:`PyCFunction_Check`, but does not account for "

"subtypes."

msgstr ""

#: ../../c-api/structures.rst:514

msgid "Equivalent to ``PyCMethod_New(ml, self, module, NULL)``."

msgstr ""

#: ../../c-api/structures.rst:519

msgid "Equivalent to ``PyCMethod_New(ml, self, NULL, NULL)``."

msgstr ""

#: ../../c-api/structures.rst:524

msgid ""

"Get the function's flags on *func* as they were passed to :c:member:"

"`~PyMethodDef.ml_flags`."

msgstr ""

#: ../../c-api/structures.rst:527 ../../c-api/structures.rst:545

#: ../../c-api/structures.rst:565

msgid ""

"If *func* is not a C function object, this fails with an exception. *func* "

"must not be ``NULL``."

msgstr ""

#: ../../c-api/structures.rst:530

msgid ""

"This function returns the function's flags on success, and ``-1`` with an "

"exception set on failure."

msgstr ""

#: ../../c-api/structures.rst:536

msgid ""

"This is the same as :c:func:`PyCFunction_GetFlags`, but without error or "

"type checking."

msgstr ""

#: ../../c-api/structures.rst:542

msgid ""

"Get the function pointer on *func* as it was passed to :c:member:"

"`~PyMethodDef.ml_meth`."

msgstr ""

#: ../../c-api/structures.rst:548

msgid ""

"This function returns the function pointer on success, and ``NULL`` with an "

"exception set on failure."

msgstr ""

#: ../../c-api/structures.rst:554

msgid ""

"This is the same as :c:func:`PyCFunction_GetFunction`, but without error or "

"type checking."

msgstr ""

#: ../../c-api/structures.rst:560

msgid ""

"Get the \"self\" object on *func*. This is the object that would be passed "

"to the first argument of a :c:type:`PyCFunction`. For C function objects "

"created through a :c:type:`PyMethodDef` on a :c:type:`PyModuleDef`, this is "

"the resulting module object."

msgstr ""

#: ../../c-api/structures.rst:568

msgid ""

"This function returns a :term:`borrowed reference` to the \"self\" object on "

"success, and ``NULL`` with an exception set on failure."

msgstr ""

#: ../../c-api/structures.rst:574

msgid ""

"This is the same as :c:func:`PyCFunction_GetSelf`, but without error or type "

"checking."

msgstr ""

#: ../../c-api/structures.rst:579

msgid "Accessing attributes of extension types"

msgstr ""

#: ../../c-api/structures.rst:583

msgid ""

"Structure which describes an attribute of a type which corresponds to a C "

"struct member. When defining a class, put a NULL-terminated array of these "

"structures in the :c:member:`~PyTypeObject.tp_members` slot."

msgstr ""

#: ../../c-api/structures.rst:588

msgid "Its fields are, in order:"

msgstr ""

#: ../../c-api/structures.rst:592

msgid ""

"Name of the member. A NULL value marks the end of a ``PyMemberDef[]`` array."

msgstr ""

#: ../../c-api/structures.rst:595

msgid "The string should be static, no copy is made of it."

msgstr ""

#: ../../c-api/structures.rst:599

msgid ""

"The type of the member in the C struct. See :ref:`PyMemberDef-types` for the "

"possible values."

msgstr ""

#: ../../c-api/structures.rst:604

msgid ""

"The offset in bytes that the member is located on the type’s object struct."

msgstr ""

#: ../../c-api/structures.rst:608

msgid ""

"Zero or more of the :ref:`PyMemberDef-flags`, combined using bitwise OR."

msgstr ""

#: ../../c-api/structures.rst:612

msgid ""

"The docstring, or NULL. The string should be static, no copy is made of it. "

"Typically, it is defined using :c:macro:`PyDoc_STR`."

msgstr ""

#: ../../c-api/structures.rst:616

msgid ""

"By default (when :c:member:`~PyMemberDef.flags` is ``0``), members allow "

"both read and write access. Use the :c:macro:`Py_READONLY` flag for read-"

"only access. Certain types, like :c:macro:`Py_T_STRING`, imply :c:macro:"

"`Py_READONLY`. Only :c:macro:`Py_T_OBJECT_EX` (and legacy :c:macro:"

"`T_OBJECT`) members can be deleted."

msgstr ""

#: ../../c-api/structures.rst:625

msgid ""

"For heap-allocated types (created using :c:func:`PyType_FromSpec` or "

"similar), ``PyMemberDef`` may contain a definition for the special member "

"``\"__vectorcalloffset__\"``, corresponding to :c:member:`~PyTypeObject."

"tp_vectorcall_offset` in type objects. This member must be defined with "

"``Py_T_PYSSIZET``, and either ``Py_READONLY`` or ``Py_READONLY | "

"Py_RELATIVE_OFFSET``. For example::"

msgstr ""

#: ../../c-api/structures.rst:632

msgid ""

"static PyMemberDef spam_type_members[] = {\n"

" {\"__vectorcalloffset__\", Py_T_PYSSIZET,\n"

" offsetof(Spam_object, vectorcall), Py_READONLY},\n"

" {NULL} /* Sentinel */\n"

"};"

msgstr ""

#: ../../c-api/structures.rst:638

msgid "(You may need to ``#include <stddef.h>`` for :c:func:`!offsetof`.)"

msgstr ""

#: ../../c-api/structures.rst:640

msgid ""

"The legacy offsets :c:member:`~PyTypeObject.tp_dictoffset` and :c:member:"

"`~PyTypeObject.tp_weaklistoffset` can be defined similarly using "

"``\"__dictoffset__\"`` and ``\"__weaklistoffset__\"`` members, but "

"extensions are strongly encouraged to use :c:macro:`Py_TPFLAGS_MANAGED_DICT` "

"and :c:macro:`Py_TPFLAGS_MANAGED_WEAKREF` instead."

msgstr ""

#: ../../c-api/structures.rst:648

msgid ""

"``PyMemberDef`` is always available. Previously, it required including "

"``\"structmember.h\"``."

msgstr ""

#: ../../c-api/structures.rst:653

msgid ""

":c:macro:`Py_RELATIVE_OFFSET` is now allowed for "

"``\"__vectorcalloffset__\"``, ``\"__dictoffset__\"`` and "

"``\"__weaklistoffset__\"``."

msgstr ""

#: ../../c-api/structures.rst:659

msgid ""

"Get an attribute belonging to the object at address *obj_addr*. The "

"attribute is described by ``PyMemberDef`` *m*. Returns ``NULL`` on error."

msgstr ""

#: ../../c-api/structures.rst:665

msgid ""

"``PyMember_GetOne`` is always available. Previously, it required including "

"``\"structmember.h\"``."

msgstr ""

#: ../../c-api/structures.rst:670

msgid ""

"Set an attribute belonging to the object at address *obj_addr* to object "

"*o*. The attribute to set is described by ``PyMemberDef`` *m*. Returns "

"``0`` if successful and a negative value on failure."

msgstr ""

#: ../../c-api/structures.rst:676

msgid ""

"``PyMember_SetOne`` is always available. Previously, it required including "

"``\"structmember.h\"``."

msgstr ""

#: ../../c-api/structures.rst:682

msgid "Member flags"

msgstr ""

#: ../../c-api/structures.rst:684

msgid "The following flags can be used with :c:member:`PyMemberDef.flags`:"

msgstr ""

#: ../../c-api/structures.rst:688

msgid "Not writable."

msgstr ""

#: ../../c-api/structures.rst:692

msgid ""

"Emit an ``object.__getattr__`` :ref:`audit event <audit-events>` before "

"reading."

msgstr ""

#: ../../c-api/structures.rst:697

msgid ""

"Indicates that the :c:member:`~PyMemberDef.offset` of this ``PyMemberDef`` "

"entry indicates an offset from the subclass-specific data, rather than from "

"``PyObject``."

msgstr ""

#: ../../c-api/structures.rst:701

msgid ""

"Can only be used as part of the :c:data:`Py_tp_members` :c:type:`slot "

"<PyType_Slot>` when creating a class using negative :c:member:`~PyType_Spec."

"basicsize`. It is mandatory in that case. When setting :c:member:"

"`~PyTypeObject.tp_members` from the slot during class creation, Python "

"clears the flag and sets :c:member:`PyMemberDef.offset` to the offset from "

"the ``PyObject`` struct."

msgstr ""

#: ../../c-api/structures.rst:716

msgid ""

"The :c:macro:`!RESTRICTED`, :c:macro:`!READ_RESTRICTED` and :c:macro:`!"

"WRITE_RESTRICTED` macros available with ``#include \"structmember.h\"`` are "

"deprecated. :c:macro:`!READ_RESTRICTED` and :c:macro:`!RESTRICTED` are "

"equivalent to :c:macro:`Py_AUDIT_READ`; :c:macro:`!WRITE_RESTRICTED` does "

"nothing."

msgstr ""

#: ../../c-api/structures.rst:727

msgid ""

"The :c:macro:`!READONLY` macro was renamed to :c:macro:`Py_READONLY`. The :c:"

"macro:`!PY_AUDIT_READ` macro was renamed with the ``Py_`` prefix. The new "

"names are now always available. Previously, these required ``#include "

"\"structmember.h\"``. The header is still available and it provides the old "

"names."

msgstr ""

#: ../../c-api/structures.rst:736

msgid "Member types"

msgstr ""

#: ../../c-api/structures.rst:738

msgid ""

":c:member:`PyMemberDef.type` can be one of the following macros "

"corresponding to various C types. When the member is accessed in Python, it "

"will be converted to the equivalent Python type. When it is set from Python, "

"it will be converted back to the C type. If that is not possible, an "

"exception such as :exc:`TypeError` or :exc:`ValueError` is raised."

msgstr ""

#: ../../c-api/structures.rst:746

msgid ""

"Unless marked (D), attributes defined this way cannot be deleted using e.g. :"

"keyword:`del` or :py:func:`delattr`."

msgstr ""

#: ../../c-api/structures.rst:750

msgid "Macro name"

msgstr ""

#: ../../c-api/structures.rst:750

msgid "C type"

msgstr ""

#: ../../c-api/structures.rst:750

msgid "Python type"

msgstr ""

#: ../../c-api/structures.rst:752

msgid ":c:expr:`char`"

msgstr ""

#: ../../c-api/structures.rst:752 ../../c-api/structures.rst:753

#: ../../c-api/structures.rst:754 ../../c-api/structures.rst:755

#: ../../c-api/structures.rst:756 ../../c-api/structures.rst:757

#: ../../c-api/structures.rst:758 ../../c-api/structures.rst:759

#: ../../c-api/structures.rst:760 ../../c-api/structures.rst:761

#: ../../c-api/structures.rst:762

msgid ":py:class:`int`"

msgstr ""

#: ../../c-api/structures.rst:753

msgid ":c:expr:`short`"

msgstr ""

#: ../../c-api/structures.rst:754

msgid ":c:expr:`int`"

msgstr ""

#: ../../c-api/structures.rst:755

msgid ":c:expr:`long`"

msgstr ""

#: ../../c-api/structures.rst:756

msgid ":c:expr:`long long`"

msgstr ""

#: ../../c-api/structures.rst:757

msgid ":c:expr:`unsigned char`"

msgstr ""

#: ../../c-api/structures.rst:758

msgid ":c:expr:`unsigned int`"

msgstr ""

#: ../../c-api/structures.rst:759

msgid ":c:expr:`unsigned short`"

msgstr ""

#: ../../c-api/structures.rst:760

msgid ":c:expr:`unsigned long`"

msgstr ""

#: ../../c-api/structures.rst:761

msgid ":c:expr:`unsigned long long`"

msgstr ""

#: ../../c-api/structures.rst:762

msgid ":c:expr:`Py_ssize_t`"

msgstr ""

#: ../../c-api/structures.rst:763

msgid ":c:expr:`float`"

msgstr ""

#: ../../c-api/structures.rst:763 ../../c-api/structures.rst:764

msgid ":py:class:`float`"

msgstr ""

#: ../../c-api/structures.rst:764

msgid ":c:expr:`double`"

msgstr ""

#: ../../c-api/structures.rst:765

msgid ":c:expr:`char` (written as 0 or 1)"

msgstr ""

#: ../../c-api/structures.rst:765

msgid ":py:class:`bool`"

msgstr ""

#: ../../c-api/structures.rst:767

msgid ":c:expr:`const char *` (*)"

msgstr ""

#: ../../c-api/structures.rst:767 ../../c-api/structures.rst:768

msgid ":py:class:`str` (RO)"

msgstr ""

#: ../../c-api/structures.rst:768

msgid ":c:expr:`const char[]` (*)"

msgstr ""

#: ../../c-api/structures.rst:769

msgid ":c:expr:`char` (0-127)"

msgstr ""

#: ../../c-api/structures.rst:769

msgid ":py:class:`str` (**)"

msgstr ""

#: ../../c-api/structures.rst:770

msgid ":c:expr:`PyObject *`"

msgstr ""

#: ../../c-api/structures.rst:770

msgid ":py:class:`object` (D)"

msgstr ""

#: ../../c-api/structures.rst:773

msgid ""

"(*): Zero-terminated, UTF8-encoded C string. With :c:macro:`!Py_T_STRING` "

"the C representation is a pointer; with :c:macro:`!Py_T_STRING_INPLACE` the "

"string is stored directly in the structure."

msgstr ""

#: ../../c-api/structures.rst:778

msgid "(**): String of length 1. Only ASCII is accepted."

msgstr ""

#: ../../c-api/structures.rst:780

msgid "(RO): Implies :c:macro:`Py_READONLY`."

msgstr ""