التابع bytes.count()‎ في بايثون

من موسوعة حسوب
< Python‏ | bytes

يعيد هذا التابع عدد مرات ظهور تسلسل فرعي ضمن كائن bytes.

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

bytes.count(sub[, start[, end]])

المعاملات

sub

التسلسل الفرعي المراد معرفة عدد مرات ظهوره ضمن كائن bytes. يمكن للتسلسل الفرعي أن يكون أيّ كائن شبيه بالبايتات (bytes-like object).

ملاحظة: في الإصدار 3.3 من بايثون، أصبح بالإمكان استخدام الأعداد الصحيحة من 0 إلى 255 كقيمة لهذا المعامل.

start

معامل اختياري، يحدد الموقع الذي يبدأ منه التابع عملية البحث ضمن كائن bytes.

end

معامل اختياري، يحدد الموقع الذي ينهي فيه التابع عملية البحث ضمن كائن bytes.

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

يعيد هذا التابع عدد مرات ظهور التسلسل الفرعي sub فرعية ضمن النطاق المحدّد بواسطة المعاملين start و end. يسلك هذان المعاملان نفس السلوك المتّبع في عملية اقتطاع السلاسل النصية slicing.

أمثلة

يبين المثال التالي النتائج المعادة من استخدام التابع count()‎:

>>> bytes = b'\xf0\xf1\xf2'
>>> bytes = b'\xf0\xf1\xf2\xf0\xf2'
>>> bytes.count(b'\xf0')
2
>>> bytes.count(b'\xf1')
1

انظر ايضًا

  • البايتات في بايثون.
  • التابع bytes.find()‎: يعيد التابع أدنى قيمة للفهرس والذي يكون التسلسل الفرعي موجودًا في ضمن البيانات الثنائية.
  • التابع bytes.index()‎: يؤدي هذا التابع نفس وظيفة التابع bytes.find()‎ ولكنّه يطلق الخطأ ValueError إن لم يعثر على التسلسل الفرعي.
  • التابع bytes.rfind()‎: يعيد التابع أعلى قيمة للفهرس في التسلسل الأصلي حيث تجد فيه التسلسل الفرعي.
  • التابع bytes.rindex()‎: يشبه التابع bytes.rfind()‎ في أنّه يحدّد أعلى قيمة للفهرس تجد فيه التسلسل الفرعي ضمن التسلسل الأصلي، ويختلف عنه في أنّه يطلق الخطأ ValueError إن لم يعثر على التسلسل الفرعي.

مصادر