الدالة toRegex()‎ في Kotlin

تحول الدالة toRegex()‎ السلسلة النصية التي استٌدعيت معها إلى تعبير نمطي (regular expression).

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

inline fun String.toRegex(): Regex 
inline fun String.toRegex(option: RegexOption): Regex
inline fun String.toRegex(options: Set<RegexOption>): Regex

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).

المعاملات

option

كائن من النوع RegexOption يمثل الخيارات التي ستستعمل في ضبط التعبير النمطي عند التحويل.

options

مجموعة تحوي كائنات من النوع RegexOption يمثل الخيارات التي ستستعمل في ضبط التعبير النمطي عند التحويل.

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

يعاد تعبير نمطي ناتج عن تحويل السلسلة النصية المعطاة.

أمثلة

مثالٌ على استعمال الدالة toRegex()‎:

fun main(args: Array<String>) {
    println("""-?\d+(\.\d+)?""".toRegex()) // -?\d+(\.\d+)?
    // يطابق هذا التعبير النمطي القيم العددية
}

انظر أيضًا

• الدالة toCollection()‎: تضيف كل محارف السلسلة التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها.
• الدالة toHashSet()‎: تحلّل كائنًا من النوع HashSet يحوي كل محارف السلسلة التي استٌدعيت معها.
• الدالة toList()‎: تضيف كل محارف سلسلة المحارف التي استٌدعيت معها إلى قائمة، إذ يوضع كل محرف في عنصر.
• الدالة toLong()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد طويل.
• الدالة toLongOrNull()‎: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد طويل.
• الدالة toLowerCase()‎: تحول المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف صغيرة (lowercase).
• الدالة toMutableList()‎: تضيف كل محارف سلسلة المحارف التي استٌدعيت معها إلى قائمة متغيرة، إذ يوضع كل محرف في عنصر.
• الدالة toPattern()‎: تحول السلسلة النصية التي استٌدعيت معها إلى نمط.
• الدالة toSet()‎: تضيف كل محارف سلسلة الحروف  التي استٌدعيت معها إلى مجموعة من النوع Set، إذ يوضع كل محرف في عنصر.
• الدالة toShort()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير.

مصادر

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