الفرق بين المراجعتين لصفحة: «Python/pprint»
ط نقل Mohammed Taher صفحة pprint إلى Python/pprint |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الوحدة <code>pprint</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:الوحدة <code>pprint</code> في بايثون}}</noinclude> | ||
تتيح وحدة pprint إمكانية طباعة بنى البيانات في بايثون بصورة جميلة pretty-print بطريقة تسمح باستخدام هذه البيانات | تتيح وحدة <code>pprint</code> إمكانية طباعة بنى البيانات في بايثون بصورة جميلة pretty-print بطريقة تسمح باستخدام هذه البيانات كمدخلات في مفسّر بايثون. وإن تضمنت البنى المنسّقة كائنات ليست من أنواع بايثون الأساسية، فمن الممكن أن يكون تمثيل ذلك الكائن غير قابل للتحميل. | ||
تظهر هذه الحالة عند تضمين كائنات مثل الملفات أو المنافذ sockets أو | تظهر هذه الحالة عند تضمين كائنات مثل الملفات أو المنافذ sockets أو [[Python/class|الأصناف]]، إلى جانب العديد من الكائنات الأخرى والتي تكون غير قابلة للتمثيل على هيئة حروف في بايثون. | ||
يُبقي التمثيل المنسّق الكائنات في سطر واحد إن كان ذلك ممكنًا، ويقسّمها إلى أسطر متعددة إن لم تلائم العرض المسموح به، ويمكن تعديل هذا المقدار عن طريق إنشاء كائنات PrettyPrinter. | يُبقي التمثيل المنسّق الكائنات في سطر واحد إن كان ذلك ممكنًا، ويقسّمها إلى أسطر متعددة إن لم تلائم العرض المسموح به، ويمكن تعديل هذا المقدار عن طريق إنشاء كائنات <code>PrettyPrinter</code>. | ||
من الجدير بالذكر أنّ القواميس تُرتَّب حسب المفاتيح قبل إجراء عملية التنسيق. | من الجدير بالذكر أنّ [[Python/dict|القواميس]] تُرتَّب حسب المفاتيح قبل إجراء عملية التنسيق. | ||
== | == دوال الوحدة <code>pprint</code> == | ||
تقدّم وحدة <code>pprint</code> الدوال التالية: | |||
== | === الدالة <code>[[Python/pprint/pformat|pprint.pformat()]]</code> === | ||
تعيد الدالة التمثيل المنسّق للكائن المعطى على هيئة [[Python/str|سلسلة نصية]]. | |||
=== الدالة <code>[[Python/pprint/pprint|pprint.pprint()]]</code> === | |||
=== الدالة <code>pprint | |||
تطبع الدالة التمثيل المنسّق للكائن المعطى في المخرجات المعطاة، متبوعًا بسطر جديد. | تطبع الدالة التمثيل المنسّق للكائن المعطى في المخرجات المعطاة، متبوعًا بسطر جديد. | ||
=== الدالة <code>pprint.isreadable()</code> === | === الدالة <code>[[Python/pprint/isreadable|pprint.isreadable()]]</code> === | ||
تحدّد الدالة ما إذا كان التمثيل المنسّق للكائن المعطى "قابلًا للقراءة" أو يمكن استخدامه لإعادة بناء القيمة باستخدام الدالة eval(). | تحدّد الدالة ما إذا كان التمثيل المنسّق للكائن المعطى "قابلًا للقراءة" أو يمكن استخدامه لإعادة بناء القيمة باستخدام الدالة <code>[[Python/eval|eval()]]</code>. | ||
=== الدالة <code>pprint.isrecursive()</code> === | === الدالة <code>[[Python/pprint/isrecursive|pprint.isrecursive()]]</code> === | ||
تحدّد الدالة ما إذا كان الكائن المعطى يتطلب تمثيلًا تعاوديًا. | تحدّد الدالة ما إذا كان الكائن المعطى يتطلب تمثيلًا تعاوديًا. | ||
=== الدالة <code>pprint.saferepr()</code> === | === الدالة <code>[[Python/pprint/saferepr|pprint.saferepr()]]</code> === | ||
تعيد الدالة تمثيلًا على هيئة سلسلة نصية للكائن المعطى، ومحميًا تجاه بنى البيانات التعاودية. | تعيد الدالة تمثيلًا على هيئة سلسلة نصية للكائن المعطى، ومحميًا تجاه بنى البيانات التعاودية. | ||
== كائنات PrettyPrinter == | == كائنات PrettyPrinter == | ||
تعرّف وحدة <code>pprint</code> صنفًا واحدًا فقط هو الصنف <code>PrettyPrinter</code>، وتقدّم نسخ هذا الصنف عددًا من التوابع التي يمكن الاستفادة منها في طباعة المخرجات بصورة منسّقة وجميلة. | |||
=== التابع <code>PrettyPrinter.pformat()</code> === | === التابع <code>[[Python/PrettyPrinter/pformat|PrettyPrinter.pformat()]]</code> === | ||
يعيد التابع التمثيل المنسّق للكائن المعطى. | |||
=== التابع <code>PrettyPrinter.pprint()</code> === | === التابع <code>[[Python/PrettyPrinter/pprint|PrettyPrinter.pprint()]]</code> === | ||
يطبع التابع التمثيل المنسّق للكائن المعطى على المخرجات المحدّدة في الدالة البانية للصنف <code>PrettyPrinter</code> متبوعًا بسطر جديد. | |||
=== التابع <code>PrettyPrinter.isreadable()</code> === | === التابع <code>[[Python/PrettyPrinter/isreadable|PrettyPrinter.isreadable()]]</code> === | ||
يحدّد التابع ما إذا كان التمثيل المنسّق للكائن المعطى "قابلًا للقراءة" أو يمكن استخدامه لإعادة بناء القيمة باستخدام الدالة <code>[[Python/eval|eval()]]</code>. | |||
=== التابع <code>PrettyPrinter.isrecursive()</code> === | === التابع <code>[[Python/PrettyPrinter/isrecursive|PrettyPrinter.isrecursive()]]</code> === | ||
يحدّد التابع ما إذا كان الكائن المعطى يتطلب تمثيلًا تعاوديًا. | |||
=== التابع <code>PrettyPrinter.format()</code> === | === التابع <code>[[Python/PrettyPrinter/format|PrettyPrinter.format()]]</code> === | ||
يعيد التابع نسخة للكائن المعطى تكون على هيئة [[Python/str|سلسلة نصية]]، وراية تحدد ما إذا كانت النتيجة قابلة للقراءة وراية أخرى تحدّد ما إذا تمكن التابع من اكتشاف حالة تعاود في النتيجة. | |||
== مصادر == | == مصادر == | ||
مراجعة 07:40، 20 أغسطس 2018
تتيح وحدة pprint إمكانية طباعة بنى البيانات في بايثون بصورة جميلة pretty-print بطريقة تسمح باستخدام هذه البيانات كمدخلات في مفسّر بايثون. وإن تضمنت البنى المنسّقة كائنات ليست من أنواع بايثون الأساسية، فمن الممكن أن يكون تمثيل ذلك الكائن غير قابل للتحميل.
تظهر هذه الحالة عند تضمين كائنات مثل الملفات أو المنافذ sockets أو الأصناف، إلى جانب العديد من الكائنات الأخرى والتي تكون غير قابلة للتمثيل على هيئة حروف في بايثون.
يُبقي التمثيل المنسّق الكائنات في سطر واحد إن كان ذلك ممكنًا، ويقسّمها إلى أسطر متعددة إن لم تلائم العرض المسموح به، ويمكن تعديل هذا المقدار عن طريق إنشاء كائنات PrettyPrinter.
من الجدير بالذكر أنّ القواميس تُرتَّب حسب المفاتيح قبل إجراء عملية التنسيق.
دوال الوحدة pprint
تقدّم وحدة pprint الدوال التالية:
الدالة pprint.pformat()
تعيد الدالة التمثيل المنسّق للكائن المعطى على هيئة سلسلة نصية.
الدالة pprint.pprint()
تطبع الدالة التمثيل المنسّق للكائن المعطى في المخرجات المعطاة، متبوعًا بسطر جديد.
الدالة pprint.isreadable()
تحدّد الدالة ما إذا كان التمثيل المنسّق للكائن المعطى "قابلًا للقراءة" أو يمكن استخدامه لإعادة بناء القيمة باستخدام الدالة eval().
الدالة pprint.isrecursive()
تحدّد الدالة ما إذا كان الكائن المعطى يتطلب تمثيلًا تعاوديًا.
الدالة pprint.saferepr()
تعيد الدالة تمثيلًا على هيئة سلسلة نصية للكائن المعطى، ومحميًا تجاه بنى البيانات التعاودية.
كائنات PrettyPrinter
تعرّف وحدة pprint صنفًا واحدًا فقط هو الصنف PrettyPrinter، وتقدّم نسخ هذا الصنف عددًا من التوابع التي يمكن الاستفادة منها في طباعة المخرجات بصورة منسّقة وجميلة.
التابع PrettyPrinter.pformat()
يعيد التابع التمثيل المنسّق للكائن المعطى.
التابع PrettyPrinter.pprint()
يطبع التابع التمثيل المنسّق للكائن المعطى على المخرجات المحدّدة في الدالة البانية للصنف PrettyPrinter متبوعًا بسطر جديد.
التابع PrettyPrinter.isreadable()
يحدّد التابع ما إذا كان التمثيل المنسّق للكائن المعطى "قابلًا للقراءة" أو يمكن استخدامه لإعادة بناء القيمة باستخدام الدالة eval().
التابع PrettyPrinter.isrecursive()
يحدّد التابع ما إذا كان الكائن المعطى يتطلب تمثيلًا تعاوديًا.
التابع PrettyPrinter.format()
يعيد التابع نسخة للكائن المعطى تكون على هيئة سلسلة نصية، وراية تحدد ما إذا كانت النتيجة قابلة للقراءة وراية أخرى تحدّد ما إذا تمكن التابع من اكتشاف حالة تعاود في النتيجة.