Registros (Dart 3)

Parte da seção Programação Orientada a Objetos do Journey de Dart da Coddy. Lição 86 de 110.

O Dart 3 introduziu records — uma maneira leve de agrupar vários valores sem criar uma classe completa. Os records são imutáveis, têm igualdade integrada e são perfeitos para retornar vários valores de uma função ou agrupar temporariamente dados relacionados.

Crie um registro envolvendo valores entre parênteses:

void main() {
  // Um registro simples com dois valores
  var point = (10, 20);
  print(point.$1);  // 10 - acessa o primeiro elemento
  print(point.$2);  // 20 - acessa o segundo elemento
  
  // Registros com campos nomeados
  var person = (name: 'Alice', age: 30);
  print(person.name);  // Alice
  print(person.age);   // 30
}

Campos posicionais são acessados com $1, $2, etc., enquanto campos nomeados usam seus nomes diretamente. Você pode misturar ambos os estilos em um único registro.

Os records se destacam ao retornar vários valores de funções — não é necessário criar uma classe apenas para retornar duas partes de dados:

(int, int) divideWithRemainder(int a, int b) {
  return (a ~/ b, a % b);
}

(String name, int age) getUser() {
  return ('Bob', 25);
}

void main() {
  var (quotient, remainder) = divideWithRemainder(17, 5);
  print('$quotient remainder $remainder');  // 3 resto 2
  
  var (name, age) = getUser();
  print('$name is $age');  // Bob é 25
}

Os records oferecem suporte automático à igualdade com base em seus valores, tornando-os convenientes para comparações sem que você precise implementar ==. Use records quando precisar de agrupamentos de dados simples e imutáveis; use classes quando precisar de métodos, mutabilidade ou um comportamento mais complexo.

Desafio

Fácil

Vamos criar um sistema de coordenadas usando records! Você criará funções que trabalham com pontos 2D representados como records, demonstrando como os records facilitam retornar e trabalhar com vários valores relacionados sem criar classes completas.

Você organizará seu código em dois arquivos:

geometry.dart: crie funções que usam records para trabalhar com dados de coordenadas:
- Uma função createPoint(int x, int y) que retorna um record com os campos nomeados x e y. O tipo de retorno deve ser ({int x, int y})
- Uma função midpoint(({int x, int y}) p1, ({int x, int y}) p2) que calcula e retorna o ponto médio entre dois pontos como um record com campos nomeados. Use divisão inteira (~/) para o cálculo
- Uma função distance(({int x, int y}) p1, ({int x, int y}) p2) que retorna um record com campos posicionais: a distância horizontal (diferença em x) e a distância vertical (diferença em y). O tipo de retorno deve ser (int, int). Calcule como p2.x - p1.x e p2.y - p1.y
main.dart: importe seu arquivo de geometria e demonstre os records em ação:
- Crie dois pontos usando createPoint: o ponto A em (2, 4) e o ponto B em (10, 8)
- Imprima Point A: ([x], [y]) usando os campos nomeados
- Imprima Point B: ([x], [y]) usando os campos nomeados
- Calcule o ponto médio e imprima Midpoint: ([x], [y])
- Calcule a distância e use a desestruturação para extrair os valores para as variáveis dx e dy; em seguida, imprima Distance: dx=[dx], dy=[dy]

Observe como os records permitem retornar vários valores de forma organizada: use campos nomeados para maior clareza quando o significado for importante e campos posicionais quando o contexto for óbvio!

Saída esperada:

Point A: (2, 4)
Point B: (10, 8)
Midpoint: (6, 6)
Distance: dx=8, dy=4

Experimente você mesmo

import 'geometry.dart';

void main() {
  // TODO: Crie o ponto A em (2, 4) usando createPoint
  
  // TODO: Crie o ponto B em (10, 8) usando createPoint
  
  // TODO: Imprima o Ponto A usando campos nomeados: Point A: ([x], [y])
  
  // TODO: Imprima o Ponto B usando campos nomeados: Point B: ([x], [y])
  
  // TODO: Calcule o ponto médio e imprima: Midpoint: ([x], [y])
  
  // TODO: Calcule a distância e use a desestruturação para extrair em dx e dy
  // Em seguida, imprima: Distance: dx=[dx], dy=[dy]
}