Kotlin/kotlin.text/Regex/init

تنشئ الدالة Regex()‎ تعبيرًا نمطيًا (regular expression) انطلاقًا من السلسلة النصية المُمرّرة إليه.

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

Regex(pattern: String)
Regex(pattern: String, option: RegexOption)
Regex(pattern: String, options: Set<RegexOption>)

تنشئ الدالة Regex()‎ تعبيرًا نمطيًا من النمط pattern مع ضبطه وفقًا الخيار option أو مجموعة الخيارات options (أو القيمة الافتراضية لهذه الخيارات إن لم يعطَ الوسيط option) التي تضبط ذلك النمط.

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

يعاد كائن من النوع Regex يحتوي على التعبير النمطي pattern بعد ضبطه وفقًا للخيار option أو مجموعة الخيارات options المعطاة أو القيمة الافتراضية لها (إن لم يُعطَ أي خيار).

أمثلة

ينشِئ التابع Regex()‎ في الشيفرة التالية تعبيرًا نمطيًا باسم reg ثم يطابق سلسلةً نصيةً معه باستخدام الدالة containsMatchIn()‎:

fun main(args: Array<String>) {
    val reg = Regex("""-?\d+(\.\d+)?""")

    print(reg.containsMatchIn("xabcdy")) // false
    print(reg.containsMatchIn("xabc22dy")) // true
}

انظر أيضًا

• الخاصية Regex.options: تمثل مجموعةَ الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعي معها.
• الخاصية Regex.pattern: النمط الأولي الذي استُخدم في إنشاء التعبير النمطي الذي استُدعي معها.
• الدالة containsMatchIn()‎: تتحقق إن كان بإمكان التعبير النمطي الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من سلسلة المحارف المُمرّرة إليه.
• الدالة find()‎: تبحث عن أول محرف متطابق مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
• الدالة findAll()‎: تبحث عن جميع المحارف المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
• الأصناف والبواني (constructors) في لغة Kotlin.

مصادر

• صفحة <init> للصنف Regex في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.