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

من موسوعة حسوب
لا ملخص تعديل
لا ملخص تعديل
 
(7 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:السلاسل النصية في بايثون}}</noinclude>
<noinclude>{{DISPLAYTITLE:السلاسل النصية في بايثون}}</noinclude>
يمكن التعامل مع البيانات النصية في بايثون باستخدام كائنات <code>str</code> أو السلاسل النصية (strings)، وهي تسلسلات (sequences) غير قابلة للتغيير (immutable) من رموز Unicode.  
يمكن التعامل مع البيانات النصية في بايثون باستخدام كائنات <code>str</code> أو السلاسل النصية (strings)، وهي تسلسلات (sequences) غير قابلة للتغيير (immutable) من رموز يونيكود (Unicode).  


هناك طرائق مختلفة للتعبير عن السلاسل النصية، إذ يمكن أن تحاط بعلامات اقتباس مفردة <code>('...')</code> أو مزدوجة <code>("...")</code>، ويستخدم الرمز <code>\</code> لتهريب علامات الاقتباس:<syntaxhighlight lang="python3">
هناك طرائق مختلفة للتعبير عن السلاسل النصية، إذ يمكن أن تحاط بعلامات اقتباس مفردة <code>('...')</code> أو مزدوجة <code>("...")</code>، ويستخدم الرمز <code>\</code> لتهريب علامات الاقتباس:<syntaxhighlight lang="python3">
>>>
>>> 'spam eggs'  # علامات اقتباس مفردة
>>> 'spam eggs'  # علامات اقتباس مفردة
'spam eggs'
'spam eggs'
سطر 17: سطر 16:
'"Isn\'t," she said.'
'"Isn\'t," she said.'
</syntaxhighlight>
</syntaxhighlight>
 
{{Course|course=python}}
__TOC__
== استخدام السلاسل النصية ==
== استخدام السلاسل النصية ==
تحاط المخرجات في الوضع التفاعلي للمفسّر بعلامات الاقتباس، وتهرّب الأحرف الخاصة باستخدام الخطوط المائلة <code>\</code>، وعلى الرغم من أنّ المخرجات قد تبدو في بعض الأحيان مختلفة عن المدخلات (قد تختلف علامات الاقتباس التي تحيط بالسلسلة النصية) لكن السلسلتين النصيتين ستكونان متطابقتان.
تحاط المخرجات في الوضع التفاعلي للمفسّر بعلامات الاقتباس، وتهرّب الأحرف الخاصة باستخدام الخطوط المائلة <code>\</code>، وعلى الرغم من أنّ المخرجات قد تبدو في بعض الأحيان مختلفة عن المدخلات (قد تختلف علامات الاقتباس التي تحيط بالسلسلة النصية) لكن السلسلتين النصيتين ستكونان متطابقتان.
سطر 26: سطر 26:


في المثال التالي يستخدم الحرف الخاص <code>‎\n</code> ضمن السلسلة النصية والذي يظهر في السلسلة النصية المخرجة دون استخدام الدالة <code>[[Python/print|print()]]‎</code>، وتحوّله الدالة إلى سطر جديد:<syntaxhighlight lang="python3">
في المثال التالي يستخدم الحرف الخاص <code>‎\n</code> ضمن السلسلة النصية والذي يظهر في السلسلة النصية المخرجة دون استخدام الدالة <code>[[Python/print|print()]]‎</code>، وتحوّله الدالة إلى سطر جديد:<syntaxhighlight lang="python3">
>>>
>>> '"Isn\'t," she said.'
>>> '"Isn\'t," she said.'
'"Isn\'t," she said.'
'"Isn\'t," she said.'
سطر 41: سطر 40:


في المثال التالي يظهر الحرف الخاص ‎<code>\n</code> ضمن السلسلة النصية، لاحظ الفرق بين المخرجات:<syntaxhighlight lang="python3">
في المثال التالي يظهر الحرف الخاص ‎<code>\n</code> ضمن السلسلة النصية، لاحظ الفرق بين المخرجات:<syntaxhighlight lang="python3">
>>>
>>> print('C:\some\name') 
>>> print('C:\some\name') 
C:\some
C:\some
سطر 61: سطر 59:
== ربط السلاسل النصية وتكرارها ==
== ربط السلاسل النصية وتكرارها ==
يمكن ربط السلاسل النصية بعضها ببعض بواسطة العامل <code>+</code>، ويمكن تكرار السلاسل باستخدام العامل <code>*</code>، فمثلًا، تكرر الشيفرة التالية السلسلة النصية <code>'un'</code> ثلاث مرات وتربطها بعد ذلك بالسلسلة النصية <code>'ium'</code>:<syntaxhighlight lang="python3">
يمكن ربط السلاسل النصية بعضها ببعض بواسطة العامل <code>+</code>، ويمكن تكرار السلاسل باستخدام العامل <code>*</code>، فمثلًا، تكرر الشيفرة التالية السلسلة النصية <code>'un'</code> ثلاث مرات وتربطها بعد ذلك بالسلسلة النصية <code>'ium'</code>:<syntaxhighlight lang="python3">
>>>
>>> 3 * 'un' + 'ium'
>>> 3 * 'un' + 'ium'
'unununium'
'unununium'
</syntaxhighlight>
</syntaxhighlight>
تربط بايثون السلاسل النصية المتجاورة بعضها ببعض تلقائيًا:<syntaxhighlight lang="python3">
تربط بايثون السلاسل النصية المتجاورة بعضها ببعض تلقائيًا:
>>>
<syntaxhighlight lang="python3">
>>> 'Py' 'thon'
>>> 'Py' 'thon'
'Python'
'Python'
</syntaxhighlight>هذه الخاصية مفيدة عند الحاجة إلى لتقسيم السلاسل الطويلة:<syntaxhighlight lang="python3">
</syntaxhighlight>
>>>
هذه الخاصية مفيدة عند الحاجة إلى تقسيم السلاسل الطويلة:
<syntaxhighlight lang="python3">
>>> text = ('Put several strings within parentheses '
>>> text = ('Put several strings within parentheses '
...         'to have them joined together.')
...         'to have them joined together.')
>>> text
>>> text
'Put several strings within parentheses to have them joined together.'
'Put several strings within parentheses to have them joined together.'
</syntaxhighlight>تعمل هذه الخاصية مع السلاسل النصية المحاطة بعلامات اقتباس فقط، ولا تعمل مع المتغيرات أو التعابير:<syntaxhighlight lang="python3">
</syntaxhighlight>
>>>
 
