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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(مراجعة وتدقيق.)
ط
 
سطر 29: سطر 29:
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==انظر أيضًا==
 
==انظر أيضًا==
*الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|pattern]]:</code> تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
+
*الدالة <code>[[Kotlin/kotlin.text/Regex/replace|replace()‎]]</code>: تبدل سلسلة النصية معينة مكان كل تطابقات <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي تعيدها الدالة الممررة إليها.
*<code>[[Kotlin/kotlin.text/Regex/findAll| findAll()‎]]:</code> تعيد كل المطابقات [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره  في الوسيط المُمرّر <code>input،</code>بداية من الفهرس المحدد بالوسيط <code>startIndex.</code>
+
*الدالة <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn()‎]]</code>: تتحقق إن كان بإمكان [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من [[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليه.
 
+
*الدالة <code>[[Kotlin/kotlin.text/Regex/find|find()‎]]</code>: تبحث عن أول محرف متطابق مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
*الخاصية <code>[[Kotlin/kotlin.text/Regex/options|options]]:</code> تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
+
*الدالة <code>[[Kotlin/kotlin.text/Regex/matches|matches()‎]]</code>: تتحقق من مطابقة جميع محارف [[Kotlin/CharSequence|السلسلة]] الممررة إليها مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها. 
 +
*الدالة <code>[[Kotlin/kotlin.text/Regex/split|split()‎]]</code>: تقتطع المحارف الموجودة بين الأجزاء المتطابقة مع <nowiki/>[[Kotlin/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] الممررة إليها.
 
==مصادر==
 
==مصادر==
 
*[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.]

المراجعة الحالية بتاريخ 14:56، 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
}

انظر أيضًا

مصادر