> **Источник:** https://python-all.ru/3.7/c-api/buffer.html > > «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor. --- # Протокол буфера Некоторые объекты, доступные в Python, предоставляют доступ к лежащему в основе массиву памяти или *буферу*. К таким объектам относятся встроенные [`bytes`](https://python-all.ru/3.7/library/stdtypes.html#bytes) и [`bytearray`](https://python-all.ru/3.7/library/stdtypes.html#bytearray), а также некоторые расширяющие типы, например [`array.array`](https://python-all.ru/3.7/library/array.html#array.array). Сторонние библиотеки могут определять собственные типы для специальных целей, таких как обработка изображений или численный анализ. Хотя каждый из этих типов имеет свою семантику, их объединяет общая характеристика: все они основаны на возможно большом буфере памяти. В некоторых ситуациях желательно получить прямой доступ к этому буферу без промежуточного копирования. Python предоставляет такую возможность на уровне C в виде [буферного протокола](https://python-all.ru/3.7/c-api/buffer.html#bufferobjects). У этого протокола есть две стороны: - На стороне производителя тип может экспортировать «буферный интерфейс», который позволяет объектам этого типа предоставлять информацию о своём базовом буфере. Этот интерфейс описан в разделе [Buffer Object Structures](https://python-all.ru/3.7/c-api/typeobj.html#buffer-structs); - На стороне потребителя доступно несколько способов получить указатель на необработанные базовые данные объекта (например, параметр метода). Простые объекты, такие как [`bytes`](https://python-all.ru/3.7/library/stdtypes.html#bytes) и [`bytearray`](https://python-all.ru/3.7/library/stdtypes.html#bytearray), предоставляют свой базовый буфер в байт-ориентированной форме. Возможны и другие формы; например, элементы, предоставляемые [`array.array`](https://python-all.ru/3.7/library/array.html#array.array), могут быть многобайтовыми значениями. Примером потребителя буферного интерфейса является метод [`write()`](https://python-all.ru/3.7/library/io.html#io.BufferedIOBase.write) файловых объектов: любой объект, который может экспортировать последовательность байтов через буферный интерфейс, может быть записан в файл. В то время как `write()` требуется только доступ на чтение к внутреннему содержимому переданного ему объекта, другие методы, такие как [`readinto()`](https://python-all.ru/3.7/library/io.html#io.BufferedIOBase.readinto), требуют доступа на запись к содержимому своего аргумента. Буферный интерфейс позволяет объектам выборочно разрешать или запрещать экспорт буферов с возможностью чтения-записи и только для чтения. Существует два способа для потребителя буферного интерфейса получить буфер над целевым объектом: - вызов [`PyObject_GetBuffer()`](https://python-all.ru/3.7/c-api/buffer.html#c.PyObject_GetBuffer) с правильными параметрами; - вызов [`PyArg_ParseTuple()`](https://python-all.ru/3.7/c-api/arg.html#c.PyArg_ParseTuple) (или одного из его аналогов) с одним из `y*`, `w*` или `s*` [кодов формата](https://python-all.ru/3.7/c-api/arg.html#arg-parsing). В обоих случаях [`PyBuffer_Release()`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBuffer_Release) должен быть вызван, когда буфер больше не нужен. Невыполнение этого требования может привести к различным проблемам, таким как утечка ресурсов. ## Структура буфера Структуры буферов (или просто «буферы») полезны как способ предоставления бинарных данных из другого объекта программисту на Python. Их также можно использовать как механизм среза с нулевым копированием. Благодаря возможности ссылаться на блок памяти, можно довольно легко предоставить любые данные программисту на Python. Память может быть большим константным массивом в C-расширении, необработанным блоком памяти для манипуляций перед передачей в библиотеку операционной системы или использоваться для передачи структурированных данных в их родном формате в памяти. В отличие от большинства типов данных, предоставляемых интерпретатором Python, буферы не являются указателями [`PyObject`](https://python-all.ru/3.7/c-api/structures.html#c.PyObject), а представляют собой простые структуры C. Это позволяет очень просто создавать и копировать их. Когда нужна универсальная обёртка вокруг буфера, можно создать объект [memoryview](https://python-all.ru/3.7/c-api/memoryview.html#memoryview-objects). Краткие инструкции по написанию экспортирующего объекта см. в разделе [Структуры буферных объектов](https://python-all.ru/3.7/c-api/typeobj.html#buffer-structs). Для получения буфера см. [`PyObject_GetBuffer()`](https://python-all.ru/3.7/c-api/buffer.html#c.PyObject_GetBuffer). **`Py_buffer`** **void \*`buf`** Указатель на начало логической структуры, описываемой полями буфера. Это может быть любое место в базовом физическом блоке памяти экспортёра. Например, при отрицательном [`strides`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.strides) значение может указывать на конец блока памяти. Для [непрерывных](https://python-all.ru/3.7/glossary.html#term-contiguous) массивов значение указывает на начало блока памяти. **void \*`obj`** Новая ссылка на экспортирующий объект. Ссылка принадлежит потребителю и автоматически уменьшается и устанавливается в `NULL` с помощью [`PyBuffer_Release()`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBuffer_Release). Это поле эквивалентно возвращаемому значению любой стандартной функции C-API. В особом случае для *временных* буферов, обёрнутых в [`PyMemoryView_FromBuffer()`](https://python-all.ru/3.7/c-api/memoryview.html#c.PyMemoryView_FromBuffer) или [`PyBuffer_FillInfo()`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBuffer_FillInfo), это поле равно `NULL`. В целом экспортирующие объекты НЕ ДОЛЖНЫ использовать эту схему. **Py\_ssize\_t `len`** `product(shape) * itemsize`. Для непрерывных массивов это длина базового блока памяти. Для разрывных массивов это длина, которую имела бы логическая структура при копировании в непрерывное представление. Обращение к `((char *)buf)[0] up to ((char *)buf)[len-1]` допустимо только в том случае, если буфер получен через запрос, гарантирующий непрерывность. В большинстве случаев такой запрос будет [`PyBUF_SIMPLE`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBUF_SIMPLE) или [`PyBUF_WRITABLE`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBUF_WRITABLE). **int `readonly`** Индикатор, доступен ли буфер только для чтения. Это поле управляется флагом [`PyBUF_WRITABLE`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBUF_WRITABLE). **Py\_ssize\_t `itemsize`** Размер одного элемента в байтах. То же, что и значение [`struct.calcsize()`](https://python-all.ru/3.7/library/struct.html#struct.calcsize), вызванное для значений, не являющихся `NULL` [`format`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.format). Важное исключение: если потребитель запрашивает буфер без флага [`PyBUF_FORMAT`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBUF_FORMAT), [`format`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.format) будет установлен в `NULL`, но [`itemsize`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.itemsize) всё ещё содержит значение для исходного формата. Если [`shape`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.shape) присутствует, равенство `product(shape) * itemsize == len` по-прежнему выполняется, и потребитель может использовать [`itemsize`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.itemsize) для навигации по буферу. Если [`shape`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.shape) равен `NULL` в результате запроса [`PyBUF_SIMPLE`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBUF_SIMPLE) или [`PyBUF_WRITABLE`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBUF_WRITABLE), потребитель должен игнорировать [`itemsize`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.itemsize) и считать `itemsize == 1`. **const char \*`format`** Строка, завершающаяся *NUL*, в синтаксисе модуля [`struct`](https://python-all.ru/3.7/library/struct.html#module-struct) описывает содержимое одного элемента. Если это `NULL`, предполагается `"B"` (беззнаковые байты). Это поле управляется флагом [`PyBUF_FORMAT`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBUF_FORMAT). **int `ndim`** Количество измерений, которые память представляет в виде n-мерного массива. Если оно равно `0`, [`buf`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.buf) указывает на один элемент, представляющий скаляр. В этом случае [`shape`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.shape), [`strides`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.strides) и [`suboffsets`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.suboffsets) ДОЛЖНЫ быть равны `NULL`. Макрос `PyBUF_MAX_NDIM` ограничивает максимальное количество измерений до 64. Экспортёры ОБЯЗАНЫ соблюдать это ограничение; потребители многомерных буферов ДОЛЖНЫ уметь работать с размерностью до `PyBUF_MAX_NDIM`. **Py\_ssize\_t \*`shape`** Массив из `Py_ssize_t` длиной [`ndim`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.ndim), указывающий форму памяти в виде n-мерного массива. Обратите внимание, что `shape[0] * ... * shape[ndim-1] * itemsize` ДОЛЖНО быть равно [`len`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.len). Значения формы ограничены `shape[n] >= 0`. Случай `shape[n] == 0` требует особого внимания. Дополнительную информацию см. в разделе [сложные массивы](https://python-all.ru/3.7/c-api/buffer.html#complex-arrays). Массив формы доступен потребителю только для чтения. **Py\_ssize\_t \*`strides`** Массив из `Py_ssize_t` длиной [`ndim`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.ndim), задающий количество байтов, которое нужно пропустить, чтобы перейти к новому элементу в каждом измерении. Значения шага могут быть любыми целыми числами. Для обычных массивов шаги обычно положительны, но потребитель ДОЛЖЕН уметь обрабатывать случай `strides[n] <= 0`. Дополнительную информацию см. в разделе [сложные массивы](https://python-all.ru/3.7/c-api/buffer.html#complex-arrays). Массив шагов доступен потребителю только для чтения. **Py\_ssize\_t \*`suboffsets`** Массив из `Py_ssize_t` длиной [`ndim`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.ndim). Если `suboffsets[n] >= 0`, значения, хранящиеся по n-му измерению, являются указателями, и значение смещения подмассива указывает, сколько байтов добавить к каждому указателю после разыменования. Отрицательное значение смещения подмассива означает, что разыменование производиться не должно (шаг по непрерывному блоку памяти). Если все смещения подмассивов отрицательны (т.е. разыменование не требуется), то это поле должно быть `NULL` (значение по умолчанию). Такой тип представления массива используется библиотекой Python Imaging Library (PIL). Дополнительную информацию о доступе к элементам такого массива см. в разделе [сложные массивы](https://python-all.ru/3.7/c-api/buffer.html#complex-arrays). Массив смещений подмассивов доступен потребителю только для чтения. **void \*`internal`** Предназначено для внутреннего использования экспортирующим объектом. Например, экспортёр может переинтерпретировать это значение как целое число и использовать для хранения флагов о том, нужно ли освобождать массивы shape, strides и suboffsets при освобождении буфера. Потребитель НЕ ДОЛЖЕН изменять это значение. ## Типы запросов буфера Обычно буферы получают, отправляя запрос буфера экспортирующему объекту через [`PyObject_GetBuffer()`](https://python-all.ru/3.7/c-api/buffer.html#c.PyObject_GetBuffer). Поскольку сложность логической структуры памяти может сильно различаться, потребитель использует аргумент *flags* для указания точного типа буфера, с которым он может работать. Все поля [`Py_buffer`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer) однозначно определяются типом запроса. ### поля, не зависящие от запроса Следующие поля не зависят от *flags* и всегда должны заполняться корректными значениями: [`obj`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.obj), [`buf`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.buf), [`len`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.len), [`itemsize`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.itemsize), [`ndim`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.ndim). ### только для чтения, формат > **`PyBUF_WRITABLE`** > > Управляет полем [`readonly`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.readonly). Если флаг установлен, экспортёр ОБЯЗАН предоставить буфер для записи, иначе сообщить об ошибке. В противном случае экспортёр МОЖЕТ предоставить буфер только для чтения или для записи, но выбор ДОЛЖЕН быть единым для всех потребителей. > > **`PyBUF_FORMAT`** > > Управляет полем [`format`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.format). Если установлен, это поле ДОЛЖНО быть заполнено корректно. В противном случае это поле ДОЛЖНО быть `NULL`. [`PyBUF_WRITABLE`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBUF_WRITABLE) можно комбинировать (|) с любыми флагами из следующего раздела. Поскольку [`PyBUF_SIMPLE`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBUF_SIMPLE) определён как 0, [`PyBUF_WRITABLE`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBUF_WRITABLE) может использоваться как самостоятельный флаг для запроса простого буфера для записи. [`PyBUF_FORMAT`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBUF_FORMAT) можно комбинировать (по ИЛИ) с любыми флагами, кроме [`PyBUF_SIMPLE`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBUF_SIMPLE). Последний уже подразумевает формат `B` (беззнаковые байты). ### форма, шаги, подсмещения Флаги, управляющие логической структурой памяти, перечислены в порядке убывания сложности. Обратите внимание, что каждый флаг содержит все биты флагов, расположенных ниже него. | Запрос | форма | шаги | подсмещения | | --- | --- | --- | --- | | `PyBUF_INDIRECT` | да | да | если необходимо | | `PyBUF_STRIDES` | да | да | NULL | | `PyBUF_ND` | да | NULL | NULL | | `PyBUF_SIMPLE` | NULL | NULL | NULL | ### запросы непрерывности [Непрерывность](https://python-all.ru/3.7/glossary.html#term-contiguous) по C или Fortran может быть явно запрошена, с информацией о шагах и без неё. Без информации о шагах буфер должен быть непрерывным по C. | Запрос | форма | шаги | подсмещения | непрерывность | | --- | --- | --- | --- | --- | | `PyBUF_C_CONTIGUOUS` | да | да | NULL | C | | `PyBUF_F_CONTIGUOUS` | да | да | NULL | F | | `PyBUF_ANY_CONTIGUOUS` | да | да | NULL | C или F | | `PyBUF_ND` | да | NULL | NULL | C | ### составные запросы Все возможные запросы полностью определяются некоторой комбинацией флагов из предыдущего раздела. Для удобства протокол буфера предоставляет часто используемые комбинации в виде отдельных флагов. В следующей таблице *U* обозначает неопределённую непрерывность. Потребителю придётся вызвать [`PyBuffer_IsContiguous()`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBuffer_IsContiguous), чтобы определить непрерывность. | Запрос | форма | шаги | подсмещения | непрерывность | только для чтения | формат | | --- | --- | --- | --- | --- | --- | --- | | `PyBUF_FULL` | да | да | если необходимо | U | 0 | да | | `PyBUF_FULL_RO` | да | да | если необходимо | U | 1 или 0 | да | | `PyBUF_RECORDS` | да | да | NULL | U | 0 | да | | `PyBUF_RECORDS_RO` | да | да | NULL | U | 1 или 0 | да | | `PyBUF_STRIDED` | да | да | NULL | U | 0 | NULL | | `PyBUF_STRIDED_RO` | да | да | NULL | U | 1 или 0 | NULL | | `PyBUF_CONTIG` | да | NULL | NULL | C | 0 | NULL | | `PyBUF_CONTIG_RO` | да | NULL | NULL | C | 1 или 0 | NULL | ## Комплексные массивы ### В стиле NumPy: форма и шаги Логическая структура массивов в стиле NumPy определяется [`itemsize`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.itemsize), [`ndim`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.ndim), [`shape`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.shape) и [`strides`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.strides). Если `ndim == 0`, то область памяти, на которую указывает [`buf`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.buf), интерпретируется как скаляр размера [`itemsize`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.itemsize). В этом случае и [`shape`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.shape), и [`strides`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.strides) равны `NULL`. Если [`strides`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.strides) равно `NULL`, массив интерпретируется как стандартный n-мерный C-массив. В противном случае потребитель должен обращаться к n-мерному массиву следующим образом: ```c ptr = (char *)buf + indices[0] * strides[0] + ... + indices[n-1] * strides[n-1]; item = *((typeof(item) *)ptr); ``` Как отмечалось выше, [`buf`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.buf) может указывать на любую позицию в реальном блоке памяти. Экспортер может проверить корректность буфера с помощью этой функции: ```python def verify_structure(memlen, itemsize, ndim, shape, strides, offset): """Проверить, что параметры представляют допустимый массив в пределах границ выделенной памяти: char *mem: начало физического блока памяти memlen: длина физического блока памяти смещение: (char *)buf - mem """ if offset % itemsize: return False if offset < 0 or offset+itemsize > memlen: return False if any(v % itemsize for v in strides): return False if ndim <= 0: return ndim == 0 and not shape and not strides if 0 in shape: return True imin = sum(strides[j]*(shape[j]-1) for j in range(ndim) if strides[j] <= 0) imax = sum(strides[j]*(shape[j]-1) for j in range(ndim) if strides[j] > 0) return 0 <= offset+imin and offset+imax+itemsize <= memlen ``` ### В стиле PIL: форма, шаги и suboffsets В дополнение к обычным элементам массивы в стиле PIL могут содержать указатели, по которым нужно перейти, чтобы получить следующий элемент в измерении. Например, обычный трехмерный C-массив `char v[2][2][3]` можно также рассматривать как массив из 2 указателей на 2 двумерных массива: `char (*v[2])[2][3]`. В представлении suboffsets эти два указателя могут быть встроены в начало [`buf`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.buf), указывая на два `char x[2][3]` массива, которые могут находиться в любом месте памяти. Вот функция, которая возвращает указатель на элемент в N-мерном массиве, на который указывает N-мерный индекс, при наличии как ненулевых `NULL` шагов, так и suboffsets: ```c void *get_item_pointer(int ndim, void *buf, Py_ssize_t *strides, Py_ssize_t *suboffsets, Py_ssize_t *indices) { char *pointer = (char*)buf; int i; for (i = 0; i < ndim; i++) { pointer += strides[i] * indices[i]; if (suboffsets[i] >=0 ) { pointer = *((char**)pointer) + suboffsets[i]; } } return (void*)pointer; } ``` ## Функции, связанные с буфером #### `int PyObject_CheckBuffer(PyObject *obj)` Возвращает `1`, если *obj* поддерживает интерфейс буфера, иначе `0`. Когда возвращается `1`, это не гарантирует, что [`PyObject_GetBuffer()`](https://python-all.ru/3.7/c-api/buffer.html#c.PyObject_GetBuffer) выполнится успешно. Эта функция всегда завершается успешно. #### `int PyObject_GetBuffer(PyObject *exporter, Py_buffer *view, int flags)` Отправляет запрос *exporter* для заполнения *view* в соответствии с *flags*. Если экспортер не может предоставить буфер точного типа, он ДОЛЖЕН вызвать `PyExc_BufferError`, установить `view->obj` в `NULL` и вернуть `-1`. В случае успеха заполняет *view*, устанавливает `view->obj` в новую ссылку на *exporter* и возвращает 0. В случае цепочечных поставщиков буфера, которые перенаправляют запросы одному объекту, `view->obj` МОЖЕТ ссылаться на этот объект вместо *exporter* (см. [Структуры буферных объектов](https://python-all.ru/3.7/c-api/typeobj.html#buffer-structs)). Успешные вызовы [`PyObject_GetBuffer()`](https://python-all.ru/3.7/c-api/buffer.html#c.PyObject_GetBuffer) должны быть парными с вызовами [`PyBuffer_Release()`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBuffer_Release), как и в случае с `malloc()` и `free()`. Таким образом, после того как потребитель закончил работу с буфером, [`PyBuffer_Release()`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBuffer_Release) должен быть вызван ровно один раз. #### `void PyBuffer_Release(Py_buffer *view)` Освобождает буфер *view* и уменьшает счётчик ссылок для `view->obj`. Эту функцию ОБЯЗАТЕЛЬНО нужно вызывать, когда буфер больше не используется, иначе могут возникнуть утечки ссылок. Вызов этой функции для буфера, который не был получен через [`PyObject_GetBuffer()`](https://python-all.ru/3.7/c-api/buffer.html#c.PyObject_GetBuffer), является ошибкой. #### `Py_ssize_t PyBuffer_SizeFromFormat(const char *)` Возвращает подразумеваемое [`itemsize`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.itemsize) из [`format`](https://python-all.ru/3.7/c-api/buffer.html#c.Py_buffer.format). Эта функция ещё не реализована. #### `int PyBuffer_IsContiguous(Py_buffer *view, char order)` Возвращает `1`, если память, определяемая *view*, является C-style (*order* равен `'C'`) или Fortran-style (*order* равен `'F'`) [непрерывной (contiguous)](https://python-all.ru/3.7/glossary.html#term-contiguous), или любой из них (*order* равен `'A'`). Иначе возвращает `0`. Эта функция всегда завершается успешно. #### `void* PyBuffer_GetPointer(Py_buffer *view, Py_ssize_t *indices)` Получает область памяти, на которую указывают *indices* внутри заданного *view*. *indices* должен указывать на массив из `view->ndim` индексов. #### `int PyBuffer_FromContiguous(Py_buffer *view, void *buf, Py_ssize_t len, char fort)` Копирует *len* байт из непрерывного буфера *buf* в *view*. *fort* может быть `'C'` или `'F'` (для упорядочения в стиле C или в стиле Фортрана). `0` возвращается при успехе, `-1` при ошибке. #### `int PyBuffer_ToContiguous(void *buf, Py_buffer *src, Py_ssize_t len, char order)` Копирует *len* байтов из *src* в его непрерывное представление в *buf*. *order* может быть `'C'`, `'F'` или `'A'` (для упорядочения в стиле C или Fortran, либо любого из них). `0` возвращается при успехе, `-1` при ошибке. Эта функция завершается ошибкой, если *len* != *src-\>len*. #### `void PyBuffer_FillContiguousStrides(int ndims, Py_ssize_t *shape, Py_ssize_t *strides, int itemsize, char order)` Заполняет массив *strides* шагами в байтах (byte-strides) для [непрерывного](https://python-all.ru/3.7/glossary.html#term-contiguous) массива заданной формы с заданным количеством байтов на элемент (в стиле C, если *order* равен `'C'`, или в стиле Fortran, если *order* равен `'F'`). #### `int PyBuffer_FillInfo(Py_buffer *view, PyObject *exporter, void *buf, Py_ssize_t len, int readonly, int flags)` Обрабатывает запросы буфера для экспортёра, который хочет предоставить *buf* размером *len* с настройкой возможности записи в соответствии с *readonly*. *buf* интерпретируется как последовательность байтов без знака. Аргумент *flags* указывает тип запроса. Эта функция всегда заполняет *view* в соответствии с флагами, за исключением случаев, когда *buf* помечен как доступный только для чтения и в *flags* установлен [`PyBUF_WRITABLE`](https://python-all.ru/3.7/c-api/buffer.html#c.PyBUF_WRITABLE). При успехе устанавливает `view->obj` в новую ссылку на *exporter* и возвращает 0. В противном случае возбуждает `PyExc_BufferError`, устанавливает `view->obj` в `NULL` и возвращает `-1`. Если эта функция используется как часть [getbufferproc](https://python-all.ru/3.7/c-api/typeobj.html#buffer-structs), *exporter* ДОЛЖЕН быть установлен на экспортирующий объект, а *flags* должны передаваться без изменений. В противном случае *exporter* ДОЛЖЕН быть `NULL`.