تعمل هذه الخاصية مع السلاسل النصية المحاطة بعلامات اقتباس فقط، ولا تعمل مع المتغيرات أو التعابير:
 
<syntaxhighlight lang="python3">
>>> prefix = 'Py'
>>> prefix = 'Py'
>>> prefix 'thon'  # لا يمكن ربط السلسلة النصية بالمتغيرات
>>> prefix 'thon'  # لا يمكن ربط السلسلة النصية بالمتغيرات
سطر 86: سطر 87:
</syntaxhighlight>
</syntaxhighlight>
استخدم العامل <code>+</code> لربط المتغيرات أو المتغيرات مع السلاسل النصية:<syntaxhighlight lang="python3">
استخدم العامل <code>+</code> لربط المتغيرات أو المتغيرات مع السلاسل النصية:<syntaxhighlight lang="python3">
>>>
>>> prefix + 'thon'
>>> prefix + 'thon'
'Python'
'Python'
</syntaxhighlight>
</syntaxhighlight>
== فهرسة السلاسل النصية ==
== فهرسة السلاسل النصية ==
يمكن فهرسة السلاسل النصية في بايثون، ويحمل الحرف الأول رقم الفهرس <code>0</code>. نوع الأحرف المفردة غير متوفّر في بايثون، فالحرف المفرد هو ببساطة سلسلة نصية ذات عنصر واحد:<syntaxhighlight lang="python3">
يمكن فهرسة السلاسل النصية في بايثون، ويحمل الحرف الأول رقم الفهرس <code>0</code>.
>>>
 
جدير بالذكر أنّ نوع الأحرف المفردة <code>char</code> غير متوفّر في بايثون، فالحرف المفرد هو ببساطة سلسلة نصية ذات عنصر واحد:<syntaxhighlight lang="python3">
>>> word = 'Python'
>>> word = 'Python'
>>> word[0]  # الحرف في الموقع 0
>>> word[0]  # الحرف في الموقع 0
سطر 100: سطر 102:
</syntaxhighlight>
</syntaxhighlight>
يمكن لأرقام الفهارس أن تكون سالبة، وحينئذ يبدأ العدّ من اليمين:<syntaxhighlight lang="python3">
يمكن لأرقام الفهارس أن تكون سالبة، وحينئذ يبدأ العدّ من اليمين:<syntaxhighlight lang="python3">
>>>
>>> word[-1]  # الحرف الأخير
>>> word[-1]  # الحرف الأخير
'n'
'n'
سطر 109: سطر 110:
</syntaxhighlight>
</syntaxhighlight>


لاحظ أنّه لمّا كان ‎<code>-0</code> و <code>0</code> متساويان، فإنّ الفهارس السالبة تبدأ من <code>‎-1</code>.
لاحظ أنّه لمّا كان ‎<code>-0</code> و <code>0</code> متساويين، فإنّ الفهارس السالبة تبدأ من <code>‎-1</code>.


== اقتطاع السلسلة النصية ==
== اقتطاع السلسلة النصية ==
إضافة إلى الفهرسة تدعم بايثون عملية الاقتطاع (slicing) أيضًا. تستخدم الفهرسة للحصول على أحرف مفردة، أما عملية التقطيع فتتيح الحصول على جزء من السلسلة النصية:<syntaxhighlight lang="python3">
إضافة إلى الفهرسة تدعم بايثون عملية الاقتطاع (slicing) أيضًا. تستخدم الفهرسة للحصول على أحرف مفردة، أما عملية التقطيع فتتيح الحصول على جزء من السلسلة النصية:<syntaxhighlight lang="python3">
>>>
>>> word[0:2]  # الحروف من الموقع 0 (مشمول) إلى الموقع 2 (غير مشمول)‏
>>> word[0:2]  # الحروف من الموقع 0 (مشمول) إلى الموقع 2 (غير مشمول)‏
'Py'
'Py'
سطر 120: سطر 120:
</syntaxhighlight>
</syntaxhighlight>
لاحظ أنّ الرقم الأول يكون مشمولًا دائمًا بعملية الاقتطاع أما الرقم الأخير فلا يكون مشمولًا. وهكذا فإن التعبير <code>s[:i] + s[i:]</code>‎ يساوي <code>s</code> دائمًا:<syntaxhighlight lang="python3">
لاحظ أنّ الرقم الأول يكون مشمولًا دائمًا بعملية الاقتطاع أما الرقم الأخير فلا يكون مشمولًا. وهكذا فإن التعبير <code>s[:i] + s[i:]</code>‎ يساوي <code>s</code> دائمًا:<syntaxhighlight lang="python3">
>>>
>>> word[:2] + word[2:]
>>> word[:2] + word[2:]
'Python'
'Python'
سطر 128: سطر 127:


