الفرق بين المراجعتين لصفحة: «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|السلسلة النصية]] التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
+تحوّل الدالة <code>toUpperCase()</code>‎ [[Kotlin/Char|المحرف]] أو جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى محارف كبيرة (uppercase).
+==البنية العامة==
-== البنية العامة ==
 <syntaxhighlight lang="kotlin">
 inline actual fun Char.toUpperCase(): Char
-</syntaxhighlight>يمكن استدعاء الدالة <code>toUpperCase()</code>‎ عبر [[Kotlin/Char/index|حرف]].<syntaxhighlight lang="kotlin">
 inline actual fun String.toUpperCase(): String
-</syntaxhighlight>يمكن استدعاء الدالة <code>toUpperCase()</code>‎ عبر [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin">
 inline fun String.toUpperCase(locale: Locale): String
-</syntaxhighlight>
+</syntaxhighlight>'''المنصة المطلوبة''': JVM.
-يمكن استدعاء الدالة <code>toUpperCase()</code>‎ عبر [[Kotlin/String|سلسلة نصية]]، مع تمرير وسيط من نوع <code>locale</code>والذي يمرّر  الخصائص الثقافية واللغوية للمنطقة الجغرافية المحلية.
+وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
-يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+== المعاملات ==
-== القيم المعادة ==
+=== <code>locale</code> ===
-[[Kotlin/String|سلسلة نصية]] أو [[Kotlin/Char/index|حرف]].
+المحلية المراد ضبطها إلى منطقة جغرافية محددة وأخذها بالحسبان أثناء عملية التحويل.
-== أمثلة ==
+==القيم المعادة==
+يعاد المحرف <code>Char</code> المعطى بعد تحويله إلى محرف كبير، أو السلسلة النصية <code>String</code> المعطاة بعد تحويل جميع محارفها إلى محارف كبيرة.
-=== استخدام الدالة <code>toUpperCase()‎</code> مع سلسلة نصية ===
+==أمثلة==
-تُعرّف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>x</code> ثم تستدعي الدالة <code>toUpperCase()‎</code> عبر <code>x</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+استعمال الدالة <code>toUpperCase()‎</code> لتحويل جميع حروف سلسلة نصية إلى حروف كبيرة:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
      val x = "hsoub"
@@ سطر 31: / سطر 26: @@
 }
-</syntaxhighlight>
+</syntaxhighlight>استعمال الدالة <code>toUpperCase()‎</code> لتحويل الحرف <code>i</code> مع تمرير الوسيط <code>Locale("tr")‎</code> الذي يضبط المحلية إلى اللغة التركية:<syntaxhighlight lang="kotlin">
-=== استخدام الدالة <code>toUpperCase()‎</code> مع حرف مع تمرير وسيط ===
-تستدعي الشيفرة الآتية الدالة <code>toUpperCase()‎</code> عبر الحرف <code>i</code>، مع تمرير المتغير <code>Locale("tr")‎</code> الذي يحدد الخصوصيات المحلية للغة التركية، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 import java.util.Locale
 fun main(args: Array<String>) {
      println("i".toUpperCase(Locale("tr"))) // İ
 }
 </syntaxhighlight>
+==انظر أيضًا==
+*الدالة [[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|السلسلة]] التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها.
-== انظر أيضًا ==
+* الدالة <nowiki/>[[Kotlin/kotlin.text/toFloat|<code>toFloat()</code>‎]]: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى <nowiki/>[[Kotlin/Float|عدد عشري]].
-* <code>[[Kotlin/Byte/compareTo|compareTo()]]</code>‎ : يقارن بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .
+* الدالة <nowiki/>[[Kotlin/kotlin.text/toHashSet|<code>toHashSet()</code>‎]]: تحلّل كائنًا من النوع <code>HashSet</code> يحوي كل محارف <nowiki/>[[Kotlin/CharSequence/index|السلسلة]] التي استٌدعيت معها.
+* الدالة <nowiki/>[[Kotlin/kotlin.text/toInt|<code>toInt()</code>‎]]: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح.
-* <code>[[Kotlin/Byte/dec|dec()]]</code>‎ : تخفض قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+* الدالة [[Kotlin/kotlin.text/toSet|<code>toSet()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت معها إلى مجموعة من النوع <code>[[Kotlin/Set|Set]]</code>، إذ يوضع كل محرف في عنصر.
-* <code>[[Kotlin/Byte/inc|inc()]]</code>‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+* الدالة [[Kotlin/kotlin.text/toShort|<code>toShort()</code>‎]]: تحلّل [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وتحوّلها إلى [[Kotlin/Short|عدد قصير.]]
-* <code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+* الدالة [[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-upper-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]]