الدالة Regex.find()‎ في لغة Kotlin

تعيد الدالةfind()‎ القيمة true إن وَجَد التعبير النمطي الذي استُدعيت عبره على الأقل تطابقا واحدًا في الوسيط المُمرّر.

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

actual fun containsMatchIn(input: CharSequence): Boolean

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

قيمة منطقية.

أمثلة

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

ينشِئ التابع Regex()‎ في الشيفرة الآتية تعبيرًا نمطيًا باسم reg لمطابقة التعابير العددية، ثم يستدعي عبره الدالة find()‎، ثم يطبع الناتج:

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

// سلسلة نصية تحتوي أعدادا، وبالتالي سيوجد تطابق مع التعبير النمطي
val str1 = "as12d"
    
// سلسلة نصية لا تحتوي أعدادا، وبالتالي لن يوجد تطابق مع التعبير النمطي
val str2 = "ash d"
    
print(reg.containsMatchIn(str1) ) // true
print(reg.containsMatchIn(str2) ) // false

}

أنظر أيضًا

• الخاصية pattern: تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.

• الخاصية options: تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.

مصادر

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