التابع String.new في روبي
ينشئ التابع new سلسلةً نصيةً جديدةً تحوي البيانات المُمرَّرة إليه.
البنية العامة
new(str="") → new_str
new(str="", encoding: enc) → new_str
new(str="", capacity: size) → new_str
المعاملات
str
السلسلة النصية المراد إنشاؤها. القيمة الافتراضية هي: "".
encoding
وسيط مسمى يحدِّد ترميز السلسلة النصية المراد إنشاؤها. وفي حال عدم تحديد القيمة للمفتاح، تكون قيمة المفتاح هي ترميز السلسلة النصية str نفسه؛ وفي حال كانت السلسلة النصية str فارغةً، يأخذ المفتاح قيمة افتراضية ألا وهي "ASCII-8BIT" .
capacity
وسيط مسمى يحدِّد الحجم (بالبايت) الذي ستحجزه السلسلة النصية في ذاكرة التخزين المؤقت. هذا الأمر يؤدي بدوره إلى تسريع الأداء، خصوصًا عندما يتم استدعاء السلسلة النصية مرات عديدة.
القيمة المعادة
تعاد سلسلة نصية جديدة تحوي القيمة str ومرمزة بالترميز encoding وذات حجم capacity.
أمثلة
أمثلة على استعمال التابع new:
n1= String.new(str="wikiHsoub", encoding: "ASCII-8BIT") #=> "wikiHsoub"
n1.encoding #=> <Encoding:ASCII-8BIT>
n2= String.new(str="wikiHsoub") #=> "wikiHsoub"
n2.encoding #=> <Encoding:UTF-8>
n3=String.new(str="") #=> ""
n3.encoding #=> <Encoding:ASCII-8BIT>
انظر أيضًا
- التابع
bytesize: يعيد طول السلسلة النصية التي استدعيت معه بالبايت. - التابع
byteslice: يجلب محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه.