`slice.md`

85 строк · 7.0 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.9/c-api/slice.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Объекты срезов89**[PyTypeObject](https://python-all.ru/3.9/c-api/type.html#c.PyTypeObject) `PySlice_Type`**1011Объект типа для объектов среза. Это то же самое, что [`slice`](https://python-all.ru/3.9/library/functions.html#slice) на уровне Python.1213#### `int PySlice_Check(PyObject *ob)`1415Возвращает истину, если *ob* является объектом среза; *ob* не должен быть `NULL`. Эта функция всегда завершается успешно.1617#### `PyObject* PySlice_New(PyObject *start, PyObject *stop, PyObject *step)`1819*Возвращаемое значение: новая ссылка.*2021Возвращает новый объект среза с заданными значениями. Параметры *start*, *stop* и *step* используются как значения одноимённых атрибутов объекта среза. Любое из значений может быть `NULL`; в этом случае для соответствующего атрибута будет использовано `None`. Возвращает `NULL`, если новый объект не удалось выделить.2223#### `int PySlice_GetIndices(PyObject *slice, Py_ssize_t length, Py_ssize_t *start, Py_ssize_t *stop, Py_ssize_t *step)`2425Извлекает индексы start, stop и step из объекта среза *slice*, предполагая последовательность длины *length*. Считает индексы, превышающие *length*, ошибками.2627Возвращает `0` при успехе и `-1` при ошибке без установленного исключения (если только один из индексов не был [`None`](https://python-all.ru/3.9/library/constants.html#None) и не удалось преобразовать его в целое число, в этом случае возвращается `-1` с установленным исключением).2829Скорее всего, эту функцию не следует использовать.3031Изменено в версии 3.2: Тип параметра для параметра *slice* ранее был `PySliceObject*` .3233#### `int PySlice_GetIndicesEx(PyObject *slice, Py_ssize_t length, Py_ssize_t *start, Py_ssize_t *stop, Py_ssize_t *step, Py_ssize_t *slicelength)`3435Пригодная замена для [`PySlice_GetIndices()`](https://python-all.ru/3.9/c-api/slice.html#c.PySlice_GetIndices). Извлекает индексы start, stop и step из объекта среза *slice*, предполагая последовательность длины *length*, и сохраняет длину среза в *slicelength*. Выходящие за границы индексы обрезаются в соответствии с обработкой обычных срезов.3637Возвращает `0` при успехе и `-1` при ошибке с установленным исключением.3839> **Примечание**40>41> Эта функция считается небезопасной для последовательностей изменяемого размера. Её вызов следует заменить комбинацией [`PySlice_Unpack()`](https://python-all.ru/3.9/c-api/slice.html#c.PySlice_Unpack) и [`PySlice_AdjustIndices()`](https://python-all.ru/3.9/c-api/slice.html#c.PySlice_AdjustIndices), где42>43> ```c44> if (PySlice_GetIndicesEx(slice, length, &start, &stop, &step, &slicelength) < 0) {45>     // вернуть ошибку46> }47> ```48>49> заменяется на50>51> ```c52> if (PySlice_Unpack(slice, &start, &stop, &step) < 0) {53>     // вернуть ошибку54> }55> slicelength = PySlice_AdjustIndices(length, &start, &stop, step);56> ```5758Изменено в версии 3.2: Тип параметра для параметра *slice* ранее был `PySliceObject*` .5960Изменено в версии 3.6.1: Если `Py_LIMITED_API` не установлен или установлен в значение между `0x03050400` и `0x03060000` (не включая) или `0x03060100` и выше, `PySlice_GetIndicesEx()` реализован в виде макроса с использованием `PySlice_Unpack()` и `PySlice_AdjustIndices()`. Аргументы *start*, *stop* и *step* вычисляются более одного раза.6162Устарело с версии 3.6.1: Если `Py_LIMITED_API` установлен в значение меньше `0x03050400` или между `0x03060000` и `0x03060100` (не включая), `PySlice_GetIndicesEx()` является устаревшей функцией.6364#### `int PySlice_Unpack(PyObject *slice, Py_ssize_t *start, Py_ssize_t *stop, Py_ssize_t *step)`6566Извлекает элементы данных start, stop и step из объекта среза как целые числа C. Молча уменьшает значения, превышающие `PY_SSIZE_T_MAX`, до `PY_SSIZE_T_MAX`, молча увеличивает значения start и stop, меньшие `PY_SSIZE_T_MIN`, до `PY_SSIZE_T_MIN`, и молча увеличивает значения step, меньшие `-PY_SSIZE_T_MAX`, до `-PY_SSIZE_T_MAX`.6768Возвращает `-1` при ошибке, `0` при успехе.6970Новое в версии 3.6.1.7172#### `Py_ssize_t PySlice_AdjustIndices(Py_ssize_t length, Py_ssize_t *start, Py_ssize_t *stop, Py_ssize_t step)`7374Корректирует индексы начала/конца среза для последовательности указанной длины. Выходящие за границы индексы обрезаются в соответствии с обработкой обычных срезов.7576Возвращает длину среза. Всегда завершается успешно. Не вызывает код Python .7778Новое в версии 3.6.1.7980# Объект Ellipsis8182**[PyObject](https://python-all.ru/3.9/c-api/structures.html#c.PyObject) \*`Py_Ellipsis`**8384Объект Python `Ellipsis`. У этого объекта нет методов. С точки зрения подсчёта ссылок с ним нужно обращаться как с любым другим объектом. Как и [`Py_None`](https://python-all.ru/3.9/c-api/none.html#c.Py_None), это объект-одиночка.85