الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/MatchNamedGroupCollection/get»

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>MatchNamedGroupCollection.get()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>get()‎</code> ال...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>MatchNamedGroupCollection.get()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>MatchNamedGroupCollection.get()‎</code> في لغة Kotlin}}</noinclude>
تعيد الدالة<code>get()‎</code> القيمة <code>true</code> إن وَجَد [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعيت عبره على الأقل تطابقا واحدًا في الوسيط المُمرّر.
تعيد الدالة<code>get()‎</code> كائنا من النوع <code>[[Kotlin/kotlin.text/MatchResult/index|MatchGroup]]</code> إن كانت المجموعة التي تحمل الإسم المُمرّر <code>name</code>. مطابقَة، وإلا فستعيد <code>null</code>.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
actual fun containsMatchIn(input: CharSequence): Boolean
abstract operator fun get(name: String): MatchGroup?
 
</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحيّة operator للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator).


</syntaxhighlight>
==القيمة المُعادة==
==القيمة المُعادة==
قيمة منطقية.
قيمة منطقية.

مراجعة 13:59، 6 يوليو 2018

تعيد الدالةget()‎ كائنا من النوع MatchGroup إن كانت المجموعة التي تحمل الإسم المُمرّر name. مطابقَة، وإلا فستعيد null.

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

abstract operator fun get(name: String): MatchGroup?

ويُلاحظ وجود الكلمة المفتاحيّة operator للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator).

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

قيمة منطقية.

أمثلة

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

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

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: تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.

مصادر