الفرق بين المراجعتين لصفحة: «Sass/str slice»

المراجعة الحالية بتاريخ 07:00، 20 مايو 2018

تعيد الدالة str_slice()‎ جزءًا من السلسلة النصيَّة الممرَّرة إليها والذي يبدأ وينتهي عند موضع محدَّد.

لاحظ أن رقم ترتيب العنصر الأول في Sass هو 1، والعنصر الثاني هو 2، وهكذا على عكس بعض اللغات.

البنية العامة

str_slice($string, $start-at, $end-at: -1)

المعاملات

`‎$string`

السلسلة النصّيَّة المراد استخراج سلسلة نصيَّة فرعيَّة منها.

`‎$start-at`

موضع الحرف الأول من السلسلة النصيَّة الفرعيَّة المراد الحصول عليها. إذا كانت قيمة هذا المعامل سالبة، فسيحسب موضع بداية تلك السلسلة بدءًا من نهاية السلسلة النصيَّة ‎‎$string.

`‎$end-at`

موضع الحرف الأخير من السلسلة النصيَّة الفرعيَّة المراد الحصول عليها. إذا كانت قيمة هذا المعامل سالبة، فسيحسب موضع نهاية تلك السلسلة بدءًا من نهاية السلسلة النصيَّة ‎‎$string. القيمة الافتراضية لهذا المعامل هي ‎-1 أي ستكون نهاية السلسلة المعادة هي نهاية السلسلة ‎‎$string.

القيم المعادة

يُعاد جزء من السلسلة النصية ‎$string الذي يبدأ عند الموقع ‎$start-at وينتهي عند الموقع ‎$end-at. ستكون السلسلة النصية المُعادة مُقتبسة إذا كانت السلسلة ‎‎$string مُقتبسة فقط.

الأخطاء والاستثناءات

سيُرمى الخطأ ArgumentError إن كان أيٌّ من المعاملات من النوع الخطأ.

أمثلة

أمثلة نموذجية عن الدالة str_slice()‎:

str_slice("abcd", 2, 3);   // "bc"
str_slice("abcd", 2);      // "bcd"
str_slice("abcd", -3, -2); // "bc"
str_slice("abcd", 2, -2);  // "bc"

مثال عن استخدام الدالة str_slice()‎ لضبط قيمة الخاصِّيَّة content مع العنصر الزائف ‎::before:

.selector::before {
  content: str_slice("a'b", 2, 2) // "'"
}

سيُصرّف المثال السابق إلى شيفرة CSS الآتية:

.selector::before {
  content: "'"; }

انظر أيضًا

الدالة str_index()‎: تعيد موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة.
الدالة str_length()‎: تعيد عدد أحرف السلسلة النصيَّة الممرَّرة إليها.
الدالة str_insert()‎: تدرج سلسلةً نصيةً داخل أخرى عند موضع محدَّد.

مصادر

قسم الدالة str_slice في صفحة الدوال في توثيق Sass الرسمي.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()str_slice</code> في Sass}}</noinclude>
-تستخرج الدالة <code>str_slice()‎</code> سلسلةً نصيةً من <code>‎$string</code>، ستبدأ السلسلة المُستخرجة من المؤشر رقم <code>‎$start-at</code>وتنتهي عند <code>‎$end-at.</code> لاحظ أنه على عكس بعض اللغات، فإنّ رقم الحرف الأول في لغة [[Sass]] هو 1، والثاني رقمه 2، وهكذا.
+تعيد الدالة <code>str_slice()‎</code> جزءًا من السلسلة النصيَّة الممرَّرة إليها والذي يبدأ وينتهي عند موضع محدَّد.
+لاحظ أن رقم ترتيب العنصر الأول في <nowiki/>[[Sass]] هو 1، والعنصر الثاني هو 2، وهكذا على عكس بعض اللغات.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
@@ سطر 9: / سطر 11: @@
 === <code>‎$string</code>  ===
-سلسلة نصّية.
+السلسلة النصّيَّة المراد استخراج سلسلة نصيَّة فرعيَّة منها.
 === <code>‎$start-at</code> ===
