الفرق بين المراجعتين ل"Python/bytes/decode"
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة <code>bytes.decode()</code> في بايثون}}</noinclude> ترمّز الدالة البايتات إلى سلسلة نصية...') |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>bytes.decode()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة <code>bytes.decode()</code> في بايثون}}</noinclude> | ||
| − | ترمّز الدالة البايتات إلى سلسلة نصية. | + | ترمّز الدالة البايتات إلى [[Python/str|سلسلة نصية]]. |
== البنية العامة == | == البنية العامة == | ||
| سطر 11: | سطر 11: | ||
=== <code>encoding</code> === | === <code>encoding</code> === | ||
يحدّد هذا المعامل الترميز الذي ستستخدمه الدالة في عملها، ويأخذ القيمة الافتراضية <code>'utf-8'</code>. وللاطلاع على قائمة بالترميزات المتاحة راجع [https://docs.python.org/3/library/codecs.html#standard-encodings قسم الترميزات القياسية]. | يحدّد هذا المعامل الترميز الذي ستستخدمه الدالة في عملها، ويأخذ القيمة الافتراضية <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>errors</code> === | === <code>errors</code> === | ||
| − | يحدّد المعامل <code>error</code> الطريقة المطلوبة للتعامل مع الأخطاء. يأخذ هذا المعامل القيمة الافتراضية <code>'strict'</code> والتي تعني أنّه في حال حدوث أخطاء أثناء عملية الترميز فستطلق الدالة الخطأ <code>UnicodeError</code>. | + | يحدّد المعامل <code>error</code> الطريقة المطلوبة للتعامل مع الأخطاء. يأخذ هذا المعامل القيمة الافتراضية <code>'strict'</code> والتي تعني أنّه في حال حدوث أخطاء أثناء عملية فك الترميز فستطلق الدالة الخطأ <code>UnicodeError</code>. |
| − | يمكن أن يأخذ هذا المعامل قيمًا أخرى هي <code>'ignore'</code>، <code>'replace | + | يمكن أن يأخذ هذا المعامل قيمًا أخرى هي <code>''ignore'</code>، <code>'replace</code>، وأي اسم مسجّل بواسطة الدالة <code>codecs.register_error()</code> . |
'''ملاحظة:''' أصبحت هذه الدالة تدعم المعاملات المفتاحية منذ الإصدار 3.1 من اللغة. | '''ملاحظة:''' أصبحت هذه الدالة تدعم المعاملات المفتاحية منذ الإصدار 3.1 من اللغة. | ||
| سطر 21: | سطر 23: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* [[Python/str|السلاسل النصية في بايثون.]] | * [[Python/str|السلاسل النصية في بايثون.]] | ||
| + | * [[Python/bytes|البايتات في بايثون.]] | ||
| + | * [[Python/bytearray|مصفوفات البايتات في بايثون.]] | ||
== مصادر == | == مصادر == | ||
مراجعة 18:45، 12 مايو 2018
ترمّز الدالة البايتات إلى سلسلة نصية.
البنية العامة
b.decode()
المعاملات
encoding
يحدّد هذا المعامل الترميز الذي ستستخدمه الدالة في عملها، ويأخذ القيمة الافتراضية 'utf-8'. وللاطلاع على قائمة بالترميزات المتاحة راجع قسم الترميزات القياسية.
ملاحظة: يسمح تمرير المعامل encoding إلى السلسلة النصية بفك ترميز أي كائن شبيه بالبايت bytes-like object على نحو مباشر، دون الحاجة إلى إنشاء كائن بايتات أو كائن مصفوفة بايتات مؤقت.
errors
يحدّد المعامل error الطريقة المطلوبة للتعامل مع الأخطاء. يأخذ هذا المعامل القيمة الافتراضية 'strict' والتي تعني أنّه في حال حدوث أخطاء أثناء عملية فك الترميز فستطلق الدالة الخطأ UnicodeError.
يمكن أن يأخذ هذا المعامل قيمًا أخرى هي ''ignore'، 'replace، وأي اسم مسجّل بواسطة الدالة codecs.register_error() .
ملاحظة: أصبحت هذه الدالة تدعم المعاملات المفتاحية منذ الإصدار 3.1 من اللغة.