Cairo disponibiliza dicionários como parte das suas bibliotecas principais, representados pelo tipo Felt252Dict<T>.
Em Cairo, o tipo das chaves de um dicionário está limitado a felt252, o que é diferente de outras linguagens, onde é possível definir o tipo da chave.
Para criar um dicionário, podes usar o método default do trait Default, assim:
let mut foo: Felt252Dict<u32> = Default::default();
As operações básicas mais utilizadas são:
insert(felt252, T) -> () para escrever valores numa instância de dicionário eget(felt252) -> T para ler valores a partir dela.E é assim que usarias estas operações:
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');
Se tentares obter o valor de uma chave que não existe no dicionário, é devolvido o valor zero do tipo de valor.
Isto pode baralhar-te, sobretudo se o valor predefinido do teu tipo de valor (por exemplo, 0 para um número inteiro) for um valor válido.
Também significa que não há forma de eliminar dados de um dicionário.
Algo a ter em conta quando integrares esta estrutura no teu código.
Um amigo teu tem uma antiga loja grossista chamada Gross Store.
O nome vem da quantidade de artigos que a loja vende: é tudo em grosas.
O teu amigo pediu-te para implementares um sistema de ponto de venda (POS) para a loja dele.
Primeiro, queres construir um protótipo para o sistema.
No teu protótipo, o sistema vai apenas registar a quantidade.
O teu amigo deu-te uma lista de medidas para te ajudar:
| Unidade | Valor |
|---|---|
| quarter_of_a_dozen | 3 |
| half_of_a_dozen | 6 |
| dozen | 12 |
| small_gross | 120 |
| gross | 144 |
| great_gross | 1728 |
Para usares a medida, tens de a guardar no teu programa.
let units = units();
// Felt252Dictionary with entries like { 'dozen': 12 }
Tens de implementar uma função que cria uma nova conta (vazia) para o cliente.
let bill = new_bill();
// Empty Felt252Dictionary
Para implementares isto, tens de:
false se a unit indicada não estiver no mapa units.bill do cliente, indexado pelo nome do artigo, e devolver true.unit indicada.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)
Repara que o valor devolvido é do tipo
bool.
Para implementares isto, tens de:
false se o artigo indicado não estiver na conta.
Considera-se que um artigo não está na conta quando a sua quantidade é 0.false se a unit indicada não estiver no mapa units.false se a nova quantidade ficar abaixo de 0.bill, por isso podes devolver 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)
Repara que o valor devolvido é do tipo
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
Repara que o valor devolvido é do tipo
u32.
Inscreve-te no Exercism para aprenderes e dominares Cairo com 25 conceitos68 exercícios, e mentoria humana real, tudo grátis.