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