objbuffer.md

1> **Источник:** https://python-all.ru/3.3/c-api/objbuffer.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Старый буферный протокол89Устарело с версии 3.0.1011Эти функции были частью API «старого буферного протокола» в Python 2. В Python 3 этот протокол больше не существует, но функции всё ещё доступны для упрощения переноса кода из версии 2.x. Они работают как обёртка для совместимости вокруг [*нового буферного протокола*](https://python-all.ru/3.3/c-api/buffer.html#bufferobjects), но не дают контроля над временем жизни ресурсов, захваченных при экспорте буфера.1213Поэтому рекомендуется вызывать [`PyObject_GetBuffer()`](https://python-all.ru/3.3/c-api/buffer.html#PyObject_GetBuffer) (или `y*` или `w*` [*коды формата*](https://python-all.ru/3.3/c-api/arg.html#arg-parsing) с помощью [`PyArg_ParseTuple()`](https://python-all.ru/3.3/c-api/arg.html#PyArg_ParseTuple)) для получения буферного представления объекта и [`PyBuffer_Release()`](https://python-all.ru/3.3/c-api/buffer.html#PyBuffer_Release), когда это представление можно освободить.1415#### `int PyObject_AsCharBuffer(PyObject *obj, const char **buffer, Py_ssize_t *buffer_len)`1617Возвращает указатель на область памяти, доступную только для чтения, пригодную для ввода на основе символов. Аргумент *obj* должен поддерживать интерфейс односегментного символьного буфера. При успехе возвращает `0`, устанавливает *buffer* на область памяти и *buffer\_len* – длину буфера. При ошибке возвращает `-1` и устанавливает [`TypeError`](https://python-all.ru/3.3/library/exceptions.html#TypeError).1819#### `int PyObject_AsReadBuffer(PyObject *obj, const void **buffer, Py_ssize_t *buffer_len)`2021Возвращает указатель на область памяти только для чтения, содержащую произвольные данные. Аргумент *obj* должен поддерживать интерфейс односегментного читаемого буфера. При успехе возвращает `0`, устанавливает *buffer* на область памяти и *buffer\_len* – длину буфера. При ошибке возвращает `-1` и устанавливает [`TypeError`](https://python-all.ru/3.3/library/exceptions.html#TypeError).2223#### `int PyObject_CheckReadBuffer(PyObject *o)`2425Возвращает `1`, если *o* поддерживает интерфейс односегментного читаемого буфера. В противном случае возвращает `0`.2627#### `int PyObject_AsWriteBuffer(PyObject *obj, void **buffer, Py_ssize_t *buffer_len)`2829Возвращает указатель на область памяти, доступную для записи. Аргумент *obj* должен поддерживать интерфейс односегментного символьного буфера. При успехе возвращает `0`, устанавливает *buffer* на область памяти и *buffer\_len* – длину буфера. При ошибке возвращает `-1` и устанавливает [`TypeError`](https://python-all.ru/3.3/library/exceptions.html#TypeError).30