الفرق بين المراجعتين لصفحة: «Kotlin/text/toUpperCase»
< Kotlin
جميل-بيلوني (نقاش | مساهمات) مراجعة وتدقيق. |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
(1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code> | <noinclude>{{DISPLAYTITLE:الدالة <code>toUpperCase()</code> في Kotlin}}</noinclude> | ||
تحوّل الدالة <code>toUpperCase()</code> [[Kotlin/Char| | تحوّل الدالة <code>toUpperCase()</code> [[Kotlin/Char|المحرف]] أو جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى محارف كبيرة (uppercase). | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
inline actual fun Char.toUpperCase(): Char | inline actual fun Char.toUpperCase(): Char | ||
inline actual fun String.toUpperCase(): String | inline actual fun String.toUpperCase(): String | ||
inline fun String.toUpperCase(locale: Locale): String | inline fun String.toUpperCase(locale: Locale): String | ||
</syntaxhighlight>المنصة المطلوبة | </syntaxhighlight>'''المنصة المطلوبة''': JVM. | ||
وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). | |||
== المعاملات == | |||
=== <code>locale</code> === | |||
المحلية المراد ضبطها إلى منطقة جغرافية محددة وأخذها بالحسبان أثناء عملية التحويل. | |||
==القيم المعادة== | ==القيم المعادة== | ||
يعاد | يعاد المحرف <code>Char</code> المعطى بعد تحويله إلى محرف كبير، أو السلسلة النصية <code>String</code> المعطاة بعد تحويل جميع محارفها إلى محارف كبيرة. | ||
==أمثلة== | ==أمثلة== | ||
استعمال الدالة <code>toUpperCase()</code> لتحويل جميع حروف سلسلة نصية إلى حروف كبيرة:<syntaxhighlight lang="kotlin"> | استعمال الدالة <code>toUpperCase()</code> لتحويل جميع حروف سلسلة نصية إلى حروف كبيرة:<syntaxhighlight lang="kotlin"> | ||
سطر 32: | سطر 35: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
*الدالة [[Kotlin/text/ | *الدالة [[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/text/isUpperCase|<code>isUpperCase()</code>]]: تتحقق إن | *الدالة <nowiki/>[[Kotlin/kotlin.text/toCollection|<code>toCollection()</code>]]: تضيف كل محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها. | ||
==مصادر== | |||
* الدالة <nowiki/>[[Kotlin/kotlin.text/toFloat|<code>toFloat()</code>]]: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى <nowiki/>[[Kotlin/Float|عدد عشري]]. | |||
* الدالة <nowiki/>[[Kotlin/kotlin.text/toHashSet|<code>toHashSet()</code>]]: تحلّل كائنًا من النوع <code>HashSet</code> يحوي كل محارف <nowiki/>[[Kotlin/CharSequence/index|السلسلة]] التي استٌدعيت معها. | |||
* الدالة <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>'Dž'</code> أو <code>'Nj'</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]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Function]] | ||
[[تصنيف:Kotlin Text]] |
المراجعة الحالية بتاريخ 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). تتكون المحارف العنوانية عادةً من محرفين ملتصقين، مثل'Dž'
أو'Nj'
، إذ يعاملان وكأنَّهما محرفٌ واحدٌ فقط. - الدالة
isUpperCase()
: تتحقق إن كان الحرف الذي استٌدعي معها حرفًا كبيرًا (upper case).