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

مراجعة 12:59، 30 أغسطس 2018

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

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

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

المعاملات

`input`

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

`replacement`

السلسلة النصية التي يراد أن تحل مكان المطابقة الأولى للتعبير النمطي المعطى في المعامل input.

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

تعاد سلسلة نصية تحوي جميع محتوى المعامل input بعد تبديل السلسلة النصية replacement مكان أول مطابقة للتعبير النمطي المعطى فيها.

أمثلة

استعمال الدالة replaceFirst()‎ لاستبدال أول مطابقة لعدد موجود في سلسلة من المحارف:

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

    println(reg.replaceFirst("ab12cd34ef", "X")) // => abXcd34ef
}

انظر أيضًا

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

الخاصية options: تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.

مصادر

صفحة الدالة Regex.replaceFirst()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 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/String|سلسلة النصية]] معينة مكان أول مطابقة [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
@@ سطر 8: / سطر 8: @@
 ): String
 </syntaxhighlight>
+== المعاملات ==
+=== <code>input</code> ===
+[[Kotlin/CharSequence|سلسلة المحارف]] المراد مطابقتها مع تعبير نمطي واستبدال محتوى المعامل <code>replacement</code> بأول مطابقة لها.
+=== <code>replacement</code> ===
+[[Kotlin/String|السلسلة النصية]] التي يراد أن تحل مكان المطابقة الأولى [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] المعطى في المعامل <code>input</code>.
 ==القيمة المعادة==
-[[Kotlin/String|سلسلة نصية]]
+تعاد [[Kotlin/String|سلسلة نصية]] تحوي جميع محتوى المعامل <code>input</code> بعد تبديل السلسلة النصية <code>replacement</code> مكان أول مطابقة [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] المعطى فيها.
 ==أمثلة==
-===استخدام التابع <code>replaceFirst()‎</code>===
+استعمال الدالة <code>replaceFirst()‎</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>) {
-val reg = Regex("""-?\d+(\.\d+)?""") // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
+    // يطابق التعبير النمطي التالي جميع الأعداد
+    val reg = Regex("""-?\d+(\.\d+)?""")
-println(reg.replaceFirst("ab12cd34ef", "X")) // => abXcd34ef
+     println(reg.replaceFirst("ab12cd34ef", "X")) // => abXcd34ef
 }
 </syntaxhighlight>
-==أنظر أيضًا==
+==انظر أيضًا==
-* الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|pattern]]:</code> تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
+*الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|pattern]]:</code> تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
-* <code>[[Kotlin/kotlin.text/Regex/findAll| findAll()‎]]:</code> تعيد كل المطابقات [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره  في الوسيط المُمرّر <code>input،</code>بداية من الفهرس المحدد بالوسيط <code>startIndex.</code>
+*<code>[[Kotlin/kotlin.text/Regex/findAll| findAll()‎]]:</code> تعيد كل المطابقات [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره  في الوسيط المُمرّر <code>input،</code>بداية من الفهرس المحدد بالوسيط <code>startIndex.</code>
-* الخاصية <code>[[Kotlin/kotlin.text/Regex/options|options]]:</code> تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
+*الخاصية <code>[[Kotlin/kotlin.text/Regex/options|options]]:</code> تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
 ==مصادر==
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/replace-first.html الدالة  Regex.replaceFirst()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/replace-first.html صفحة الدالة Regex.replaceFirst()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin Regex]]