الفرق بين المراجعتين لصفحة: «Kotlin/text/toUpperCase»
< Kotlin
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع text.toUpperCase() في لغة Kotlin}}</noinclude> تحوّل الدالة <code>toUpperCase()</code> Kotlin/Char/index|...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: التابع text.toUpperCase() في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: التابع text.toUpperCase() في لغة Kotlin}}</noinclude> | ||
تحوّل الدالة <code>toUpperCase()</code> [[Kotlin/Char/index|الحرف]] أو [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها إلى حالة الأحرف | تحوّل الدالة <code>toUpperCase()</code> [[Kotlin/Char/index|الحرف]] أو [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase). | ||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
inline actual fun Char. | inline actual fun Char.toUpperCase(): Char | ||
</syntaxhighlight>يمكن استدعاء الدالة <code> | </syntaxhighlight>يمكن استدعاء الدالة <code>toUpperCase()</code> عبر [[Kotlin/Char/index|حرف]].<syntaxhighlight lang="kotlin"> | ||
inline actual fun String. | inline actual fun String.toUpperCase(): String | ||
</syntaxhighlight>يمكن استدعاء الدالة <code> | </syntaxhighlight>يمكن استدعاء الدالة <code>toUpperCase()</code> عبر [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin"> | ||
inline fun String. | inline fun String.toUpperCase(locale: Locale): String | ||
</syntaxhighlight> | </syntaxhighlight> | ||
يمكن استدعاء الدالة <code> | يمكن استدعاء الدالة <code>toUpperCase()</code> عبر [[Kotlin/String|سلسلة نصية]]، مع تمرير وسيط من نوع <code>locale</code>والذي يمرّر الخصائص الثقافية واللغوية للمنطقة الجغرافية المحلية. | ||
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | ||
| سطر 26: | سطر 26: | ||
تُعرّف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>x</code> ثم تستدعي الدالة <code>toUpperCase()</code> عبر <code>x</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> | تُعرّف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>x</code> ثم تستدعي الدالة <code>toUpperCase()</code> عبر <code>x</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val x = " | val x = "hsoub" | ||
print(x. | print(x.toUpperCase()) // HSOUB | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
=== استخدام الدالة <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> | |||
== انظر أيضًا == | == انظر أيضًا == | ||
* <code>[[Kotlin/Byte/compareTo|compareTo()]]</code> : يقارن بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة . | * <code>[[Kotlin/Byte/compareTo|compareTo()]]</code> : يقارن بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة . | ||
| سطر 40: | سطر 52: | ||
== مصادر == | == مصادر == | ||
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to- | * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-upper-case.html صفحة الدالة toUpperCase() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Method]] | [[تصنيف:Kotlin Method]] | ||
مراجعة 17:22، 2 يوليو 2018
تحوّل الدالة toUpperCase() الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
البنية العامة
inline actual fun Char.toUpperCase(): Char
يمكن استدعاء الدالة toUpperCase() عبر حرف.
inline actual fun String.toUpperCase(): String
يمكن استدعاء الدالة toUpperCase() عبر سلسلة نصية.
inline fun String.toUpperCase(locale: Locale): String
يمكن استدعاء الدالة toUpperCase() عبر سلسلة نصية، مع تمرير وسيط من نوع localeوالذي يمرّر الخصائص الثقافية واللغوية للمنطقة الجغرافية المحلية.
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
سلسلة نصية أو حرف.
أمثلة
استخدام الدالة toUpperCase() مع سلسلة نصية
تُعرّف الشيفرة الآتية سلسلة نصية باسم x ثم تستدعي الدالة toUpperCase() عبر x، ثم تطبع الناتج:
fun main(args: Array<String>) {
val x = "hsoub"
print(x.toUpperCase()) // HSOUB
}
استخدام الدالة toUpperCase() مع حرف مع تمرير وسيط
تستدعي الشيفرة الآتية الدالة toUpperCase() عبر الحرف i، مع تمرير المتغير Locale("tr") الذي يحدد الخصوصيات المحلية للغة التركية، ثم تطبع الناتج:
import java.util.Locale
fun main(args: Array<String>) {
println("i".toUpperCase(Locale("tr"))) // İ
}
انظر أيضًا
compareTo() : يقارن بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة0إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .
dec() : تخفض قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.inc() : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.isDefined(): تعيد القيمةtrueفي حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).