هناك بعض القيم الافتراضية المفيدة في خاصية التقطيع، فإذا حذف الرقم الأول فإنّ القيمة الافتراضية له ستكون صفرًا، وإذا حُذف الرقم الثاني فإنّ القيمة الافتراضية تكون طول السلسلة النصية التي سيجري اقتطاعها.<syntaxhighlight lang="python3">
هناك بعض القيم الافتراضية المفيدة في خاصية التقطيع، فإذا حذف الرقم الأول فإنّ القيمة الافتراضية له ستكون صفرًا، وإذا حُذف الرقم الثاني فإنّ القيمة الافتراضية تكون طول السلسلة النصية التي سيجري اقتطاعها.<syntaxhighlight lang="python3">
>>>
>>> word[:2]   # اقتطاع الحروف من الموقع 0 إلى الموقع 2 (غير مشمول)‏
>>> word[:2]   # اقتطاع الحروف من الموقع 0 إلى الموقع 2 (غير مشمول)‏
'Py'
'Py'
سطر 150: سطر 148:


تؤدي محاولة استخدام فهرس كبير جدًّا (يتجاوز طول السلسلة النصية) إلى حدوث خطأ:<syntaxhighlight lang="python3">
تؤدي محاولة استخدام فهرس كبير جدًّا (يتجاوز طول السلسلة النصية) إلى حدوث خطأ:<syntaxhighlight lang="python3">
>>>
>>> word[42]  # السلسلة النصية فيها 6 محارف فقط
>>> word[42]  # السلسلة النصية فيها 6 محارف فقط
Traceback (most recent call last):
Traceback (most recent call last):
سطر 158: سطر 155:


ولكن لا تظهر هذه الأخطاء عند اقتطاع السلاسل النصية:<syntaxhighlight lang="python3">
ولكن لا تظهر هذه الأخطاء عند اقتطاع السلاسل النصية:<syntaxhighlight lang="python3">
>>>
>>> word[4:42]
>>> word[4:42]
'on'
'on'
سطر 165: سطر 161:
</syntaxhighlight>
</syntaxhighlight>


تمتاز السلاسل النصية في بايثون بأنّها غير قابلة للتعديل (immutable)؛ لذا فإنّ إسناد قيمة إلى موقع مفهرس ضمن السلسلة سيؤدي إلى حدوث خطأ:<syntaxhighlight lang="python3">
السلاسل النصية في بايثون غير قابلة للتعديل (immutable)؛ لذا فإنّ إسناد قيمة إلى موقع مفهرس ضمن السلسلة سيؤدي إلى حدوث خطأ:<syntaxhighlight lang="python3">
>>>
>>> word[0] = 'J'
>>> word[0] = 'J'
  ...
  ...
سطر 176: سطر 171:


إن كنت ترغب في تغيير السلسلة النصية، فيجب إنشاء واحدة جديدة:<syntaxhighlight lang="python3">
إن كنت ترغب في تغيير السلسلة النصية، فيجب إنشاء واحدة جديدة:<syntaxhighlight lang="python3">
>>>
>>> 'J' + word[1:]
>>> 'J' + word[1:]
'Jython'
'Jython'
>>> word[:2] + 'py'
>>> word[:2] + 'py'
'Pypy'
'Pypy'
تعيد الدالة الداخلية len()‎ طول السلسلة النصية:
 
>>>
</syntaxhighlight>تعيد الدالة الداخلية <code>[[Python/len|len()‎]]</code> طول السلسلة النصية:<syntaxhighlight lang="python3">
>>> s = 'supercalifragilisticexpialidocious'
>>> s = 'supercalifragilisticexpialidocious'
>>> len(s)
>>> len(s)
سطر 189: سطر 183:


