الفرق بين المراجعتين ل"Kotlin/kotlin.text/count"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.count()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة <code>count()‎</code> القيمة <code>tr...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>text.count()‎</code> في لغة Kotlin}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: الدالة <code>text.count()‎</code> في لغة Kotlin}}</noinclude>
تعيد الدالة <code>count()‎</code> القيمة <code>true</code> إن كانت [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها تساوي [[Kotlin/CharSequence/index|سلسلة الحروف]] أو الكائن (<code>StringBuffer</code>) المُمرّر.   
+
تعيد الدالة <code>count()‎</code> عدد حروف [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها، وفي حال تمرير دالة منطقية <code>predicate</code> فستعيد عدد الحروف التي تحقق تلك الدالة المنطقية.   
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
inline fun String.contentEquals(
+
inline fun CharSequence.count(): Int
    charSequence: CharSequence
 
): Boolean
 
  
inline fun String.contentEquals(
+
inline fun CharSequence.count(
     stringBuilder: StringBuffer
+
     predicate: (Char) -> Boolean
): Boolean
+
): Int
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
 
  
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+
 
 +
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
  
 
==القيم المعادة==
 
==القيم المعادة==
قيمة منطقية.  
+
عدد من النوع <code>Int</code>.  
 
==أمثلة==
 
==أمثلة==
 
===استخدام الدالة <code>()count</code> مع سلسلة نصية===
 
===استخدام الدالة <code>()count</code> مع سلسلة نصية===
تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()count</code> عبرها مع تمرير  [[Kotlin/String|سلسلة نصية]] كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
+
تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()count</code> عبرها، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
 
     val str = "hsoub"
 
     val str = "hsoub"
  
     println(str.contentEquals("hsoub")) // => true
+
     println(str.count()) // => 5
    println(str.contentEquals("abc")) // => false
+
}
 +
</syntaxhighlight>استخدام الدالة <code>()count</code> مع سلسلة نصية مع تمرير دالة منطقية كوسيط
 +
 
 +
تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()count</code> عبرها مع تمرير  دالة منطقية كوسيط، ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 +
fun main(args: Array<String>) {
 +
    val str = "Hsoub Wiki"
  
 +
    println(str.count {it.isUpperCase()}) // => 2
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
سطر 34: سطر 38:
  
 
==مصادر==
 
==مصادر==
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/content-equals.html الدالة text.count()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/count.html الدالة text.count()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Functions]]
 
[[تصنيف:Kotlin Functions]]

مراجعة 13:53، 8 يوليو 2018

تعيد الدالة count()‎ عدد حروف السلسلة النصية التي استُدعيت عبرها، وفي حال تمرير دالة منطقية predicate فستعيد عدد الحروف التي تحقق تلك الدالة المنطقية.

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

inline fun CharSequence.count(): Int 

inline fun CharSequence.count(
    predicate: (Char) -> Boolean
): Int

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

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

عدد من النوع Int.

أمثلة

استخدام الدالة ()count مع سلسلة نصية

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()count عبرها، ثمَّ تطبع الناتج:

fun main(args: Array<String>) {
    val str = "hsoub"

    println(str.count()) // => 5
}

استخدام الدالة ()count مع سلسلة نصية مع تمرير دالة منطقية كوسيط تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()count عبرها مع تمرير دالة منطقية كوسيط، ثمَّ تطبع الناتج:

fun main(args: Array<String>) {
    val str = "Hsoub Wiki"

    println(str.count {it.isUpperCase()}) // => 2
}

انظر أيضًا

  • contains(): تعيد القيمة true إن كانت سلسلة الحروف التي استُدعيت عبرها تحتوي الحرف أو سلسلة الحروف المُمرّرة. الوسيطignoreCase يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف.
  • compareTo(): تقارن بين سلسلتين نصيتين.
  • asSequence(): تنشئ كائنًا من الصنف Sequence والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر