Rust - Usando Structs

Uma struct, ou estrutura, é um tipo de dados personalizado que nos permite nomear e criar um conjunto de vários valores relacionados que compõem um grupo de dados. Se você estiver familiarizado com uma linguagem orientada a objeto, um struct é como os atributos de dados de um objeto.

Existe três tipos de estruturas que são:

• Estrutura de tuplas que são, basicamente denominadas por tuplas.
• Temos aquela clássica estrutura do C.
• Temos a estrutura de unidade, que são sem campo, são uteis para os genéricos.

 struct Tuplestruct(i32, i32); fn main() { let number = Tuplestruct(10, 20); // Destructure let Tuplestruct(x, y) = number; println!("x: {}, y: {}", x, y); } /* x: 10, y: 20 */ 

Código acima temos uma estrutura com tuplas. Criamos struct na linha 2 informando que terá dois números inteiros, dentro da função main importamos dois números para estrutura após a importação retiramos o mesmo da estrutura e imprimimos abaixo. Nesse exemplo temos uma estrutra de tuplas de uma forma simples.

 struct NormalStruct { a: i32, b: i32, } fn main() { let ns = NormalStruct { a: 1, b: 2 }; // Destructure let NormalStruct { a, b } = ns; println!("a: {}, b: {}", a, b) } /* a: 1, b: 2 */ 

Código acima temos uma estrutura comum, criamos uma structs na linha 2 informando que teremos a e b sendo inteiros, dentro da função main importamos números a e b com os números após retiramos os valores da estrutura e imprimimos abaixo.

Mas realmente, como podemos usar isso de forma útil ?

 #[derive(Debug)] struct User { username: String, email: String, active: bool, } fn main() { let user = build_user( String::from("contato@higordiego.com.br"), String::from("Higor Diego"), ); println!("email: {}, active: {}", user.email, user.active); } fn build_user(email: String, username: String) -> User { User { username: username, email: email, active: true, } } /* email: contato@higordiego.com.br, active: true */ 

Então, vamos pensar da seguinte forma, o código acima tem estrutura para receber usuários, o struct possui atributos de um sistema simples onde temos o nome e email e se o usuário está ativo ou não no sistema. Criamos uma função para gerar esse usuário retornando sua estrutura e após isso na função main imprimimos os valores contidos.

Se parar para pensar um pouco esse struct lembra um modelo ou esquema de um ORM isso é muito familiar para as pessoas que já desenvolvem.

Vamos para um exemplo prático.

Iremos fazer uma chamada nessa API http://ip-api.com/json/187.19.230.194 o retorno dela vem com um JSON da seguinte forma.

{ "as": "AS28126 BRISANET SERVICOS DE TELECOMUNICACOES LTDA", "city": "Jaguaribe", "country": "Brazil", "countryCode": "BR", "isp": "Brisanet Servicos De Telecomunicacoes Ltda", "lat": -6.05537, "lon": -38.506, "org": "Brisanet Servicos De Telecomunicacoes Ltda", "query": "187.19.230.194", "region": "CE", "regionName": "Ceará", "status": "success", "timezone": "America/Fortaleza", "zip": "63475-000" } 

Iremos criar uma struct que armazena alguns dados desse retorno, segue o exemplo abaixo.

 extern crate reqwest; use serde::{Deserialize}; #[derive(Debug)] #[derive(Deserialize)] struct Information { city: String, country: String } fn main() -> Result<(), Box<std::error::Error>> { let resp: Information = reqwest::get("http://ip-api.com/json/187.19.230.194")?.json()?; println!("city: {}", resp.city); println!("country: {}", resp.country); Ok(()) } /* city: Jaguaribe country: Brazil */ 

No código acima requisitamos a url usando um pacote chamado request com o método GET informamos que o retorno será em json, após o retorno injetamos os dados no struct e com esse dados pegamos dois atributos daquele json que é o city e country, e por fim imprimimos no console.

O struct é muito útil para estruturar os seus dados, vamos utilizar ele bastante aqui nos próximos posts.

Então galera é isso, espero que tenham gostado até a próxima.