نتائج البحث

تتحقق الدالة isNullOrEmpty()‎ إن كانت سلسلة المحارف التي استٌدعيت معها تساوي null أو كانت فارغةً. البنية العامة inline fun CharSequence?.isNullOrEmpty(): Boolean وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true كانت سلسلة المحارف المعطاة تساوي null أو كانت فارغةً، أو تعاد القيمة false خلاف ذلك. أمثلة مثالٌ على استعمال الدالة isNullOrEmpty()‎: fun main(args: Array<String>) { val str = "hsoub" ...

تتحقق الدالة containsMatchIn()‎ إن كان بإمكان التعبير النمطي الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من سلسلة المحارف المُمرّرة إليه. البنية العامة actual fun containsMatchIn(input: CharSequence): Boolean المعاملات input سلسلة المحارف التي يراد التحقق من تطابق أحد محارفها -على الأقل- مع التعبير النمطي المعطى. القيمة المعادة تعاد القيمة true المنطقية إن بإمكان التعبير النمطي المعطى مطابقة محرفٍ واحدٍ على الأقل من سلسلة المحارف input، أو تعاد القيمة false خلاف ذلك. أمثلة تنشئ الدالة Regex()‎ في الشيفرة التالية تعبيرًا نمطيًا باسم reg لمطابقة الأعداد، ثم تُستعمَل ...

تعيد الدالة commonSuffixWith ()‎ أطول لاحقة (Suffix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها. تأخذ الدالة بالحسبان ألا تقتطع الأزواج البديلة (surrogate pairs) عند جلب البادئة المشتركة تلك.  البنية العامة fun CharSequence.commonSuffixWith( other: CharSequence, ignoreCase: Boolean = false ): String المعاملات Other سلسلة المحارف التي يراد جلب اللاحقة المشتركة بينها وبين سلسلة المحارف المعطاة. ignoreCase قيمة منطقية تحدد إن كان يراد تجاهل حالة الحروف أم لا أثناء البحث عن لاحقة مشتركة. ...

تجلب الدالة take()‎ أول n محرف من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها وتضعها في قائمة. البنية العامة fun CharSequence.take(n: Int): CharSequence fun String.take(n: Int): String المعاملات n عدد صحيح يمثل عدد المحارف الأولى المراد جلبها من سلسلة المحارف المعطاة. إن كانت القيمة المعطاة لهذا المعامل أكبر من طول سلسلة المحارف، فستعاد كل المحارف الموجودة في السلسلة. القيم المعادة تعاد سلسلة من المحارف أو سلسلة نصية تحوي أول n محرف من سلسلة المحارف أو السلسلة النصية المعطاة. أمثلة مثالٌ على استعمال الدالة ()take: fun ...

تتحقق الدالة endsWith()‎ إن كانت السلسلة النصية أو سلسلة المحارف التي استُدعيت معها تنتهي بمحرف معين أو لاحقة معينة. البنية العامة fun String.endsWith( suffix: String, ignoreCase: Boolean = false ): Boolean fun CharSequence.endsWith( char: Char, ignoreCase: Boolean = false ): Boolean fun CharSequence.endsWith( suffix: CharSequence, ignoreCase: Boolean = false ): Boolean المعاملات suffix سلسلة نصية أو سلسلة من المحارف تمثل اللاحقة التي يراد التحقق ...

تجلب الدالة take()‎ آخر n محرف من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها وتضعها في قائمة.   البنية العامة fun CharSequence.takeLast(n: Int): CharSequence fun String.takeLast(n: Int): String المعاملات n عدد صحيح يمثل عدد المحارف الأخيرة المراد جلبها من سلسلة المحارف المعطاة. إن كانت القيمة المعطاة لهذا المعامل أكبر من طول سلسلة المحارف، فستعاد كل المحارف الموجودة في السلسلة. القيم المعادة تعاد سلسلة من المحارف أو سلسلة نصية تحوي آخر n محرف من سلسلة المحارف أو السلسلة النصية المعطاة.  أمثلة مثالٌ على استعمال الدالة ()takeLast: fun ...

تتحقق الدالة matches()‎ من مطابقة جميع محارف السلسلة الممررة إليها مع التعبير النمطي الذي استدعي معها. البنية العامة infix actual fun matches(input: CharSequence): Boolean وجود الكلمة المفتاحية infix يدل على إمكانية استدعاء الدالة بنمط التدوين الداخلي (Infix notation)؛ أي من خلال حذف المعامل . والأقواس () المُستخدَمَين في الاستدعاء عادةً. المعاملات input سلسلة من المحارف التي يراد أن يُتحقَق من مطابقتها كلِّيًا لتعبير نمطي معين. القيمة المعادة تعاد القيمة true إن تطابقت جميع محارف السلسلة input مع التعبير النمطي المعطى. أمثلة استعمال الدالة matches()‎ للتحقق من مطابقة ...

تقتطع الدالة split()‎ المحارف الموجودة بين الأجزاء المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممررة إليها. البنية العامة actual fun split( input: CharSequence, limit: Int = 0 ): List<String> المعاملات input سلسلة المحارف المراد اقتطاع الأجزاء المجاورة لتلك المتطابقة مع تعبير نمطي وجلبها. limit عدد صحيح موجب يحدد الحد الأقصى لعدد الأجزاء المقتطعة المراد جلبها. قيمته الافتراضية هي: 0 أي لا يوجد حد أقصى. القيمة المعادة تعاد قائمة تضم المحارف الموجودة ...

تجلب الدالة takeLastWhile()‎ آخر عناصر محققة لشرطٍ محدَّدٍ من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها.   البنية العامة inline fun CharSequence.takeLastWhile( predicate: (Char) -> Boolean ): CharSequence inline fun String.takeLastWhile( predicate: (Char) -> Boolean ): String يُلاحَظ وجود الكلمة المفتاحية inline التي تدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات predicate دالةٌ تطبق على كل محرف من محارف سلسلة المحارف أو السلسلة النصية المعطاة. يمرر إليها كل محرف على حدة ثم تعيد قيمة منطقية مقابلة ...

تجلب الدالة takeWhile()‎ أول عناصر محققة لشرطٍ محدَّدٍ من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها. البنية العامة inline fun CharSequence.takeWhile( predicate: (Char) -> Boolean ): CharSequence inline fun String.takeWhile( predicate: (Char) -> Boolean ): String يُلاحَظ وجود الكلمة المفتاحية inline التي تدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات predicate دالةٌ تطبق على كل محرف من محارف سلسلة المحارف أو السلسلة النصية المعطاة. يمرر إليها كل محرف على حدة ثم تعيد قيمة منطقية مقابلة له. ...

تبدل الدالة replaceFirst()‎ سلسلة النصية معينة مكان أول مطابقة للتعبير النمطي الذي استدعي معها في سلسلة المحارف المُمرّرة إليها. البنية العامة actual fun replaceFirst( input: CharSequence, replacement: String ): String المعاملات input سلسلة المحارف المراد مطابقتها مع تعبير نمطي واستبدال محتوى المعامل replacement بأول مطابقة لها. replacement السلسلة النصية التي يراد أن تحل مكان المطابقة الأولى للتعبير النمطي المعطى في المعامل input. القيمة المعادة تعاد سلسلة نصية تحوي جميع محتوى المعامل input بعد تبديل السلسلة النصية replacement ...

ترشِّح الدالة filter()‎ محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا. البنية العامة inline fun CharSequence.filter( predicate: (Char) -> Boolean ): CharSequence inline fun String.filter( predicate: (Char) -> Boolean ): String وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (لمزيد من التفاصيل، راجع توثيق الدوال المباشرة). المعاملات predicate دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف السلسلة النصية أو سلسلة المحارف المعطاة. يمرر إلى هذه الدالة محرفٌ وتعيد قيمة منطقية. القيم المعادة تُعاد سلسلة ...

تقطِّع الدالة chunked()‎ سلسلة المحارف التي استُدعيت معها إلى عدة أجزاء لا يتجاوز كل منها حجمًا معينًا وتعيدها في قائمة أو تطبِّق دالة معينة على كل منها وتضع الناتج الذي تعيده هذه الدالة في قائمة. البنية العامة fun CharSequence.chunked(size: Int): List<String> fun <R> CharSequence.chunked( size: Int, transform: (CharSequence) -> R ): List<R> بيئة التشغيل المطلوبة: Kotlin 1.2. المعاملات size عدد صحيح يمثل عدد العناصر المراد اقتطاعها ووضعها في كل سلسلة نصية. يجب أن يكون هذا ...

تبحث الدالة find()‎ عن أول محرف متطابق مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين. البنية العامة actual fun find( input: CharSequence, startIndex: Int = 0 ): MatchResult? تبحث الدالة find()‎ عن أول محرف متطابق مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف input الممررة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء ...

تتحقق الدالة contains()‎ إن كانت سلسلة المحارف التي استُدعيت معها تحوي المحرف أو سلسلة المحارف المُمرّرة إليها. إن مُرِّر تعبير نمطي إلى هذه الدالة، فستتحقق إن كانت سلسلة المحارف التي استُدعيت معها تحوي محرفًا واحدًا على الأقل متطابقًا مع ذلك التعبير النمطي. البنية العامة operator fun CharSequence.contains( other: CharSequence, ignoreCase: Boolean = false ): Boolean operator fun CharSequence.contains( char: Char, ignoreCase: Boolean = false ): Boolean inline operator fun ...

تنشئ الدالة StringBuilder()‎ كائنًا من النوع StringBuilder. البنية العامة StringBuilder(capacity: Int) StringBuilder(content: CharSequence) StringBuilder() StringBuilder(content: String = "") منصة التشغيل المطلوبة: JS. المعاملات capacity عدد صحيح يحدد حجم الكائن StringBuilder المراد إنشاؤها. content سلسلة من المحارف أو سلسلة نصية تمثل محتوى الكائن StringBuilder المراد إنشاؤها. القيم المعادة يعاد كائنٌ من النوع StringBuilder. أمثلة استعمال الدالة StringBuilder()‎ لإنشاء كائن من النوع StringBuilder: fun main(args: Array<String>) { val sb1 = StringBuilder("hsoub") // ...

تنشئ الدالة StringBuilder()‎ كائنًا من النوع StringBuilder. البنية العامة StringBuilder(capacity: Int) StringBuilder(content: CharSequence) StringBuilder() StringBuilder(content: String = "") منصة التشغيل المطلوبة: JS. المعاملات capacity عدد صحيح يحدد حجم الكائن StringBuilder المراد إنشاؤها. content سلسلة من المحارف أو سلسلة نصية تمثل محتوى الكائن StringBuilder المراد إنشاؤها. القيم المعادة يعاد كائنٌ من النوع StringBuilder. أمثلة استعمال الدالة StringBuilder()‎ لإنشاء كائن من النوع StringBuilder: fun main(args: Array<String>) { val sb1 = StringBuilder("hsoub") // ...

تتحقق الدالة regionMatches()‎ من مطابقة جزأين من سلسلتين نصيتين أو سلسلتين من المحارف محددين ببداية وطول مع بعضهما بعضًا. البنية العامة actual fun CharSequence.regionMatches( thisOffset: Int, other: CharSequence, otherOffset: Int, length: Int, ignoreCase: Boolean = false ): Boolean fun String.regionMatches( thisOffset: Int, other: String, otherOffset: Int, length: Int, ...

تبحث الدالة findAll()‎ عن جميع المحارف المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين. البنية العامة actual fun findAll( input: CharSequence, startIndex: Int = 0 ): Sequence<MatchResult> تبحث الدالة findAll()‎ عن جميع المحارف المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف input الممررة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء ...

تعيد الدالة windowedSequence()‎ سلسلة تحتوي على سلاسل نصية بحجم معين ثابت جلبت من سلسلة المحارف التي استدعيت معها عند التحرك بخطوات محددة ثابتة، أو تحوي ناتج تطبيق دالة معينة على تلك السلاسل النصية المجلوبة.   البنية العامة fun CharSequence.windowedSequence( size: Int, step: Int = 1, partialWindows: Boolean = false ): Sequence<String> الإصدار المطلوب: Kotlin 1.2. تعيد الدالة windowedSequence()‎ سلسلة مكونة من سلاسل نصية حجم كل منها يساوي size جلبت من سلسلة المحارف ...