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

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

تبحث الدالة findAll()‎ عن جميع المحارف المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.

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

actual fun findAll(
    input: CharSequence, 
    startIndex: Int = 0
): Sequence<MatchResult>
تبحث الدالة findAll()‎ عن جميع المحارف المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف input الممررة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند المحرف ذي الفهرس startIndex. يجب ألا تقل قيمة المعامل startIndex عن القيمة 0، القيمة الافتراضية له، وألا تزيد عن القيمة input.length()‎.

المعاملات

input

سلسلة المحارف التي يراد جلب جميع محارفها المتطابقة مع التعبير النمطي المعطى.

startIndex

عدد صحيح يحدد فهرس المحرف الذي يراد بدء عملية المطابقة عنده. القيمة الافتراضية له هي: 0؛ أي بدء عملية المطابقة عند المحرف الأول.

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

تعاد سلسلة تحوي جميع المحارف المتطابقة مع التعبير النمطي المعطى في سلسلة المحارف input. يجدر بالذكر أن عملية البحث عن المحارف المتطابقة تبدأ من المحرف ذي الفهرس startIndex.

أمثلة

ينشِئ التابع Regex() في الشيفرة الآتية تعبيرًا نمطيًا باسم reg لمطابقة التعابير العددية، ثم يستدعي عبره الدالة findAll()‎ ويحيل القيمة المعادة إلى المتغير matchResults، ثم ينشئ كائن من النوع Appendable عبر الدالة StringBuilder()‎،ثم يطبع الناتج بعد تجميع النتائج في الحلقة التكرارية for:
fun main(args: Array<String>) {
val reg = Regex("""-?\d+(\.\d+)?""") // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45

val matchResults = reg.findAll("ab12cd34ef")
    
val result = StringBuilder()
    
for (matchResult in matchResults) {
    result.append(matchResult.value + " ")
}

println(result) // => 12 34
}

أنظر أيضًا

مصادر