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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (استبدال النص - 'Kotlin Functions' ب'Kotlin Function')
(مراجعة وتدقيق.)
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>text.codePointCount()‎</code> في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>String.codePointCount()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>codePointCount()‎</code> عدد أكواد اليونيكود (Unicode code point) في المجال المُحدّد من النص.  
+
تعيد الدالة <code>codePointCount()‎</code> عدد محارف الترميز الموحد (Unicode code point) الموجودة في مجال مُحدّد من سلسلة نصية.  
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
سطر 7: سطر 7:
 
     endIndex: Int
 
     endIndex: Int
 
): Int  
 
): Int  
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+
</syntaxhighlight>'''منصة التشغيل المطلوبة''': JVM.
 +
 
 +
وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
 +
 
 +
== المعاملات ==
 +
 
 +
=== <code>beginIndex</code> ===
 +
عدد صحيح يشير إلى فهرس العنصر الذي يمثل بداية المجال في السلسلة النصية المعطاة.
 +
 
 +
<code>endIndex</code>
 +
 
 +
عدد صحيح يشير إلى فهرس العنصر (لا يدخل ضمن المجال) الذي يمثل نهاية المجال في السلسلة النصية المعطاة.
  
 
==القيم المعادة==
 
==القيم المعادة==
عدد من النوع <code>Int</code>.  
+
يعاد عدد صحيح يمثل عدد محارف الترميز الموحد (Unicode code point) الموجودة في المجال الذي يبدأ عند العنصر ذي الفهرس <code>beginIndex</code> وينتهي عند العنصر ذي الفهرس <code>endIndex</code> ضمن السلسلة النصية المعطاة.  
 
==أمثلة==
 
==أمثلة==
===استخدام الدالة <code>()codePointCount</code> مع سلسلة نصية===
+
مثالٌ على استخدام الدالة <code>()codePointCount</code><nowiki/>:<syntaxhighlight lang="kotlin">
تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()codePointCount</code> عبرها مع تمرير عددين كوسيطين، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
 
     val str = "hsoub Academy"
 
     val str = "hsoub Academy"
  
     println(str.codePointCount(2,8)) // => 6  
+
     println(str.codePointCount(2, 8)) // => 6
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
===انظر أيضًا===
+
==انظر أيضًا==
* <code>[[Kotlin/kotlin.text/codePointAt|codePointAt()]]‎</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود في الفهرس المُحدّد.
+
* الدالة <code>[[Kotlin/kotlin.text/codePointAt|codePointAt()]]‎</code>: تعيد المحرف (Unicode code point) عند الفهرس المُحدّد. 
  
* <code>[[Kotlin/kotlin.text/codePointBefore|codePointBefore()]]‎</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود قبل الفهرس المُحدّد. 
+
* الدالة <code>[[Kotlin/kotlin.text/codePointBefore|codePointBefore()]]‎</code>: تعيد المحرف (Unicode code point) الموجود قبل الفهرس المُحدّد. 
* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
 
  
 
==مصادر==
 
==مصادر==
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/code-point-count.html الدالة text.codePointCount()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/code-point-count.html صفحة الدالة String.codePointCount()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Function]]
 
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]
 +
[[تصنيف:Kotlin String]]

المراجعة الحالية بتاريخ 11:36، 2 سبتمبر 2018

تعيد الدالة codePointCount()‎ عدد محارف الترميز الموحد (Unicode code point) الموجودة في مجال مُحدّد من سلسلة نصية.

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

inline fun String.codePointCount(
    beginIndex: Int, 
    endIndex: Int
): Int

منصة التشغيل المطلوبة: JVM.

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

المعاملات

beginIndex

عدد صحيح يشير إلى فهرس العنصر الذي يمثل بداية المجال في السلسلة النصية المعطاة.

endIndex

عدد صحيح يشير إلى فهرس العنصر (لا يدخل ضمن المجال) الذي يمثل نهاية المجال في السلسلة النصية المعطاة.

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

يعاد عدد صحيح يمثل عدد محارف الترميز الموحد (Unicode code point) الموجودة في المجال الذي يبدأ عند العنصر ذي الفهرس beginIndex وينتهي عند العنصر ذي الفهرس endIndex ضمن السلسلة النصية المعطاة.

أمثلة

مثالٌ على استخدام الدالة ()codePointCount:

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

    println(str.codePointCount(2, 8)) // => 6
}

انظر أيضًا

  • الدالة codePointAt(): تعيد المحرف (Unicode code point) عند الفهرس المُحدّد. 
  • الدالة codePointBefore(): تعيد المحرف (Unicode code point) الموجود قبل الفهرس المُحدّد. 

مصادر