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 para objetos set
y frozenset
. Se puede acceder mejor a cualquier funcionalidad que no se enumere a continuación utilizando el protocolo de objeto abstracto (que incluye PyObject_CallMethod()
, PyObject_RichCompareBool()
, PyObject_Hash()
, PyObject_Repr()
, PyObject_IsTrue()
, PyObject_Print()
, y PyObject_GetIter()
) o el protocolo de número abstracto (que incluye 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 contener los datos internos de los objetosset
yfrozenset
. Es como unPyDictObject
en el sentido de que es un tamaño fijo para conjuntos pequeños (muy parecido al almacenamiento de tuplas) y apuntará a un bloque de memoria separado de tamaño variable para conjuntos de tamaño medio y grande (muy similar a la lista almacenamiento). Ninguno de los campos de esta estructura debe considerarse público y está sujeto a cambios. Todo el acceso debe hacerse a través de la API documentada en lugar de manipular los valores en 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.
Agrega key a una instancia de
set
. También funciona con instanciasfrozenset
(comoPyTuple_SetItem()
se puede usar para completar los valores de los frozensets nuevos antes de que estén expuestos a otro código). Retorna0
en caso de éxito o-1
en caso de error. Lanza unTypeError
si la key no se puede compartir. 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.