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

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

تحوّل الدالة toUpperCase()‎ المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف كبيرة (uppercase).

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

inline actual fun Char.toUpperCase(): Char
inline actual fun String.toUpperCase(): String 
inline fun String.toUpperCase(locale: Locale): String

المنصة المطلوبة: JVM.

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

المعاملات

`locale`

المحلية المراد ضبطها إلى منطقة جغرافية محددة وأخذها بالحسبان أثناء عملية التحويل.

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

يعاد المحرف Char المعطى بعد تحويله إلى محرف كبير، أو السلسلة النصية String المعطاة بعد تحويل جميع محارفها إلى محارف كبيرة.

أمثلة

استعمال الدالة toUpperCase()‎ لتحويل جميع حروف سلسلة نصية إلى حروف كبيرة:

fun main(args: Array<String>) {    
    val x = "hsoub"
    
    print(x.toUpperCase()) // HSOUB
}

استعمال الدالة toUpperCase()‎ لتحويل الحرف i مع تمرير الوسيط Locale("tr")‎ الذي يضبط المحلية إلى اللغة التركية:

import java.util.Locale

fun main(args: Array<String>) {    
    println("i".toUpperCase(Locale("tr"))) // İ
}

انظر أيضًا

الدالة toBoolean()‎: تعيد القيمة true إن كانت السلسلة النصية التي استٌدعيت معها تساوي "true" مع تجاهل حالة الأحرف، أو تعيد القيمة false.
الدالة toByte()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع Byte.
الدالة toByteArray()‎: ترمز جميع محارف السلسلة النصية التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع ByteArray.
الدالة toCollection()‎: تضيف كل محارف السلسلة التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها.

