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

من موسوعة حسوب
التعديل اللاحق ←
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التهيئة الأولية <init> عبر التابع MatchGroup.Init()‎ في لغة Kotlin}}</noinclude> ينشِئ التابع <code>M...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التهيئة الأولية <init> عبر التابع MatchGroup.Init()‎ في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: التهيئة الأولية <init> عبر التابع MatchGroup.Init()‎ في لغة Kotlin}}</noinclude>
ينشِئ التابع <code>MatchGroup()‎</code> [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] (regular expression) انطلاقًا من [[Kotlin/String|السلسلة النصية]] المُمرّرة.   
ينشِئ التابع <code>MatchGroup()‎</code>  كائنًا من النوع <code>[[Kotlin/kotlin.text/MatchGroup/index|MatchGroup]]</code>، والذي يُمكن أن يحتوي مجموعة نتائج (capturing group) واحدة للكائنات من نوع  <code>[[Kotlin/kotlin.text/MatchResult/index|MatchResult]]</code>.   


== البنية العامة ==
== البنية العامة ==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
Regex(pattern: String)
MatchGroup(actual value: String, range: IntRange)


</syntaxhighlight>ينشِئ التابع <code>Regex()‎</code> [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] (regular expression) انطلاقًا من [[Kotlin/String|السلسلة النصية]] المُمرّرة والقيمة الابتداية للوسيط <code>options</code>. <syntaxhighlight lang="kotlin">
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''  
Regex(pattern: String, option: RegexOption)


</syntaxhighlight>ينشِئ التابع <code>Regex()‎</code> [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] (regular expression) انطلاقًا من [[Kotlin/String|السلسلة النصية]] المُمرّرة ومن الوسيط المُمرر <code>option</code>.<syntaxhighlight lang="kotlin">
ينشِئ التابع <code>MatchGroup()‎</code>  كائنًا من النوع <code>[[Kotlin/kotlin.text/MatchGroup/index|MatchGroup]]</code>، والذي يُمكن أن يحتوي مجموعة نتائج (capturing group) واحدة للكائنات من نوع  <code>[[Kotlin/kotlin.text/MatchResult/index|MatchResult]]</code>. حيث الوسيط المُمرّر <code>value</code> هو قيمة مجموعة النتائج، والوسيط <code>range</code>  يمثل مجال الفهارس التي تحدّد مكان مجموعة النتائج. وهي متوفرة في بيئة التشغيل JVM  فقط. <syntaxhighlight lang="kotlin">
Regex(pattern: String, options: Set<RegexOption>)
MatchGroup(actual value: String)


</syntaxhighlight>ينشِئ التابع <code>Regex()‎</code> [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] (regular expression) انطلاقًا من [[Kotlin/String|السلسلة النصية]] المُمرّرة ومن  الوسيط المُمرر <code>options</code>.
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JS'''


ينشِئ التابع <code>MatchGroup()‎</code>  كائنًا من النوع <code>[[Kotlin/kotlin.text/MatchGroup/index|MatchGroup]]</code>، والذي يُمكن أن يحتوي مجموعة نتائج (capturing group) واحدة للكائنات من نوع  <code>[[Kotlin/kotlin.text/MatchResult/index|MatchResult]]</code>. حيث الوسيط المُمرّر <code>value</code>  هو قيمة مجموعة النتائج.
== القيم المعادة ==
== القيم المعادة ==
[[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] (regular expression).
كائن من النوع <code>[[Kotlin/kotlin.text/MatchGroup/index|MatchGroup]]</code>


== أمثلة ==
== أمثلة ==


=== استخدام التابع <code>MatchGroup()‎</code> لإنشاء تعبير نمطي ===
=== استخدام التابع <code>MatchGroup()‎</code> ===
ينشِئ التابع <code>MatchGroup()‎</code> في الشيفرة الآتية [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] باسم <code>reg</code> ، ثم يجربه باستخدام الدالة  <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn()]]‎</code> :<syntaxhighlight lang="kotlin">
ينشِئ التابع <code>[[Kotlin/kotlin.text/Regex/Init|Regex()]]‎</code> في الشيفرة الآتية تعبيرًا نمطيًا باسم <code>reg</code> لمطابقة التعابير العددية، ثم نعرّف متغيرًا <code>x</code> عبر التابع <code>MatchGroup()‎</code>  مع تمرير وسيطين إليه، ثم نطبع الخاصية <code>range</code> الخاصة بالمتغير  <code>x</code>:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
  val reg = Regex("""-?\d+(\.\d+)?""")
val reg = """-?\d+(\.\d+)?""".toRegex()
   
val x = MatchGroup("rr",2..4)
  print(reg.containsMatchIn("xabcdy")) // false
 
  print(reg.containsMatchIn("xabc22dy")) // true
print(x.range) // 2..4
}
}
</syntaxhighlight>
</syntaxhighlight>
سطر 33: سطر 33:


== مصادر ==
== مصادر ==
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/-init-.html التهيئة الأوليّة عبر التابع MatchGroup.Init()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-match-group/-init-.html التهيئة الأوليّة عبر التابع MatchGroup.Init()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Method]]
[[تصنيف:Kotlin Method]]

مراجعة 12:28، 6 يوليو 2018

ينشِئ التابع MatchGroup()‎ كائنًا من النوع MatchGroup، والذي يُمكن أن يحتوي مجموعة نتائج (capturing group) واحدة للكائنات من نوع  MatchResult.

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

MatchGroup(actual value: String, range: IntRange)

بيئة التشغيل المطلوبة: JVM  ينشِئ التابع MatchGroup()‎ كائنًا من النوع MatchGroup، والذي يُمكن أن يحتوي مجموعة نتائج (capturing group) واحدة للكائنات من نوع  MatchResult. حيث الوسيط المُمرّر value هو قيمة مجموعة النتائج، والوسيط range  يمثل مجال الفهارس التي تحدّد مكان مجموعة النتائج. وهي متوفرة في بيئة التشغيل JVM  فقط. 

MatchGroup(actual value: String)

بيئة التشغيل المطلوبة: JS

ينشِئ التابع MatchGroup()‎ كائنًا من النوع MatchGroup، والذي يُمكن أن يحتوي مجموعة نتائج (capturing group) واحدة للكائنات من نوع  MatchResult. حيث الوسيط المُمرّر value هو قيمة مجموعة النتائج.

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

كائن من النوع MatchGroup

أمثلة

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

ينشِئ التابع Regex()‎ في الشيفرة الآتية تعبيرًا نمطيًا باسم reg لمطابقة التعابير العددية، ثم نعرّف متغيرًا x عبر التابع MatchGroup()‎ مع تمرير وسيطين إليه، ثم نطبع الخاصية range الخاصة بالمتغير x:

fun main(args: Array<String>) {
 val reg = """-?\d+(\.\d+)?""".toRegex()
 val x = MatchGroup("rr",2..4)

 print(x.range) // 2..4
}

انظر أيضًا

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/MatchGroup/init&oldid=12275»