الدالة ascii()‎ في بايثون

تعيد الدّالة ascii()‎ تمثيلًا (representation) نصيًّا لكائن مُعيّنٍ يُمكن طباعته كما الحال مع الدّالة repr()‎، لكن مع تهريب (escape) المحارف التي لا تُعدّ محارفَ ASCII في السلسلة النّصيّة المعادة باستعمال التّهريبات ‎\‎U‎ أو ‎\‎u‎‎ أو ‎\‎x. وتُعيد هذه الدّالة سلسلةً نصيّةً مُشابهةً لتلك التي كانت تُعيدها الدّالة repr()‎ في بايثون 2.

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

ascii(object)

المعاملات

object

الكائن المُراد الحصول على تمثيلٍ نصيّ له.

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

سلسلة نصيّة تمثّل الكائن. انظر المثال H]khi.

أمثلة

يوضّح المثال التّالي الفرق بين كلّ من الدّالة repr()‎ والدّالة ascii()‎، إذ نُعرِّف التّابع ‎‎_‎‎_‎‎repr‎‎_‎‎_‎ الخاصّ الذي تُمثّل القيمة التّي يُعيدها تمثيلَ الكائن من نوع الصّنفِ المُعرّفِ عليه. لاحظ أنّ المحارف « و » و¦ ليست محارف ASCII، لذا فقد هُرّبَت.

>>> class Example:
...     def __repr__(self):
...         return '«Class¦Example»'
...
>>> example_object = Example()
>>> repr(example_object)
'«Class¦Example»'
>>> ascii(example_object)
'\\xabClass\\xa6Example\\xbb'

انظر أيضًا

• تنسيق المخرجات في بايثون.
• تعريف الأصناف في بايثون.

مصادر

• قسم الدالة ascii في صفحة Functions في توثيق Python الرسمي.