الفرق بين المراجعتين ل"Kotlin/kotlin.text/Regex/matchEntire"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
ط (إضافة قسم "المعاملات")
 
سطر 6: سطر 6:
  
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
==المعاملات==
 +
 +
=== <code>input</code> ===
 +
[[Kotlin/CharSequence|سلسلة المحارف]] التي يراد تطابق جميع محارفها مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] المعطى.
 +
 
==القيمة المعادة==
 
==القيمة المعادة==
 
تعاد نسخةٌ من الصنف [[Kotlin/kotlin.text/MatchResult/index|<code>MatchResult</code>]] تحتوي على جميع [[Kotlin/CharSequence|محارف]] المعامل <code>input</code> إن تطابقت جميع تلك [[Kotlin/CharSequence|المحارف]] مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] المعطى، أو تعاد القيمة <code>null</code> خلاف ذلك.
 
تعاد نسخةٌ من الصنف [[Kotlin/kotlin.text/MatchResult/index|<code>MatchResult</code>]] تحتوي على جميع [[Kotlin/CharSequence|محارف]] المعامل <code>input</code> إن تطابقت جميع تلك [[Kotlin/CharSequence|المحارف]] مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] المعطى، أو تعاد القيمة <code>null</code> خلاف ذلك.

المراجعة الحالية بتاريخ 05:53، 1 سبتمبر 2018

تحاول الدالة matchEntire()‎ مطابقة جميع محارف السلسلة الممررة إليها مع التعبير النمطي الذي استدعي معها.

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

actual fun matchEntire(input: CharSequence): MatchResult?

المعاملات

input

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

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

تعاد نسخةٌ من الصنف MatchResult تحتوي على جميع محارف المعامل input إن تطابقت جميع تلك المحارف مع التعبير النمطي المعطى، أو تعاد القيمة null خلاف ذلك.

أمثلة

استعمال الدالة matchEntire()‎ لمعرفة سلسلة المحارف المطابقة للتعبير النمطي ‎-?\d+(\.\d+)?‎ بشكل كامل:

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

    println(reg.matchEntire("ab12cd34ef")?.value) // => null
    println(reg.matchEntire("1234567890")?.value) // => 1234567890
}

انظر أيضًا

مصادر