== التحويل إلى سلسلة نصية ==
== التحويل إلى سلسلة نصية ==
تستخدم الدالة <code>str()</code>‎ لتحويل الكائنات إلى سلاسل نصية، وتعيد سلسلة فارغة في حال عدم تقديم كائن لها. تعيد الدالة <code>str(object)</code>‎ التابع <code>object.__str__()‎</code> وهو عبارة عن تمثيل للكائن على هيئة سلسلة نصية قابلة للطباعة ومنسّقة بصورة جيدة. إن كان الكائن سلسلة نصية فإنّ الدالة تعيد السلسلة النصّية ذاتها. إن لم يمتلك الكائن تابع <code>‎__str__()‎</code> فإنّ الدالة <code>str()</code>‎ ستتراجع (fall back) إلى الدالة <code>[[Python/Function/repr|repr(object)]]</code>‎.<syntaxhighlight lang="python3">
تستخدم الدالة <code>str()</code>‎ لتحويل الكائنات إلى سلاسل نصية، وتعيد سلسلة فارغة في حال عدم تقديم كائن لها. تعيد الدالة <code>str(object)</code>‎ التابع <code>object.__str__()‎</code> وهو عبارة عن تمثيل للكائن على هيئة سلسلة نصية قابلة للطباعة ومنسّقة بصورة جيدة. إن كان الكائن سلسلة نصية فإنّ الدالة تعيد السلسلة النصّية ذاتها. إن لم يمتلك الكائن تابع <code>‎__str__()‎</code> فإنّ الدالة <code>str()</code>‎ ستتراجع (fall back) إلى الدالة <code>[[Python/repr|repr(object)]]</code>‎.<syntaxhighlight lang="python3">
>>> str()
>>> str()
''
''
سطر 208: سطر 202:
'Python'
'Python'
</syntaxhighlight>
</syntaxhighlight>
== الدوال التابعة للكائن <code>str</code> ==
يدعم الكائن <code>str</code> جميع [[Python/sequence_operations|العمليات المشتركة بين أنواع التسلسلات]] في بايثون، إضافة إلى بعض الدوال الخاصة:
=== <code>[[Python/str/capitalize|str.capitalize()‎]]</code> ===
تعيد الدالة نسخة من السلسلة النصية مع تحويل الحرف الأول إلى حرف كبير، والأحرف الباقية إلى أحرف صغيرة.
=== <code>[[Python/str/casefold|str.casefold()‎]]</code> ===
تعيد هذه الدالة السلسلة النصية بحالة casefolded، ويمكن استخدام هذا النوع من السلاسل لإجراء المقارنة دون الاعتماد على حالة الأحرف.
=== <code>[[Python/str/center|str.center()‎]]</code> ===
تعيد الدالة أحرف السلسلة النصية مزاحة نحو الوسط ضمن سلسلة نصّية ذات طول محدّد.
=== <code>[[Python/str/count|str.count()‎]]</code> ===
تعيد هذه الدالة عدد مرات ظهور سلسلة نصية فرعية ضمن السلسلة الأصلية.
=== <code>[[Python/str/encode|str.encode()‎]]</code> ===
تعيد الدالة نسخة مرمّزة من السلسلة النصية على هيئة <nowiki/>[[Python/bytes|بايتات]].
=== <code>[[Python/str/endswith|str.endswith()‎]]</code> ===
تتحقّق الدالة من وجود سلسلة نصية فرعية في نهاية السلسلة النصية الأصلية.
=== <code>[[Python/str/expandtabs|str.expandtabs()‎]]</code> ===
تعيد الدالة ‎ نسخة من السلسلة النصية بعد تحويل جميع علامات الجدولة إلى مسافة بيضاء واحدة أو أكثر.
=== <code>[[Python/str/find|str.find()‎]]</code> ===
تعيد الدالة أدنى قيمة للفهرس في السلسلة النصية والذي تكون السلسلة الفرعية موجودة فيه ضمن الجزء المقتطع من السلسلة.
=== <code>[[Python/str/format|str.format()‎]]</code> ===
تؤدي هذه الدالة عمليات التنسيق على السلسلة النصية بواسطة <nowiki/>[[Python/arguments|معاملات موضعية]] أو <nowiki/>[[Python/arguments#.D9.85.D8.B9.D8.A7.D9.85.D9.84.D8.A7.D8.AA .D8.A7.D9.84.D9.83.D9.84.D9.85.D8.A7.D8.AA .D8.A7.D9.84.D9.85.D9.81.D8.AA.D8.A7.D8.AD.D9.8A.D8.A9|مفتاحية]].
=== <code>[[Python/str/format_map|str.format_map()‎]]</code> ===
تؤدّي هذه الدالة عمليات التنسيق على السلسلة النصية بواسطة <nowiki/>[[Python/dict|قاموس]].
=== <code>[[Python/str/index|str.index()‎]]</code> ===
تؤدي هذه الدالة نفس وظيفة الدالة <code>[[Python/str/find|str.find()‎]]</code> ولكنّها تطلق الخطأ <code>ValueError</code> إن لم تعثر على السلسلة الفرعية.
=== <code>[[Python/str/isalnum|str.isalnum()‎]]</code> ===
تتحقّق هذه الدالة ممّا إذا كانت السلسلة النصية تضمّ حروفًا وأرقامًا وأنّها تضمّ حرفًا واحدًا على الأقل.
=== <code>[[Python/str/isalpha|str.isalpha()‎]]</code> ===
تتحقّق الدالة ممّا إذا كانت السلسلة النصية مكوّنة من الحروف فقط، وأنّ فيها حرفًا واحدًا على الأقل.
=== <code>[[Python/str/isdecimal|str.isdecimal()‎]]</code> ===
تحقّق الدالة ممّا إذا كانت السلسلة النصية مكوّنة من حروف الأعداد العشرية فقط، وأنّ فيها حرفًا واحدًا على الأقل.
=== <code>[[Python/str/isdigit|str.isdigit()‎]]</code> ===
تتحقّق الدالة ممّا إذا كانت السلسلة النصية مكوّنة من حروف الأعداد (digits) فقط، وأنّ فيها حرفًا واحدًا على الأقل.
=== <code>[[Python/str/isidentifier|str.isidentifier()‎]]</code> ===
تتحقّق الدالة ممّا إذا كانت السلسلة النصية تتضمّن معرّفًا صحيحًا (identifier) في لغة بايثون.
=== <code>[[Python/str/islower|str.islower()‎]]</code> ===
تتحقّق الدالة ممّا إذا كانت حروف السلسلة النصية حروفًا صغيرة lower case.
=== <code>[[Python/str/isnumeric|str.isnumeric()‎]]</code> ===
تتحقّق الدالة ممّا إذا كانت جميع الحروف في السلسلة النصية حروفًا عددية، وأنّ هناك حرفًا واحدًا على الأقل في تلك السلسلة.
=== <code>[[Python/str/isprintable|str.isprintable()‎]]</code> ===
تتحقّق الدالة ممّا إذا كانت جميع الحروف في السلسلة النصية قابلة للطباعة أو أن السلسلة النصية فارغة.
=== <code>[[Python/str/isspace|str.isspace()‎]]</code> ===
تحقّق الدالة ممّا إذا كانت السلسلة النصية مكوّنة من حروف مسافات بيضاء فقط وأنّ في السلسلة حرفًا واحدًا على الأقل.
=== <code>[[Python/str/istitle|str.istitle()‎]]</code> ===
تتحقّق الدالة ممّا إذا كانت أوائل الكلمات في السلسلة النصية حروفًا كبيرة (titlecased).
=== <code>[[Python/str/isupper|str.isupper()‎]]</code> ===
تتحقّق الدالة ممّا إذا كانت جميع الحروف في السلسلة النصية حروفًا كبيرة.
=== <code>[[Python/str/join|str.join()‎]]</code> ===
تعيد الدالة السلسلة النصية الناتجة عن ربط السلاسل النصية التابعة لكائن قابل للتكرار (iterable).
=== <code>[[Python/str/ljust|str.ljust()‎]]</code> ===
تعيد الدالة أحرف السلسلة النصية مزاحة نحو اليسار ضمن سلسلة نصّية ذات طول محدّد.
=== <code>[[Python/str/lower|str.lower()‎]]</code> ===
تحول الدالة جميع الحروف في السلسلة النصية إلى حروف صغيرة.
=== <code>[[Python/str/lstrip|str.lstrip()‎]]</code> ===
تحذف الدالة الحروف التي يحدّدها المستخدم من بداية السلسلة النصية.
=== <code>[[Python/str/maketrans|str.maketrans()‎]]</code> ===
تعيد هذه الدالة الساكنة جدول ترجمة يمكن استخدامه بواسطة الدالة <code>[[Python/str/translate|str.translate()]]‎</code>.
=== <code>[[Python/str/partition|str.partition()‎]]</code> ===
تقسم هذه الدالة السلسلة النصية عند أول ظهور للقيمة التي يحدّدها المستخدم.
=== <code>[[Python/str/replace|str.replace()‎]]</code> ===
تبدّل هذه الدالة العبارة التي يختارها المستخدم - مهما تكرّرت في السلسلة النصية - بالقيمة الجديدة التي يحدّدها.
=== <code>[[Python/str/rfind|str.rfind()‎]]</code> ===
تعيد الدالة أعلى قيمة للفهرس في السلسلة النصية حيث تجد فيه السلسلة النصية الفرعية.
=== <code>[[Python/str/rindex|str.rindex()‎]]</code> ===
تعيد الدالة أعلى قيمة للفهرس في السلسلة النصية حيث تجد فيه السلسلة النصية الفرعية.
=== <code>[[Python/str/rjust|str.rjust()‎]]</code> ===
تعيد الدالة أحرف السلسلة النصية مزاحة نحو اليمين ضمن سلسلة نصّية ذات طول محدّد.
=== <code>[[Python/str/rpartition|str.rpartition()‎]]</code> ===
تقسم هذه الدالة السلسلة النصية عند آخر ظهور للقيمة التي يحدّدها المستخدم.
=== <code>[[Python/str/rsplit|str.rsplit()‎]]</code> ===
تحوّل هذه الدالة السلسلة النصية من جهة اليمين إلى <nowiki/>[[Python/list|قائمة]] من السلاسل النصية بالاعتماد على الفاصل الذي يحدّده المستخدم.
=== <code>[[Python/str/rstrip|str.rstrip()‎]]</code> ===
تحذف الدالة الحروف التي يحدّدها المستخدم من نهاية السلسلة النصية.
=== <code>[[Python/str/split|str.split()‎]]</code> ===
تقسّم الدالة السلسلة النصية إلى <nowiki/>[[Python/list|قائمة]] من السلاسل النصية بالاعتماد على فاصل محدّد.
=== <code>[[Python/str/splitlines|str.splitlines()‎]]</code> ===
تقسم الدالة السلسلة النصية إلى <nowiki/>[[Python/list|قائمة]] من الأسطر.
=== <code>[[Python/str/startswith|str.startswith()‎]]</code> ===
تتحقّق الدالة من أنّ السلسلة النصية تبدأ بالقيمة التي يحدّدها المستخدم.
=== <code>[[Python/str/strip|str.strip()‎]]</code> ===
تحذف الدالة الحروف المحدّدة من قبل المستخدم من نهاية وبداية السلسلة النصية.
=== <code>[[Python/str/swapcase|str.swapcase()‎]]</code> ===
تقلب الدالة‎ حالة الحروف في السلسلة النصية.
=== <code>[[Python/str/title|str.title()‎]]</code> ===
تحوّل الدالة‎ أوائل الكلمات في السلسلة النصية إلى أحرف كبيرة Title Case.
=== <code>[[Python/str/translate|str.translate()‎]]</code> ===
تعيد الدالة‎ الحروف في السلسلة النصية بالاعتماد على جدول الترجمة translation table.
=== <code>[[Python/str/upper|str.upper()‎]]</code> ===
تحوّل الدالة‎ الحروف في السلسلة النصية إلى حروف كبيرة.
=== <code>[[Python/str/zfill|str.zfill()‎]]</code> ===
تضيف الدالة‎ أصفارًا من الترميز ASCII إلى يسار السلسلة النصية لتصبح السلسلة بالطول المحدد من قبل المستخدم.
== انظر أيضًا ==
* [[Python/tuples|الصفوف tuple في بايثون]].
* [[Python/list|القوائم lists في بايثون]].
* [[Python/set|المجموعات set في بايثون]].
* [[Python/dict|القواميس dict في بايثون]].
* [[Python/bytes|البايتات في بايثون]].
== مصادر ==
== مصادر ==
* صفحتا [https://docs.python.org/3/tutorial/introduction.html#strings An Informal Introduction To Python]و [https://docs.python.org/3/library/stdtypes.html#text-sequence-type-str Built-in Types] في توثيق بايثون الرسمي.
* صفحتا [https://docs.python.org/3/tutorial/introduction.html#strings An Informal Introduction To Python]و [https://docs.python.org/3/library/stdtypes.html#text-sequence-type-str Built-in Types] في توثيق بايثون الرسمي.
[[تصنيف:Python]]
[[تصنيف:Python]]
[[تصنيف:Python Types]]
[[تصنيف:Python Types]]

المراجعة الحالية بتاريخ 08:55، 23 يونيو 2022

يمكن التعامل مع البيانات النصية في بايثون باستخدام كائنات str أو السلاسل النصية (strings)، وهي تسلسلات (sequences) غير قابلة للتغيير (immutable) من رموز يونيكود (Unicode).

هناك طرائق مختلفة للتعبير عن السلاسل النصية، إذ يمكن أن تحاط بعلامات اقتباس مفردة ('...') أو مزدوجة ("...")، ويستخدم الرمز \ لتهريب علامات الاقتباس:

>>> 'spam eggs'  # علامات اقتباس مفردة
'spam eggs'
>>> 'doesn\'t'  # استخدم \' لتهريب علامات الاقتباس المفردة...‏
"doesn't"
>>> "doesn't"  # ...أو استخدم علامات الاقتباس المزدوجة
"doesn't"
>>> '"Yes," he said.'
'"Yes," he said.'
>>> "\"Yes,\" he said."
'"Yes," he said.'
>>> '"Isn\'t," she said.'
'"Isn\'t," she said.'
دورة تطوير التطبيقات باستخدام لغة Python
  • 69 ساعة فيديو تدريبية
  • من الصفر دون الحاجة لخبرة مسبقة
  • شهادة معتمدة من أكاديمية حسوب
  • متابعة أثناء الدورة من فريق مختص

استخدام السلاسل النصية

تحاط المخرجات في الوضع التفاعلي للمفسّر بعلامات الاقتباس، وتهرّب الأحرف الخاصة باستخدام الخطوط المائلة \، وعلى الرغم من أنّ المخرجات قد تبدو في بعض الأحيان مختلفة عن المدخلات (قد تختلف علامات الاقتباس التي تحيط بالسلسلة النصية) لكن السلسلتين النصيتين ستكونان متطابقتان.

تحاط السلسلة النصية بعلامات اقتباس مزدوجة إن كانت تحتوي على علامات اقتباس مفردة، أما إذا احتوت على علامات اقتباس مزدوجة فإنّها تحاط بعلامات اقتباس مفردة.

تنتج الدالة print() مخرجات سهلة القراءة وذلك بحذف علامات الاقتباس التي تحيط بالسلسلة النصية وطباعة الأحرف الخاصّة والمهرّبة.

في المثال التالي يستخدم الحرف الخاص ‎\n ضمن السلسلة النصية والذي يظهر في السلسلة النصية المخرجة دون استخدام الدالة print()، وتحوّله الدالة إلى سطر جديد:

>>> '"Isn\'t," she said.'
'"Isn\'t," she said.'
>>> print('"Isn\'t," she said.')
"Isn't," she said.
>>> s = 'First line.\nSecond line.'
>>> s  
'First line.\nSecond line.'
>>> print(s)  
First line.
Second line.

إن كنت لا ترغب في تحويل الأحرف الخاصة المسبوقة بالعلامة \ يمكنك استخدام السلاسل النصية الخام وذلك بإضافة الحرف r (اختصار raw) قبل علامة الاقتباس الأولى.

في المثال التالي يظهر الحرف الخاص ‎\n ضمن السلسلة النصية، لاحظ الفرق بين المخرجات:

>>> print('C:\some\name') 
C:\some
ame
>>> print(r'C:\some\name')  # note the r before the quote
C:\some\name

يمكن للسلاسل النصية أن تمتدّ لعدة أسطر، وذلك باستخدام علامات اقتباس ثلاثية """...""" أو '''...'''. تضاف نهايات الأسطر إلى السلسلة النصية تلقائيًا، ولكن يمكن تجنّب ذلك بإضافة الرمز \ في نهاية السطر، فعلى سبيل المثال:

print("""\
Usage: thingy [OPTIONS]
     -h                        Display this usage message
     -H hostname               Hostname to connect to
""")

تعطي الشيفرة السابقة المخرجات التالية (لاحظ غياب السطر الجديد في بداية السلسلة):

Usage: thingy [OPTIONS]
     -h                        Display this usage message
     -H hostname               Hostname to connect to

ربط السلاسل النصية وتكرارها

يمكن ربط السلاسل النصية بعضها ببعض بواسطة العامل +، ويمكن تكرار السلاسل باستخدام العامل *، فمثلًا، تكرر الشيفرة التالية السلسلة النصية 'un' ثلاث مرات وتربطها بعد ذلك بالسلسلة النصية 'ium':

>>> 3 * 'un' + 'ium'
'unununium'

تربط بايثون السلاسل النصية المتجاورة بعضها ببعض تلقائيًا:

>>> 'Py' 'thon'
'Python'

هذه الخاصية مفيدة عند الحاجة إلى تقسيم السلاسل الطويلة:

>>> text = ('Put several strings within parentheses '
...         'to have them joined together.')
>>> text
'Put several strings within parentheses to have them joined together.'

تعمل هذه الخاصية مع السلاسل النصية المحاطة بعلامات اقتباس فقط، ولا تعمل مع المتغيرات أو التعابير:

>>> prefix = 'Py'
>>> prefix 'thon'  # لا يمكن ربط السلسلة النصية بالمتغيرات
  ...
SyntaxError: invalid syntax
>>> ('un' * 3) 'ium'
  ...
SyntaxError: invalid syntax

استخدم العامل + لربط المتغيرات أو المتغيرات مع السلاسل النصية:

>>> prefix + 'thon'
'Python'

فهرسة السلاسل النصية

يمكن فهرسة السلاسل النصية في بايثون، ويحمل الحرف الأول رقم الفهرس 0.

جدير بالذكر أنّ نوع الأحرف المفردة char غير متوفّر في بايثون، فالحرف المفرد هو ببساطة سلسلة نصية ذات عنصر واحد:

>>> word = 'Python'
>>> word[0]  # الحرف في الموقع 0
'P'
>>> word[5]  # الحرف في الموقع 5
'n'

يمكن لأرقام الفهارس أن تكون سالبة، وحينئذ يبدأ العدّ من اليمين:

>>> word[-1]  # الحرف الأخير
'n'
>>> word[-2]  # الحرف ما قبل الأخير
'o'
>>> word[-6]
'P'

لاحظ أنّه لمّا كان ‎-0 و 0 متساويين، فإنّ الفهارس السالبة تبدأ من ‎-1.

اقتطاع السلسلة النصية

إضافة إلى الفهرسة تدعم بايثون عملية الاقتطاع (slicing) أيضًا. تستخدم الفهرسة للحصول على أحرف مفردة، أما عملية التقطيع فتتيح الحصول على جزء من السلسلة النصية:

>>> word[0:2]  # الحروف من الموقع 0 (مشمول) إلى الموقع 2 (غير مشمول)‏
'Py'
>>> word[2:5]  # الحروف من الموقع 2 (مشمول) إلى الموقع 5 (غير مشمول)‏
'tho'

لاحظ أنّ الرقم الأول يكون مشمولًا دائمًا بعملية الاقتطاع أما الرقم الأخير فلا يكون مشمولًا. وهكذا فإن التعبير s[:i] + s[i:]‎ يساوي s دائمًا:

>>> word[:2] + word[2:]
'Python'
>>> word[:4] + word[4:]
'Python'

هناك بعض القيم الافتراضية المفيدة في خاصية التقطيع، فإذا حذف الرقم الأول فإنّ القيمة الافتراضية له ستكون صفرًا، وإذا حُذف الرقم الثاني فإنّ القيمة الافتراضية تكون طول السلسلة النصية التي سيجري اقتطاعها.

>>> word[:2]   # اقتطاع الحروف من الموقع 0 إلى الموقع 2 (غير مشمول)‏
'Py'
>>> word[4:]   # اقتطاع الحروف من الموقع 4 (مشمول) إلى نهاية السلسلة
'on'
>>> word[-2:]  # الحروف من الموقع 2 من اليمين (مشمول) إلى نهاية السلسلة
'on'

لتتذكّر كيف تجري عملية الاقتطاع يمكنك التفكير في الفهارس وكأنّها فواصل بين الحروف، وتأخذ الحافة اليسرى من الحرف الأول الرقم 0، وتأخذ الحافة اليمنى من الحرف الأخير في السلسلة النصية المكوّنة من n حروف الرقم n، فمثلًا:

 +---+---+---+---+---+---+
 | P | y | t | h | o | n |
 +---+---+---+---+---+---+
 0   1   2   3   4   5   6
-6  -5  -4  -3  -2  -1

يظهر في الصف الأول الأرقام التي تشير إلى مواقع الفهارس في السلسلة النصية 0...6، أما الصفّ الثاني فتشير الأرقام فيه إلى الفهارس السالبة. وتتكون القطعة التي تبدأ بالفهرس i وتنتهي بالفهرس j من جميع الحروف الموجودة بين الحافتين i و j على التوالي.

يكون طول القطعة عند استخدام الفهارس غير السالبة هو الفرق بين الرقمين إن كانا ضمن الحدود، فعلى سبيل المثال طول القطعة word[1:3]‎ هو 2.

تؤدي محاولة استخدام فهرس كبير جدًّا (يتجاوز طول السلسلة النصية) إلى حدوث خطأ:

>>> word[42]  # السلسلة النصية فيها 6 محارف فقط
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
IndexError: string index out of range

ولكن لا تظهر هذه الأخطاء عند اقتطاع السلاسل النصية:

>>> word[4:42]
'on'
>>> word[42:]
''

السلاسل النصية في بايثون غير قابلة للتعديل (immutable)؛ لذا فإنّ إسناد قيمة إلى موقع مفهرس ضمن السلسلة سيؤدي إلى حدوث خطأ:

>>> word[0] = 'J'
  ...
TypeError: 'str' object does not support item assignment
>>> word[2:] = 'py'
  ...
TypeError: 'str' object does not support item assignment

إن كنت ترغب في تغيير السلسلة النصية، فيجب إنشاء واحدة جديدة:

>>> 'J' + word[1:]
'Jython'
>>> word[:2] + 'py'
'Pypy'

تعيد الدالة الداخلية len()‎ طول السلسلة النصية:

>>> s = 'supercalifragilisticexpialidocious'
>>> len(s)
34

التحويل إلى سلسلة نصية

تستخدم الدالة str()‎ لتحويل الكائنات إلى سلاسل نصية، وتعيد سلسلة فارغة في حال عدم تقديم كائن لها. تعيد الدالة str(object)‎ التابع object.__str__()‎ وهو عبارة عن تمثيل للكائن على هيئة سلسلة نصية قابلة للطباعة ومنسّقة بصورة جيدة. إن كان الكائن سلسلة نصية فإنّ الدالة تعيد السلسلة النصّية ذاتها. إن لم يمتلك الكائن تابع ‎__str__()‎ فإنّ الدالة str()‎ ستتراجع (fall back) إلى الدالة repr(object)‎.

>>> str()
''
>>> str(3)
'3'
>>> str(set())
'set()'
>>> str([1])
'[1]'
>>> x = [1, 2, 3]
>>> str(x)
'[1, 2, 3]'
>>> y = 2-3j
>>> str(y)
'(2-3j)
>>> z = "Python"
>>> str(z)
'Python'

الدوال التابعة للكائن str

يدعم الكائن str جميع العمليات المشتركة بين أنواع التسلسلات في بايثون، إضافة إلى بعض الدوال الخاصة:

str.capitalize()‎

تعيد الدالة نسخة من السلسلة النصية مع تحويل الحرف الأول إلى حرف كبير، والأحرف الباقية إلى أحرف صغيرة.

str.casefold()‎

تعيد هذه الدالة السلسلة النصية بحالة casefolded، ويمكن استخدام هذا النوع من السلاسل لإجراء المقارنة دون الاعتماد على حالة الأحرف.

str.center()‎

تعيد الدالة أحرف السلسلة النصية مزاحة نحو الوسط ضمن سلسلة نصّية ذات طول محدّد.

str.count()‎

تعيد هذه الدالة عدد مرات ظهور سلسلة نصية فرعية ضمن السلسلة الأصلية.

str.encode()‎

تعيد الدالة نسخة مرمّزة من السلسلة النصية على هيئة بايتات.

str.endswith()‎

تتحقّق الدالة من وجود سلسلة نصية فرعية في نهاية السلسلة النصية الأصلية.

str.expandtabs()‎

تعيد الدالة ‎ نسخة من السلسلة النصية بعد تحويل جميع علامات الجدولة إلى مسافة بيضاء واحدة أو أكثر.

str.find()‎

تعيد الدالة أدنى قيمة للفهرس في السلسلة النصية والذي تكون السلسلة الفرعية موجودة فيه ضمن الجزء المقتطع من السلسلة.

str.format()‎

تؤدي هذه الدالة عمليات التنسيق على السلسلة النصية بواسطة معاملات موضعية أو مفتاحية.

str.format_map()‎

تؤدّي هذه الدالة عمليات التنسيق على السلسلة النصية بواسطة قاموس.

str.index()‎

تؤدي هذه الدالة نفس وظيفة الدالة str.find()‎ ولكنّها تطلق الخطأ ValueError إن لم تعثر على السلسلة الفرعية.

str.isalnum()‎

تتحقّق هذه الدالة ممّا إذا كانت السلسلة النصية تضمّ حروفًا وأرقامًا وأنّها تضمّ حرفًا واحدًا على الأقل.

str.isalpha()‎

تتحقّق الدالة ممّا إذا كانت السلسلة النصية مكوّنة من الحروف فقط، وأنّ فيها حرفًا واحدًا على الأقل.

str.isdecimal()‎

تحقّق الدالة ممّا إذا كانت السلسلة النصية مكوّنة من حروف الأعداد العشرية فقط، وأنّ فيها حرفًا واحدًا على الأقل.

str.isdigit()‎

تتحقّق الدالة ممّا إذا كانت السلسلة النصية مكوّنة من حروف الأعداد (digits) فقط، وأنّ فيها حرفًا واحدًا على الأقل.

str.isidentifier()‎

تتحقّق الدالة ممّا إذا كانت السلسلة النصية تتضمّن معرّفًا صحيحًا (identifier) في لغة بايثون.

str.islower()‎

تتحقّق الدالة ممّا إذا كانت حروف السلسلة النصية حروفًا صغيرة lower case.

str.isnumeric()‎

تتحقّق الدالة ممّا إذا كانت جميع الحروف في السلسلة النصية حروفًا عددية، وأنّ هناك حرفًا واحدًا على الأقل في تلك السلسلة.

str.isprintable()‎

تتحقّق الدالة ممّا إذا كانت جميع الحروف في السلسلة النصية قابلة للطباعة أو أن السلسلة النصية فارغة.

str.isspace()‎

تحقّق الدالة ممّا إذا كانت السلسلة النصية مكوّنة من حروف مسافات بيضاء فقط وأنّ في السلسلة حرفًا واحدًا على الأقل.

str.istitle()‎

تتحقّق الدالة ممّا إذا كانت أوائل الكلمات في السلسلة النصية حروفًا كبيرة (titlecased).

str.isupper()‎

تتحقّق الدالة ممّا إذا كانت جميع الحروف في السلسلة النصية حروفًا كبيرة.

str.join()‎

تعيد الدالة السلسلة النصية الناتجة عن ربط السلاسل النصية التابعة لكائن قابل للتكرار (iterable).

str.ljust()‎

تعيد الدالة أحرف السلسلة النصية مزاحة نحو اليسار ضمن سلسلة نصّية ذات طول محدّد.

str.lower()‎

تحول الدالة جميع الحروف في السلسلة النصية إلى حروف صغيرة.

str.lstrip()‎

تحذف الدالة الحروف التي يحدّدها المستخدم من بداية السلسلة النصية.

str.maketrans()‎

تعيد هذه الدالة الساكنة جدول ترجمة يمكن استخدامه بواسطة الدالة str.translate().

str.partition()‎

تقسم هذه الدالة السلسلة النصية عند أول ظهور للقيمة التي يحدّدها المستخدم.

str.replace()‎

تبدّل هذه الدالة العبارة التي يختارها المستخدم - مهما تكرّرت في السلسلة النصية - بالقيمة الجديدة التي يحدّدها.

str.rfind()‎

تعيد الدالة أعلى قيمة للفهرس في السلسلة النصية حيث تجد فيه السلسلة النصية الفرعية.

str.rindex()‎

تعيد الدالة أعلى قيمة للفهرس في السلسلة النصية حيث تجد فيه السلسلة النصية الفرعية.

str.rjust()‎

تعيد الدالة أحرف السلسلة النصية مزاحة نحو اليمين ضمن سلسلة نصّية ذات طول محدّد.

str.rpartition()‎

تقسم هذه الدالة السلسلة النصية عند آخر ظهور للقيمة التي يحدّدها المستخدم.

str.rsplit()‎

تحوّل هذه الدالة السلسلة النصية من جهة اليمين إلى قائمة من السلاسل النصية بالاعتماد على الفاصل الذي يحدّده المستخدم.

str.rstrip()‎

تحذف الدالة الحروف التي يحدّدها المستخدم من نهاية السلسلة النصية.

str.split()‎

تقسّم الدالة السلسلة النصية إلى قائمة من السلاسل النصية بالاعتماد على فاصل محدّد.

str.splitlines()‎

تقسم الدالة السلسلة النصية إلى قائمة من الأسطر.

str.startswith()‎

تتحقّق الدالة من أنّ السلسلة النصية تبدأ بالقيمة التي يحدّدها المستخدم.

str.strip()‎

تحذف الدالة الحروف المحدّدة من قبل المستخدم من نهاية وبداية السلسلة النصية.

str.swapcase()‎

تقلب الدالة‎ حالة الحروف في السلسلة النصية.

str.title()‎

تحوّل الدالة‎ أوائل الكلمات في السلسلة النصية إلى أحرف كبيرة Title Case.

str.translate()‎

تعيد الدالة‎ الحروف في السلسلة النصية بالاعتماد على جدول الترجمة translation table.

str.upper()‎

تحوّل الدالة‎ الحروف في السلسلة النصية إلى حروف كبيرة.

str.zfill()‎

تضيف الدالة‎ أصفارًا من الترميز ASCII إلى يسار السلسلة النصية لتصبح السلسلة بالطول المحدد من قبل المستخدم.

انظر أيضًا

مصادر