Nota
¡Ayúdanos a traducir la documentación oficial de Python al Español! Puedes encontrar más información en Como contribuir. Ayuda a acercar Python a más personas de habla hispana.
Objetos conjunto¶
Esta sección detalla la API pública de los objetos set
y frozenset
. Cualquier funcionalidad que no esté listada a continuación se accede mejor utilizando el protocolo abstracto de objetos (incluyendo PyObject_CallMethod()
, PyObject_RichCompareBool()
, PyObject_Hash()
, PyObject_Repr()
, PyObject_IsTrue()
, PyObject_Print()
, y PyObject_GetIter()
) o el protocolo numérico abstracto (incluyendo PyNumber_And()
, PyNumber_Subtract()
, PyNumber_Or()
, PyNumber_Xor()
, PyNumber_InPlaceAnd()
, PyNumber_InPlaceSubtract()
, PyNumber_InPlaceOr()
, y PyNumber_InPlaceXor()
).
-
type PySetObject¶
Este subtipo de
PyObject
se utiliza para mantener los datos internos de los objetosset
yfrozenset
. Es como unPyDictObject
en el sentido de que tiene un tamaño fijo para los conjuntos pequeños (muy parecido al almacenamiento de tuplas) y apuntará a un bloque de memoria separado y de tamaño variable para los conjuntos de tamaño medio y grande (muy parecido al almacenamiento de listas). Ninguno de los campos de esta estructura debe considerarse público y todos están sujetos a cambios. Todo el acceso debe hacerse a través de la API documentada en lugar de manipular los valores de la estructura.
-
PyTypeObject PySet_Type¶
- Part of the Stable ABI.
Esta es una instancia de
PyTypeObject
que representa el tipo Pythonset
.
-
PyTypeObject PyFrozenSet_Type¶
- Part of the Stable ABI.
Esta es una instancia de
PyTypeObject
que representa el tipo Pythonfrozenset
.
Los siguientes macros de comprobación de tipos funcionan en punteros a cualquier objeto de Python. Del mismo modo, las funciones del constructor funcionan con cualquier objeto Python iterable.
-
int PySet_Check(PyObject *p)¶
Retorna verdadero si p es un objeto
set
o una instancia de un subtipo. Esta función siempre finaliza con éxito.
-
int PyFrozenSet_Check(PyObject *p)¶
Retorna verdadero si p es un objeto
frozenset
o una instancia de un subtipo. Esta función siempre finaliza con éxito.
-
int PyAnySet_Check(PyObject *p)¶
Retorna verdadero si p es un objeto
set
, un objetofrozenset
, o una instancia de un subtipo. Esta función siempre finaliza con éxito.
-
int PySet_CheckExact(PyObject *p)¶
Retorna verdadero si p es un objeto
set
pero no una instancia de un subtipo. Esta función siempre finaliza con éxito.Nuevo en la versión 3.10.
-
int PyAnySet_CheckExact(PyObject *p)¶
Retorna verdadero si p es un objeto
set
o un objetofrozenset
pero no una instancia de un subtipo. Esta función siempre finaliza con éxito.
-
int PyFrozenSet_CheckExact(PyObject *p)¶
Retorna verdadero si p es un objeto
frozenset
pero no una instancia de un subtipo. Esta función siempre finaliza con éxito.
-
PyObject *PySet_New(PyObject *iterable)¶
- Return value: New reference. Part of the Stable ABI.
Retorna un nuevo
set
que contiene objetos retornados por iterable. El iterable puede serNULL
para crear un nuevo conjunto vacío. Retorna el nuevo conjunto en caso de éxito oNULL
en caso de error. LanzaTypeError
si iterable no es realmente iterable. El constructor también es útil para copiar un conjunto (c=set(s)
).
-
PyObject *PyFrozenSet_New(PyObject *iterable)¶
- Return value: New reference. Part of the Stable ABI.
Retorna un nuevo
frozenset
que contiene objetos retornados por iterable. El iterable puede serNULL
para crear un nuevo conjunto congelado vacío. Retorna el nuevo conjunto en caso de éxito oNULL
en caso de error. LanzaTypeError
si iterable no es realmente iterable.
Las siguientes funciones y macros están disponibles para instancias de set
o frozenset
o instancias de sus subtipos.
-
Py_ssize_t PySet_Size(PyObject *anyset)¶
- Part of the Stable ABI.
Retorna la longitud de un objeto
set
ofrozenset
. Equivalente alen(anyset)
. Lanza unPyExc_SystemError
si anyset no esset
,frozenset
, o una instancia de un subtipo.
-
Py_ssize_t PySet_GET_SIZE(PyObject *anyset)¶
Forma macro de
PySet_Size()
sin comprobación de errores.
-
int PySet_Contains(PyObject *anyset, PyObject *key)¶
- Part of the Stable ABI.
Retorna
1
si se encuentra,0
si no se encuentra y-1
si se encuentra un error. A diferencia del método Python__contains__()
, esta función no convierte automáticamente conjuntos no compartibles en congelados temporales. Lanza unTypeError
si la key no se puede compartir. LanzaPyExc_SystemError
si anyset no es unset
,frozenset
, o una instancia de un subtipo.
-
int PySet_Add(PyObject *set, PyObject *key)¶
- Part of the Stable ABI.
Añade key a una instancia
set
. También funciona con instancias defrozenset
(al igual quePyTuple_SetItem()
puede usarse para rellenar los valores de nuevos frozensets antes de que sean expuestos a otro código). Retorna0
en caso de éxito o-1
en caso de fallo. Lanza un errorTypeError
si la key no se puede intercambiar. Lanza unMemoryError
si no hay espacio para crecer. Lanza unSystemError
si set no es una instancia deset
o su subtipo.
Las siguientes funciones están disponibles para instancias de set
o sus subtipos, pero no para instancias de frozenset
o sus subtipos.
-
int PySet_Discard(PyObject *set, PyObject *key)¶
- Part of the Stable ABI.
Retorna
1
si se encuentra y se elimina,0
si no se encuentra (no se realiza ninguna acción) y-1
si se encuentra un error. No lanzaKeyError
por faltar claves. Lanza unTypeError
si la key no se puede compartir. A diferencia del método Pythondiscard()
, esta función no convierte automáticamente conjuntos no compartibles en congelados temporales. LanzaPyExc_SystemError
si set no es una instancia deset
o su subtipo.
-
PyObject *PySet_Pop(PyObject *set)¶
- Return value: New reference. Part of the Stable ABI.
Retorna una nueva referencia a un objeto arbitrario en el set y elimina el objeto del set. Retorna
NULL
en caso de falla. LanzaKeyError
si el conjunto está vacío. Lanza aSystemError
si set no es una instancia deset
o su subtipo.
-
int PySet_Clear(PyObject *set)¶
- Part of the Stable ABI.
Vacía un conjunto existente de todos los elementos.