الفرق بين المراجعتين ل"Python/urllib/parse/unquote"
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة <code>urllib.parse.unquote()</code> في بايثون}}</noinclude> تحوّل الدالة الحروف المهرّبة...') |
|||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>urllib.parse.unquote()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة <code>urllib.parse.unquote()</code> في بايثون}}</noinclude> | ||
− | تحوّل الدالة الحروف المهرّبة بالصيغة %xx إلى الحروف الأصلية المكافئة لها. | + | تحوّل الدالة الحروف المهرّبة بالصيغة <code>%xx</code> إلى الحروف الأصلية المكافئة لها. |
== البنية العامة == | == البنية العامة == | ||
سطر 10: | سطر 10: | ||
== المعاملات == | == المعاملات == | ||
− | === string === | + | === <code>string</code> === |
السلسلة النصية المراد فكّ ترميزها. | السلسلة النصية المراد فكّ ترميزها. | ||
− | === encoding و errors === | + | === <code>encoding</code> و <code>errors</code> === |
− | يحدّد هذان المعاملان الاختياريان طريقة فكّ ترميز التسلسلات المرمّزة بترميز النسبة المئوية إلى حروف يونيكود، وبنفس الطريقة المتّبعة في التابع bytes.decode(). | + | يحدّد هذان المعاملان الاختياريان طريقة فكّ ترميز التسلسلات المرمّزة بترميز النسبة المئوية إلى حروف يونيكود، وبنفس الطريقة المتّبعة في التابع <code>[[Python/bytes/decode|bytes.decode()]]</code>. |
− | |||
− | |||
− | |||
+ | يأخذ المعامل <code>encoding</code> القيمة الافتراضية <code>'utf-8'</code>، أما المعامل <code>'errors'</code> فيأخذ القيمة الافتراضية <code>'replace'</code> والتي تعني أن التسلسلات غير الصالحة للاستخدام ستُستبدل بحروف أخرى. | ||
== أمثلة == | == أمثلة == | ||
سطر 33: | سطر 31: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة <code>[[Python/urllib/parse/quote|urllib.parse.quote()]]</code>: تستبدل الدالة الحروف الخاصة في السلسلة النصية المعطاة باستخدام علامة التهريب <code>%xx</code>. | * الدالة <code>[[Python/urllib/parse/quote|urllib.parse.quote()]]</code>: تستبدل الدالة الحروف الخاصة في السلسلة النصية المعطاة باستخدام علامة التهريب <code>%xx</code>. | ||
− | * الدالة <code>[[Python/urllib/parse/quote plus|urllib.parse.quote_plus()]]</code>: هذه الدالة مشابهة للدالة <code>quote()</code> ولكنّها تستبدل المسافات الفارغة بعلامات <code>+</code>. | + | * الدالة <code>[[Python/urllib/parse/quote plus|urllib.parse.quote_plus()]]</code>: هذه الدالة مشابهة للدالة <code>[[Python/urllib/parse/quote|quote()]]</code> ولكنّها تستبدل المسافات الفارغة بعلامات <code>+</code>. |
− | * الدالة <code>[[Python/urllib/parse/quote from bytes|urllib.parse.quote_from_bytes()]]</code>: تشبه هذه | + | * الدالة <code>[[Python/urllib/parse/quote from bytes|urllib.parse.quote_from_bytes()]]</code>: تشبه هذه الدالةُ الدالةَ [[Python/urllib/parse/quote|<code>quote()</code>]] ولكنّها تستقبل كائنات <code>[[Python/byte-bytearray-operations|bytes]]</code> عوضًا عن كائنات <nowiki/>[[Python/str|str]]، ولا تؤدي عمليات الترميز من السلاسل النصية إلى البايتات. |
* الدالة <nowiki/>[[Python/urllib/parse/unquote plus|<code>urllib.parse.unquote_plus()</code>]]: هذه الدالة مشابهة للدالة <code>[[Python/urllib/parse/unquote|unquote()]]</code> ولكنّها تستبدل علامات <code>+</code> بالمسافات البيضاء، وهذا هو المطلوب عند إلغاء الاقتباس من قيم نماذج HTML. | * الدالة <nowiki/>[[Python/urllib/parse/unquote plus|<code>urllib.parse.unquote_plus()</code>]]: هذه الدالة مشابهة للدالة <code>[[Python/urllib/parse/unquote|unquote()]]</code> ولكنّها تستبدل علامات <code>+</code> بالمسافات البيضاء، وهذا هو المطلوب عند إلغاء الاقتباس من قيم نماذج HTML. | ||
* الدالة <code>[[Python/urllib/parse/unquote to bytes|urllib.parse.unquote_to_bytes()]]</code>: تحول الدالة الحروف المهرّبة بالصيغة <code>%xx</code> إلى القيمة الثمانية المفردة المقابلة لها، وتعيد كائن <code>[[Python/bytes|bytes]]</code>. | * الدالة <code>[[Python/urllib/parse/unquote to bytes|urllib.parse.unquote_to_bytes()]]</code>: تحول الدالة الحروف المهرّبة بالصيغة <code>%xx</code> إلى القيمة الثمانية المفردة المقابلة لها، وتعيد كائن <code>[[Python/bytes|bytes]]</code>. |
المراجعة الحالية بتاريخ 20:53، 5 فبراير 2019
تحوّل الدالة الحروف المهرّبة بالصيغة %xx
إلى الحروف الأصلية المكافئة لها.
البنية العامة
urllib.parse.unquote(string, encoding='utf-8', errors='replace')
المعاملات
string
السلسلة النصية المراد فكّ ترميزها.
encoding
و errors
يحدّد هذان المعاملان الاختياريان طريقة فكّ ترميز التسلسلات المرمّزة بترميز النسبة المئوية إلى حروف يونيكود، وبنفس الطريقة المتّبعة في التابع bytes.decode()
.
يأخذ المعامل encoding
القيمة الافتراضية 'utf-8'
، أما المعامل 'errors'
فيأخذ القيمة الافتراضية 'replace'
والتي تعني أن التسلسلات غير الصالحة للاستخدام ستُستبدل بحروف أخرى.
أمثلة
يبين المثال التالي طريقة عمل الدالة:
>>> import urllib.parse
>>> urllib.parse.unquote('/El%20Ni%C3%B1o/')
'/El Niño/'
انظر أيضًا
- الدالة
urllib.parse.quote()
: تستبدل الدالة الحروف الخاصة في السلسلة النصية المعطاة باستخدام علامة التهريب%xx
. - الدالة
urllib.parse.quote_plus()
: هذه الدالة مشابهة للدالةquote()
ولكنّها تستبدل المسافات الفارغة بعلامات+
. - الدالة
urllib.parse.quote_from_bytes()
: تشبه هذه الدالةُ الدالةَquote()
ولكنّها تستقبل كائناتbytes
عوضًا عن كائنات str، ولا تؤدي عمليات الترميز من السلاسل النصية إلى البايتات. - الدالة
urllib.parse.unquote_plus()
: هذه الدالة مشابهة للدالةunquote()
ولكنّها تستبدل علامات+
بالمسافات البيضاء، وهذا هو المطلوب عند إلغاء الاقتباس من قيم نماذج HTML. - الدالة
urllib.parse.unquote_to_bytes()
: تحول الدالة الحروف المهرّبة بالصيغة %xx
إلى القيمة الثمانية المفردة المقابلة لها، وتعيد كائنbytes
. - الدالة
urllib.parse.urlencode()
: تحوّل الدالة كائن ربط mapping object أو تسلسلًا من صفوف ذات عنصرين، والتي قد تحتوي على كائناتstr
أوbytes
إلى سلسلة نصية مرمّزة بالنسبة المئوية ضمن الترميز ASCII.