الدالة ()str_insert في Sass
تُدرج الدالة 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() لضبط قيمة لون الخلفية (background-color):
.selector {
background-color: str-insert(ed, "r", 1); // red
}
سيُصرّف المثال السابق إلى شيفرة CSS الآتية:
.selector {
background-color: red;
}
انظر أيضًا
- الدالة
str_index(): تعيد موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة.
- الدالة
str_length(): تعيد عدد أحرف سلسلة نصيَّة محدَّدة.