الفرق بين المراجعتين ل"Sass/str index"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (مراجعة الصفحة وتدقيقها.)
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>()str_index</code> في Sass}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: الدالة <code>()str_index</code> في Sass}}</noinclude>
تُعيد الدالة <code>str_index()‎</code> مُؤشر أول ظهور للسلسة النصية <code>‎$substring</code> داخل <code>‎$string</code>. إن لم تكن موجودةً فستٌعيد القيمة المعدومة <code>null</code>.
+
تُعيد الدالة <code>str_index()‎</code> موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة.
  
لاحظ أنه على عكس بعض اللغات، فإنّ رقم الحرف الأول في [[Sass]] هو <code>1</code>، والثاني رقمه <code>2</code>، وهكذا.
+
لاحظ أن رقم ترتيب العنصر الأول في <nowiki/>[[Sass]] هو 1، والعنصر الثاني هو وهكذا على عكس بعض اللغات.
 
== البنية العامة ==
 
== البنية العامة ==
 
<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>.
+
يٌعاد عدد صحيح يمثل فهرس أول ظهور للسلسة النصيَّة <code>‎$substring</code> داخل السلسلة <code>‎$string</code>. إن لم تكن تلك السلسلة موجودةً، فستُعاد القيمة العدميَّة (null).
  
 
== الأخطاء والاستثناءات ==
 
== الأخطاء والاستثناءات ==
سطر 23: سطر 23:
  
 
== انظر أيضًا ==
 
== انظر أيضًا ==
* الدالة <code>[[Sass/str insert|str_insert()]]</code>‎: تُدرج سلسة نصية في أخرى.
+
* الدالة <code>[[Sass/str insert|str_insert()]]</code>‎: سلسلةً نصيةً داخل أخرى عند موضع محدَّد.
 
+
* الدالة <code>[[Sass/str-length|str-length()]]</code>‎: تعيد عدد أحرف سلسلة نصية محدَّدة.
* الدالة <code>[[Sass/str-length|str-length()]]</code>‎: تُعيد عدد احرف سلسلة نصية.
 
  
 
== مصادر ==
 
== مصادر ==

مراجعة 16:37، 12 مايو 2018

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

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

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

str_index($string, $substring)

المعاملات

‎$string

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

‎$substring

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

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

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

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

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

انظر أيضًا

  • الدالة str_insert()‎: سلسلةً نصيةً داخل أخرى عند موضع محدَّد.
  • الدالة str-length()‎: تعيد عدد أحرف سلسلة نصية محدَّدة.

مصادر