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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.replaceFirst()‎</code> في لغة Kotlin}}</noinclude> تستبدل الدالة<code>replaceFirst()‎</code> ك...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.replaceFirst()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.replaceFirst()‎</code> في لغة Kotlin}}</noinclude>
تستبدل الدالة<code>replaceFirst()‎</code> كل المطابقات [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره في الكائن المُمرّر <code>input</code>، [[Kotlin/String|بالسلسلة النصية]] المُمرّرة <code>replacement</code>.
تستبدل الدالة<code>replaceFirst()‎</code> المطابقة الأولى [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره في الكائن المُمرّر <code>input</code>، [[Kotlin/String|بالسلسلة النصية]] المُمرّرة <code>replacement</code>.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
actual fun replace(
actual fun replaceFirst(
     input: CharSequence,  
     input: CharSequence,  
     replacement: String
     replacement: String
سطر 12: سطر 12:
==أمثلة==
==أمثلة==
===استخدام التابع <code>replaceFirst()‎</code>===
===استخدام التابع <code>replaceFirst()‎</code>===
ينشِئ التابع <code>[[Kotlin/kotlin.text/Regex/Init|Regex()]]‎</code> في الشيفرة الآتية <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] باسم <code>reg</code> لمطابقة التعابير العددية، ثم يستدعي عبره الدالة <code>replaceFirst()‎</code> لاستبدال المطابقات الموجودة في [[Kotlin/String|السلسلة النصية]] المُمررّة  [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] <code>reg</code> (أي للتعابير العددية)، ثم يطبع الناتج:<syntaxhighlight lang="kotlin">
ينشِئ التابع <code>[[Kotlin/kotlin.text/Regex/Init|Regex()]]‎</code> في الشيفرة الآتية <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] باسم <code>reg</code> لمطابقة التعابير العددية، ثم يستدعي عبره الدالة <code>replaceFirst()‎</code> لاستبدال المطابقة الأولى الموجودة في [[Kotlin/String|السلسلة النصية]] المُمررّة  [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] <code>reg</code> (أي للتعابير العددية)، ثم يطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
val reg = Regex("""-?\d+(\.\d+)?""") // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
val reg = Regex("""-?\d+(\.\d+)?""") // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
      
      
println(reg.replace("ab12cd34ef", "X")) // => abXcdXef
println(reg.replaceFirst("ab12cd34ef", "X")) // => abXcd34ef
}
}
</syntaxhighlight>
</syntaxhighlight>
سطر 26: سطر 26:


==مصادر==
==مصادر==
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/replace.html الدالة  Regex.replaceFirst()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/replace-first.html الدالة  Regex.replaceFirst()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Methods]]
[[تصنيف:Kotlin Methods]]

مراجعة 18:17، 5 يوليو 2018

تستبدل الدالةreplaceFirst()‎ المطابقة الأولى للتعبير النمطي الذي استُدعيت عبره في الكائن المُمرّر input، بالسلسلة النصية المُمرّرة replacement.

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

actual fun replaceFirst(
    input: CharSequence, 
    replacement: String
): String

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

سلسلة نصية

أمثلة

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

ينشِئ التابع Regex() في الشيفرة الآتية تعبيرًا نمطيًا باسم reg لمطابقة التعابير العددية، ثم يستدعي عبره الدالة replaceFirst()‎ لاستبدال المطابقة الأولى الموجودة في السلسلة النصية المُمررّة للتعبير النمطي reg (أي للتعابير العددية)، ثم يطبع الناتج:

fun main(args: Array<String>) {
val reg = Regex("""-?\d+(\.\d+)?""") // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
    
println(reg.replaceFirst("ab12cd34ef", "X")) // => abXcd34ef
}

أنظر أيضًا

  • الخاصية pattern: تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
  •  findAll()‎: تعيد كل المطابقات للتعبير النمطي الذي استُدعيت عبره في الوسيط المُمرّر input،بداية من الفهرس المحدد بالوسيط startIndex.
  • الخاصية options: تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.

مصادر