الدالة ()str_insert في Sass

تُدرج الدالة str_insert()‎ سلسلةً نصيةً داخل أخرى. لاحظ أنه على عكس بعض اللغات، فإنّ رقم الحرف الأول هو 1، والثاني رقمه 2، وهكذا.

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

str_insert($string, $insert, $index)

المعاملات

‎$string 

سلسلة نصّية.

‎$insert

السلسلة النصّية المراد إدماجُها.

‎$index

الموضع الذي ستُدرج فيه السلسلة ‎$insert. تُحتسب المؤشرات السلبية من نهاية ‎‎$string. إن كان المؤشر خارج حدود السلسلة النصية فستُدرج ‎$insert في بداية السلسة أو نهايتها.

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

السلسلة النصية الناتجة ستكون مُقتبسة إذا وفقط إذا كانت ‎‎$string مُقتبسة.

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

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

أمثلة

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

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

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

.selector {
  background-color: red;
}

انظر أيضًا

• الدالة str_index()‎: تُدرج سلسة نصية في أخرى.

• الدالة str_length()‎: تُعيد عدد أحرف سلسلة نصية.

مصادر

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