الفرق بين المراجعتين لصفحة: «Python/bytes/index»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة <code>bytes.index()</code> في بايثون}}</noinclude> تؤدي هذه الدالة نفس وظيفة الدالة <code>...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>bytes.index()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة <code>bytes.index()</code> في بايثون}}</noinclude> | ||
يؤدي هذا التابع نفس وظيفة التابع <code>[[Python/bytes/find|bytes.find()]]</code> ولكنّه يطلق الخطأ <code>[[Python/built-in exceptions#ValueError|ValueError]]</code> إن لم يعثر على التسلسل الفرعي. | |||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
bytes.index(sub[, start[, end]]) | |||
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 10: | سطر 11: | ||
===<code>sub</code>=== | ===<code>sub</code>=== | ||
التسلسل الفرعي المراد معرفة موقعه، ويمكن أن يكون أيّ كائن شبيه بالبايتات bytes-like objects أو عددًا صحيحًا من <code>0</code> إلى <code>255</code>. | التسلسل الفرعي المراد معرفة موقعه، ويمكن أن يكون أيّ كائن شبيه بالبايتات (bytes-like objects) أو عددًا صحيحًا من <code>0</code> إلى <code>255</code>. | ||
===<code>start</code>=== | ===<code>start</code>=== | ||
الموقع الذي | الموقع الذي يبدأ منه التابع عملية البحث ضمن البيانات الثنائية. | ||
===<code>end</code>=== | ===<code>end</code>=== | ||
الموقع الذي | الموقع الذي ينهي فيه التابع عملية البحث ضمن البيانات الثنائية. | ||
يسلك هذان المعاملان نفس السلوك المتّبع في عملية [[Python/str#.D8.A7.D9.82.D8.AA.D8.B7.D8.A7.D8.B9 .D8.A7.D9.84.D8.B3.D9.84.D8.B3.D9.84.D8.A9 .D8.A7.D9.84.D9.86.D8.B5.D9.8A.D8.A9|اقتطاع السلاسل النصية slicing]]. | يسلك هذان المعاملان نفس السلوك المتّبع في عملية [[Python/str#.D8.A7.D9.82.D8.AA.D8.B7.D8.A7.D8.B9 .D8.A7.D9.84.D8.B3.D9.84.D8.B3.D9.84.D8.A9 .D8.A7.D9.84.D9.86.D8.B5.D9.8A.D8.A9|اقتطاع السلاسل النصية slicing]]. | ||
== القيمة المعادة == | == القيمة المعادة == | ||
يعيد التابع أدنى قيمة للفهرس في البيانات الثنائية حيث يكون التسلسل الفرعي <code>sub</code> موجودًا في الجزء المقتطع من التسلسل <code>s[start:end]</code>، ويطلق الخطأ <code>[[Python/built-in exceptions#ValueError|ValueError]]</code> إن لم تعثر على التسلسل الفرعي. | |||
== أمثلة == | == أمثلة == | ||
| سطر 32: | سطر 33: | ||
ValueError: subsection not found | ValueError: subsection not found | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | |||
== انظر أيضًا == | *[[Python/bytes|البايتات في بايثون.]] | ||
* [[Python/bytes/find| | *التابع <code>[[Python/bytes/find|bytes.find()]]</code>: إعادة أدنى قيمة للفهرس والذي يكون التسلسل الفرعي موجودًا في ضمن البيانات الثنائية. | ||
*التابع <code>[[Python/bytes/rfind|bytes.rfind()]]</code>: إعادة أعلى قيمة للفهرس في التسلسل الأصلي حيث تجد فيه التسلسل الفرعي. | |||
*التابع <code>[[Python/bytes/rindex|bytes.rindex()]]</code>: يشبه التابع <code>[[Python/bytes/rfind|bytes.rfind()]]</code> في أنّه يحدّد أعلى قيمة للفهرس تجد فيه التسلسل الفرعي ضمن التسلسل الأصلي، ويختلف عنه في أنّه يطلق الخطأ <code>ValueError</code> إن لم يعثر على التسلسل الفرعي. | |||
== مصادر == | == مصادر == | ||
* [https://docs.python.org/3/library/stdtypes.html#bytes.index قسم index في صفحة Types في توثيق بايثون الرسمي.] | * [https://docs.python.org/3/library/stdtypes.html#bytes.index قسم index في صفحة Types في توثيق بايثون الرسمي.] | ||
مراجعة 08:04، 5 يونيو 2018
يؤدي هذا التابع نفس وظيفة التابع bytes.find() ولكنّه يطلق الخطأ ValueError إن لم يعثر على التسلسل الفرعي.
البنية العامة
bytes.index(sub[, start[, end]])
المعاملات
sub
التسلسل الفرعي المراد معرفة موقعه، ويمكن أن يكون أيّ كائن شبيه بالبايتات (bytes-like objects) أو عددًا صحيحًا من 0 إلى 255.
start
الموقع الذي يبدأ منه التابع عملية البحث ضمن البيانات الثنائية.
end
الموقع الذي ينهي فيه التابع عملية البحث ضمن البيانات الثنائية.
يسلك هذان المعاملان نفس السلوك المتّبع في عملية اقتطاع السلاسل النصية slicing.
القيمة المعادة
يعيد التابع أدنى قيمة للفهرس في البيانات الثنائية حيث يكون التسلسل الفرعي sub موجودًا في الجزء المقتطع من التسلسل s[start:end]، ويطلق الخطأ ValueError إن لم تعثر على التسلسل الفرعي.
أمثلة
>>> mycar = b'I have a blue car'
>>> mycar.index(b'blue')
9
>>> mycar.index(b'red')
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
ValueError: subsection not found
انظر أيضًا
- البايتات في بايثون.
- التابع
bytes.find(): إعادة أدنى قيمة للفهرس والذي يكون التسلسل الفرعي موجودًا في ضمن البيانات الثنائية. - التابع
bytes.rfind(): إعادة أعلى قيمة للفهرس في التسلسل الأصلي حيث تجد فيه التسلسل الفرعي. - التابع
bytes.rindex(): يشبه التابعbytes.rfind()في أنّه يحدّد أعلى قيمة للفهرس تجد فيه التسلسل الفرعي ضمن التسلسل الأصلي، ويختلف عنه في أنّه يطلق الخطأValueErrorإن لم يعثر على التسلسل الفرعي.