الفرق بين المراجعتين ل"Sass/str insert"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
سطر 28: سطر 28:
 
مثال عن استخدام الدالة <code>str-insert()‎</code>  لضبط قيمة لون الخلفية (<code>[[CSS/background-color|background-color]]</code>):<syntaxhighlight lang="sass">
 
مثال عن استخدام الدالة <code>str-insert()‎</code>  لضبط قيمة لون الخلفية (<code>[[CSS/background-color|background-color]]</code>):<syntaxhighlight lang="sass">
 
.selector {
 
.selector {
   background-color: str-insert(ed, "r", 1); // red
+
   background-color: str_insert(ed, "r", 1); // red
 
}
 
}
 
</syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <nowiki/>[[CSS]] الآتية:<syntaxhighlight lang="css">
 
</syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <nowiki/>[[CSS]] الآتية:<syntaxhighlight lang="css">
 
.selector {
 
.selector {
   background-color: red;
+
   background-color: red; }
}
 
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
== انظر أيضًا ==
 
== انظر أيضًا ==
 
* الدالة <code>[[Sass/str index|str_index()]]</code>‎: تعيد موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة.
 
* الدالة <code>[[Sass/str index|str_index()]]</code>‎: تعيد موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة.
 
 
* الدالة <code>[[Sass/str length|str_length()]]</code>‎: تعيد عدد أحرف سلسلة نصيَّة محدَّدة.
 
* الدالة <code>[[Sass/str length|str_length()]]</code>‎: تعيد عدد أحرف سلسلة نصيَّة محدَّدة.
 
* الدالة <code>[[Sass/str slice|str_slice()‎]]</code>: تعيد جزءًا من السلسلة النصيَّة الممرَّرة إليها والذي يبدأ وينتهي عند موضع محدَّد.
 
* الدالة <code>[[Sass/str slice|str_slice()‎]]</code>: تعيد جزءًا من السلسلة النصيَّة الممرَّرة إليها والذي يبدأ وينتهي عند موضع محدَّد.

مراجعة 09:05، 19 مايو 2018

تُدرج الدالة 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()‎: تعيد عدد أحرف سلسلة نصيَّة محدَّدة.
  • الدالة str_slice()‎: تعيد جزءًا من السلسلة النصيَّة الممرَّرة إليها والذي يبدأ وينتهي عند موضع محدَّد.
  • الدالة unquote()‎: تزيل علامات الاقتباس من سلسلة نصيَّة مُقتبسة.
  • الدالة to_lower_case()‎: تحوّل جميع حروف السلسلة النصيَّة الممرَّرة إليها إلى حروف صغيرة.

مصادر