التهيئة الأولية <init> للصنف Regex في Kotlin

من موسوعة حسوب
< Kotlin‏ | kotlin.text‏ | Regex(بالتحويل من 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) التي تضبط ذلك النمط.

المعاملات

pattern

سلسلة نصية تمثل النمط الذي سينشأ منه تعبير نمطي.

option

كائن من النوع RegexOption يحوي خيارًا واحدًا من خيارات التعابير النمطية.

options

مجموعة تتألف من عدة كائنات من النوع RegexOption تمثل خيارات التعابير النمطية.

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

يعاد كائن من النوع 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
}

انظر أيضًا

مصادر