التابع pprint.pprint()‎ في بايثون

تطبع الدالة التمثيل المنسّق للكائن المعطى في المخرجات المعطاة، متبوعًا بسطر جديد.

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

pprint.pprint(object, stream=None, indent=1, width=80, depth=None, *, compact=False)

المعاملات

إن أخذ المعامل stream القيمة None فستستخدم الدالة sys.stdout. يمكن استخدام هذه الدالة في مفسر بايثون التفاعلي عوضًا عن الدالة print()‎ لتفحّص القيم (يمكن كذلك إعادة إسناد print = pprint.pprint لاستخدامها ضمن نطاق معين).

تُمرّر المعاملات indent و width و depth و compact إلى الدالة البانية للصنف PrettyPrinter كمعاملات تنسيق.

ملاحظة: أضيف المعامل compact في الإصدار 3.4 من اللغة.

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

تعيد الدالة التمثيل المنسّق للكائن المعطى على هيئة سلسلة نصية.

أمثلة

يبين المثال التالي آلية عمل الدالة:

>>> import pprint
>>> stuff = ['spam', 'eggs', 'lumberjack', 'knights', 'ni']
>>> stuff.insert(0, stuff)
>>> pprint.pprint(stuff)
[<Recursion on list with id=...>,
 'spam',
 'eggs',
 'lumberjack',
 'knights',
 'ni']

انظر أيضًا

• التابع PrettyPrinter.pprint()‎: يطبع التابع التمثيل المنسّق للكائن المعطى على المخرجات المحدّدة في الدالة البانية للصنف PrettyPrinter متبوعًا بسطر جديد..

مصادر

صفحة Data pretty printer في توثيق بايثون الرسمي.