DESCRIPTION.

Créer un objet séquence, ou collection, qui contient un ensemble muable de valeurs pouvant être de toutes natures d'objets valides. 

SYNTAXE.

ESB_Ensemble = { valeura , ... , valeurn }

ESB_Ensemble ⇨ Nom de la variable [ OBLIGATOIRE ]

= ⇨ affectation de l'ensemble à la variable [ OBLIGATOIRE ]

{ } ⇨ création d'une instance de set ( ) [ OBLIGATOIRE ]

valeura , ... , valeurn ⇨ éléments de l'ensemble [ optionnel ]

ESB_Ensemble = set ( iterable )

ESB_Ensemble ⇨ Nom de la variable [ OBLIGATOIRE ]

= ⇨ affectation de l'ensemble à la variable [ OBLIGATOIRE ]

set ( ) ⇨ appel du constructeur de classe [ OBLIGATOIRE ]

iterable ⇨ objet itérable contenant les valeurs [ optionnel ]

REMARQUES.

valeur peut être n'importe quel objet valide de Python pouvant être comparé, mais non muable. 

iterable doit être un objet collection, ou séquence, nom muable tel que : tuple ( ), bytes ( ) , str ( ) ou set ( ).

Python gère de nombreux types d'objets_variables. Certains sont des collections de valeurs regroupées au sein d'un même objet_variable. Les ensembles, set ( ),  sont des objets_variables composites, comme les listes, où l'on peut enregistrer des valeurs dans un ordre quelconque.

Python propose 2 types d'ensembles, set ( ) et frozenset ( ). On peut les considérer comme des dict ( ) où les valeurs ne sont pas associées à une clé. Le type set ( ) est muable, comme les objets de type list ( ), le nombre de ses éléments peut changer. Le type frozenset ( ) est immuable, les objets de type tuple ( ), le nombre de ses éléments ne peut pas changer. L'avantage des objets ensembles est leur rapidité dans les comparaisons d'ensembles par rapport aux objet list ( ), tuple ( ), dict ( ), ... En contrepartie, la gestion de leurs éléments, recherche et tri par exemple, est plus ardue, du fait qu'ils ne peut pas être indexés.

Comme il est muable, il n'a pas de valeur de hachage, un set ( ) ne peut servir de clef dans un dict ( ) ou comme élément d'un autre ensemble. 

L'ordre d'entrée, et la position, des éléments dans un set ( ) n'est pas mémorisé. Il n'est donc pas possible d'appeler ou d'identifier l'un des éléments d'un set ( ) par un index, ni de retourner un sous-ensemble d'un set ( ) par une méthodes de tranchages (slicing) comme pour les list ( ) et les tuple ( ).

Les instances de set ( ) sont des objets itérables et mutables.

valeur peut être une référence à n'importe quel objet valide dans Python.

Dans la forme ESB_Ensemble = set ( iterable ), iterable peut prendre de nombreuses formes, faisant parfois intervenir des méthodes builtin pour sa constitution. 

Bien qu'étant un raccourcit, la forme de création ESB_Ensemble = { valeura , ... , valeurn } est à privilégier.

Les variables globales de type set ( ) sont identifiées dans le site par : ESB_. 

Voir les conventions sur les variables utilisées dans ce site ...

CRÉER UN ENSEMBLE MUTABLE.

Voir le tutoriel sur les ensembles mutables ...

MÉTHODES SPÉCIFIQUES AUX OBJETS SET. 

add ( ) : ajoute un élément à l'ensemble. 

clear ( ) : supprime tous les éléments de ensemble.

copy ( ) : créer une copie superficielle de l'ensemble.

difference ( ) : retourne la différence entre ensembles dans un ensemble.

difference_update ( ) : retourne la différence entre ensembles.

discard ( ) : supprime un élément, s'il existe, de l'ensemble. 

intersection ( ) : retourne l'intersection entre ensembles dans un ensemble.

intersection_update ( ) : retourne l'intersection entre ensembles.

isdisjoint ( ) : teste si des ensembles n'ont aucun élément commun.

issubset ( ) : teste si un ensemble est comprit dans un autre.

issuperset ( ) : teste si un ensemble en englobe totalement un autre.

pop ( ) : retourne aléatoirement un élément, puis le supprime de l'ensemble.

remove ( ) : supprime un élément de l'ensemble.

symmetric_difference ( ) : retourne les éléments présents une seule fois dans deux ensembles.

symmetric_difference_update ( ) : supprime les éléments présents dans un l'autre ensemble.

union ( ) : fusionne plusieurs ensembles dans un nouvel ensemble. 

update ( ) : ajoute tous les éléments présents dans d'autres ensembles.