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

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

تُعيد الدالة str_index()‎ مُؤشر أول ظهور للسلسة النصيةً ‎$substring داخل ‎$string. إن لم يكن هناك أي تواجد فستٌعيد القيمة المعدومة null.

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

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

str_index($string, $substring)

المعاملات

`‎$string`

سلسلة نصّية.

`‎$substring`

السلسلة النصّية المراد البحث عنها.

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

عدد صحيح يمثل مؤشر أول ظهور للسلسة النصيةً ‎$substring داخل ‎$string

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

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

انظر أيضًا

الدالة str_insert()‎: تُدرج سلسة نصية في أخرى.

الدالة str-length()‎: تُعيد عدد احرف سلسلةنصية.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()str_index</code> في Sass}}</noinclude>
-تُدرج الدالة <code>str_index'''()‎'''</code> '''سلسلةً نصيةً داخل أخرى.'''
+تُعيد الدالة <code>str_index'''()‎'''</code> مُؤشر أول ظهور للسلسة '''النصيةً''' <code>‎$substring</code> داخل <code>‎$string</code>. إن لم يكن هناك أي تواجد فستٌعيد القيمة المعدومة <code>null</code>.
-لاحظ أنه على عكس بعض اللغات، فإنّ رقم الحرف الأول هو <code>1</code>، والثاني رقمه <code>2</code>، وهكذا.
+لاحظ أنه على عكس بعض اللغات، فإنّ رقم الحرف الأول في [[Sass]] هو <code>1</code>، والثاني رقمه <code>2</code>، وهكذا.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-str_index($string, $insert, $index)
+str_index($string, $substring)
 </syntaxhighlight>
@@ سطر 13: / سطر 13: @@
 سلسلة نصّية.
-=== <code>‎$insert</code> ===
+=== <code>‎$substring</code> ===
-السلسلة النصّية المراد إدماجُها.
+السلسلة النصّية المراد البحث عنها.
-=== <code>‎$index</code> ===
-الموضع الذي ستُدرج فيه السلسلة <code>‎$insert</code>. تُحتسب المؤشرات السلبية من نهاية <code>‎‎$string</code>. إن كان المؤشر خارج حدود السلسلة النصية فستُدرج <code>‎$insert</code> في بداية السلسة أو نهايتها.
 == القيم المعادة ==
-السلسلة النصية الناتجة ستكون مُقتبسة إذا وفقط إذا كانت <code>‎‎$string</code> غير مُقتبسة.
+عدد صحيح يمثل مؤشر أول ظهور للسلسة '''النصيةً''' <code>‎$substring</code> داخل <code>‎$string</code>
 == الأخطاء والاستثناءات ==
 سيُرمى الخطأ <code>ArgumentError</code> إن كان أيّ من المعاملات من النوع الخطأ.
-== أمثلة ==
-مثال عن استخدام الدالة <code>str-insert()‎</code>  لضبط قيمة لون الخلفية ([[CSS/background-color|background-color]]):<syntaxhighlight lang="sass">
-selector {
-  background-color: ‎str-insert(ed, "r", 1) => red
-}
-</syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <nowiki/>[[CSS]] الآتية:<syntaxhighlight lang="css">
-selector {
-  background-color: red;
-}
-</syntaxhighlight>
 == انظر أيضًا ==
-* الدالة <code>[[Sass/str index|'''str_index'''()]]</code>‎: تُدرج سلسة نصية في أخرى.
+* الدالة <code>[[Sass/str insert|'''str_insert'''()]]</code>‎: تُدرج سلسة نصية في أخرى.
 * الدالة <code>[[Sass/str-length|str-length()]]</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_index-instance_method قسم الدالة  في صفحة الدوال في توثيق Sass الرسمي.]
 [[تصنيف:Sass]]
 [[تصنيف: Sass Function]]