Kotlin/kotlin.text/Regex/replaceFirst

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

مصادر

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