MemoryView objects

Python documentation

A

memoryview

object exposes the C level

buffer interface

as a Python object which can then be passed around like any other object.

PyObject

*PyMemoryView_FromObject(

PyObject

*obj)

Return value: New reference. Part of the

Stable ABI

.Create a memoryview object from an object that provides the buffer interface. If obj supports writable buffer exports, the memoryview object will be read/write, otherwise it may be either read-only or read/write at the discretion of the exporter.

PyBUF_READ

Flag to request a readonly buffer.

PyBUF_WRITE

Flag to request a writable buffer.

PyObject

*PyMemoryView_FromMemory(char*mem,

Py_ssize_t

size, intflags)

Return value: New reference. Part of the

Stable ABI

since version 3.7.Create a memoryview object using mem as the underlying buffer. flags can be one of

PyBUF_READ

or

PyBUF_WRITE

.

New in version 3.3.

PyObject

*PyMemoryView_FromBuffer(const

Py_buffer

*view)

Return value: New reference. Part of the

Stable ABI

since version 3.11.Create a memoryview object wrapping the given buffer structure view. For simple byte buffers,

PyMemoryView_FromMemory()

is the preferred function.

PyObject

*PyMemoryView_GetContiguous(

PyObject

*obj, intbuffertype, charorder)

Return value: New reference. Part of the

Stable ABI

.Create a memoryview object to a

contiguous

chunk of memory (in either ‘C’ or ‘F’ortran order) from an object that defines the buffer interface. If memory is contiguous, the memoryview object points to the original memory. Otherwise, a copy is made and the memoryview points to a new bytes object.

buffertype can be one of

PyBUF_READ

or

PyBUF_WRITE

.

intPyMemoryView_Check(

PyObject

*obj)

Return true if the object obj is a memoryview object. It is not currently allowed to create subclasses of

memoryview

. This function always succeeds.

Py_buffer

*PyMemoryView_GET_BUFFER(

PyObject

*mview)

Return a pointer to the memoryview’s private copy of the exporter’s buffer. mviewmust be a memoryview instance; this macro doesn’t check its type, you must do it yourself or you will risk crashes.

PyObject

*PyMemoryView_GET_BASE(

PyObject

*mview)

Return either a pointer to the exporting object that the memoryview is based on or NULL if the memoryview has been created by one of the functions

PyMemoryView_FromMemory()

or

PyMemoryView_FromBuffer()

. mviewmust be a memoryview instance.