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

<noinclude>{{DISPLAYTITLE:الدالة <code>bytes.maketrans()‎</code> في بايثون}}</noinclude>
تعيد هذه الدالة الساكنة جدول ترجمة (translation table) يمكن استخدامه بواسطة الدالة <code>[[Python/bytes/translate|bytes.translate()‎]]</code>. 

== البنية العامة ==
<syntaxhighlight lang="python3">
b.maketrans()
</syntaxhighlight>

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

=== <code>from</code> ===
كائن شبيه بالبايتات (bytes-like object) يتضمّن الحروف التي ستربطها الدالة بحروف المعامل <code>to</code>.

=== <code>to</code> ===
كائن شبيه بالبايتات يتضمن الحروف التي ستربط بها الدالة حروف المعامل <code>from</code>.

'''ملاحظة''': يجب أن يمتلك المعاملان الطول نفسه، ويجب أن يكون المعاملان كائنين شبيهين بالبايتات.

'''ملاحظة''': هذه الدالة موجودة في الإصدار 3.1 وما بعده من بايثون.

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

تعيد الدالة جدول ترجمة يمكن استخدامه بواسطة الدالة <code>[[Python/bytes/translate|bytes.translate()‎]]</code> والذي سيربط كل حرف في المعامل <code>from</code> بالحرف الذي يمتلك الموقع ذاته في المعامل <code>to</code>. 

== أمثلة ==
يبين المثال التالي النتائج المعادة من تطبيق الدالة:
<syntaxhighlight lang="python3">
>>> bytes1 = b'abc'
>>> bytes2 = b'xyz'
>>> byte = b'abcxyz'
>>> trans = bytes.maketrans(bytes1, bytes2)
>>> print(trans)
b'\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\x0c\r\x0e\x0f\x10\x11\x12\x13\x14
\x15\x16\x17\x18\x19\x1a\x1b\x1c\x1d\x1e\x1f !"#$%&\'()*+,-./0123456789:;<=>?@AB
CDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`xyzdefghijklmnopqrstuvwxyz{|}~\x7f\x80\x81\x82\x8
3\x84\x85\x86\x87\x88\x89\x8a\x8b\x8c\x8d\x8e\x8f\x90\x91\x92\x93\x94\x95\x96\x9
7\x98\x99\x9a\x9b\x9c\x9d\x9e\x9f\xa0\xa1\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xa
b\xac\xad\xae\xaf\xb0\xb1\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xbb\xbc\xbd\xbe\xb
f\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xcb\xcc\xcd\xce\xcf\xd0\xd1\xd2\xd
3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xdb\xdc\xdd\xde\xdf\xe0\xe1\xe2\xe3\xe4\xe5\xe6\xe
7\xe8\xe9\xea\xeb\xec\xed\xee\xef\xf0\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xf
b\xfc\xfd\xfe\xff'
>>> byte.translate(trans)
b'xyzxyz'
</syntaxhighlight>

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

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