الفرق بين المراجعتين لصفحة: «Python/print»
إضافة الصّفحة |
طلا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>print()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة <code>print()</code> في بايثون}}</noinclude> | ||
تطبع الدّالة <code>print()</code> الكائنات المُعطاة. تُفصَل القيم المطبوعة بقيمة المُعامل <code>sep</code> وتُتبع بقيمة المُعامل <code>end</code>. | |||
== البنية العامة == | == البنية العامة == | ||
| سطر 9: | سطر 9: | ||
== المعاملات == | == المعاملات == | ||
=== <code>objects</code> === | === <code>objects</code> === | ||
مُعامل اختياريّ. | مُعامل اختياريّ يُمثّل الكائنات التّي ستُطبع. | ||
الكائنات | تُحوّل الكائنات إلى سلاسل نصيّة كما تفعل الدّالة <code>[[Python/str|str()]]</code> قبل كتابتها إلى التّيار <code>file</code> مفصولة بالفاصل <code>sep</code> ومتبوعة باللاحقة <code>end</code>. | ||
=== <code>sep</code> === | === <code>sep</code> === | ||
مُعامل كلمة مفتاحيّة (يجب عليك تمرير اسم المُعامل مع قيمته). | مُعامل كلمة مفتاحيّة (يجب عليك تمرير اسم المُعامل مع قيمته). وهو مُعامل اختياريّ. | ||
السّلسلةَ النّصيّة التّي ستَفصِل بين كلّ كائن من الكائنات التي ستُطبع. القيمة الافتراضيّة هي مسافة واحدة. | السّلسلةَ النّصيّة التّي ستَفصِل بين كلّ كائن من الكائنات التي ستُطبع. القيمة الافتراضيّة هي مسافة واحدة. | ||
=== <code>end</code> === | === <code>end</code> === | ||
مُعامل كلمة مفتاحيّة. | مُعامل كلمة مفتاحيّة. وهو مُعامل اختياريّ. | ||
السّلسلةَ النّصيّة التي سينتهي بها المُخرَج. القيمة الافتراضيّة هي محرف الأسطر الجديدة <code>'\n'</code>. | السّلسلةَ النّصيّة التي سينتهي بها المُخرَج. القيمة الافتراضيّة هي محرف الأسطر الجديدة <code>'\n'</code>. | ||
| سطر 29: | سطر 25: | ||
=== <code>file</code> === | === <code>file</code> === | ||
مُعامل كلمة مفتاحيّة. | مُعامل كلمة مفتاحيّة. وهو مُعامل اختياريّ. | ||
تيّار النّصوص (text stream) الذي ستُطبع إليه الكائنات، القيمة الافتراضيّة هي <code>sys.stdout</code>. | تيّار النّصوص (text stream) الذي ستُطبع إليه الكائنات، القيمة الافتراضيّة هي <code>sys.stdout</code>. | ||
| سطر 41: | سطر 37: | ||
=== <code>flush</code> === | === <code>flush</code> === | ||
مُعامل كلمة مفتاحيّة. | مُعامل كلمة مفتاحيّة.وهو مُعامل اختياريّ. | ||
يُحدّد ما إذا كان التّيار سيُخرَج من التّخزين الانتقاليّ للنّظام أو لا. القيمة الافتراضيّة هي <code>False</code> مرّر القيمة <code>True</code> لإخراجه. | يُحدّد ما إذا كان التّيار سيُخرَج من التّخزين الانتقاليّ للنّظام أو لا. القيمة الافتراضيّة هي <code>False</code> مرّر القيمة <code>True</code> لإخراجه. | ||
مراجعة 20:47، 11 مايو 2018
تطبع الدّالة print() الكائنات المُعطاة. تُفصَل القيم المطبوعة بقيمة المُعامل sep وتُتبع بقيمة المُعامل end.
البنية العامة
print(*objects, sep=' ', end='\n', file=sys.stdout, flush=False)
المعاملات
objects
مُعامل اختياريّ يُمثّل الكائنات التّي ستُطبع.
تُحوّل الكائنات إلى سلاسل نصيّة كما تفعل الدّالة str() قبل كتابتها إلى التّيار file مفصولة بالفاصل sep ومتبوعة باللاحقة end.
sep
مُعامل كلمة مفتاحيّة (يجب عليك تمرير اسم المُعامل مع قيمته). وهو مُعامل اختياريّ.
السّلسلةَ النّصيّة التّي ستَفصِل بين كلّ كائن من الكائنات التي ستُطبع. القيمة الافتراضيّة هي مسافة واحدة.
end
مُعامل كلمة مفتاحيّة. وهو مُعامل اختياريّ.
السّلسلةَ النّصيّة التي سينتهي بها المُخرَج. القيمة الافتراضيّة هي محرف الأسطر الجديدة '\n'.
إن لم تُعط أيّة قيمة للمُعامل objects فستُطبع قيمة end فقط.
file
مُعامل كلمة مفتاحيّة. وهو مُعامل اختياريّ.
تيّار النّصوص (text stream) الذي ستُطبع إليه الكائنات، القيمة الافتراضيّة هي sys.stdout.
يجب على قيمته أن تكون كائنًا يحتوي على تابعٍ write(string) يقبل سلسلة نصيّة كمُعامل.
ولأنّ القيم التي ستُطبع تُحوّل إلى سلاسل نصيّة، فلا يُمكن استخدام الدّالة print() مع كائنات الملفّات ذات الوضع الثّنائي (binary mode file objects). لذا استخدم التّابع file.write(…)
عوضًا عنها.
عادة ما تُحدّد قيمة المُعامل file ما إن كان المُخرَج سيُخزّن في التّخزين الانتقالي (buffer) أو لا.
flush
مُعامل كلمة مفتاحيّة.وهو مُعامل اختياريّ.
يُحدّد ما إذا كان التّيار سيُخرَج من التّخزين الانتقاليّ للنّظام أو لا. القيمة الافتراضيّة هي False مرّر القيمة True لإخراجه.
القيمة المعادة
القيمة None.
أمثلة
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:
>>> print() # لا مُعاملات
>>> print('A', 'A', sep='!') # طبع سلسلتين نصيّتين مع فصلهما بعلامة تعجّب
A!A
>>> print('A', 'A', sep='!', end='|\n') # إنهاء القيمة المطبوعة بفاصل عمودي وسطر جديد
A!A|
ملاحظات
يُمكن كذلك أن تكون قيمة كلّ من المُعامل sep والمُعامل end والمُعامل file القيمةَ None والتي تعني أنّ القيم الافتراضيّة هي التي ستُستخدم.