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

المراجعة الحالية بتاريخ 05:28، 4 سبتمبر 2018

تعيد الدالة intern()‎ تمثيلًا معياريًّا (canonical representation) للسلسلة النصية التي استُدعيت معها.

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

inline fun String.intern(): String

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

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

تعاد سلسلة نصية.

أمثلة

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

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

    print(str.intern()) // hsoub
}

انظر أيضًا

الدالة format()‎: تنسِّق سلسلة نصية وفقًا لقيمة المعاملات التي تمرر إليها.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة text.intern()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة String.intern()‎ في Kotlin}}</noinclude>
-تعيد الدالة <code>intern()‎</code> فهرس أول ظهور للحرف أو [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس المُمرّر <code>startIndex</code>، في حال كان ذلك الحرف غير موجود فستعيد العدد ‎<code>-1</code>.
+تعيد الدالة <code>intern()‎</code> تمثيلًا معياريًّا (canonical representation) [[Kotlin/String|للسلسلة النصية]] التي استُدعيت معها.
+== البنية العامة ==
+<syntaxhighlight lang="kotlin">
+inline fun String.intern(): String
-في حال إعطاء الوسيط <code>ignoreCase</code>  القيمة <code>true</code> فإنّ الدالة <code>indexOf()‎</code> لن تفرق بين الحروف الكبيرة والصغيرة.
+</syntaxhighlight>'''بيئة التشغيل المطلوبة''': JVM.
-== البنية العامة ==
-يمكن استدعاء  الدالة <code>indexOf()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
-fun CharSequence.indexOf(
-    char: Char,
-    startIndex: Int = 0,
-    ignoreCase: Boolean = false
-): Int
-fun CharSequence.indexOf(
-    string: String,
-    startIndex: Int = 0,
-    ignoreCase: Boolean = false
-): Int
-</syntaxhighlight>
 == القيم المعادة ==
-فهرس أول ظهور للعنصر المُمرّر أو  العدد ‎<code>-1</code>.
+تعاد [[Kotlin/String|سلسلة نصية]].
 == أمثلة ==
+<nowiki/><nowiki/>مثالٌ على استعمال الدالة <code>()intern</code>:<syntaxhighlight lang="kotlin">
-=== استخدام  الدالة<code>()intern</code>مع سلسلة نصية مع تمرير حرف كوسيط  ===
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>str</code><nowiki/>، ثم تستخدم الدالة  <code>()intern</code>  للحصول على فهرس أول ظهور للحرفين <code>'x'</code> و<code>'s'</code> ، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-var str = "hsoub"
+    var str = "hsoub"
-print(str.indexOf('s')) // 1
-print(str.indexOf('x')) // -1
+    print(str.intern()) // hsoub
 }
 </syntaxhighlight>
-=== استخدام  الدالة<code>()indexOf</code>مع سلسلة نصية مع تمرير سلسلة نصية كوسيط  ===
+== <nowiki/>انظر أيضًا ==
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستخدم الدالة  <code>()indexOf</code>  للحصول على فهرس أول ظهور  [[Kotlin/String|للسلسلتين النصيتين]]<code>"sou"</code> و<code>"sx"</code> ، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+* الدالة <code>[[Kotlin/kotlin.text/format|format()‎]]</code>: تنسِّق سلسلة نصية وفقًا لقيمة المعاملات التي تمرر إليها.
-fun main(args: Array<String>) {
-var str = "hsoub"
-print(str.indexOf("sou")) // 1
-print(str.indexOf("sx")) // -1
-}
-</syntaxhighlight>
-== انظر أيضًا ==
-* <code>[[Kotlin/kotlin.text/indexOfAny|indexOfAny]]()‎</code>: تعيد  فهرس أول ظهور للحرف أو [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس المُمرّر <code>startIndex</code>، في حال كان ذلك الحرف أو تلك  [[Kotlin/String|السلسلة النصية]] المُمرّرة غير موجودة فستعيد الدالةُ العدد ‎<code>-1</code>.
 == مصادر ==
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/index-of.html الدالة text.intern()‎  في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/intern.html صفحة الدالة String.intern()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Methods]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin String]]