-مؤشر الحرف الأول من السلسلة الفرعية. إذا كان هذا سلبيًا ، يتم حسابه من نهاية <code>‎‎$string.</code>
+موضع الحرف الأول من السلسلة النصيَّة الفرعيَّة المراد الحصول عليها. إذا كانت قيمة هذا المعامل سالبة، فسيحسب موضع بداية تلك السلسلة بدءًا من نهاية السلسلة النصيَّة <code>‎‎$string</code>.
 === <code>‎$end-at</code> ===
-مؤشر الحرف الأخير من السلسلة الفرعية. إذا كان هذا سلبيًا ، يتم حسابه من نهاية <code>‎‎$string.</code> قيمته الافتراضية هي ‎.<code>-1</code>
+موضع الحرف الأخير من السلسلة النصيَّة الفرعيَّة المراد الحصول عليها. إذا كانت قيمة هذا المعامل سالبة، فسيحسب موضع نهاية تلك السلسلة بدءًا من نهاية السلسلة النصيَّة <code>‎‎$string</code>. القيمة الافتراضية لهذا المعامل هي ‎<code>-1</code> أي ستكون نهاية السلسلة المعادة هي نهاية السلسلة <code>‎‎$string</code>.
 == القيم المعادة ==
-السلسلة النصية الناتجة ستكون مُقتبسة إذا وفقط إذا كانت <code>‎‎$string</code> مُقتبسة.
+يُعاد جزء من السلسلة النصية <code>‎$string</code> الذي يبدأ عند الموقع <code>‎$start-at</code> وينتهي عند الموقع <code>‎$end-at</code>. ستكون السلسلة النصية المُعادة مُقتبسة إذا كانت السلسلة <code>‎‎$string</code> مُقتبسة فقط.
 == الأخطاء والاستثناءات ==
-سيُرمى الخطأ <code>ArgumentError</code> إن كان أيّ من المعاملات من النوع الخطأ.
+سيُرمى الخطأ <code>ArgumentError</code> إن كان أيٌّ من المعاملات من النوع الخطأ.
 == أمثلة ==
-مثال عن استخدام الدالة <code>str-slice()‎</code>  لضبط قيمة الخاصية <code>[[CSS/content|content]]</code> مع العنصر الزائف ‎<code>[[CSS/::before|::before]]</code>:<syntaxhighlight lang="sass">
+أمثلة نموذجية عن الدالة <code>str_slice()‎</code>:<syntaxhighlight lang="sass">
+str_slice("abcd", 2, 3);   // "bc"
+str_slice("abcd", 2);      // "bcd"
+str_slice("abcd", -3, -2); // "bc"
+str_slice("abcd", 2, -2);  // "bc"
+</syntaxhighlight>مثال عن استخدام الدالة <code>str_slice()‎</code> لضبط قيمة الخاصِّيَّة <code>[[CSS/content|content]]</code> مع العنصر الزائف ‎<code>[[CSS/::before|::before]]</code>:<syntaxhighlight lang="sass">
 .selector::before {
-   content: str-slice("a'b", 2, 2) // "'"
+   content: str_slice("a'b", 2, 2) // "'"
 }
 </syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <nowiki/>[[CSS]] الآتية:<syntaxhighlight lang="css">
 .selector::before {
-   content: "'";
+   content: "'"; }
-}
 </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 insert|str_insert()]]</code>‎: تدرج سلسلةً نصيةً داخل أخرى عند موضع محدَّد.
-* الدالة <code>[[Sass/str insert|str_insert()]]</code>‎: تُدرج الدالة سلسلةً نصيةً داخل أخرى.
 == مصادر ==
-* [https://sass-lang.com/documentation/Sass/Script/Functions.html#str_slice-instance_method قسم الدالة str_slice في صفحة الدوال في توثيق Sass الرسمي.]
+* [https://sass-lang.com/documentation/Sass/Script/Functions.html#str_slice-instance_method قسم الدالة str_slice في صفحة الدوال في توثيق Sass الرسمي].
-[[تصنيف:Sass]]
+[[تصنيف:Sass|{{SUBPAGENAME}}]]
-[[تصنيف: Sass Function]]
+[[تصنيف: Sass Function|{{SUBPAGENAME}}]]