الفرق بين المراجعتين ل"Python/cgi/escape"
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة <code>cgi.escape()</code> في بايثون}}</noinclude> تحوّل الدالة الحروف '&' و '>' و '<' في ال...') |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>cgi.escape()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة <code>cgi.escape()</code> في بايثون}}</noinclude> | ||
| − | تحوّل الدالة الحروف '&' و '>' و '<' في السلسلة النصية المعطاة إلى تسلسل حروف آمن في HTML. تُستخدم هذه الدالة لعرض النصوص التي قد تحتوي على مثل هذه المحارف. | + | تحوّل الدالة الحروف <code>'&'</code> و <code>'>'</code> و <code>'<'</code> في [[Python/str|السلسلة النصية]] المعطاة إلى تسلسل حروف آمن في HTML. تُستخدم هذه الدالة لعرض النصوص التي قد تحتوي على مثل هذه المحارف. |
| − | '''ملاحظة:''' هذه الدالة مهملة منذ الإصدار 3.2 من بايثون. هذه الدالة غير آمنة لأنّ المعامل quote يحمل قيمة خاطئة افتراضيًا. استخدم الدالة html.escape() عوضًا عنها. | + | '''ملاحظة:''' هذه الدالة مهملة منذ الإصدار 3.2 من بايثون. هذه الدالة غير آمنة لأنّ المعامل <code>quote</code> يحمل قيمة خاطئة افتراضيًا. استخدم الدالة <code>[[Python/html/escape|html.escape()]]</code> عوضًا عنها. |
== البنية العامة == | == البنية العامة == | ||
| سطر 11: | سطر 11: | ||
cgi.escape(s, quote=False) | cgi.escape(s, quote=False) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | |||
== المعاملات == | == المعاملات == | ||
=== <code>s</code> === | === <code>s</code> === | ||
| سطر 18: | سطر 17: | ||
=== <code>quote</code> === | === <code>quote</code> === | ||
| − | معامل اختياري، إن أخذ قيمة صحيحة فإنّ الدالة ستحوّل علامات الاقتباس | + | معامل اختياري، إن أخذ قيمة صحيحة فإنّ الدالة ستحوّل علامات الاقتباس المزدوجة (<code>"</code>) إضافة إلى المحارف سابقة الذكر. تساعد عملية التحويل هذه في تضمين قيم خصائص [[HTML]] المحاطة بعلامة اقتباس مزدوجة، مثل <code><a href="..."></code>. يجدر التنبيه إلى أنّ الدالة لا تحوّل علامات الاقتباس المفردة على الإطلاق. |
== مصادر == | == مصادر == | ||
مراجعة 17:40، 27 ديسمبر 2018
تحوّل الدالة الحروف '&' و '>' و '<' في السلسلة النصية المعطاة إلى تسلسل حروف آمن في HTML. تُستخدم هذه الدالة لعرض النصوص التي قد تحتوي على مثل هذه المحارف.
ملاحظة: هذه الدالة مهملة منذ الإصدار 3.2 من بايثون. هذه الدالة غير آمنة لأنّ المعامل quote يحمل قيمة خاطئة افتراضيًا. استخدم الدالة html.escape() عوضًا عنها.
البنية العامة
cgi.escape(s, quote=False)
المعاملات
s
السلسلة النصية التي ستحول الدالة حروفها إلى تسلسل حروف آمن في HTML.
quote
معامل اختياري، إن أخذ قيمة صحيحة فإنّ الدالة ستحوّل علامات الاقتباس المزدوجة (") إضافة إلى المحارف سابقة الذكر. تساعد عملية التحويل هذه في تضمين قيم خصائص HTML المحاطة بعلامة اقتباس مزدوجة، مثل <a href="...">. يجدر التنبيه إلى أنّ الدالة لا تحوّل علامات الاقتباس المفردة على الإطلاق.