الفرق بين المراجعتين ل"Sass/str index"
< Sass
اذهب إلى التنقل
اذهب إلى البحث
ط (استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].') |
|||
| (4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()str_index</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()str_index</code> في Sass}}</noinclude> | ||
| − | تُعيد الدالة <code>str_index()</code> | + | تُعيد الدالة <code>str_index()</code> موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة. |
| − | لاحظ | + | لاحظ أن رقم ترتيب العنصر الأول في <nowiki/>[[Sass]] هو 1، والعنصر الثاني هو 2، وهكذا على عكس بعض اللغات. |
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
| سطر 11: | سطر 11: | ||
=== <code>$string</code> === | === <code>$string</code> === | ||
| − | + | السلسلة النصّيَّة التي سيُبحث ضمنها. | |
=== <code>$substring</code> === | === <code>$substring</code> === | ||
| − | السلسلة | + | السلسلة النصّيَّة المراد البحث عنها. |
== القيم المعادة == | == القيم المعادة == | ||
| − | عدد صحيح يمثل | + | يٌعاد عدد صحيح يمثل فهرس أول ظهور للسلسة النصيَّة <code>$substring</code> داخل السلسلة <code>$string</code>. إن لم تكن تلك السلسلة موجودةً، فستُعاد القيمة العدميَّة (null). |
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
سيُرمى الخطأ <code>ArgumentError</code> إن كان أيّ من المعاملات من النوع الخطأ. | سيُرمى الخطأ <code>ArgumentError</code> إن كان أيّ من المعاملات من النوع الخطأ. | ||
| + | |||
| + | == أمثلة == | ||
| + | أمثلة نموذجية عن الدالة <code>str_index()</code>:<syntaxhighlight lang="sass"> | ||
| + | str_index(abcd, a); // 1 | ||
| + | str_index(abcd, ab); // 1 | ||
| + | str_index(abcd, X); // null | ||
| + | str_index(abcd, c); // 3 | ||
| + | |||
| + | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * الدالة <code>[[Sass/str insert|str_insert()]]</code>: | + | * الدالة <code>[[Sass/str insert|str_insert()]]</code>: تضيف سلسلةً نصيةً داخل أخرى عند موضع محدَّد. |
| − | + | * الدالة <code>[[Sass/str length|str_length()]]</code>: تعيد عدد أحرف سلسلة نصية محدَّدة. | |
| − | * الدالة <code>[[Sass/str | + | * الدالة <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_index-instance_method قسم الدالة str_index في صفحة الدوال في توثيق 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}}]] |
المراجعة الحالية بتاريخ 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(): تحوِّل جميع حروف السلسلة النصيَّة الممرَّرة إليها إلى حروف صغيرة.