التابع String.try_convert في روبي

يحاول التابع try_convert تحويل الكائن الذي مُرِّر إليه إلى سلسلة نصية. يجري هذا التابع عملية التحويل باستعمال التابع to_str.

ملاحظة: يمكن استعمال الدالة to_s لتحويل الكائنات إلى سلاسل نصية إن أمكن أيضًا.

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

try_convert(obj) → string or nil

المعاملات

obj

الكائن المراد تحويله إلى سلسلة نصية.

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

تعاد سلسلة نصية تمثِّل ناتج تحويل الكائن obj، أو تعاد القيمة nil إن لم يكن بالإمكان إجراء عملية التحويل لأي سبب كان.

أمثلة

مثال على استعمال التابع try_convert:

String.try_convert("str")     #=> "str"
String.try_convert(/re/)      #=> nil

انظر أيضًا

• التابع bytesize: يعيد طول السلسلة النصية التي استدعيت معه بالبايت.
• التابع byteslice: يجلب محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه.

مصادر

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