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

من موسوعة حسوب
→ التعديل السابق
مرئينص الويكي
لا ملخص تعديل
مراجعة وتدقيق.
 
(مراجعتان متوسطتان بواسطة مستخدمين اثنين آخرين غير معروضتين)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>text.format()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>String.format()‎</code> في Kotlin}}</noinclude>
يختلف سلوك  حسب نوع وعدد الوسائط المُمرّرة إليها (انظر فقرة البنية العامة).   
تنسِّق الدالة <code>format()‎</code> سلسلة نصية وفقًا لقيمة المعاملات التي تمرر إليها.   
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
inline fun String.format(vararg args: Any?): String  
inline fun String.format(vararg args: Any?): String  


</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
</syntaxhighlight>'''بيئة التشغيل المطلوبة''': JVM.


تستخدم الدالة<code>format()‎</code> <nowiki/>[[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها كقالب توضيب (format string) وتعيد [[Kotlin/String|سلسلة نصية]] بتعويض الوسيط المحدد باستخدام الإعدادات المحلية الابتدائية. <syntaxhighlight lang="kotlin">
تستعمل <code>format()‎</code> <nowiki/>[[Kotlin/String|السلسلة النصية]] التي استُدعيت معها كسلسلة تنسيق نصية (format string) وتعيد [[Kotlin/String|سلسلة نصية]] ناتجة عن تعويض الوسائط <code>args</code> المعطاة وباستخدام الإعدادات الافتراضية للمحلية (locale). <syntaxhighlight lang="kotlin">
inline fun String.Companion.format(
inline fun String.Companion.format(
     format: String,  
     format: String,  
     vararg args: Any?
     vararg args: Any?
): String  
): String  
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
</syntaxhighlight>'''بيئة التشغيل المطلوبة''': JVM.


تستخدم الدالة<code>format()‎</code> <nowiki/>[[Kotlin/String|السلسلة النصية]] المُمرّرة <code>format</code> كقالب توضيب (format string) وتعيد [[Kotlin/String|سلسلة نصية]] بتعويض الوسيط المحدد باستخدام الإعدادات المحلية الابتدائية. <syntaxhighlight lang="kotlin">
تستعمل الدالة <code>format()‎</code> <nowiki/>[[Kotlin/String|السلسلة النصية]] <code>format</code> المُمرّرة كسلسلة تنسيق نصية وتعيد [[Kotlin/String|سلسلة نصية]] ناتجة عن تعويض الوسائط <code>args</code> المعطاة وباستخدام الإعدادات الافتراضية للمحلية (locale). <syntaxhighlight lang="kotlin">
inline fun String.format(
inline fun String.format(
     locale: Locale,  
     locale: Locale,  
     vararg args: Any?
     vararg args: Any?
): String
): String
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
</syntaxhighlight>'''بيئة التشغيل المطلوبة''': JVM.


تستخدم الدالة<code>format()‎</code> <nowiki/>[[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها كقالب توضيب (format string) وتعيد [[Kotlin/String|سلسلة نصية]] بتعويض الوسيط المحدد باستخدام الإعدادات المحلية المُمرّرة <code>locale</code>. <syntaxhighlight lang="kotlin">
تستعمل الدالة <code>format()‎</code> <nowiki/>[[Kotlin/String|السلسلة النصية]] التي استُدعيت معها كسلسلة تنسيق نصية وتعيد [[Kotlin/String|سلسلة نصية]] ناتجة عن تعويض الوسائط <code>args</code> المعطاة وباستخدام الإعدادات <code>locale</code> الممررة للمحلية (locale). <syntaxhighlight lang="kotlin">
inline fun String.Companion.format(
inline fun String.Companion.format(
     locale: Locale,  
     locale: Locale,  
سطر 27: سطر 27:
     vararg args: Any?
     vararg args: Any?
): String
): String
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
</syntaxhighlight>'''بيئة التشغيل المطلوبة''': JVM.


تستخدم الدالة<code>format()‎</code> <nowiki/>[[Kotlin/String|السلسلة النصية]] المُمرّرة <code>format</code> كقالب توضيب (format string) وتعيد [[Kotlin/String|سلسلة نصية]] بتعويض الوسيط المحدد باستخدام الإعدادات المحلية المُمرّرة <code>locale</code>.  
تستعمل الدالة <code>format()‎</code> <nowiki/>[[Kotlin/String|السلسلة النصية]] <code>format</code> الممررة كسلسلة تنسيق نصية وتعيد [[Kotlin/String|سلسلة نصية]] ناتجة عن تعويض الوسائط <code>args</code> المعطاة وباستخدام الإعدادات <code>locale</code> الممررة للمحلية (locale).  


يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
== المعاملات ==
=== <code>args</code> ===
الوسائط المراد استعمالها في علمية التنسيق.
=== <code>format</code> ===
سلسلة التنسيق النصية.
=== <code>locale</code> ===
إعدادات المحلية المراد استعمالها في عملية التنسيق.


==القيم المعادة==
==القيم المعادة==
[[Kotlin/String|سلسلة نصية]].
تعاد [[Kotlin/String|سلسلة نصية]].


==أمثلة==
==أمثلة==
===استخدام الدالة <code>()format</code> مع سلسلة نصية===
مثالٌ على استعمال الدالة <code>()format</code><nowiki/>:<syntaxhighlight lang="kotlin">
تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>formatTemplate</code>، ثمَّ تستدعي الدالة  <code>()format</code> عبرها مع تمرير [[Kotlin/String|سلسلتين نصيتين]] كوسيطين، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
  var formatTemplate = "%-2s\t%s"
    var formatTemplate = "%-2s\t%s"


  println(formatTemplate.format("%b", "hsoub")) // %b hsoub
    println(formatTemplate.format("%b", "hsoub")) // %b hsoub
}
}
</syntaxhighlight>
</syntaxhighlight>
==انظر أيضًا==
* <code>[[Kotlin/kotlin.text/foldIndexed|foldIndexed()]]‎</code>: تُراكِم الدالة<code>foldIndexed()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة الراهنة وعلى الحرف الموالي في  [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها  وكذلك فهرسه. ثم تُعيد القيمة النهائية. 
* <code>[[Kotlin/kotlin.text/fold|fold()]]‎</code>: تُراكِم الدالة<code>fold()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة الراهنة وعلى الحرف الموالي في  سلسلة الحروف التي استُدعيت عبرها. ثم تُعيد القيمة النهائية. 
* <code>[[Kotlin/kotlin.text/elementAt|elementAt()]]‎</code>: تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء <code>IndexOutOfBoundsException</code>. 
==مصادر==
==مصادر==
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/format.html الدالة text.format()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/format.html صفحة الدالة String.format()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Text]]
[[تصنيف:Kotlin String]]

المراجعة الحالية بتاريخ 13:18، 3 سبتمبر 2018

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

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

inline fun String.format(vararg args: Any?): String

بيئة التشغيل المطلوبة: JVM. تستعمل format()‎ السلسلة النصية التي استُدعيت معها كسلسلة تنسيق نصية (format string) وتعيد سلسلة نصية ناتجة عن تعويض الوسائط args المعطاة وباستخدام الإعدادات الافتراضية للمحلية (locale). 

inline fun String.Companion.format(
    format: String, 
    vararg args: Any?
): String

بيئة التشغيل المطلوبة: JVM. تستعمل الدالة format()‎ السلسلة النصية format المُمرّرة كسلسلة تنسيق نصية وتعيد سلسلة نصية ناتجة عن تعويض الوسائط args المعطاة وباستخدام الإعدادات الافتراضية للمحلية (locale). 

inline fun String.format(
    locale: Locale, 
    vararg args: Any?
): String

بيئة التشغيل المطلوبة: JVM. تستعمل الدالة format()‎ السلسلة النصية التي استُدعيت معها كسلسلة تنسيق نصية وتعيد سلسلة نصية ناتجة عن تعويض الوسائط args المعطاة وباستخدام الإعدادات locale الممررة للمحلية (locale). 

inline fun String.Companion.format(
    locale: Locale, 
    format: String, 
    vararg args: Any?
): String

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

تستعمل الدالة format()‎ السلسلة النصية format الممررة كسلسلة تنسيق نصية وتعيد سلسلة نصية ناتجة عن تعويض الوسائط args المعطاة وباستخدام الإعدادات locale الممررة للمحلية (locale).

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

المعاملات

args

الوسائط المراد استعمالها في علمية التنسيق.

format

سلسلة التنسيق النصية.

locale

إعدادات المحلية المراد استعمالها في عملية التنسيق.

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

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

أمثلة

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

fun main(args: Array<String>) {
    var formatTemplate = "%-2s\t%s"

    println(formatTemplate.format("%b", "hsoub")) // %b	hsoub
}

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/format&oldid=16383»