الدالة ()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()‎: تُعيد عدد احرف سلسلة نصية.

مصادر