DESCRIPTION.

Retourne la valeur associée à une clé, si elle existe, d'un dict ( ), sinon Python créé et ajoute un couple clé:valeur dans le dict ( ), à partir des arguments fournis. 

SYNTAXE.

Valeur = DCT_Donnees.setdefault ( cle , valeur )

Valeur = ⇨ variable qui recevra la valeur [ optionnel ]

DCT_Donnees ⇨ nom du dictionnaire [ OBLIGATOIRE ]

.setdefault ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

cle ⇨ clé à rechercher [ OBLIGATOIRE ]

valeur ⇨ valeur à associer si la clé est absente [ optionnel ]

REMARQUES.

cle est le nom d'une des clés du dict ( ) ou une forme valide pour la création d'une clé d'un dict ( ).

valeur est une forme valide pour la valeur de cle.

La méthode dict ( ).setdefaut ( ) peut ajouter un couple clé:valeur, si il n'est pas déjà présent, avec une certaine valeur dans un dict ( ). Si cle est présente dans le dict ( ), la valeur associée n'est pas modifiée, sinon la méthode dict ( ).setdefaut ( ) ajoute le couple cle : valeur, ou cle : None si valeur est omise, à la fin du dict ( ).

Si cle est présente dans le dict ( ), sa valeur associée est retournée, sinon Python retourne valeur, ou None.

DCT_Donnees doit être un dictionnaire existant et valide, même s'il ne possède aucun couple clé:valeur (dictionnaire vide : { }).

EXEMPLES.

DCT_Fruits = { "pomme" : "jaune" , "kiwi" : "vert" , "fraise" : "rouge" , "myrtille" : "bleu"  }

print ( DCT_Fruits.setdefault ( "pomme" ) ) retourne jaune

print ( DCT_Fruits.setdefault ( "orange" ) ) retourne None

print ( DCT_Fruits.setdefault ( "fraise" ,"rose" ) ) retourne rouge

print ( DCT_Fruits.setdefault ( "banane" ,"jaune" ) ) retourne jaune

print ( DCT_Fruits ) retourne {'pomme': 'jaune', 'kiwi': 'vert', 'fraise': 'rouge', 'myrtille': 'bleu', 'orange': None, 'banane': 'jaune'}

DCT_Fruits = { "pomme" : "jaune" , "kiwi" : "vert" , "fraise" : "rouge" , "myrtille" : "bleu"  }

Nouveau = DCT_Fruits.setdefault ( "kiwi" ) 

print ( Nouveau ) retourne vert

Nouveau = DCT_Fruits.setdefault ( "peche" ) 

print ( Nouveau ) retourne None

Nouveau = DCT_Fruits.setdefault ( "myrtille" , "violet" ) 

print ( Nouveau ) retourne bleu

Nouveau = DCT_Fruits.setdefault ( "abricot" , "orange" ) 

print ( Nouveau ) retourne orange

print ( DCT_Fruits ) retourne {'pomme': 'jaune', 'kiwi': 'vert', 'fraise': 'rouge', 'myrtille': 'bleu', 'peche': None, 'abricot': 'orange'}