الفرق بين المراجعتين لصفحة: «Python/bytes/decode»
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>bytes.decode()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة <code>bytes.decode()</code> في بايثون}}</noinclude> | ||
يفك التابع ترميز البايتات الممرّرة إليه إلى [[Python/str|سلسلة نصية]]. | |||
== البنية العامة == | == البنية العامة == | ||
| سطر 10: | سطر 10: | ||
=== <code>encoding</code> === | === <code>encoding</code> === | ||
يحدّد هذا المعامل الترميز الذي | يحدّد هذا المعامل الترميز الذي سيستخدمه التابع في عمله، ويأخذ القيمة الافتراضية <code>'utf-8'</code>. وللاطلاع على قائمة بالترميزات المتاحة راجع [https://docs.python.org/3/library/codecs.html#standard-encodings قسم الترميزات القياسية]. | ||
'''ملاحظة:''' يسمح تمرير المعامل <code>encoding</code> إلى السلسلة النصية بفك ترميز أي كائن شبيه بالبايت bytes-like object على نحو مباشر، دون الحاجة إلى إنشاء [[Python/bytes|كائن بايتات]] أو كائن [[Python/bytearray|مصفوفة بايتات]] مؤقت. | '''ملاحظة:''' يسمح تمرير المعامل <code>encoding</code> إلى السلسلة النصية بفك ترميز أي كائن شبيه بالبايت bytes-like object على نحو مباشر، دون الحاجة إلى إنشاء [[Python/bytes|كائن بايتات]] أو كائن [[Python/bytearray|مصفوفة بايتات]] مؤقت. | ||
=== <code>errors</code> === | === <code>errors</code> === | ||
يحدّد المعامل <code>error</code> الطريقة المطلوبة للتعامل مع الأخطاء. يأخذ هذا المعامل القيمة الافتراضية <code>'strict'</code> والتي تعني أنّه في حال حدوث أخطاء أثناء عملية فك الترميز | يحدّد المعامل <code>error</code> الطريقة المطلوبة للتعامل مع الأخطاء. يأخذ هذا المعامل القيمة الافتراضية <code>'strict'</code> والتي تعني أنّه في حال حدوث أخطاء أثناء عملية فك الترميز فسيطلق التابع الخطأ <code>[[Python/built-in exceptions#UnicodeError|UnicodeError]]</code>. | ||
يمكن أن يأخذ هذا المعامل قيمًا أخرى هي <code>'ignore'</code> و <code>'replace'</code> و <code>'backslashreplace'</code>، وأي اسم مسجّل بواسطة الدالة <code>codecs.register_error()</code> . | يمكن أن يأخذ هذا المعامل قيمًا أخرى هي <code>'ignore'</code> و <code>'replace'</code> و <code>'backslashreplace'</code>، وأي اسم مسجّل بواسطة الدالة <code>codecs.register_error()</code> . | ||
'''ملاحظة:''' | '''ملاحظة:''' أصبح هذا التابع يدعم المعاملات المفتاحية منذ الإصدار 3.1 من اللغة. | ||
== أمثلة == | == أمثلة == | ||
يوضّح المثال التالي النتائج المعادة من تطبيق | يوضّح المثال التالي النتائج المعادة من تطبيق التابع باستخدام معاملات متنوعة:<syntaxhighlight lang="python3"> | ||
>>> b'\x80abc'.decode("utf-8", "strict") | >>> b'\x80abc'.decode("utf-8", "strict") | ||
Traceback (most recent call last): | Traceback (most recent call last): | ||
| سطر 40: | سطر 40: | ||
* [[Python/bytes|البايتات في بايثون.]] | * [[Python/bytes|البايتات في بايثون.]] | ||
* [[Python/bytearray|مصفوفات البايتات في بايثون.]] | * [[Python/bytearray|مصفوفات البايتات في بايثون.]] | ||
* الدالة <code>[[Python/bytes/fromhex|bytes.fromhex()]]</code>: فك ترميز سلسلة نصية تتضمن أعداد ست عشرية إلى كائن bytes. | |||
* الدالة <code>[[Python/bytes/hex|bytes.hex()]]</code>: ترميز كائن bytes إلى سلسلة نصية تتضمن عددين ستّ عشريين مقابل كلّ بايت. | |||
== مصادر == | == مصادر == | ||
مراجعة 07:37، 5 يونيو 2018
يفك التابع ترميز البايتات الممرّرة إليه إلى سلسلة نصية.
البنية العامة
b.decode()
المعاملات
encoding
يحدّد هذا المعامل الترميز الذي سيستخدمه التابع في عمله، ويأخذ القيمة الافتراضية 'utf-8'. وللاطلاع على قائمة بالترميزات المتاحة راجع قسم الترميزات القياسية.
ملاحظة: يسمح تمرير المعامل encoding إلى السلسلة النصية بفك ترميز أي كائن شبيه بالبايت bytes-like object على نحو مباشر، دون الحاجة إلى إنشاء كائن بايتات أو كائن مصفوفة بايتات مؤقت.
errors
يحدّد المعامل error الطريقة المطلوبة للتعامل مع الأخطاء. يأخذ هذا المعامل القيمة الافتراضية 'strict' والتي تعني أنّه في حال حدوث أخطاء أثناء عملية فك الترميز فسيطلق التابع الخطأ UnicodeError.
يمكن أن يأخذ هذا المعامل قيمًا أخرى هي 'ignore' و 'replace' و 'backslashreplace'، وأي اسم مسجّل بواسطة الدالة codecs.register_error() .
ملاحظة: أصبح هذا التابع يدعم المعاملات المفتاحية منذ الإصدار 3.1 من اللغة.
أمثلة
يوضّح المثال التالي النتائج المعادة من تطبيق التابع باستخدام معاملات متنوعة:
>>> b'\x80abc'.decode("utf-8", "strict")
Traceback (most recent call last):
...
UnicodeDecodeError: 'utf-8' codec can't decode byte 0x80 in position 0:
invalid start byte
>>> b'\x80abc'.decode("utf-8", "replace")
'\ufffdabc'
>>> b'\x80abc'.decode("utf-8", "backslashreplace")
'\\x80abc'
>>> b'\x80abc'.decode("utf-8", "ignore")
'abc'
انظر أيضًا
- السلاسل النصية في بايثون.
- البايتات في بايثون.
- مصفوفات البايتات في بايثون.
- الدالة
bytes.fromhex(): فك ترميز سلسلة نصية تتضمن أعداد ست عشرية إلى كائن bytes. - الدالة
bytes.hex(): ترميز كائن bytes إلى سلسلة نصية تتضمن عددين ستّ عشريين مقابل كلّ بايت.