Struct é uma classe embutida do Ruby para criar rapidamente classes simples que agrupam alguns atributos — gerando automaticamente o construtor, acessadores, igualdade e muito mais. É uma forma concisa de definir classes de dados leves sem escrever uma classe completa.
,
()
= x
= y
()
x == other.x && y == other.y
= .new(, )
Struct.new(:x, :y) gera uma classe com um construtor, attr_accessors para x e y, igualdade baseada em valor, to_s e muito mais — eliminando o código repetitivo de uma classe de dados simples.
Point = Struct.new(:x, :y)
p = Point.new(1, 2)
p.x # 1 — accessor generated
p.y = 5 # setter generated
p == Point.new(1, 5) # true — VALUE-based equality (generated)
p.to_a # [1, 5] — convertible
# Structs can have methods too
Point = Struct.new(:x, :y) do
def distance_from_origin
Math.sqrt(x**2 + y**2)
end
end
Point.new(3, 4).distance_from_origin # 5.0
Structs fornecem acessadores e igualdade baseada em valor (duas structs com atributos iguais são iguais — conveniente para objetos de dados), e você pode adicionar métodos personalizados em um bloco.
# keyword arguments (clearer for many fields)
Point = Struct.new(:x, :y, keyword_init: true)
Point.new(x: 1, y: 2)
# Data (Ruby 3.2+) — an IMMUTABLE alternative to Struct (for value objects)
Point = Data.define(:x, :y)
p = Point.new(1, 2)
p.x # 1 (read-only — immutable)
p2 = p.with(x: 5) # non-destructive copy with a change
O Data do Ruby 3.2 é uma variante imutável de Struct — ideal para objetos de valor que não devem mudar.
Struct é um recurso útil do Ruby para criar rapidamente classes de dados simples sem código repetitivo, então entendê-lo é valioso para escrever Ruby conciso e limpo.
O benefício principal é eliminar o código repetitivo que uma classe simples de armazenamento de dados requer — em vez de escrever uma classe completa com um construtor, attr_accessors e igualdade, Struct.new(:x, :y) gera tudo isso em uma linha, incluindo igualdade baseada em valor (duas structs com atributos iguais são iguais, que é o que você quer para objetos de dados e difere da igualdade por referência de classes regulares).
Isso torna Struct ideal para estruturas de dados leves, objetos de valor, retornar valores agrupados de métodos e registros simples onde uma classe completa seria excessiva — uma ferramenta prática de produtividade que mantém o código conciso.
Entender Struct (classes de dados concisas com acessadores gerados e igualdade de valor, além da capacidade de adicionar métodos personalizados), structs com inicialização por palavra-chave (mais claro para muitos campos) e a classe Data moderna (alternativa imutável do Ruby 3.2 para objetos de valor que não devem mudar) é um conhecimento valioso para modelar dados simples elegantemente.
Como definir pequenas classes de dados é uma necessidade comum, e como Struct (e Data) fornecem uma forma concisa e idiomática de fazer isso com comportamento gerado útil (especialmente igualdade de valor), saber quando recorrer a Struct/Data versus uma classe completa é um conhecimento Ruby praticamente relevante que reflete escrever código limpo e conciso — uma ferramenta útil no kit de ferramentas do desenvolvedor Ruby para a tarefa frequente de agrupar atributos relacionados em um tipo leve, incorporando a ênfase do Ruby em concisão e redução de código repetitivo.