Struct هي فئة مدمجة في Ruby لإنشاء فئات بسيطة بسرعة تجمع معاً عدداً قليلاً من السمات — حيث تقوم بإنشاء المُنشئ والوصول والمساواة تلقائياً وغير ذلك. إنها طريقة موجزة لتعريف فئات بيانات خفيفة الوزن دون الحاجة إلى كتابة فئة كاملة.
,
()
= x
= y
()
x == other.x && y == other.y
= .new(, )
Struct.new(:x, :y) تُنشئ فئة بها مُنشئ، attr_accessor لـ x و y، مساواة قائمة على القيمة، to_s، وغير ذلك — مما يلغي الكود المعياري لفئة بيانات بسيطة.
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 وسائل الوصول و مساواة قائمة على القيمة (هيكلان بنفس السمات متساويان — وهو أمر مريح لكائنات البيانات)، ويمكنك إضافة طرق مخصصة في كتلة برمجية.
# 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 في Ruby 3.2 هو متغير غير قابل للتغيير من Struct — مثالي لكائنات القيمة التي لا يجب أن تتغير.
Struct هي ميزة Ruby مفيدة لإنشاء فئات بيانات بسيطة بسرعة دون كود معياري، لذلك فهم هذا مفيد لكتابة Ruby موجزة وواضحة.
الفائدة الأساسية هي القضاء على الكود المتكرر الذي تتطلبه فئة بسيطة تحمل البيانات — بدلاً من كتابة فئة كاملة بمُنشئ و attr_accessor ومساواة، فإن Struct.new(:x, :y) تُنشئ كل ذلك في سطر واحد، بما في ذلك مساواة قائمة على القيمة (هيكلان بنفس السمات متساويان، وهو ما تريده لكائنات البيانات وهذا يختلف عن مساواة المرجع للفئات العادية).
هذا يجعل Struct مثالية للبنى البيانات الخفيفة الوزن، كائنات القيمة، إرجاع قيم مجمعة من الطرق، والسجلات البسيطة حيث ستكون فئة كاملة إفراطاً — أداة إنتاجية عملية تحافظ على الكود موجزاً.
فهم Struct (فئات بيانات موجزة بوسائل وصول مُنشأة ومساواة قيم، بالإضافة إلى القدرة على إضافة طرق مخصصة)، والـ Structs الموجهة بالكلمات المفتاحية (أوضح بكثير للعديد من الحقول)، و Data الحديث (بديل Ruby 3.2 غير القابل للتغيير لكائنات القيمة التي لا يجب أن تتغير) هو معرفة قيمة لنمذجة البيانات البسيطة بأناقة.
نظراً لأن تعريف فئات البيانات الصغيرة هي حاجة شائعة، وبما أن Struct (و Data) توفر طريقة موجزة وموحية لفعل ذلك مع سلوك مُنشأ مفيد (خاصة مساواة القيمة)، فإن معرفة متى تستخدم Struct/Data مقابل فئة كاملة هي معرفة Ruby عملية ذات صلة تعكس كتابة كود نظيف وموجز — أداة مفيدة في مجموعة أدوات مطور Ruby للمهمة المتكررة لتجميع السمات ذات الصلة في نوع خفيف الوزن، مجسدة تركيز Ruby على الإيجاز وتقليل الكود المعياري.