الفرق بين المراجعتين لصفحة: «Sass/str insert»
< Sass
لا ملخص تعديل |
ط استبدال النص - '\[\[تصنيف:(.*)\]\]' ب'{{SUBPAGENAME}}' |
||
| (6 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()str_insert</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()str_insert</code> في Sass}}</noinclude> | ||
تُدرج الدالة <code>str_insert | تُدرج الدالة <code>str_insert()</code> سلسلةً نصيةً داخل أخرى عند موضع محدَّد. | ||
لاحظ | لاحظ أن رقم ترتيب العنصر الأول في <nowiki/>[[Sass]] هو 1، والعنصر الثاني هو 2، وهكذا على عكس بعض اللغات. | ||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
| سطر 10: | سطر 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>$insert</code> إلى السلسلة <code>$string</code> في الموضع <code>$index</code>. ستكون تلك السلسلة المُعادة مُقتبسة إذا كانت السلسلة <code>$string</code> مُقتبسة فقط. | ||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
| سطر 26: | سطر 26: | ||
== أمثلة == | == أمثلة == | ||
مثال عن استخدام الدالة <code> | أمثلة نموذجية عن الدالة <code>str_insert()</code>:<syntaxhighlight lang="sass"> | ||
selector { | str_insert("abcd", "X", 1); // "Xabcd" | ||
background-color: | str_insert("abcd", "X", 4); // "abcXd" | ||
str_insert("abcd", "X", 5); // "abcdX" | |||
</syntaxhighlight>مثال عن استخدام الدالة <code>str_insert()</code> لضبط قيمة لون الخلفية (<code>[[CSS/background-color|background-color]]</code>):<syntaxhighlight lang="sass"> | |||
.selector { | |||
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| | * الدالة <code>[[Sass/str index|str_index()]]</code>: تعيد موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة. | ||
* الدالة <code>[[Sass/str length|str_length()]]</code>: تعيد عدد أحرف سلسلة نصيَّة محدَّدة. | |||
* الدالة <code>[[Sass/str | * الدالة <code>[[Sass/str slice|str_slice()]]</code>: تعيد جزءًا من السلسلة النصيَّة الممرَّرة إليها والذي يبدأ وينتهي عند موضع محدَّد. | ||
* الدالة <code>[[Sass/unquote|unquote()]]</code>: تزيل علامات الاقتباس من سلسلة نصيَّة مُقتبسة. | |||
* الدالة <code>[[Sass/to lower case|to_lower_case()]]</code>: تحوّل جميع حروف السلسلة النصيَّة الممرَّرة إليها إلى حروف صغيرة. | |||
== مصادر == | == مصادر == | ||
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#str_insert-instance_method قسم الدالة | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#str_insert-instance_method قسم الدالة str_insert في صفحة الدوال في توثيق Sass الرسمي]. | ||
[[تصنيف:Sass]] | [[تصنيف:Sass|{{SUBPAGENAME}}]] | ||
[[تصنيف: Sass Function]] | [[تصنيف: Sass Function|{{SUBPAGENAME}}]] | ||
المراجعة الحالية بتاريخ 07:00، 20 مايو 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():
str_insert("abcd", "X", 1); // "Xabcd"
str_insert("abcd", "X", 4); // "abcXd"
str_insert("abcd", "X", 5); // "abcdX"
مثال عن استخدام الدالة 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(): تحوّل جميع حروف السلسلة النصيَّة الممرَّرة إليها إلى حروف صغيرة.