Records (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. Records são imutáveis, possuem igualdade integrada e são perfeitos para retornar múltiplos valores de uma função ou agrupar dados relacionados temporariamente.

Crie um record envolvendo os valores entre parênteses:

void main() {
  // Um record simples com dois valores
  var point = (10, 20);
  print(point.$1);  // 10 - acessa o primeiro elemento
  print(point.$2);  // 20 - acessa o segundo elemento
  
  // Records 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.

Records se destacam ao retornar múltiplos valores de funções - não há necessidade de criar uma classe apenas para retornar dois pedaços 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 tem 25
}

Records suportam automaticamente igualdade baseada em seus valores, tornando-os convenientes para comparações sem que você precise implementar == manualmente. Use records quando precisar de agrupamentos de dados simples e imutáveis; use classes quando precisar de métodos, mutabilidade ou comportamento mais complexo.

Desafio

Fácil

Vamos construir um sistema de coordenadas usando records! Você criará funções que trabalham com pontos 2D representados como records, demonstrando como os records facilitam o retorno e o trabalho com múltiplos valores relacionados sem a necessidade de 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 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 a 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: ponto A em (2, 4) e ponto B em (10, 8)
- Imprima Point A: (${pointA.x}, ${pointA.y}) usando os campos nomeados
- Imprima Point B: (${pointB.x}, ${pointB.y}) usando os campos nomeados
- Calcule o ponto médio e imprima Midpoint: (${mid.x}, ${mid.y})
- Calcule a distância e use a desestruturação para extrair os valores para as variáveis dx e dy, depois imprima Distance: dx=$dx, dy=$dy

Observe como os records permitem retornar múltiplos valores de forma limpa - campos nomeados para clareza quando o significado importa, e campos posicionais quando o contexto é óbvio!

Saída esperada:

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

Folha de consulta

O Dart 3 introduziu records (registros) - uma maneira leve de agrupar vários valores sem criar uma classe completa. Records são imutáveis e perfeitos para retornar múltiplos valores de uma função.

Crie um record envolvendo os valores em parênteses:

// Record simples com campos posicionais
var point = (10, 20);
print(point.$1);  // 10 - acessa o primeiro elemento
print(point.$2);  // 20 - acessa o segundo elemento

// Records 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.

Records são ideais para retornar múltiplos valores de funções:

// O tipo de retorno especifica a estrutura do record
(int, int) divideWithRemainder(int a, int b) {
  return (a ~/ b, a % b);
}

// Campos nomeados no tipo de retorno
(String name, int age) getUser() {
  return ('Bob', 25);
}

// Desestruturando records
var (quotient, remainder) = divideWithRemainder(17, 5);
print('$quotient remainder $remainder');  // 3 remainder 2

var (name, age) = getUser();
print('$name is $age');  // Bob is 25

Tipos de retorno de record com campos nomeados usam chaves:

({int x, int y}) createPoint(int x, int y) {
  return (x: x, y: y);
}

Records suportam automaticamente igualdade baseada em seus valores.

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]
}