الدالة str.encode() في بايثون
تعيد الدالة encode() نسخة مرمّزة من السلسلة النصية على هيئة بايتات.
البنية العامة
x.encode()
المعاملات
encoding
يحدّد هذا المعامل الترميز الذي ستستخدمه الدالة في عملها، ويأخذ القيمة الافتراضية 'utf-8'. وللاطلاع على قائمة بالترميزات المتاحة راجع قسم الترميزات القياسية.
errors
يحدّد المعامل error الطريقة المطلوبة للتعامل مع الأخطاء. يأخذ هذا المعامل القيمة الافتراضية 'strict' والتي تعني أنّه في حال حدوث أخطاء أثناء عملية الترميز فستطلق الدالة الخطأ UnicodeError.
يمكن أن يأخذ هذا المعامل قيمًا أخرى هي 'ignore'، 'replace'، 'xmlcharrefreplace'، 'backslashreplace' وأي اسم مسجّل بواسطة الدالة codecs.register_error() .
ملاحظة: أصبحت هذه الدالة تدعم المعاملات المفتاحية منذ الإصدار 3.1 من اللغة.
القيمة المعادة
تعيد الدالة encode() نسخة مرمّزة من السلسلة النصية على هيئة بايتات.
أمثلة
>>> name = "Hsoub Wiki"
>>> name.encode()
b'Hsoub Wiki'