الفرق بين المراجعتين لصفحة: «Sass/str insert»

مراجعة 12:02، 20 أبريل 2018

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

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()str_insert</code> في Sass}}</noinclude>
-تُعيد الدالة <code>str_insert'''()‎'''</code> عدد حروف '''السلسلة النصية.'''
+تُدرج الدالة <code>str_insert'''()‎'''</code> '''سلسلةً نصيةً داخل أخرى.'''
+لاحظ أنه على عكس بعض اللغات، فإنّ رقم الحرف الأول هو <code>1</code>، والثاني رقمه <code>2</code>، وهكذا.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-str_insert($string)
+str_insert($string, $insert, $index)
 </syntaxhighlight>
@@ سطر 10: / سطر 12: @@
 === <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>‎$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/unquote|unquote()]]</code>‎: إزالة علامات الاقتباس من سلسلةنصية مُقتبسة.
+* الدالة <code>[[Sass/str index|'''str_index'''()]]</code>‎: تُدرج سلسة نصية في أخرى.
-* الدالة <code>[[Sass/str insert|'''str_insert'''()]]</code>‎: تُدرج سلسة نصية في أخرى.
+* الدالة <code>[[Sass/str-length|str-length()]]</code>‎: تُعيد عدد احرف سلسلةنصية.
 == مصادر ==
-* [https://sass-lang.com/documentation/Sass/Script/Functions.html#str_length-instance_method قسم الدالة  في صفحة الدوال في توثيق Sass الرسمي.]
+* [https://sass-lang.com/documentation/Sass/Script/Functions.html#str_insert-instance_method قسم الدالة  في صفحة الدوال في توثيق Sass الرسمي.]
 [[تصنيف:Sass]]
 [[تصنيف: Sass Function]]