الفرق بين المراجعتين ل"Sass/str insert"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].')
ط (استبدال النص - '\[\[تصنيف:(.*)\]\]' ب'{{SUBPAGENAME}}')
 
سطر 48: سطر 48:
 
== مصادر ==
 
== مصادر ==
 
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#str_insert-instance_method قسم الدالة str_insert في صفحة الدوال في توثيق Sass الرسمي].
 
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#str_insert-instance_method قسم الدالة str_insert في صفحة الدوال في توثيق Sass الرسمي].
[[تصنيف:Sass]]
+
[[تصنيف:Sass|{{SUBPAGENAME}}]]
[[تصنيف: Sass Function]]
+
[[تصنيف: Sass Function|{{SUBPAGENAME}}]]

المراجعة الحالية بتاريخ 07:00، 20 مايو 2018

تُدرج الدالة str_insert()‎ سلسلةً نصيةً داخل أخرى عند موضع محدَّد.

لاحظ أن رقم ترتيب العنصر الأول في Sass هو 1، والعنصر الثاني هو 2، وهكذا على عكس بعض اللغات.

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

str_insert($string, $insert, $index)

المعاملات

‎$string

السلسلة النصّيَّة التي سيضاف إليها سلسلة نصيَّة أخرى.

‎$insert

السلسلة النصّية المراد إضافتها.

‎$index

الموضع الذي ستُدرج فيه السلسلة ‎$insert ضمن السلسلة ‎$string. إن كانت قيمة هذا المعامل سالبة، فسيحسب موضع إضافة السلسلة النصيَّة $insert بدءًا من نهاية السلسلة ‎‎$string. إن كانت القيمة المعطاة تشير إلى موضع خارج حدود السلسلة النصيَّة $string، فستُدرج السلسلة ‎$insert في بداية السلسلة أو نهايتها.

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

تُعاد السلسلة النصيَّة الناتجة عن إضافة السلسلة ‎$insert إلى السلسلة ‎$string في الموضع ‎$index. ستكون تلك السلسلة المُعادة مُقتبسة إذا كانت السلسلة ‎‎$string مُقتبسة فقط.

الأخطاء والاستثناءات

سيُرمى الخطأ ArgumentError إن كان أيّ من المعاملات من النوع الخطأ.

أمثلة

أمثلة نموذجية عن الدالة str_insert()‎:

str_insert("abcd", "X", 1); // "Xabcd"
str_insert("abcd", "X", 4); // "abcXd"
str_insert("abcd", "X", 5); // "abcdX"

مثال عن استخدام الدالة str_insert()‎ لضبط قيمة لون الخلفية (background-color):

.selector {
  background-color: str_insert(ed, "r", 1); // red
}

سيُصرّف المثال السابق إلى شيفرة CSS الآتية:

.selector {
  background-color: red; }

انظر أيضًا

  • الدالة str_index()‎: تعيد موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة.
  • الدالة str_length()‎: تعيد عدد أحرف سلسلة نصيَّة محدَّدة.
  • الدالة str_slice()‎: تعيد جزءًا من السلسلة النصيَّة الممرَّرة إليها والذي يبدأ وينتهي عند موضع محدَّد.
  • الدالة unquote()‎: تزيل علامات الاقتباس من سلسلة نصيَّة مُقتبسة.
  • الدالة to_lower_case()‎: تحوّل جميع حروف السلسلة النصيَّة الممرَّرة إليها إلى حروف صغيرة.

مصادر