> **Источник:** https://python-all.ru/3.1/c-api/objbuffer.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# Старый буферный протокол

Устарело с версии 3.0.

Эти функции были частью API «старого буферного протокола» в Python 2. В Python 3 этот протокол больше не существует, но функции всё ещё доступны для упрощения переноса кода из версии 2.x. Они работают как обёртка для совместимости вокруг [*нового буферного протокола*](https://python-all.ru/3.1/c-api/buffer.html#bufferobjects), но не дают контроля над временем жизни ресурсов, захваченных при экспорте буфера.

Поэтому рекомендуется вызывать [`PyObject_GetBuffer()`](https://python-all.ru/3.1/c-api/buffer.html#PyObject_GetBuffer) (или `y*` или `w*` [*коды формата*](https://python-all.ru/3.1/c-api/arg.html#arg-parsing) с помощью [`PyArg_ParseTuple()`](https://python-all.ru/3.1/c-api/arg.html#PyArg_ParseTuple)) для получения буферного представления объекта и [`PyBuffer_Release()`](https://python-all.ru/3.1/c-api/buffer.html#PyBuffer_Release), когда это представление можно освободить.

**int `PyObject_AsCharBuffer`([PyObject](https://python-all.ru/3.1/c-api/structures.html#PyObject) *\*obj*, const char *\*\*buffer*, Py\_ssize\_t *\*buffer\_len*)**

Возвращает указатель на область памяти, доступную только для чтения, пригодную для ввода на основе символов. Аргумент

*obj*

должен поддерживать интерфейс односегментного символьного буфера. При успехе возвращает

`0`

, устанавливает

*buffer*

на область памяти и

*buffer\_len*

– длину буфера. При ошибке возвращает

`-1`

и устанавливает

[`TypeError`](https://python-all.ru/3.1/library/exceptions.html#TypeError)

.

**int `PyObject_AsReadBuffer`([PyObject](https://python-all.ru/3.1/c-api/structures.html#PyObject) *\*obj*, const void *\*\*buffer*, Py\_ssize\_t *\*buffer\_len*)**

Возвращает указатель на область памяти только для чтения, содержащую произвольные данные. Аргумент

*obj*

должен поддерживать интерфейс односегментного читаемого буфера. При успехе возвращает

`0`

, устанавливает

*buffer*

на область памяти и

*buffer\_len*

– длину буфера. При ошибке возвращает

`-1`

и устанавливает

[`TypeError`](https://python-all.ru/3.1/library/exceptions.html#TypeError)

.

**int `PyObject_CheckReadBuffer`([PyObject](https://python-all.ru/3.1/c-api/structures.html#PyObject) *\*o*)**

Возвращает

`1`

, если

*o*

поддерживает интерфейс односегментного читаемого буфера. В противном случае возвращает

`0`

.

**int `PyObject_AsWriteBuffer`([PyObject](https://python-all.ru/3.1/c-api/structures.html#PyObject) *\*obj*, void *\*\*buffer*, Py\_ssize\_t *\*buffer\_len*)**

Возвращает указатель на область памяти, доступную для записи. Аргумент

*obj*

должен поддерживать интерфейс односегментного символьного буфера. При успехе возвращает

`0`

, устанавливает

*buffer*

на область памяти и

*buffer\_len*

– длину буфера. При ошибке возвращает

`-1`

и устанавливает

[`TypeError`](https://python-all.ru/3.1/library/exceptions.html#TypeError)

.