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

مصادر