الفرق بين المراجعتين لصفحة: «Python/pprint»

من موسوعة حسوب
لا ملخص تعديل
لا ملخص تعديل
 
(1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 5: سطر 5:
تظهر هذه الحالة عند تضمين كائنات مثل الملفات أو المنافذ sockets أو [[Python/class|الأصناف]]، إلى جانب العديد من الكائنات الأخرى والتي تكون غير قابلة للتمثيل على هيئة حروف في بايثون.
تظهر هذه الحالة عند تضمين كائنات مثل الملفات أو المنافذ sockets أو [[Python/class|الأصناف]]، إلى جانب العديد من الكائنات الأخرى والتي تكون غير قابلة للتمثيل على هيئة حروف في بايثون.


يُبقي التمثيل المنسّق الكائنات في سطر واحد إن كان ذلك ممكنًا، ويقسّمها إلى أسطر متعددة إن لم تلائم العرض المسموح به، ويمكن تعديل هذا المقدار عن طريق إنشاء كائنات <code>PrettyPrinter</code>.
يُبقي التمثيل المنسّق الكائنات في سطر واحد إن كان ذلك ممكنًا، ويقسّمها إلى أسطر متعددة إن لم تلائم العرض المسموح به، ويمكن تعديل هذا المقدار عن طريق إنشاء كائنات <code>[[Python/PrettyPrinter|PrettyPrinter]]</code>.


من الجدير بالذكر أنّ [[Python/dict|القواميس]] تُرتَّب حسب المفاتيح قبل إجراء عملية التنسيق.
من الجدير بالذكر أنّ [[Python/dict|القواميس]] تُرتَّب حسب المفاتيح قبل إجراء عملية التنسيق.
سطر 28: سطر 28:
تعيد الدالة تمثيلًا على هيئة سلسلة نصية للكائن المعطى، ومحميًا تجاه بنى البيانات التعاودية.  
تعيد الدالة تمثيلًا على هيئة سلسلة نصية للكائن المعطى، ومحميًا تجاه بنى البيانات التعاودية.  


== كائنات PrettyPrinter ==
== [[Python/pprint/PrettyPrinter|الصنف <code>PrettyPrinter</code>]] ==


تعرّف وحدة <code>pprint</code> صنفًا واحدًا فقط هو الصنف <code>PrettyPrinter</code>، وتقدّم نسخ هذا الصنف عددًا من التوابع التي يمكن الاستفادة منها في طباعة المخرجات بصورة منسّقة وجميلة.
تعرّف وحدة <code>pprint</code> صنفًا واحدًا فقط هو الصنف [[Python/PrettyPrinter|<code>PrettyPrinter</code>]]، وتقدّم نسخ هذا الصنف عددًا من التوابع التي يمكن الاستفادة منها في طباعة المخرجات بصورة منسّقة وجميلة.


=== التابع <code>[[Python/PrettyPrinter/pformat|PrettyPrinter.pformat()‎]]</code> ===
== انظر أيضًا ==
يعيد التابع التمثيل المنسّق للكائن المعطى.
* [[Python/print|الدالة <code>print()‎</code>]] : تطبع الدّالة الكائنات المُعطاة.
 
=== التابع <code>[[Python/PrettyPrinter/pprint|PrettyPrinter.pprint()‎]]</code> ===
يطبع التابع التمثيل المنسّق للكائن المعطى على المخرجات المحدّدة في الدالة البانية للصنف <code>PrettyPrinter</code> متبوعًا بسطر جديد.
 
=== التابع <code>[[Python/PrettyPrinter/isreadable|PrettyPrinter.isreadable()‎]]</code> ===
يحدّد التابع ما إذا كان التمثيل المنسّق للكائن المعطى "قابلًا للقراءة" أو يمكن استخدامه لإعادة بناء القيمة باستخدام الدالة <code>[[Python/eval|eval()‎]]</code>.
 
=== التابع <code>[[Python/PrettyPrinter/isrecursive|PrettyPrinter.isrecursive()‎]]</code> ===
يحدّد التابع ما إذا كان الكائن المعطى يتطلب تمثيلًا تعاوديًا.
 
=== التابع <code>[[Python/PrettyPrinter/format|PrettyPrinter.format()‎]]</code> ===
يعيد التابع نسخة للكائن المعطى تكون على هيئة [[Python/str|سلسلة نصية]]، وراية تحدد ما إذا كانت النتيجة قابلة للقراءة وراية أخرى تحدّد ما إذا تمكن التابع من اكتشاف حالة تعاود في النتيجة.


== مصادر ==
== مصادر ==

المراجعة الحالية بتاريخ 09:05، 20 أغسطس 2018


تتيح وحدة pprint إمكانية طباعة بنى البيانات في بايثون بصورة جميلة pretty-print بطريقة تسمح باستخدام هذه البيانات كمدخلات في مفسّر بايثون. وإن تضمنت البنى المنسّقة كائنات ليست من أنواع بايثون الأساسية، فمن الممكن أن يكون تمثيل ذلك الكائن غير قابل للتحميل.

تظهر هذه الحالة عند تضمين كائنات مثل الملفات أو المنافذ sockets أو الأصناف، إلى جانب العديد من الكائنات الأخرى والتي تكون غير قابلة للتمثيل على هيئة حروف في بايثون.

يُبقي التمثيل المنسّق الكائنات في سطر واحد إن كان ذلك ممكنًا، ويقسّمها إلى أسطر متعددة إن لم تلائم العرض المسموح به، ويمكن تعديل هذا المقدار عن طريق إنشاء كائنات PrettyPrinter.

من الجدير بالذكر أنّ القواميس تُرتَّب حسب المفاتيح قبل إجراء عملية التنسيق.

دوال الوحدة pprint

تقدّم وحدة pprint الدوال التالية:

الدالة pprint.pformat()

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

الدالة pprint.pprint()‎

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

الدالة pprint.isreadable()‎

تحدّد الدالة ما إذا كان التمثيل المنسّق للكائن المعطى "قابلًا للقراءة" أو يمكن استخدامه لإعادة بناء القيمة باستخدام الدالة eval()‎.

الدالة pprint.isrecursive()‎

تحدّد الدالة ما إذا كان الكائن المعطى يتطلب تمثيلًا تعاوديًا.

الدالة pprint.saferepr()‎

تعيد الدالة تمثيلًا على هيئة سلسلة نصية للكائن المعطى، ومحميًا تجاه بنى البيانات التعاودية.

الصنف PrettyPrinter

تعرّف وحدة pprint صنفًا واحدًا فقط هو الصنف PrettyPrinter، وتقدّم نسخ هذا الصنف عددًا من التوابع التي يمكن الاستفادة منها في طباعة المخرجات بصورة منسّقة وجميلة.

انظر أيضًا

مصادر