الفرق بين المراجعتين لصفحة: «Python/bytes/translate»

من موسوعة حسوب
< Python‏ | bytes
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة <code>bytes.translate()‎</code> في بايثون}}</noinclude> تعيد الدالة تسلسل البيانات الثنائ...'
 
ط استبدال النص - ':الدالة' ب':التابع'
 
(4 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الدالة <code>bytes.translate()‎</code> في بايثون}}</noinclude>
<noinclude>{{DISPLAYTITLE:التابع <code>bytes.translate()‎</code> في بايثون}}</noinclude>
 
يعيد التابع تسلسل البيانات الثنائية بعد إجراء عمليات الربط والحذف بالاعتماد على جدول التحويل.
تعيد الدالة تسلسل البيانات الثنائية بعد إجراء عمليات الربط والحذف بالاعتماد على جدول الترجمة.


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


<syntaxhighlight lang="python3">
<syntaxhighlight lang="python3">
x.translate()
bytes.translate(table, delete=b'')</syntaxhighlight>
</syntaxhighlight>


== المعاملات ==
== المعاملات ==
سطر 13: سطر 11:
=== <code>table</code> ===
=== <code>table</code> ===


جدول ترجمة يمكن إنشاؤه باستخدام الدالة [[Python/bytes/maketrans|<code>bytes.maketrans()‎</code>]]، ويجب أن يكون كائن بايتات بطول <code>256</code>.
جدول تحويل يمكن إنشاؤه باستخدام التابع [[Python/bytes/maketrans|<code>bytes.maketrans()‎</code>]]، ويجب أن يكون كائن بايتات بطول <code>256</code>.


يمكن أن يأخذ هذا المعامل القيمة <code>None</code> وحينئذ سيتقصر عمل الدالة على حذف القيم المحددة في المعامل <code>delete</code>.
يمكن أن يأخذ هذا المعامل القيمة <code>None</code> وحينئذ سيتقصر عمل التابع على حذف القيم المحددة في المعامل <code>delete</code>.


=== delete ===
=== <code>delete</code> ===
معامل اختياري يحدد البيانات التي ستحذفها الدالة من التسلسل الأصلي.
معامل اختياري يحدد البيانات التي سيحذفها التابع من التسلسل الأصلي.


'''ملاحظة:''': في الإصدار 3.6 من بايثون أصبح هذا المعامل معاملًا مفتاحيًا.
'''ملاحظة:''' في الإصدار 3.6 من بايثون أصبح هذا المعامل معاملًا مفتاحيًا.


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


تعيد الدالة نسخة من البيانات الثنائية بعد استبدال الحروف بالاعتماد على جدول الترجمة.  
يعيد التابع نسخة من البيانات الثنائية بعد استبدال الحروف بالاعتماد على جدول التحويل.  


== أمثلة ==
== أمثلة ==
يوضّح المثال التالي طريقة استخدام الدالتين <code>bytes.maketrans()‎</code> و <code>bytes.translate()‎</code>
يوضّح المثال التالي طريقة استخدام التابعين <code>[[Python/bytes/maketrans|bytes.maketrans()]]‎</code> و <code>bytes.translate()‎</code>:


<syntaxhighlight lang="python3">
<syntaxhighlight lang="python3">
سطر 53: سطر 51:


== انظر أيضًا ==
== انظر أيضًا ==
* [[Python/bytes/maketrans|الدالة maketrans()‎ في بايثون.]]
* [[Python/bytes|السلاسل النصية في بايثون.]]
* [[Python/bytes|السلاسل النصية في بايثون.]]


*التابع <code>[[Python/bytes/maketrans|bytes.maketrans()‎]]</code>: يعيد هذا التابع الساكن جدول تحويل (translation table) يمكن استخدامه بواسطة التابع <code>bytes.translate()‎</code>.
== مصادر ==
== مصادر ==
* [https://docs.python.org/3/library/stdtypes.html#bytes.translate قسم translate في صفحة Types في توثيق بايثون الرسمي.]
* [https://docs.python.org/3/library/stdtypes.html#bytes.translate قسم translate في صفحة Types في توثيق بايثون الرسمي.]
[[تصنيف:Python]]
[[تصنيف:Python]]
[[تصنيف:Python Function]]
[[تصنيف:Python Method]]
[[تصنيف:Python Built-in Functions]]
[[تصنيف:Python Types]]
[[تصنيف:Python Bytes]]

المراجعة الحالية بتاريخ 11:58، 10 يونيو 2018

يعيد التابع تسلسل البيانات الثنائية بعد إجراء عمليات الربط والحذف بالاعتماد على جدول التحويل.

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

bytes.translate(table, delete=b'')

المعاملات

table

جدول تحويل يمكن إنشاؤه باستخدام التابع bytes.maketrans()‎، ويجب أن يكون كائن بايتات بطول 256.

يمكن أن يأخذ هذا المعامل القيمة None وحينئذ سيتقصر عمل التابع على حذف القيم المحددة في المعامل delete.

delete

معامل اختياري يحدد البيانات التي سيحذفها التابع من التسلسل الأصلي.

ملاحظة: في الإصدار 3.6 من بايثون أصبح هذا المعامل معاملًا مفتاحيًا.

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

يعيد التابع نسخة من البيانات الثنائية بعد استبدال الحروف بالاعتماد على جدول التحويل.

أمثلة

يوضّح المثال التالي طريقة استخدام التابعين bytes.maketrans() و bytes.translate()‎:

>>> 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'
byte = b'read this short text'
byte.translate(None, b'aeiou')
b'rd ths shrt txt'

انظر أيضًا

  • التابع bytes.maketrans()‎: يعيد هذا التابع الساكن جدول تحويل (translation table) يمكن استخدامه بواسطة التابع bytes.translate()‎.

مصادر