الفرق بين المراجعتين لصفحة: «Python/urllib/parse/urldefrag»

مراجعة 19:49، 5 فبراير 2019

تحذف الدالة محدّد القطعة fragment identifier في عنوان URL المعطى.

البنية العامة

urllib.parse.urldefrag(url)

‎المعاملات

`url`

عنوان URL المراد حذف محدّد القطعة منه.

القيمة المعادة

إن تضمّن عنوان URL المعطى محدّد قطعة fragment identifier فإنّ الدالة تعيد النسخة المعدلة من العنوان المعطى دون محدّد قطعة، وتفصل محدّد القطعة في سلسلة نصية منفصلة. أما في حال عدم وجود محدّد قطعة في العنوان المعطى فإنّ الدالة تعيد ذلك العنوان دون تغييره وتعيد كذلك سلسلة نصية فارغة.

تكون القيمة المعادة نسخة متفرّعة من الصفّ. ويمتلك هذا الصنف خصائص إضافية مساعدة تمتاز بكونها للقراءة فقط:

الخاصية	الفهرس	القيمة	القيمة إن لم تكن الخاصية موجودة
url	0	عنوان URL دون مكوّن "القطعة"	سلسلة نصية فارغة
fragment	1	محدّد القطعة	سلسلة نصية فارغة

راجع قسم (نتائج التحليل المنظمة) للمزيد من المعلومات حول الكائن الناتج من هذه الدالة.

ملاحظة:

أصبحت النتيجة المعادة من الدالة كائنًا مرتّبًا عوضًا عن صفّ ذي عنصرين وذلك في الإصدار 3.2 من بايثون.

أمثلة

يبين المثال التالي طريقة عمل الدالة:

>>> from urllib.parse import urldefrag
>>> url = 'http://www.example.com/test1?page=2&id=3#sub'
>>> defrag = urldefrag(url)
>>> print(defrag)
DefragResult(url='http://www.example.com/test1?page=2&id=3', fragment='sub')
>>> defrag
DefragResult(url='http://www.example.com/test1?page=2&id=3', fragment='sub')
>>> defrag[0]
'http://www.example.com/test1?page=2&id=3'
>>> defrag[1]
'sub'

انظر أيضًا

الدالة urllib.parse.urlsplit()‎: هذه الدالة مشابهة للدالة urlparse()‎ ولكنّها لا تقسم المعاملات من عنوان URL.
الدالة urllib.parse.urlunsplit()‎: تدمج الدالة عناصر الصفّ الذي يشبه ما تعيده الدالة urlsplit()‎ في عنوان URL كامل على هيئة سلسلة نصية.

مصادر

صفحة Parse URLs into components في توثيق بايثون الرسمي.

@@ سطر 16: / سطر 16: @@
 == القيمة المعادة ==
-إن تضمّن عنوان URL المعطى محدّد قطعة fragment identifier فإنّ الدالة تعيد النسخة المعدلة من العنوان المعطى دون محدّد قطعة، وتفصل محدّد القطعة في سلسلة نصية منفصلة. أما في حال عدم وجود محدّد قطعة في العنوان المعطى فإنّ الدالة تعيد ذلك العنوان دون تغييره وتعيد كذلك سلسلة نصية فارغة.
+إن تضمّن عنوان URL المعطى محدّد قطعة fragment identifier فإنّ الدالة تعيد النسخة المعدلة من العنوان المعطى دون محدّد قطعة، وتفصل محدّد القطعة في [[Python/str|سلسلة نصية]] منفصلة. أما في حال عدم وجود محدّد قطعة في العنوان المعطى فإنّ الدالة تعيد ذلك العنوان دون تغييره وتعيد كذلك [[Python/str|سلسلة نصية]] فارغة.
 تكون القيمة المعادة نسخة متفرّعة من الصفّ. ويمتلك هذا الصنف خصائص إضافية مساعدة تمتاز بكونها للقراءة فقط:
+{| class="wikitable mw-collapsible"
+!الخاصية
+!الفهرس
-راجع قسم (نتائج تحليل منظمة) للمزيد من المعلومات حول الكائن الناتج من هذه الدالة.
+!القيمة
+!القيمة إن لم تكن الخاصية موجودة
+|-
+|url
+|0
+|عنوان URL دون مكوّن "القطعة"
+|[[Python/str|سلسلة نصية]] فارغة
+|-
+|fragment
+|1
+|محدّد القطعة
+|[[Python/str|سلسلة نصية]] فارغة
+|-
+|
+|
+|
+|
+|}
+راجع قسم ([[Python/urllib/parse#.D9.86.D8.AA.D8.A7.D8.A6.D8.AC .D8.A7.D9.84.D8.AA.D8.AD.D9.84.D9.8A.D9.84 .D8.A7.D9.84.D9.85.D9.86.D8.B8.D9.91.D9.85.D8.A9|نتائج التحليل المنظمة]]) للمزيد من المعلومات حول الكائن الناتج من هذه الدالة.
 '''ملاحظة:'''
@@ سطر 33: / سطر 51: @@
 <syntaxhighlight lang="python3">
->>> from urllib.parse import urljoin
+>>> from urllib.parse import urldefrag
->>> urljoin('http://www.cwi.nl/%7Eguido/Python.html', 'FAQ.html')
+>>> url = 'http://www.example.com/test1?page=2&id=3#sub'
-'http://www.cwi.nl/%7Eguido/FAQ.html'
+>>> defrag = urldefrag(url)
+>>> print(defrag)
+DefragResult(url='http://www.example.com/test1?page=2&id=3', fragment='sub')
+>>> defrag
+DefragResult(url='http://www.example.com/test1?page=2&id=3', fragment='sub')
+>>> defrag[0]
+'http://www.example.com/test1?page=2&id=3'
+>>> defrag[1]
+'sub'
 </syntaxhighlight>