Objetos MemoryView

Um objeto memoryview expõe a interface de buffer a nível de C como um objeto Python que pode ser passado como qualquer outro objeto.

PyObject *PyMemoryView_FromObject(PyObject *obj)

Retorna valor: Nova referência. Parte da ABI Estável.

Cria um objeto memoryview a partir de um objeto que fornece a interface do buffer. Se obj tiver suporte a exportações de buffer graváveis, o objeto memoryview será de leitura/gravação; caso contrário, poderá ser somente leitura ou leitura/gravação, a critério do exportador.

PyBUF_READ

Sinalizador para solicitar um buffer de somente leitura.

PyBUF_WRITE

Sinalizador para solicitar um buffer gravável.

PyObject *PyMemoryView_FromMemory(char *mem, Py_ssize_t size, int flags)

Retorna valor: Nova referência. Parte da ABI Estável desde a versão 3.7.

Cria um objeto memoryview usando mem como o buffer subjacente. flags pode ser um dos seguintes PyBUF_READ ou PyBUF_WRITE.

Adicionado na versão 3.3.

PyObject *PyMemoryView_FromBuffer(const Py_buffer *view)

Retorna valor: Nova referência. Parte da ABI Estável desde a versão 3.11.

Cria um objeto de memoryview envolvendo a estrutura de buffer view fornecida. Para buffers de bytes simples, PyMemoryView_FromMemory() é a função preferida.

PyObject *PyMemoryView_GetContiguous(PyObject *obj, int buffertype, char order)

Retorna valor: Nova referência. Parte da ABI Estável.

Cria um objeto memoryview para um pedaço contíguo de memória (na ordem ‘C’ ou ‘F’ortran, representada por order) a partir de um objeto que define a interface do buffer. Se a memória for contígua, o objeto memoryview apontará para a memória original. Caso contrário, é feita uma cópia e a visualização da memória aponta para um novo objeto bytes.

buffertype pode ser um entre PyBUF_READ ou PyBUF_WRITE.

int PyMemoryView_Check(PyObject *obj)

Retorna true se o objeto obj for um objeto memoryview. Atualmente, não é permitido criar subclasses de memoryview. Esta função sempre tem sucesso.

Py_buffer *PyMemoryView_GET_BUFFER(PyObject *mview)

Retorna um ponteiro para a cópia privada da memória do buffer do exportador. mview deve ser uma instância de memoryview; Se essa macro não verificar seu tipo, faça você mesmo ou corre o risco de travar.

PyObject *PyMemoryView_GET_BASE(PyObject *mview)

Retorna um ponteiro para o objeto de exportação no qual a memória é baseada ou NULL se a memória tiver sido criada por uma das funções PyMemoryView_FromMemory() ou PyMemoryView_FromBuffer(). mview deve ser uma instância de memoryview.