الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/Regex/find»
جميل-بيلوني (نقاش | مساهمات) مراجعة وتدقيق. |
ط استبدال النص - 'Kotlin Methods' ب'Kotlin Function' |
||
سطر 29: | سطر 29: | ||
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/find.html صفحة الدالة Regex.find() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/find.html صفحة الدالة Regex.find() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Function]] | ||
[[تصنيف:Kotlin Text]] | [[تصنيف:Kotlin Text]] | ||
[[تصنيف:Kotlin Regex]] | [[تصنيف:Kotlin Regex]] |
مراجعة 11:36، 30 أغسطس 2018
تبحث الدالة find()
عن أول محرف متطابق مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
البنية العامة
actual fun find(
input: CharSequence,
startIndex: Int = 0
): MatchResult?
تبحث الدالة find()
عن أول محرف متطابق مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف input
الممررة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند المحرف ذي الفهرس startIndex
. يجب ألا تقل قيمة المعامل startIndex
عن القيمة 0 وألا تزيد عن القيمة input.length()
.
القيمة المعادة
يعاد أول محرف تطابق مع التعبير النمطي المعطى من سلسلة المحارف input
. يجدر بالذكر أن عملية البحث عن المحرف المتطابق تبدأ من المحرف ذي الفهرس startIndex
.
أمثلة
استعمال الدالة find()
لجلب أول رقم تطابق مع التعبير النمطي -?\d+(\.\d+)?:
fun main(args: Array<String>) {
val reg = """-?\d+(\.\d+)?""".toRegex()
val matchResult = reg.find("aff4rb")
print(matchResult?.value) // 4
}
انظر أيضًا
- الخاصية
pattern:
تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
- الخاصية
options:
تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.