Ruby/String/partition

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

إذا لم يعثر التابع على تطابق؛، فإنه يعيد مصفوفة من السلسلة النصية المعطاة وسلسلتين فارغتين بعدها على التوالي.

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

partition(sep) → [head, sep, tail]
partition(regexp) → [head, match, tail]

المعاملات

sep

السلسلة النصية المُراد البحث عن تطابق لها ضمن السلسلة النصية المُعطاة.

regexp

التعبير النمطي المراد البحث عن تطابق له ضمن السلسلة المُعطاة.

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

تُعاد مصفوفة تحوي الجزء الذي يسبق الجزء المتطابق، والجزء المتطابق نفسه، والجزء الذي يليه على التوالي.

فى حال عدم العثور على تطابق، تُعاد مصفوفة من السلسلة النصية المعطاة وسلسلتين فارغتين بعدها على التوالي.

أمثلة

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

"hello".partition("l")         #=> ["he", "l", "lo"]
"hello".partition("x")         #=> ["hello", "", ""]
"hello".partition(/.l/)        #=> ["h", "el", "lo"]

انظر أيضًا

• التابع include?‎: يتحقق إذا كانت السلسلة النصية التي استدعيت معها تحتوي على السلسلة النصية أو المحرف المُمرَّر إليها.

• التابع index: يبحث عن سلسلة أو نمط مُحدد ضمن السلسلة النصية التي استدعيت معها، ثم يُعيد فهرس أول تطابق يعثر عليه.

مصادر

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