الدالة toFloat()‎: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد عشري.
الدالة toHashSet()‎: تحلّل كائنًا من النوع HashSet يحوي كل محارف السلسلة التي استٌدعيت معها.
الدالة toInt()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح.
الدالة toSet()‎: تضيف كل محارف سلسلة الحروف التي استٌدعيت معها إلى مجموعة من النوع Set، إذ يوضع كل محرف في عنصر.
الدالة toShort()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير.
الدالة toSortedSet()‎: تضيف كل محارف السلسلة التي استٌدعيت معها إلى مجموعة من النوع SortedSet، إذ يوضع كل محرف في عنصر.
الدالة toString()‎ : تحول العدد الذي استٌدعي معها وفقًا لأساس مُحدّد إلى سلسلة نصية.
الدالة toTitleCase()‎: تحول المحرف الذي استٌدعي معها إلى محرف عنواني (titlecase). تتكون المحارف العنوانية عادةً من محرفين ملتصقين، مثل 'ǅ' أو 'ǋ'، إذ يعاملان وكأنَّهما محرفٌ واحدٌ فقط.
الدالة isUpperCase()‎: تتحقق إن كان الحرف الذي استٌدعي معها حرفًا كبيرًا (upper case).

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.toUpperCase()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE:الدالة <code>toUpperCase()‎</code> في Kotlin}}</noinclude>
-تحوّل الدالة <code>toUpperCase()</code>‎ [[Kotlin/Char/index|الحرف]] أو [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها إلى حالة الأحرف الصغيرة (lowercase).
+تحوّل الدالة <code>toUpperCase()</code>‎ [[Kotlin/Char|المحرف]] أو جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى محارف كبيرة (uppercase).
+==البنية العامة==
-== البنية العامة ==
 <syntaxhighlight lang="kotlin">
-inline actual fun Char.toLowerCase(): Char
+inline actual fun Char.toUpperCase(): Char
+inline actual fun String.toUpperCase(): String
+inline fun String.toUpperCase(locale: Locale): String
-</syntaxhighlight>يمكن استدعاء الدالة <code>toLowerCase()</code>‎ عبر [[Kotlin/Char/index|حرف]].<syntaxhighlight lang="kotlin">
+</syntaxhighlight>'''المنصة المطلوبة''': JVM.
-inline actual fun String.toLowerCase(): String
-</syntaxhighlight>يمكن استدعاء الدالة <code>toLowerCase()</code>‎ عبر [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin">
+وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
-inline fun String.toLowerCase(locale: Locale): String
-</syntaxhighlight>
+== المعاملات ==
-يمكن استدعاء الدالة <code>toLowerCase()</code>‎ عبر [[Kotlin/String|سلسلة نصية]]، مع تمرير وسيط من نوع <code>locale</code>والذي يمرّر  الخصائص الثقافية واللغوية للمنطقة الجغرافية المحلية.
+=== <code>locale</code> ===
+المحلية المراد ضبطها إلى منطقة جغرافية محددة وأخذها بالحسبان أثناء عملية التحويل.
-يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+==القيم المعادة==
+يعاد المحرف <code>Char</code> المعطى بعد تحويله إلى محرف كبير، أو السلسلة النصية <code>String</code> المعطاة بعد تحويل جميع محارفها إلى محارف كبيرة.
+==أمثلة==
+استعمال الدالة <code>toUpperCase()‎</code> لتحويل جميع حروف سلسلة نصية إلى حروف كبيرة:<syntaxhighlight lang="kotlin">
+fun main(args: Array<String>) {
+    val x = "hsoub"
+    print(x.toUpperCase()) // HSOUB
+}
-== القيم المعادة ==
+</syntaxhighlight>استعمال الدالة <code>toUpperCase()‎</code> لتحويل الحرف <code>i</code> مع تمرير الوسيط <code>Locale("tr")‎</code> الذي يضبط المحلية إلى اللغة التركية:<syntaxhighlight lang="kotlin">
-[[Kotlin/String|سلسلة نصية]] أو [[Kotlin/Char/index|حرف]].
+import java.util.Locale
-== أمثلة ==
-=== استخدام الدالة <code>toUpperCase()‎</code> مع سلسلة نصية ===
-تُعرّف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>x</code> ثم تستدعي الدالة <code>toUpperCase()‎</code> عبر <code>x</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     val x = "HSOUB"
+     println("i".toUpperCase(Locale("tr"))) // İ
-    print(x.toLowerCase()) // hsoub
 }
 </syntaxhighlight>
-== انظر أيضًا ==
+==انظر أيضًا==
-* <code>[[Kotlin/Byte/compareTo|compareTo()]]</code>‎ : يقارن بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .
+*الدالة [[Kotlin/kotlin.text/toBoolean|<code>toBoolean()</code>‎]]: تعيد القيمة <code>true</code> إن كانت [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها تساوي <code>"true"</code> مع تجاهل حالة الأحرف، أو تعيد القيمة <code>false</code>.
+*الدالة [[Kotlin/kotlin.text/toByte|<code>toByte()</code>‎]]: تحلّل [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وتحوّلها إلى عدد من النوع <code>[[Kotlin/Byte|Byte]]</code>.
+*الدالة [[Kotlin/kotlin.text/toByteArray|<code>toByteArray()</code>‎]]: ترمز جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع <code>[[Kotlin/ByteArray|ByteArray]]</code>.
+*الدالة <nowiki/>[[Kotlin/kotlin.text/toCollection|<code>toCollection()</code>‎]]: تضيف كل محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها.
-* <code>[[Kotlin/Byte/dec|dec()]]</code>‎ : تخفض قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+* الدالة <nowiki/>[[Kotlin/kotlin.text/toFloat|<code>toFloat()</code>‎]]: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى <nowiki/>[[Kotlin/Float|عدد عشري]].
-* <code>[[Kotlin/Byte/inc|inc()]]</code>‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+* الدالة <nowiki/>[[Kotlin/kotlin.text/toHashSet|<code>toHashSet()</code>‎]]: تحلّل كائنًا من النوع <code>HashSet</code> يحوي كل محارف <nowiki/>[[Kotlin/CharSequence/index|السلسلة]] التي استٌدعيت معها.
-* <code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+* الدالة <nowiki/>[[Kotlin/kotlin.text/toInt|<code>toInt()</code>‎]]: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح.
+* الدالة [[Kotlin/kotlin.text/toSet|<code>toSet()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت معها إلى مجموعة من النوع <code>[[Kotlin/Set|Set]]</code>، إذ يوضع كل محرف في عنصر.
+* الدالة [[Kotlin/kotlin.text/toShort|<code>toShort()</code>‎]]: تحلّل [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وتحوّلها إلى [[Kotlin/Short|عدد قصير.]]
+* الدالة [[Kotlin/kotlin.text/toSortedSet|<code>toSortedSet()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence|السلسلة]]  التي استٌدعيت معها إلى مجموعة من النوع <code>[[Kotlin/collections/SortedSet|SortedSet]]</code>، إذ يوضع كل محرف في عنصر.
+* الدالة [[Kotlin/kotlin.text/toString|<code>toString()</code>‎]] : تحول العدد الذي استٌدعي معها وفقًا لأساس مُحدّد إلى [[Kotlin/String|سلسلة نصية]].
+* الدالة [[Kotlin/text/toTitleCase|<code>toTitleCase()</code>‎]]: تحول [[Kotlin/Char|المحرف]] الذي استٌدعي معها إلى محرف عنواني (titlecase). تتكون المحارف العنوانية عادةً من محرفين ملتصقين، مثل <code>'ǅ'</code> أو <code>'ǋ'</code>، إذ يعاملان وكأنَّهما محرفٌ واحدٌ فقط.
+* الدالة <nowiki/>[[Kotlin/text/isUpperCase|<code>isUpperCase()</code>‎]]: تتحقق إن كان <nowiki/>[[Kotlin/Char|الحرف]] الذي استٌدعي معها حرفًا كبيرًا (upper case).
-== مصادر ==
+==<nowiki/><nowiki/><nowiki/>مصادر==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-lower-case.html صفحة الدالة toUpperCase()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-upper-case.html صفحة الدالة toUpperCase()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]