الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/codePointAt»

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

تعيد الدالة codePointAt()‎ المحرف (Unicode code point) عند الفهرس المُحدّد.

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

inline fun String.codePointAt(index: Int): Int

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

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

المعاملات

`index`

عدد صحيح يمثل فهرس العنصر في السلسلة النصية المعطاة.

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

يعاد عدد صحيح يمثل المحرف ذا الفهرس index من السلسلة النصية المعطاة.

أمثلة

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

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

    println(str.codePointAt(0)) // => 104 
    println(str.codePointAt(2)) // => 111 
}

انظر أيضًا

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

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

مصادر

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

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