الصنف ‎‎Regex‎ في Kotlin

يمثل الصنف Regex تعبيرًا نمطيا قابلًا للتعديل (immutable regular expression). إن أردت الاطلاع على المزيد من المعلومات المتعلقة بصياغة النمط (pattern)، انتقل إلى صفحة الصنف Pattern.

actual class Regex : Serializable

الدوال البانية

<init>

تنشئ الدالة Regex()‎ تعبيرًا نمطيًا (regular expression) انطلاقًا من السلسلة النصية المُمرّرة إليه.

الخاصيات

options

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

pattern

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

الدوال

containsMatchIn

تتحقق هذه الدالة إن كان بإمكان التعبير النمطي الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من سلسلة المحارف المُمرّرة إليه.

find

تبحث هذه الدالة عن أول محرف متطابق مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.

findAll

تبحث هذه الدالة عن جميع المحارف المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.

matchEntire

تحاول هذه الدالة مطابقة جميع محارف السلسلة الممررة إليها مع التعبير النمطي الذي استدعي معها.

matches

تتحقق هذه الدالة من مطابقة جميع محارف السلسلة الممررة إليها مع التعبير النمطي الذي استدعي معها. 

replace

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

replaceFirst

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

split

تقتطع هذه الدالة المحارف الموجودة بين الأجزاء المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممررة إليها.

toPattern

تحول هذه الدالة كائنًا من النوع Regex (تعبيرًا نمطيًا) إلى النوع Pattern (نمط).

toString

تحول هذه الدالة تعبيرًا نمطيًّا إلى سلسلة نصية (أي نمط [Pattern] ذلك التعبير النمطي).

الدوال الموروثة (Inherited Functions)

equals

تتحقق هذه الدالة إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معه.

hashCode

تعيد هذه الدالة الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها.