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

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

تُعيد الدالة str_index()‎ موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة.

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

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

str_index($string, $substring)

المعاملات

`‎$string`

السلسلة النصّيَّة التي سيُبحث ضمنها.

`‎$substring`

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

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

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

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

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

أمثلة

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

str_index(abcd, a);  // 1
str_index(abcd, ab); // 1
str_index(abcd, X);  // null
str_index(abcd, c);  // 3

انظر أيضًا

الدالة str_insert()‎: تضيف سلسلةً نصيةً داخل أخرى عند موضع محدَّد.
الدالة str_length()‎: تعيد عدد أحرف سلسلة نصية محدَّدة.
الدالة str_slice()‎: تعيد جزءًا من السلسلة النصيَّة الممرَّرة إليها والذي يبدأ وينتهي عند موضع محدَّد.
الدالة to_lower_case()‎: تحوِّل جميع حروف السلسلة النصيَّة الممرَّرة إليها إلى حروف صغيرة.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()str_index</code> في Sass}}</noinclude>
-تُدرج الدالة <code>str_index'''()‎'''</code> '''سلسلةً نصيةً داخل أخرى.'''
+تُعيد الدالة <code>str_index()‎</code> موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة.
-لاحظ أنه على عكس بعض اللغات، فإنّ رقم الحرف الأول هو <code>1</code>، والثاني رقمه <code>2</code>، وهكذا.
+لاحظ أن رقم ترتيب العنصر الأول في <nowiki/>[[Sass]] هو 1، والعنصر الثاني هو 2، وهكذا على عكس بعض اللغات.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-str_index($string, $insert, $index)
+str_index($string, $substring)
 </syntaxhighlight>
 == المعاملات ==
-=== <code>‎$string </code> ===
+=== <code>‎$string</code> ===
-سلسلة نصّية.
+السلسلة النصّيَّة التي سيُبحث ضمنها.
-=== <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>. إن لم تكن تلك السلسلة موجودةً، فستُعاد القيمة العدميَّة (null).
 == الأخطاء والاستثناءات ==
@@ سطر 26: / سطر 23: @@
 == أمثلة ==
-مثال عن استخدام الدالة <code>str-insert()‎</code>  لضبط قيمة لون الخلفية ([[CSS/background-color|background-color]]):<syntaxhighlight lang="sass">
+أمثلة نموذجية عن الدالة <code>str_index()‎</code>:<syntaxhighlight lang="sass">
-selector {
+str_index(abcd, a);  // 1
-  background-color: ‎str-insert(ed, "r", 1) => red
+str_index(abcd, ab); // 1
-}
+str_index(abcd, X);  // null
-</syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <nowiki/>[[CSS]] الآتية:<syntaxhighlight lang="css">
+str_index(abcd, c);  // 3
-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>‎: تعيد عدد أحرف سلسلة نصية محدَّدة.
-* الدالة <code>[[Sass/str-length|str-length()]]</code>‎: تُعيد عدد احرف سلسلةنصية.
+* الدالة <code>[[Sass/str slice|str_slice()‎]]</code>: تعيد جزءًا من السلسلة النصيَّة الممرَّرة إليها والذي يبدأ وينتهي عند موضع محدَّد.
+* الدالة <code>[[Sass/to lower case|to_lower_case()‎]]</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 قسم الدالة str_index في صفحة الدوال في توثيق Sass الرسمي].
-[[تصنيف:Sass]]
+[[تصنيف:Sass|{{SUBPAGENAME}}]]
-[[تصنيف: Sass Function]]
+[[تصنيف: Sass Function|{{SUBPAGENAME}}]]