الفرق بين المراجعتين لصفحة: «Sass/str insert»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة الصفحة وتدقيقها. |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()str_insert</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()str_insert</code> في Sass}}</noinclude> | ||
تُدرج الدالة <code>str_insert()</code> سلسلةً نصيةً داخل أخرى. لاحظ | تُدرج الدالة <code>str_insert()</code> سلسلةً نصيةً داخل أخرى عند موضع محدَّد. | ||
لاحظ أن رقم ترتيب العنصر الأول في <nowiki/>[[Sass]] هو 1، والعنصر الثاني هو 2، وهكذا على عكس بعض اللغات. | |||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
| سطر 8: | سطر 10: | ||
== المعاملات == | == المعاملات == | ||
=== <code>$ | === <code>$string</code> === | ||
سلسلة | السلسلة النصّيَّة التي سيضاف إليها سلسلة نصيَّة أخرى. | ||
=== <code>$insert</code> === | === <code>$insert</code> === | ||
السلسلة النصّية المراد | السلسلة النصّية المراد إضافتها. | ||
=== <code>$index</code> === | === <code>$index</code> === | ||
الموضع الذي ستُدرج فيه السلسلة <code>$insert</code>. | الموضع الذي ستُدرج فيه السلسلة <code>$insert</code> ضمن السلسلة <code>$string</code>. إن كانت قيمة هذا المعامل سالبة، فسيحسب موضع إضافة السلسلة النصية <code>$insert</code> بدءًا من نهاية السلسلة <code>$string</code>. إن كانت القيمة المعطاة تشير إلى موضع خارج حدود السلسلة النصية <code>$string</code>، فستُدرج السلسلة <code>$insert</code> في بداية السلسة أو نهايتها. | ||
== القيم المعادة == | == القيم المعادة == | ||
السلسلة النصية الناتجة ستكون مُقتبسة إذا وفقط إذا كانت <code>$string</code> مُقتبسة. | تُعاد السلسلة النصية الناتجة عن إضافة السلسلة <code>$insert</code> إلى السلسلة <code>$string</code> في الموضع <code>$index</code>. ستكون تلك السلسلة المُعادة مُقتبسة إذا وفقط إذا كانت السلسلة <code>$string</code> مُقتبسة. | ||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
| سطر 35: | سطر 37: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة <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>: تعيد عدد أحرف سلسلة نصيَّة محدَّدة. | ||
== مصادر == | == مصادر == | ||
مراجعة 16:37، 12 مايو 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(): تعيد عدد أحرف سلسلة نصيَّة محدَّدة.