الدالة ()str_slice في Sass

تعيد الدالة 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 الرسمي.