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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث

تستخرج الدالة str_slice()‎ سلسلةً نصيةً من ‎$string، ستبدأ السلسلة المُستخرجة من المؤشر رقم ‎$start-atوتنتهي عند ‎$end-at.

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

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

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

المعاملات

‎$string 

سلسلة نصّية.

‎$start-at

مؤشر الحرف الأول من السلسلة الفرعية. إذا كان هذا سلبيًا ، يتم حسابه من نهاية ‎‎$string.

‎$end-at

مؤشر الحرف الأخير من السلسلة الفرعية. إذا كان هذا سلبيًا ، يتم حسابه من نهاية ‎‎$string. قيمته الافتراضية هي ‎.-1

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

السلسلة النصية الناتجة ستكون مُقتبسة إذا وفقط إذا كانت ‎‎$string غير مُقتبسة.

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

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

أمثلة

مثال عن استخدام الدالة str-slice()‎  لضبط قيمة لون الخلفية (background-color):

selector {
  background-color: str-slice("aredb", 2, 4) // red
}

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

selector {
  background-color: red; 
}

انظر أيضًا

  • الدالة str_index()‎: تُدرج سلسة نصية في أخرى.
  • الدالة str-length()‎: تُعيد عدد احرف سلسلةنصية.
  • الدالة str_insert()‎: تُدرج الدالة سلسلةً نصيةً داخل أخرى.

مصادر