الفرق بين المراجعتين ل"Sass/str insert"
< Sass
اذهب إلى التنقل
اذهب إلى البحث
ط (استبدال النص - '\[\[تصنيف:(.*)\]\]' ب'{{SUBPAGENAME}}') |
|||
| (7 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة) | |||
| سطر 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(): تحوّل جميع حروف السلسلة النصيَّة الممرَّرة إليها إلى حروف صغيرة.