عرض مصدر Sass/str insert

<noinclude>{{DISPLAYTITLE: الدالة <code>()str_insert</code> في Sass}}</noinclude>
تُدرج الدالة <code>str_insert'''()‎'''</code> '''سلسلةً نصيةً داخل أخرى.'''

لاحظ أنه على عكس بعض اللغات، فإنّ رقم الحرف الأول هو <code>1</code>، والثاني رقمه <code>2</code>، وهكذا.
== البنية العامة ==
<syntaxhighlight lang="sass">
str_insert($string, $insert, $index)
</syntaxhighlight>

== المعاملات ==

=== <code>‎$string </code> ===
سلسلة نصّية.

=== <code>‎$insert</code> ===
السلسلة النصّية المراد إدماجُها.

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

== القيم المعادة ==
السلسلة النصية الناتجة ستكون مُقتبسة إذا وفقط إذا كانت <code>‎‎$string</code> غير مُقتبسة.

== الأخطاء والاستثناءات ==
سيُرمى الخطأ <code>ArgumentError</code> إن كان أيّ من المعاملات من النوع الخطأ.

== أمثلة ==
مثال عن استخدام الدالة <code>str-insert()‎</code>  لضبط قيمة لون الخلفية ([[CSS/background-color|background-color]]):<syntaxhighlight lang="sass">
selector {
  background-color: ‎str-insert(ed, "r", 1) => red
}
</syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <nowiki/>[[CSS]] الآتية:<syntaxhighlight lang="css">
selector {
  background-color: red;
}
</syntaxhighlight>

== انظر أيضًا ==
* الدالة <code>[[Sass/str index|'''str_index'''()]]</code>‎: تُدرج سلسة نصية في أخرى.

* الدالة <code>[[Sass/str-length|str-length()]]</code>‎: تُعيد عدد احرف سلسلةنصية.

== مصادر ==
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#str_insert-instance_method قسم الدالة  في صفحة الدوال في توثيق Sass الرسمي.]
[[تصنيف:Sass]]
[[تصنيف: Sass Function]]