Sass/str insert

تُدرج الدالة 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()‎: تحوّل جميع حروف السلسلة النصيَّة الممرَّرة إليها إلى حروف صغيرة.

مصادر

• قسم الدالة str_insert في صفحة الدوال في توثيق Sass الرسمي.