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

مراجعة 13:39، 20 أبريل 2018

تستخرج الدالة 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()‎: تُدرج الدالة سلسلةً نصيةً داخل أخرى.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()str_slice</code> في Sass}}</noinclude>
-تُدرج الدالة <code>str_slice'''()‎'''</code> '''سلسلةً نصيةً داخل أخرى.'''
+تستخرج الدالة <code>str_slice'''()‎'''</code> '''سلسلةً نصيةً من <code>‎$string</code>'''، ستبدأ السلسلة المُستخرجة من المؤشر رقم <code>‎$start-at</code>وتنتهي عند <code>'''‎$end-at.'''</code>
-لاحظ أنه على عكس بعض اللغات، فإنّ رقم الحرف الأول هو <code>1</code>، والثاني رقمه <code>2</code>، وهكذا.
+لاحظ أنه على عكس بعض اللغات، فإنّ رقم الحرف الأول في لغة [[Sass]] هو <code>1</code>، والثاني رقمه <code>2</code>، وهكذا.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-str_slice($string, $insert, $index)
+str_slice($string, $start-at, $end-at: -1)
 </syntaxhighlight>
@@ سطر 13: / سطر 13: @@
 سلسلة نصّية.
-=== <code>‎$insert</code> ===
+=== <code>‎$start-at</code> ===
-السلسلة النصّية المراد إدماجُها.
+مؤشر الحرف الأول من السلسلة الفرعية. إذا كان هذا سلبيًا ، يتم حسابه من نهاية <code>‎‎$string.</code>
-=== <code>‎$index</code> ===
+=== <code>‎$end-at</code> ===
-الموضع الذي ستُدرج فيه السلسلة <code>‎$insert</code>. تُحتسب المؤشرات السلبية من نهاية <code>‎‎$string</code>. إن كان المؤشر خارج حدود السلسلة النصية فستُدرج <code>‎$insert</code> في بداية السلسة أو نهايتها.
+مؤشر الحرف الأخير من السلسلة الفرعية. إذا كان هذا سلبيًا ، يتم حسابه من نهاية <code>‎‎$string.</code> قيمته الافتراضية هي ‎.<code>-1</code>
 == القيم المعادة ==
@@ سطر 26: / سطر 26: @@
 == أمثلة ==
-مثال عن استخدام الدالة <code>str-insert()‎</code>  لضبط قيمة لون الخلفية ([[CSS/background-color|background-color]]):<syntaxhighlight lang="sass">
+مثال عن استخدام الدالة <code>str-slice()‎</code>  لضبط قيمة لون الخلفية ([[CSS/background-color|background-color]]):<syntaxhighlight lang="sass">
 selector {
-   background-color: ‎str-insert(ed, "r", 1) => red
+   background-color: str-slice("aredb", 2, 4) // red
 }
 </syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <nowiki/>[[CSS]] الآتية:<syntaxhighlight lang="css">
 selector {
    background-color: red;
 }
 </syntaxhighlight>
@@ سطر 40: / سطر 40: @@
 * الدالة <code>[[Sass/str-length|str-length()]]</code>‎: تُعيد عدد احرف سلسلةنصية.
+* الدالة <code>[[Sass/str insert|str_insert()]]</code>‎: تُدرج الدالة سلسلةً نصيةً داخل أخرى.
 == مصادر ==
-* [https://sass-lang.com/documentation/Sass/Script/Functions.html#str_insert-instance_method قسم الدالة  في صفحة الدوال في توثيق Sass الرسمي.]
+* [https://sass-lang.com/documentation/Sass/Script/Functions.html#str_slice-instance_method قسم الدالة  في صفحة الدوال في توثيق Sass الرسمي.]
 [[تصنيف:Sass]]
 [[تصنيف: Sass Function]]