عرض مصدر Python/bytes/zfill

<noinclude>{{DISPLAYTITLE:الدالة <code>str.zfill()‎</code> في بايثون}}</noinclude>
تضيف الدالة‎ العدد <code>‎b'0'‎</code> من الترميز ASCII إلى يسار التسلسل الثنائي ليصبح التسلسل بالطول المحدد من قبل المستخدم.

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

<syntaxhighlight lang="python3">
b.zfill()
</syntaxhighlight>

== المعاملات ==

=== <code>width</code> ===

يحدّد الطول المطلوب للتسلسل الثنائي بعد إضافة الأصفار. إذا كانت القيمة المحدّدة للمعامل <code>width</code> أقل من أو تساوي القيمة المعادة من <code>len(seq)‎</code>، فستعيد الدالة التسلسل الأصلي.

في حال تضمّن التسلسل الثنائي إحدى السابقتين (‎<code>b'+'</code> / <code>b'-'</code>‎) فإنّ الأصفار تضاف بعد السابقة وليس قبلها.

== القيمة المعادة ==
تعيد الدالة نسخة من السلسلة النصية بعد إضافة العدد ‎<code>‎b'0'‎</code> من الترميز ASCII إلى يسار التسلسل الثنائي.

== أمثلة ==
يوضّح المثال التالي النتائج المعادة من تطبيق الدالة على تسلسلات ثنائية متنوّعة:

<syntaxhighlight lang="python3">
>>> b"42".zfill(5)
b'00042'
>>> b"-42".zfill(5)
b'-0042'
</syntaxhighlight>

== انظر أيضًا ==
* [[Python/bytes|البايتات في بايثون.]]

== مصادر ==
* [https://docs.python.org/3/library/stdtypes.html#bytes.zfill قسم zfill في صفحة Types في توثيق بايثون الرسمي.]
[[تصنيف:Python]]
[[تصنيف:Python Function]]
[[تصنيف:Python Built-in Functions]]