Objetos rebanada (slice)¶
-
PyTypeObject PySlice_Type¶
- Part of the Stable ABI.
El objeto tipo para objetos rebanadas. Esto es lo mismo que
slice
en la capa de Python.
-
int PySlice_Check(PyObject *ob)¶
Retorna verdadero si ob es un objeto rebanada; ob no debe ser
NULL
. Esta función siempre finaliza con éxito.
-
PyObject *PySlice_New(PyObject *start, PyObject *stop, PyObject *step)¶
- Return value: New reference. Part of the Stable ABI.
Return a new slice object with the given values. The start, stop, and step parameters are used as the values of the slice object attributes of the same names. Any of the values may be
NULL
, in which case theNone
will be used for the corresponding attribute.Return
NULL
with an exception set if the new object could not be allocated.
-
int PySlice_GetIndices(PyObject *slice, Py_ssize_t length, Py_ssize_t *start, Py_ssize_t *stop, Py_ssize_t *step)¶
- Part of the Stable ABI.
Recupera los índices start, stop y step del objeto rebanada slice, suponiendo una secuencia de longitud length. Trata los índices mayores que length como errores.
Returns
0
on success and-1
on error with no exception set (unless one of the indices was notNone
and failed to be converted to an integer, in which case-1
is returned with an exception set).Probablemente no quiera usar esta función.
Distinto en la versión 3.2: El tipo de parámetro para el parámetro slice era
PySliceObject*
antes.
-
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)¶
- Part of the Stable ABI.
Reemplazo utilizable para
PySlice_GetIndices()
. Recupera los índices de start, stop, y step del objeto rebanada slice asumiendo una secuencia de longitud length, y almacena la longitud de la rebanada en slicelength. Los índices fuera de los límites se recortan de manera coherente con el manejo de sectores normales.Return
0
on success and-1
on error with an exception set.Nota
Esta función se considera no segura para secuencias redimensionables. Su invocación debe ser reemplazada por una combinación de
PySlice_Unpack()
yPySlice_AdjustIndices()
donde:if (PySlice_GetIndicesEx(slice, length, &start, &stop, &step, &slicelength) < 0) { // return error }
es reemplazado por:
if (PySlice_Unpack(slice, &start, &stop, &step) < 0) { // return error } slicelength = PySlice_AdjustIndices(length, &start, &stop, step);
Distinto en la versión 3.2: El tipo de parámetro para el parámetro slice era
PySliceObject*
antes.Distinto en la versión 3.6.1: Si
Py_LIMITED_API
no se establece o establece el valor entre0x03050400
y0x03060000
(sin incluir) o0x03060100
o un superiorPySlice_GetIndicesEx()
se implementa como un macro usandoPySlice_Unpack()
yPySlice_AdjustIndices()
. Los argumentos start, stop y step se evalúan más de una vez.Obsoleto desde la versión 3.6.1: Si
Py_LIMITED_API
se establece en un valor menor que0x03050400
o entre0x03060000
y0x03060100
(sin incluir)PySlice_GetIndicesEx()
es una función obsoleta.
-
int PySlice_Unpack(PyObject *slice, Py_ssize_t *start, Py_ssize_t *stop, Py_ssize_t *step)¶
- Part of the Stable ABI since version 3.7.
Extrae los miembros de datos start, stop, y step de un objeto rebanada como enteros en C. Reduce silenciosamente los valores mayores que
PY_SSIZE_T_MAX
aPY_SSIZE_T_MAX
, aumenta silenciosamente los valores start y stop inferiores aPY_SSIZE_T_MIN
aPY_SSIZE_T_MIN
, y silenciosamente aumenta los valores de step a menos de-PY_SSE
a-PY_SSIZE_T_MAX
.Return
-1
with an exception set on error,0
on success.Added in version 3.6.1.
-
Py_ssize_t PySlice_AdjustIndices(Py_ssize_t length, Py_ssize_t *start, Py_ssize_t *stop, Py_ssize_t step)¶
- Part of the Stable ABI since version 3.7.
Ajusta los índices de corte de inicio/fin asumiendo una secuencia de la longitud especificada. Los índices fuera de los límites se recortan de manera coherente con el manejo de sectores normales.
Retorna la longitud de la rebanada. Siempre exitoso. No llama al código de Python.
Added in version 3.6.1.
Objeto elipsis¶
-
PyObject *Py_Ellipsis¶
The Python
Ellipsis
object. This object has no methods. LikePy_None
, it is an immortal singleton object.Distinto en la versión 3.12:
Py_Ellipsis
is immortal.