Cairo fournit des dictionnaires au sein de ses bibliothèques standard, représentés par le type Felt252Dict<T>.
Dans Cairo, le type des clés d'un dictionnaire est limité à felt252, contrairement à d'autres langages où l'on peut définir le type des clés.
Pour créer un dictionnaire, on peut utiliser la méthode default du trait Default, comme ceci :
let mut foo: Felt252Dict<u32> = Default::default();
Les opérations de base les plus souvent utilisées sont :
insert(felt252, T) -> () pour écrire des valeurs dans une instance de dictionnaire, etget(felt252) -> T pour en lire des valeurs.Et voici comment on utilise ces opérations :
let mut foo: Felt252Dict<u32> = Default::default();
// Add a value to the dictionariy
foo.insert('bar', 42);
// Here we update the element of 'bar'
foo.insert('bar', 73);
// To retrieve a dictionary value, you can use
baz = foo.get('bar');
Si tu essaies de récupérer la valeur associée à une clé qui n'existe pas dans le dictionnaire, c'est la valeur zéro du type de valeur qui est renvoyée.
Cela peut prêter à confusion, surtout si la valeur par défaut de ton type de valeur (par exemple 0 pour un entier) est une valeur valide.
Cela signifie aussi qu'il n'existe aucun moyen de supprimer des données d'un dictionnaire.
C'est un point à garder en tête lorsque tu intègres cette structure dans ton code.
Un de tes amis tient un vieux magasin de gros appelé Gross Store.
Le nom vient de la quantité d'articles que le magasin vend : tout est exprimé en grosse unité.
Ton ami t'a demandé de mettre en place un système de point de vente (POS) pour son magasin.
Pour commencer, tu veux en construire un prototype.
Dans ton prototype, ton système ne fera qu'enregistrer la quantité.
Ton ami t'a donné une liste de mesures pour t'aider :
| Unité | Valeur |
|---|---|
| quarter_of_a_dozen | 3 |
| half_of_a_dozen | 6 |
| dozen | 12 |
| small_gross | 120 |
| gross | 144 |
| great_gross | 1728 |
Pour pouvoir utiliser la mesure, tu dois la stocker dans ton programme.
let units = units();
// Felt252Dictionary with entries like { 'dozen': 12 }
Tu dois implémenter une fonction qui crée une nouvelle facture (vide) pour le client.
let bill = new_bill();
// Empty Felt252Dictionary
Pour cela, tu vas devoir :
false si unit ne fait pas partie du dictionnaire units.bill du client en l'indexant par le nom de l'article, puis renvoyer true.unit.let bill = new_bill();
let units = units();
let ok = add_item(bill, units, 'carrot', 'dozen');
println!(ok);
// Output: true (since dozen is a valid unit)
Note que la valeur renvoyée est de type
bool.
Pour cela, tu vas devoir :
false si l'article donné n'est pas dans la facture.
Un article est considéré comme absent de la facture si sa quantité vaut 0.false si unit ne fait pas partie du dictionnaire units.false si la nouvelle quantité devait être inférieure à 0.bill, tu peux donc renvoyer true.true.let bill = new_bill();
let units = units();
let ok = remove_item(bill, units, 'carrot', 'dozen');
println!(ok);
// Output: false (because there are no carrots in the bill)
Note que la valeur renvoyée est de type
bool.
let mut bill: Felt252Dict<u32> = Default::default();
bill.insert('carrot', 12);
bill.insert('grapes', 3);
let qty = get_item(bill, 'carrot');
println!(qty);
// Output: 12
Note que la valeur renvoyée est de type
u32.
Inscris-toi sur Exercism pour apprendre et maîtriser Cairo avec 25 concepts68 exercices, et un vrai mentorat humain, le tout gratuitement.