Ruby/Struct/new

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

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

# 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">

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

Customer = Struct.new(:name, :address, keyword_init: true)
Customer.new(name: "Dave", address: "123 Main")
#=> #<struct Customer name="Dave", address="123 Main">

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

Customer = Struct.new(:name, :address) do
  def greeting
    "Hello #{name}!"
  end
end
Customer.new("Dave", "123 Main").greeting  #=> "Hello Dave!"

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

الشكلان الأخيران (انظر فقرة البنية العامة) يُنشئان نسخة جديدة من صنف فرعي لـ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‎

المعاملات

class_name‎

اسم البنية.

member_name

اسم العضو.

keyword_init

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

value‎

قيمة.

القيمة المُعادة

يعيد التابع new بنية جديدة.

أمثلة

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

Customer = Struct.new(:name, :address)
Customer.new("Dave", "123 Main")
#=> #<struct Customer name="Dave", address="123 Main">
Customer["Dave"]
#=> #<struct Customer name="Dave", address=nil>

انظر أيضا

• صفحة البنيات.

مصادر

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