التابع new‎ الخاص بالصنف Struct في روبي

يُستخدم الشكلان الأولان (انظر فقرة البنية العامة) لإنشاء صنف فرعي جديد من Struct يحمل الاسم class_name، والذي يمكن أن يحتوي قيمة لكل وسيط member_name. يمكن استخدام هذا الصنف الفرعي لإنشاء نسخ من البنية مثل أي صنف (Class) آخر.

إذا لم يُعط الوسيط class_name، فستُنشؤ بنية مجهولة. وبخلاف ذلك، سيظهر اسم هذه البنية كثابتة في البنية Struct ، لذلك يجب أن يكون فريدًا في جميع البنيةات المٌعرّفة في النظام، ويجب أن يبدأ بحرف كبير. إحالة (Assigning) بنية إلى ثابت سيؤدي إلى اعتماد البنية اسم الثابت كاسم لها.

إذا مُرٍّر إلى الوسيط الاختياري keyword_init القيمة true، فسيأخذ التابع new وسائط مسماة (keyword arguments) بدلاً من الوسائط العادية.

إذا تم إعطاء كتلة سيتم تقييمها في سياق StructClass، وسيُمرّر إليها الصنف الذي تم إنشاؤه كوسيط:

هذه هي الطريقة الموصى بها لتخصيص البنية. تؤدي الأصناف الفرعية أو المجهولة للبنية إلى إنشاء أصناف مجهولة إضافية، والتي لن يتم استخدامها.

الشكلان الأخيران (انظر فقرة البنية العامة) الأخيرين ينشئان نسخة جديدة من صنف فرعي للصنف Struct. يجب أن يكون عدد الوسائط value أصغر من أو يساوي عدد الخاصيات المعرّفة في البنية. القيمة الافتراضية للوسائط غير المعينة هي nil. إن كان عدد الوسائط المُمررة أكثر من عدد الخاصيات فسيُطلق الاستثناء ArgumentError.

البنية العامة

new([class_name] [, member_name]+)→ StructClass
new([class_name] [, member_name]+, keyword_init: true) → StructClass
new([class_name] [, member_name]+) {|StructClass| block } → StructClass
new(value, ...)  → object
StructClass[value, ...]→ object‎

أمثلة

مثال على استخدام التابع new‎:

# Create a structure with a name under Struct
Struct.new("Customer", :name, :address)
#=> Struct::Customer
Struct::Customer.new("Dave", "123 Main")
#=> #<struct Struct::Customer name="Dave", address="123 Main">
# Create a structure named by its constant
Customer = Struct.new(:name, :address)
#=> Customer
Customer.new("Dave", "123 Main")
#=> #<struct Customer name="Dave", address="123 Main">‎

انظر أيضا

• التابع ==: معامل التساوي - تُعاد القيمة true إن كان للبنية other (انظر فقرة البنية العامة) نفس الصنف الفرعي، وكان لها نفس قيم الأعضاء مقارنة بالبنية التي استُدعي معها.

مصادر

• قسم التابع new‎ في الصنف Struct‎ في توثيق روبي الرسمي.