التابع 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: يبحث عن سلسلة أو نمط مُحدد ضمن السلسلة النصية التي استدعيت معها، ثم يُعيد فهرس أول تطابق يعثر عليه.