Scribd
Upload
6 views1 page

Managing PyVarObject Allocation

The document outlines functions for allocating and initializing objects on the heap in Python's C API, including _PyObject_New, _PyObject_NewVar, PyObject_Init, and PyObject_InitVar. It describes how these functions manage memory allocation and reference counts for Python objects, as well as the specific use cases for variable-size objects. Additionally, it mentions the PyObject_Del function for deallocating objects and introduces the _Py_NoneStruct object representing 'None' in Python.

Uploaded by

Anupam Tripathi
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as TXT, PDF, TXT or read online on Scribd
6 views1 page

Managing PyVarObject Allocation

The document outlines functions for allocating and initializing objects on the heap in Python's C API, including _PyObject_New, _PyObject_NewVar, PyObject_Init, and PyObject_InitVar. It describes how these functions manage memory allocation and reference counts for Python objects, as well as the specific use cases for variable-size objects. Additionally, it mentions the PyObject_Del function for deallocating objects and introduces the _Py_NoneStruct object representing 'None' in Python.

Uploaded by

Anupam Tripathi
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as TXT, PDF, TXT or read online on Scribd

Allocating Objects on the Heap

******************************

PyObject *_PyObject_New(PyTypeObject *type)


*Return value: New reference.*

PyVarObject *_PyObject_NewVar(PyTypeObject *type, Py_ssize_t size)


*Return value: New reference.*

PyObject *PyObject_Init(PyObject *op, PyTypeObject *type)


*Return value: Borrowed reference.** Part of the Stable ABI.*

Initialize a newly allocated object *op* with its type and initial
reference. Returns the initialized object. Other fields of the
object are not affected.

PyVarObject *PyObject_InitVar(PyVarObject *op, PyTypeObject *type, Py_ssize_t size)


*Return value: Borrowed reference.** Part of the Stable ABI.*

This does everything "PyObject_Init()" does, and also initializes


the length information for a variable-size object.

PyObject_New(TYPE, typeobj)

Allocate a new Python object using the C structure type *TYPE* and
the Python type object *typeobj* ("PyTypeObject*"). Fields not
defined by the Python object header are not initialized. The caller
will own the only reference to the object (i.e. its reference count
will be one). The size of the memory allocation is determined from
the "tp_basicsize" field of the type object.

PyObject_NewVar(TYPE, typeobj, size)

Allocate a new Python object using the C structure type *TYPE* and
the Python type object *typeobj* ("PyTypeObject*"). Fields not
defined by the Python object header are not initialized. The
allocated memory allows for the *TYPE* structure plus *size*
("Py_ssize_t") fields of the size given by the "tp_itemsize" field
of *typeobj*. This is useful for implementing objects like tuples,
which are able to determine their size at construction time.
Embedding the array of fields into the same allocation decreases
the number of allocations, improving the memory management
efficiency.

void PyObject_Del(void *op)

Same as "PyObject_Free()".

PyObject _Py_NoneStruct

Object which is visible in Python as "None". This should only be


accessed using the "Py_None" macro, which evaluates to a pointer to
this object.

See also:

"PyModule_Create()"
To allocate and create extension modules.

You might also like