Kotlin/kotlin.text/Regex/toPattern

تعيد الدالةtoPattern()‎ نسخة من الصنف Pattern والتي لها نفس السلسلة النصية النمطية (pattern string) للتعبير النمطي الذي استُدعيت عبره، وهو ما يتيح استخدام Regex حيثما يكون Pattern مطلوبًا.

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

fun toPattern(): Pattern

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

نسخة من الصنف Pattern.

أمثلة

استخدام التابع toPattern()‎

ينشِئ التابع Regex()‎ في الشيفرة الآتية تعبيرًا نمطيًا باسم reg لمطابقة التعابير العددية، ثم يستدعي عبره الدالة toPattern()‎ لإعادة نسخة من الصنف Pattern لها نفس السلسلة النصية النمطية (pattern string) للتعبير النمطي reg، ثم يطبع الناتج:

fun main(args: Array<String>) {
val reg = Regex("""-?\d+(\.\d+)?""") // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
    
println(reg.toPattern()) // => -?\d+(\.\d+)?
}

أنظر أيضًا

•  replace()‎: تستبدل الدالةreplace()‎ كل المطابقات للتعبير النمطي الذي استُدعيت عبره في الكائن المُمرّر  input،  بالسلسلة  النصية  المُمرّرة replacement.
•  findAll()‎: تعيد كل المطابقات للتعبير النمطي الذي استُدعيت عبره في الوسيط المُمرّر input،بداية من الفهرس المحدد بالوسيط startIndex.
•  matchEntire()‎:إن كانت جميع حروف الوسيط الممرّر input تطابق التعبير النمطي الذي استُدعيت عبره، فإن الدالةmatchEntire()‎ تعيد نسخة من الصنفMatchResult تحتوي الكائن المُمرّر نفسه، وإلا فستعيد القيمة المعدومة null.

مصادر

• الدالة  Regex.toPattern()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.