Co to jest Struct i kiedy go używasz?

Question

Accepted Answer

**`Struct`** to wbudowana klasa Ruby do szybkiego tworzenia prostych klas, które łączą razem kilka **atrybutów** — automatycznie generując konstruktor, dostępniki, równość i wiele więcej. To zwięzły sposób na zdefiniowanie lekkich klas danych bez pisania pełnej klasy.

## Dlaczego to ważne

```ruby
# ❌ a full class for simple data is verbose boilerplate
class Point
  attr_accessor :x, :y
  def initialize(x, y)
    @x = x
    @y = y
  end
  def ==(other)
    x == other.x && y == other.y
  end
end

# ✅ Struct does all of that in ONE line
Point = Struct.new(:x, :y)
```

`Struct.new(:x, :y)` generuje klasę z konstruktorem, `attr_accessor`ami dla `x` i `y`, równością opartą na wartościach, `to_s` i wiele więcej — eliminując powtarzalny kod prostej klasy danych.

## Używanie Struct

```ruby
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
```

Structy dostarczają dostępników i **równości opartej na wartościach** (dwa structy z równymi atrybutami są równe — wygodne dla obiektów danych), a można dodać niestandardowe metody w bloku.

## Structy inicjalizowane słowami kluczowymi i Data (Ruby 3.2)

```ruby
# 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
```

**`Data`** z Ruby 3.2 to niezmienna wariant Struct — idealna dla obiektów wartościowych, które nie powinny się zmieniać.

## Dlaczego to ważne

`Struct` to użyteczna funkcja Ruby do **szybkiego tworzenia prostych klas danych** bez powtarzalnego kodu, dlatego zrozumienie jej jest wartościowe dla pisania zwięzłego, czystego Ruby.

Główna korzyść to eliminacja powtarzającego się kodu, który wymaga prosta klasa przechowująca dane — zamiast pisania pełnej klasy z konstruktorem, `attr_accessor`ami i równością, `Struct.new(:x, :y)` generuje to wszystko w jednej linii, w tym **równość opartą na wartościach** (dwa structy z równymi atrybutami są równe, co jest tym, czego chcesz dla obiektów danych, i różni się od równości referencyjnej zwykłych klas).

Czyny Struct idealnym dla lekkich struktur danych, obiektów wartościowych, zwracania pogrupowanych wartości z metod i prostych rekordów, gdzie pełna klasa byłaby przesadą — praktyczne narzędzie produktywności, które utrzymuje kod zwięzły.

Zrozumienie Struct (zwięzłe klasy danych z generowanymi dostępnikami i równością wartości, plus możliwość dodawania niestandardowych metod), structów inicjalizowanych słowami kluczowymi (jaśniejsze dla wielu pól) i nowoczesnej klasy **`Data`** (niezmienna alternatywa Ruby 3.2 dla obiektów wartościowych, które nie powinny się zmieniać) jest cenną wiedzą do eleganckiego modelowania prostych danych.

Ponieważ definiowanie małych klas danych jest powszechną potrzebą, a Struct (i Data) zapewniają zwięzły, idiomatyczny sposób robienia tego z użytecznym generowanym zachowaniem (szczególnie równością wartości), wiedza o tym, kiedy sięgnąć po Struct/Data zamiast pełnej klasy, to praktycznie istotna wiedza Ruby, która odzwierciedla pisanie czystego, zwięzłego kodu — użyteczne narzędzie w zestawie narzędzi dewelopera Ruby do częstego zadania łączenia powiązanych atrybutów w lekki typ, ucieleśniającego nacisk Ruby na zwięzłość i zmniejszenie powtarzalnego kodu.