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

---

# Объекты bytes

Эти функции возбуждают [`TypeError`](https://python-all.ru/3.15/library/exceptions.html#TypeError), если ожидается параметр bytes, а вызываются с параметром, не являющимся bytes.

#### `type PyBytesObject`

Этот подтип [`PyObject`](https://python-all.ru/3.15/c-api/structures.html#c.PyObject) представляет объект Python bytes.

#### `PyTypeObject PyBytes_Type`

*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*

Этот экземпляр [`PyTypeObject`](https://python-all.ru/3.15/c-api/type.html#c.PyTypeObject) представляет тип bytes в Python; это тот же объект, что и [`bytes`](https://python-all.ru/3.15/library/stdtypes.html#bytes) в слое Python.

#### `int PyBytes_Check(PyObject *o)`

Возвращает true, если объект *o* является объектом bytes или экземпляром подтипа типа bytes. Эта функция всегда завершается успешно.

#### `int PyBytes_CheckExact(PyObject *o)`

Возвращает true, если объект *o* является объектом bytes, но не экземпляром подтипа типа bytes. Эта функция всегда завершается успешно.

#### `PyObject *PyBytes_FromString(const char *v)`

*Возвращаемое значение: новая ссылка.*

*Часть [стабильного ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*

*Потокобезопасность: [атомарно](https://python-all.ru/3.15/library/threadsafety.html#threadsafety-level-atomic).*

Возвращает новый объект bytes с копией строки *v* в качестве значения в случае успеха, и `NULL` в случае неудачи. Параметр *v* не должен быть `NULL`; он не будет проверяться.

#### `PyObject *PyBytes_FromStringAndSize(const char *v, Py_ssize_t len)`

*Возвращаемое значение: новая ссылка.*

*Часть [стабильного ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*

*Потокобезопасность: [атомарно](https://python-all.ru/3.15/library/threadsafety.html#threadsafety-level-atomic).*

Возвращает новый объект bytes с копией строки *v* в качестве значения и длины *len* в случае успеха, и `NULL` в случае неудачи. Если *v* равно `NULL`, содержимое объекта bytes не инициализировано.

[Мягко устарело](https://python-all.ru/3.15/glossary.html#term-soft-deprecated) с версии 3.15: Используйте API [`PyBytesWriter`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter) вместо `PyBytes_FromStringAndSize(NULL, len)`.

#### `PyObject *PyBytes_FromFormat(const char *format, ...)`

*Возвращаемое значение: новая ссылка.*

*Часть [стабильного ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*

*Потокобезопасность: [атомарно](https://python-all.ru/3.15/library/threadsafety.html#threadsafety-level-atomic).*

Принимает строку формата в стиле C `printf()`, строку *format* и переменное количество аргументов, вычисляет размер результирующего объекта bytes Python и возвращает объект bytes, в который отформатированы значения. Переменные аргументы должны быть типами C и точно соответствовать символам формата в строке *format*. Допускаются следующие символы формата:

| Символы формата | Тип | Описание |
| --- | --- | --- |
| `%%` | *н/д* | Буквальный символ %. |
| `%c` | int | Один байт, представленный как C int. |
| `%d` | int | Эквивалентно `printf("%d")`. [\[1\]](https://python-all.ru/3.15/c-api/bytes.html#id9) |
| `%u` | unsigned int | Эквивалентно `printf("%u")`. [\[1\]](https://python-all.ru/3.15/c-api/bytes.html#id9) |
| `%ld` | long | Эквивалентно `printf("%ld")`. [\[1\]](https://python-all.ru/3.15/c-api/bytes.html#id9) |
| `%lu` | unsigned long | Эквивалентно `printf("%lu")`. [\[1\]](https://python-all.ru/3.15/c-api/bytes.html#id9) |
| `%zd` | [`Py_ssize_t`](https://python-all.ru/3.15/c-api/intro.html#c.Py_ssize_t) | Эквивалентно `printf("%zd")`. [\[1\]](https://python-all.ru/3.15/c-api/bytes.html#id9) |
| `%zu` | size\_t | Эквивалентно `printf("%zu")`. [\[1\]](https://python-all.ru/3.15/c-api/bytes.html#id9) |
| `%i` | int | Эквивалентно `printf("%i")`. [\[1\]](https://python-all.ru/3.15/c-api/bytes.html#id9) |
| `%x` | int | Эквивалентно `printf("%x")`. [\[1\]](https://python-all.ru/3.15/c-api/bytes.html#id9) |
| `%s` | const char\* | Нуль-терминированный массив символов C. |
| `%p` | const void\* | Шестнадцатеричное представление указателя C. В основном эквивалентно `printf("%p")`, за исключением того, что гарантированно начинается с литерала `0x` независимо от того, что возвращает `printf` на данной платформе. |

Нераспознанный символ формата приводит к тому, что вся оставшаяся строка формата копируется как есть в результирующий объект, а все лишние аргументы отбрасываются.

\[1\]

([1](https://python-all.ru/3.15/c-api/bytes.html#id1),[2](https://python-all.ru/3.15/c-api/bytes.html#id2),[3](https://python-all.ru/3.15/c-api/bytes.html#id3),[4](https://python-all.ru/3.15/c-api/bytes.html#id4),[5](https://python-all.ru/3.15/c-api/bytes.html#id5),[6](https://python-all.ru/3.15/c-api/bytes.html#id6),[7](https://python-all.ru/3.15/c-api/bytes.html#id7),[8](https://python-all.ru/3.15/c-api/bytes.html#id8))

Для целочисленных спецификаторов (d, u, ld, lu, zd, zu, i, x): флаг преобразования '0' действует, даже если задана точность.

#### `PyObject *PyBytes_FromFormatV(const char *format, va_list vargs)`

*Возвращаемое значение: новая ссылка.*

*Часть [стабильного ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*

*Потокобезопасность: [атомарно](https://python-all.ru/3.15/library/threadsafety.html#threadsafety-level-atomic).*

Идентично [`PyBytes_FromFormat()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytes_FromFormat), за исключением того, что принимает ровно два аргумента.

#### `PyObject *PyBytes_FromObject(PyObject *o)`

*Возвращаемое значение: новая ссылка.*

*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*

*Потокобезопасность: [Безопасно для одновременного использования на одном объекте](https://python-all.ru/3.15/library/threadsafety.html#threadsafety-level-shared).*

Возвращает байтовое представление объекта *o*, реализующего протокол буфера.

> **Примечание**
>
> Если объект реализует протокол буфера, то буфер не должен изменяться во время создания байтового объекта.

#### `Py_ssize_t PyBytes_Size(PyObject *o)`

*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*

*Потокобезопасность: [Атомарно](https://python-all.ru/3.15/library/threadsafety.html#threadsafety-level-atomic).*

Возвращает длину байтов в байтовом объекте *o*.

#### `Py_ssize_t PyBytes_GET_SIZE(PyObject *o)`

*Потокобезопасность: [атомарно](https://python-all.ru/3.15/library/threadsafety.html#threadsafety-level-atomic).*

Аналогично [`PyBytes_Size()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytes_Size), но без проверки ошибок.

#### `char *PyBytes_AsString(PyObject *o)`

*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*

*Потокобезопасность: [Безопасен для вызова из нескольких потоков только с внешней синхронизацией](https://python-all.ru/3.15/library/threadsafety.html#threadsafety-level-compatible).*

Возвращает указатель на содержимое *o*. Указатель ссылается на внутренний буфер объекта *o*, который состоит из `len(o) + 1` байтов. Последний байт в буфере всегда нулевой, независимо от наличия других нулевых байтов. Данные нельзя изменять никаким образом, за исключением случая, когда объект только что был создан с помощью `PyBytes_FromStringAndSize(NULL, size)`. Его нельзя освобождать. Если *o* вообще не является байтовым объектом, [`PyBytes_AsString()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytes_AsString) возвращает `NULL` и возбуждает [`TypeError`](https://python-all.ru/3.15/library/exceptions.html#TypeError).

#### `char *PyBytes_AS_STRING(PyObject *string)`

*Потокобезопасность: [Безопасно вызывать из нескольких потоков только с внешней синхронизацией](https://python-all.ru/3.15/library/threadsafety.html#threadsafety-level-compatible).*

Аналогично [`PyBytes_AsString()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytes_AsString), но без проверки ошибок.

#### `int PyBytes_AsStringAndSize(PyObject *obj, char **buffer, Py_ssize_t *length)`

*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*

*Потокобезопасность: [Безопасен для вызова из нескольких потоков только с внешней синхронизацией](https://python-all.ru/3.15/library/threadsafety.html#threadsafety-level-compatible).*

Возвращает содержимое объекта *obj*, завершающееся нулевым байтом, через выходные переменные *buffer* и *length*. В случае успеха возвращает `0`.

Если *length* равно `NULL`, байтовый объект не может содержать встроенные нулевые байты; если содержит, функция возвращает `-1` и возбуждается [`ValueError`](https://python-all.ru/3.15/library/exceptions.html#ValueError).

Буфер ссылается на внутренний буфер *obj*, который содержит дополнительный нулевой байт в конце (не учитывается в *length*). Данные нельзя изменять никаким образом, за исключением случая, когда объект только что был создан с помощью `PyBytes_FromStringAndSize(NULL, size)`. Его нельзя освобождать. Если *obj* вообще не является байтовым объектом, [`PyBytes_AsStringAndSize()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytes_AsStringAndSize) возвращает `-1` и возбуждает [`TypeError`](https://python-all.ru/3.15/library/exceptions.html#TypeError).

Изменено в версии 3.5: Ранее, [`TypeError`](https://python-all.ru/3.15/library/exceptions.html#TypeError) возбуждалось, когда в байтовом объекте встречались встроенные нулевые байты.

#### `void PyBytes_Concat(PyObject **bytes, PyObject *newpart)`

*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*

*Потокобезопасность: [Безопасно для одновременного использования на одном объекте](https://python-all.ru/3.15/library/threadsafety.html#threadsafety-level-shared).*

Создаёт новый байтовый объект в *\*bytes*, содержащий содержимое *newpart*, добавленное к *bytes*; вызывающий получит новую ссылку. Ссылка на старое значение *bytes* будет «[украдена](https://python-all.ru/3.15/glossary.html#term-steal)». Если новый объект не может быть создан, старая ссылка на *bytes* всё равно будет «украдена», значение *\*bytes* будет установлено в `NULL`, и будет установлено соответствующее исключение.

> **Примечание**
>
> Если *newpart* реализует протокол буфера, то буфер не должен изменяться во время создания нового байтового объекта.

#### `void PyBytes_ConcatAndDel(PyObject **bytes, PyObject *newpart)`

*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*

*Потокобезопасность: [Безопасно для одновременного использования на одном объекте](https://python-all.ru/3.15/library/threadsafety.html#threadsafety-level-shared).*

Создаёт новый байтовый объект в *\*bytes*, содержащий содержимое *newpart*, добавленное к *bytes*. Эта версия освобождает [сильную ссылку](https://python-all.ru/3.15/glossary.html#term-strong-reference) на *newpart* (т.е. уменьшает счётчик ссылок).

> **Примечание**
>
> Если *newpart* реализует протокол буфера, то буфер не должен изменяться во время создания нового байтового объекта.

#### `PyObject *PyBytes_Join(PyObject *sep, PyObject *iterable)`

*Потокобезопасность: [Безопасно для одновременного использования на одном объекте](https://python-all.ru/3.15/library/threadsafety.html#threadsafety-level-shared).*

Аналогично `sep.join(iterable)` в Python.

*sep* должен быть объектом Python [`bytes`](https://python-all.ru/3.15/library/stdtypes.html#bytes). (Обратите внимание, что [`PyUnicode_Join()`](https://python-all.ru/3.15/c-api/unicode.html#c.PyUnicode_Join) принимает разделитель `NULL` и обрабатывает его как пробел, тогда как [`PyBytes_Join()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytes_Join) не принимает разделитель `NULL`.)

*iterable* должен быть итерируемым объектом, порождающим объекты, реализующие [буферный протокол](https://python-all.ru/3.15/c-api/buffer.html#bufferobjects).

В случае успеха возвращает новый объект [`bytes`](https://python-all.ru/3.15/library/stdtypes.html#bytes). В случае ошибки устанавливает исключение и возвращает `NULL`.

Добавлено в версии 3.14.

> **Примечание**
>
> Если объекты *iterable* реализуют буферный протокол, то буферы не должны изменяться во время создания нового объекта bytes.

#### `int _PyBytes_Resize(PyObject **bytes, Py_ssize_t newsize)`

*Потокобезопасность: [Можно безопасно вызывать без внешней синхронизации для разных объектов](https://python-all.ru/3.15/library/threadsafety.html#threadsafety-level-distinct).*

Изменяет размер объекта bytes. *newsize* – новая длина объекта bytes. Можно считать, что это создание нового объекта bytes и уничтожение старого, только более эффективно. Передайте адрес существующего объекта bytes как lvalue (в него может быть произведена запись) и желаемый новый размер. В случае успеха *\*bytes* содержит изменённый объект bytes и возвращается `0`; адрес в *\*bytes* может отличаться от исходного значения. Если перераспределение не удалось, исходный объект bytes по адресу *\*bytes* освобождается, *\*bytes* устанавливается в `NULL`, устанавливается [`MemoryError`](https://python-all.ru/3.15/library/exceptions.html#MemoryError) и возвращается `-1`.

[Мягко устарело](https://python-all.ru/3.15/glossary.html#term-soft-deprecated) с версии 3.15: Вместо этого используйте API [`PyBytesWriter`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter).

#### `PyObject *PyBytes_Repr(PyObject *bytes, int smartquotes)`

*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*

*Потокобезопасность: [Атомарно](https://python-all.ru/3.15/library/threadsafety.html#threadsafety-level-atomic).*

Возвращает строковое представление *bytes*. Эта функция в настоящее время используется для реализации `bytes.__repr__()` в Python.

Эта функция не выполняет проверку типа; передача *bytes* в качестве объекта, не являющегося bytes, или `NULL` приводит к неопределённому поведению.

Если *smartquotes* равно true, представление будет использовать строку в двойных кавычках вместо строки в одинарных кавычках, если в *bytes* присутствуют одинарные кавычки. Например, байтовая строка `'Python'` будет представлена как `b"'Python'"`, когда *smartquotes* равно true, или как `b'\'Python\''`, когда оно равно false.

В случае успеха эта функция возвращает [сильную ссылку](https://python-all.ru/3.15/glossary.html#term-strong-reference) на объект [`str`](https://python-all.ru/3.15/library/stdtypes.html#str), содержащий представление. В случае ошибки возвращается `NULL` с установленным исключением.

#### `PyObject *PyBytes_DecodeEscape(const char *s, Py_ssize_t len, const char *errors, Py_ssize_t unicode, const char *recode_encoding)`

*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*

*Потокобезопасность: [Атомарно](https://python-all.ru/3.15/library/threadsafety.html#threadsafety-level-atomic).*

Обрабатывает управляющие последовательности в строке с обратной косой чертой *s*. *s* не должно быть `NULL`. *len* должно быть размером *s*.

*errors* должно быть одним из `"strict"`, `"replace"` или `"ignore"`. Если *errors* равно `NULL`, то по умолчанию используется `"strict"`.

В случае успеха эта функция возвращает [сильную ссылку](https://python-all.ru/3.15/glossary.html#term-strong-reference) на объект Python [`bytes`](https://python-all.ru/3.15/library/stdtypes.html#bytes), содержащий неэкранированную строку. В случае ошибки эта функция возвращает `NULL` с установленным исключением.

Изменено в версии 3.9: *unicode* и *recode\_encoding* теперь не используются.

# PyBytesWriter

API [`PyBytesWriter`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter) можно использовать для создания объекта Python [`bytes`](https://python-all.ru/3.15/library/stdtypes.html#bytes).

Добавлено в версии 3.15.

#### `type PyBytesWriter`

Экземпляр средства записи байтов.

Этот API **не является потокобезопасным**: writer должен использоваться только одним потоком одновременно.

Экземпляр должен быть уничтожен с помощью [`PyBytesWriter_Finish()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter_Finish) в случае успеха или [`PyBytesWriter_Discard()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter_Discard) в случае ошибки.

## Создание, Завершение, Отмена

#### `PyBytesWriter *PyBytesWriter_Create(Py_ssize_t size)`

Создаёт [`PyBytesWriter`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter) для записи *size* байт.

Если *size* больше нуля, выделяет *size* байт и устанавливает размер writer в *size*. Вызывающий ответственен за запись *size* байт с помощью [`PyBytesWriter_GetData()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter_GetData). Эта функция не выделяет память с запасом.

При ошибке устанавливает исключение и возвращает `NULL`.

*size* должен быть положительным или нулевым.

#### `PyObject *PyBytesWriter_Finish(PyBytesWriter *writer)`

Завершает объект [`PyBytesWriter`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter), созданный с помощью [`PyBytesWriter_Create()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter_Create).

При успехе возвращает объект Python [`bytes`](https://python-all.ru/3.15/library/stdtypes.html#bytes). При ошибке устанавливает исключение и возвращает `NULL`.

После вызова экземпляр writer становится недействительным в любом случае. После [`PyBytesWriter_Finish()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter_Finish) никакие API для writer вызывать нельзя.

#### `PyObject *PyBytesWriter_FinishWithSize(PyBytesWriter *writer, Py_ssize_t size)`

Аналогично [`PyBytesWriter_Finish()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter_Finish), но изменяет размер writer до *size* байт перед созданием объекта [`bytes`](https://python-all.ru/3.15/library/stdtypes.html#bytes).

#### `PyObject *PyBytesWriter_FinishWithPointer(PyBytesWriter *writer, void *buf)`

Аналогично [`PyBytesWriter_Finish()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter_Finish), но изменяет размер writer с помощью указателя *buf* перед созданием объекта [`bytes`](https://python-all.ru/3.15/library/stdtypes.html#bytes).

Устанавливает исключение и возвращает `NULL`, если указатель *buf* находится за пределами внутреннего буфера.

Псевдокод функции:

```c
Py_ssize_t size = (char*)buf - (char*)PyBytesWriter_GetData(writer);
return PyBytesWriter_FinishWithSize(writer, size);
```

#### `void PyBytesWriter_Discard(PyBytesWriter *writer)`

Отменяет объект [`PyBytesWriter`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter), созданный с помощью [`PyBytesWriter_Create()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter_Create).

Ничего не делает, если *writer* равен `NULL`.

После вызова экземпляр writer становится недействительным. После [`PyBytesWriter_Discard()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter_Discard) никакие API для writer вызывать нельзя.

## API высокого уровня

#### `int PyBytesWriter_WriteBytes(PyBytesWriter *writer, const void *bytes, Py_ssize_t size)`

Увеличивает внутренний буфер *writer* на *size* байт, записывает *size* байт из *bytes* в конец *writer* и добавляет *size* к размеру *writer*.

Если *size* равно `-1`, вызывает `strlen(bytes)` для получения длины строки.

При успехе возвращает `0`. При ошибке устанавливает исключение и возвращает `-1`.

#### `int PyBytesWriter_Format(PyBytesWriter *writer, const char *format, ...)`

Аналогично [`PyBytes_FromFormat()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytes_FromFormat), но записывает вывод непосредственно в конец writer. Увеличивает внутренний буфер writer по мере необходимости. Затем добавляет записанный размер к размеру writer.

При успехе возвращает `0`. При ошибке устанавливает исключение и возвращает `-1`.

## Геттеры

#### `Py_ssize_t PyBytesWriter_GetSize(PyBytesWriter *writer)`

Возвращает размер writer.

Функция не делает недействительными указатели, возвращённые [`PyBytesWriter_GetData()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter_GetData).

Функция не может завершиться с ошибкой.

#### `void *PyBytesWriter_GetData(PyBytesWriter *writer)`

Возвращает данные writer: начало внутреннего буфера.

Указатель остаётся действительным, пока для *writer* не будет вызвана функция [`PyBytesWriter`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter), отличная от [`PyBytesWriter_GetData()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter_GetData) или [`PyBytesWriter_GetSize()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter_GetSize).

Функция не может завершиться с ошибкой.

## Низкоуровневый API

#### `int PyBytesWriter_Resize(PyBytesWriter *writer, Py_ssize_t size)`

Изменяет размер writer на *size* байт. Может использоваться для увеличения или уменьшения размера writer. Обычно эта функция выделяет память с запасом для обеспечения амортизированной производительности при многократном изменении размера.

Вновь выделенные байты остаются неинициализированными.

При успехе возвращает `0`. При ошибке устанавливает исключение и возвращает `-1`.

*size* должен быть положительным или нулевым.

#### `int PyBytesWriter_Grow(PyBytesWriter *writer, Py_ssize_t grow)`

Увеличивает размер writer на *grow* байт от текущего размера. Обычно эта функция выделяет память с запасом для обеспечения амортизированной производительности при многократном изменении размера.

Вновь выделенные байты остаются неинициализированными.

При успехе возвращает `0`. При ошибке устанавливает исключение и возвращает `-1`.

*size* может быть отрицательным для уменьшения writer.

#### `void *PyBytesWriter_GrowAndUpdatePointer(PyBytesWriter *writer, Py_ssize_t size, void *buf)`

Аналогично [`PyBytesWriter_Grow()`](https://python-all.ru/3.15/c-api/bytes.html#c.PyBytesWriter_Grow), но также обновляет указатель *buf* .

Указатель *buf* перемещается, если внутренний буфер перемещается в памяти. Относительное положение *buf* внутри внутреннего буфера остаётся неизменным.

При ошибке устанавливает исключение и возвращает `NULL`.

*buf* не должен быть `NULL`.

Псевдокод функции:

```c
Py_ssize_t pos = (char*)buf - (char*)PyBytesWriter_GetData(writer);
if (PyBytesWriter_Grow(writer, size) < 0) {
    return NULL;
}
return (char*)PyBytesWriter_GetData(writer) + pos;
```