الفرق بين المراجعتين لصفحة: «Python/pprint»
ط نقل Mohammed Taher صفحة pprint إلى Python/pprint |
لا ملخص تعديل |
||
| (2 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 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>[[Python/PrettyPrinter|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> === | ||
تعيد الدالة تمثيلًا على هيئة سلسلة نصية للكائن المعطى، ومحميًا تجاه بنى البيانات التعاودية. | تعيد الدالة تمثيلًا على هيئة سلسلة نصية للكائن المعطى، ومحميًا تجاه بنى البيانات التعاودية. | ||
== | == [[Python/pprint/PrettyPrinter|الصنف <code>PrettyPrinter</code>]] == | ||
تعرّف وحدة <code>pprint</code> صنفًا واحدًا فقط هو الصنف [[Python/PrettyPrinter|<code>PrettyPrinter</code>]]، وتقدّم نسخ هذا الصنف عددًا من التوابع التي يمكن الاستفادة منها في طباعة المخرجات بصورة منسّقة وجميلة. | |||
=== | == انظر أيضًا == | ||
* [[Python/print|الدالة <code>print()</code>]] : تطبع الدّالة الكائنات المُعطاة. | |||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 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، وتقدّم نسخ هذا الصنف عددًا من التوابع التي يمكن الاستفادة منها في طباعة المخرجات بصورة منسّقة وجميلة.
انظر أيضًا
- الدالة
print(): تطبع الدّالة الكائنات المُعطاة.