نتائج البحث

يقسم هذا التابع السلسلة النصية عند آخر ظهور للقيمة التي يحدّدها المستخدم. البنية العامة x.rpartition() المعاملات sep يحدّد هذا المعامل الفاصل الذي سيعتمده التابع في تقسيم السلسلة النصية. القيمة المعادة يعيد هذا التابع صفًّا مكوّنًا من ثلاثة عناصر، الأول هو جزء السلسلة الذي يسبق الفاصل، والثاني هو الفاصل نفسه، والثالث هو الجزء الذي يلي الفاصل. في حال عدم العثور على الفاصل تعيد الدالة صفًّا مكوّنًا من ثلاثة عناصر، الأوّل هو السلسلة النصية نفسها، يليها سلسلتان فارغتان. أمثلة يبين المثال التالي ...

يستخدم التابع str.format()‎ والصنف Formatter صيغة سلاسل التنسيق النصية ذاتها، (ولكن يمكن للأصناف الفرعية في الصنف Formatter أن تعرّف الصيغة الخاصّة بها). ترتبط هذه الصيغة بحروف سلاسل التنسيق النصية، ولكن هناك بعض الاختلافات. تتضمّن سلاسل التنسيق "حقول استبدال" محاطة بالأقواس المعقوفة {}، ويعدّ كل شيء خارج هذه الأقواس حرفًا اعتياديًا ويُنسخ إلى المخرجات دون أي تعديل. إن كانت هناك حاجة إلى استخدام الأقواس المعقوفة ضمن النص فيمكن تهريبها بمضاعفتها: {{ و }}. الصيغة العامة لحقل الاستبدال الصيغة العامة لحقل الاستبدال ...

enumeration هو مجموعة من الأسماء الرمزية (العناصر) المرتبطة بقيم ثابتة وفريدة. يمكن مقارنة عناصر enumeration عن طريق هويتها، ويمكن المرور على عناصر enumeration بواسطة حلقة تكرارية. وحدة enum تقدّم وحدة enum أربعة أصناف enumeration يمكن استخدامها لتعريف مجموعة فريدة من الأسماء والقيم، وهذه الأصناف هي: Enum و IntEnum و Flag و IntFlag. وإلى جانب ما سبق تقدّم الوحدة مزخرفًا واحدًا هو unique()‎، وصنفًا مساعدًا واحدًا هو auto. الصنف enum.Enum هو الصنف الأساسي والذي يستخدم لإنشاء ثوابت معدّدة enumerated constants. راجع ...

تمتلك عبارة try جزءًا اختياريًا آخر، والهدف منه هو تعريف أحداث تنظيف (clean-up actions) يجب تنفيذها في جميع الظروف، فعلى سبيل المثال: >>> try: ...     raise KeyboardInterrupt ... finally: ...     print('Goodbye, world!') ... Goodbye, world! KeyboardInterrupt Traceback (most recent call last):   File "<stdin>", line 2, in <module> تُنفّذ عبارة finally دائمًا قبل الخروج من عبارة try، سواء أحدث الاستثناء أم لم يحدث. وعند حدوث استثناء في عبارة try ولم تجر معالجته بواسطة عبارة except (أو أنّه حدث في عبارة except أو else) فإنّه يعاد إطلاق ذلك ...

تمتلك عبارة try جزءًا اختياريًا آخر، والهدف منه هو تعريف أحداث تنظيف (clean-up actions) يجب تنفيذها في جميع الظروف، فعلى سبيل المثال: >>> try: ...     raise KeyboardInterrupt ... finally: ...     print('Goodbye, world!') ... Goodbye, world! KeyboardInterrupt Traceback (most recent call last):   File "<stdin>", line 2, in <module> تُنفّذ عبارة finally دائمًا قبل الخروج من عبارة try، سواء أحدث الاستثناء أم لم يحدث. وعند حدوث استثناء في عبارة try ولم تجر معالجته بواسطة عبارة except (أو أنّه حدث في عبارة except أو else) فإنّه يعاد إطلاق ذلك ...

تتيح وحدة fractions التعامل مع الأعداد الكسرية وإجراء العمليات الحسابية المختلفة عليها. يمكن إنشاء نسخة من الكائن Fraction باستخدام زوج من الأعداد الصحيحة أو من عدد كسري آخر أو من سلسلة نصية. class fractions.Fraction(numerator=0, denominator=1) class fractions.Fraction(other_fraction) class fractions.Fraction(float) class fractions.Fraction(decimal) class fractions.Fraction(string) في السطر الأول من المثال السابق جرى استخدام زوج من الأعداد الصحيحة لإنشاء نسخة جديدة من الصنف Fraction. يجب أن يكون كلّ من البسط numerator والمقام denominator نسخًا من الصنف numbers.Rational ونحصل بذلك على نسخة جديدة من الصنف Fraction تحمل القيمة (البسط/المقام). ...

تتيح وحدة fractions التعامل مع الأعداد الكسرية وإجراء العمليات الحسابية المختلفة عليها. يمكن إنشاء نسخة من الكائن Fraction باستخدام زوج من الأعداد الصحيحة أو من عدد كسري آخر أو من سلسلة نصية. class fractions.Fraction(numerator=0, denominator=1) class fractions.Fraction(other_fraction) class fractions.Fraction(float) class fractions.Fraction(decimal) class fractions.Fraction(string) في السطر الأول من المثال السابق جرى استخدام زوج من الأعداد الصحيحة لإنشاء نسخة جديدة من الصنف Fraction. يجب أن يكون كلّ من البسط numerator والمقام denominator نسخًا من الصنف numbers.Rational ونحصل بذلك على نسخة جديدة من الصنف Fraction تحمل القيمة (البسط/المقام). ...

 الصنف pathlib.PurePath في بايثون يحوي هذا الصنف التوابع والعمليات الأساسية للتعامل مع المسارات، إلا أنها لا تحوي أي وصول حقيقي إلى نظام الملفات، ومن ثمّ فليس فيها أي عملية إدخال أو إخراج بل تقتصر على العمليات النصية على المسارات، ويمكننا تلخيص عملها بأنها توابع لمعالجة السلاسل النصية التي تمثل مسارات الملفات. يمكن للمسارات النقية أن تكون مفيدةٌ في بعض الحالات الخاصة المماثلة لما يلي: لمعالجة مسارات نظام ويندوز أثناء العمل على جهاز يعمل بنظام يونكس (والعكس بالعكس)، حيث لا يمكنك ...

العدد الصحيح integer هو أي عدد موجب أو سالب لا يتضمن فاصلة عشرية، ويمكن تمثيله بالنظام العشري (decimal، الأساس 10) والست عشري (hexadecimal، الأساس 16) والثماني (octal، الأساس 8) والثنائي (binary، الأساس 2). يجب أن يكون العدد الصحيح مسبوقًا بالقيمة 0o لاستخدامه في النظام الثماني، وبالقيمة 0x لاستخدامه في النظام الست عشري، وبالقيمة 0b لاستخدامه في النظام الثنائي، وفيما يلي مجموعة من الأمثلة: >>> q = 3571 # عدد صحيح في النظام العشري >>> q ...

العدد الصحيح integer هو أي عدد موجب أو سالب لا يتضمن فاصلة عشرية، ويمكن تمثيله بالنظام العشري (decimal، الأساس 10) والست عشري (hexadecimal، الأساس 16) والثماني (octal، الأساس 8) والثنائي (binary، الأساس 2). يجب أن يكون العدد الصحيح مسبوقًا بالقيمة 0o لاستخدامه في النظام الثماني، وبالقيمة 0x لاستخدامه في النظام الست عشري، وبالقيمة 0b لاستخدامه في النظام الثنائي، وفيما يلي مجموعة من الأمثلة: >>> q = 3571 # عدد صحيح في النظام العشري >>> q ...

هذه الدالة هي المسؤولة الحقيقية عن جميع عمليات التنسيق، وهي دالة مكشوفة (exposed) كدالة منفصلة لاستخدامها في الحالات التي يكون المطلوب فيها تمرير قاموس معاملات معرّف مسبقًا، بدلًا عن فك تحزيم القاموس وإعادة تحزيمه مرة أخرى كمعاملات منفردة باستخدام الصيغتين ‎*args و ‎**kwargs. البنية العامة vformat(format_string, args, kwargs) طريقة عمل الدالة تؤدي هذه الدالة مهمّة تقسيم سلسلة التنسيق النصية إلى بيانات حرفية وحقول استبدال، وتستدعي جميع التوابع التالية: parse(format_string)‎ يمرّ هذا التابع على سلسلة التنسيق النصية الممرّرة بواسطة المعامل format_string ...

تتضمّن هذه الوحدة أنواع بيانات متخصّصة بالحاويات container وتقدّم بدائل للحاويات الداخلية dict و list و set و tuple. تقدّم هذه الوحدة الكائنات التالية: namedtuple دالة مولِّدة factory function لإنشاء أصناف فرعية من صفٍّ يتضمن حقولًا مسمّاة deque حاوية شبيهة بالقوائم تمتاز بأدائها السريع في إضافة العناصر وحذفها في كلا الطرفين. ChainMap صنف شبيه بالقواميس يستخدم لإنشاء عرض منفرد لعمليات ربط mapping متعددة Counter صنف فرعي من الصنف dict الهدف منه عدّ الكائنات القابلة للتقطيع hashable OrderedDict صنف فرعي من ...

تستخدم الدالة الداخلية dir()‎ لمعرفة الأسماء التي تعرّفها الوحدة، وتعيد هذه الدالة قائمة مرتّبة من السلاسل النصية: >>> import fibo, sys >>> dir(fibo) ['__name__', 'fib', 'fib2'] >>> dir(sys) ['__displayhook__', '__doc__', '__excepthook__', '__loader__', '__name__', '__package__', '__stderr__', '__stdin__', '__stdout__', '_clear_type_cache', '_current_frames', '_debugmallocstats', '_getframe', '_home', '_mercurial', '_xoptions', 'abiflags', 'api_version', 'argv', 'base_exec_prefix', 'base_prefix', 'builtin_module_names', 'byteorder', 'call_tracing', 'callstats', 'copyright', 'displayhook', 'dont_write_bytecode', 'exc_info', 'excepthook', 'exec_prefix', 'executable', 'exit', 'flags', 'float_info', 'float_repr_style', 'getcheckinterval', 'getdefaultencoding', 'getdlopenflags', 'getfilesystemencoding', 'getobjects', 'getprofile', 'getrecursionlimit', 'getrefcount', 'getsizeof', 'getswitchinterval', 'gettotalrefcount', 'gettrace', 'hash_info', 'hexversion', 'implementation', 'int_info', 'intern', 'maxsize', ...

يمثل كائن التاريخ date تاريخًا (سنة وشهر ويوم) في التقويم المثالي، وهو التقويم الميلادي الممتدّ إلى ما لا نهاية في كلا الاتجاهين، ويمثّل اليوم ذو التاريخ 1 كانون الثاني (يناير) سنة 1 ميلادي اليوم ذا العدد 1 في هذا الكائن، واليوم ذو التاريخ 2 كانون الثاني (يناير) سنة 1 ميلادي اليوم ذا العدد 2 في هذا الكائن، وهكذا دواليك. يطابق هذا الترقيم تعريف "التقويم الكريكوري التنبؤي proleptic Gregorian" والذي وضعه كلّ من Dershowitz و Reingold في كتابهما Calendrical Calculations والذي ...

قد تكون التعابير البرمجية في الشيفرة صحيحة من ناحية الصيغة، لكن قد يؤدي تنفيذ تلك الشيفرة إلى التسبب في حدوث الأخطاء. تسمّى الأخطاء المُكتشفة أثناء تنفيذ الشيفرة بالاستثناءات (exceptions) وقد تتسبب في إيقاف عمل البرنامج (fatal) في بعض الأحيان. صيغة الاستثناءات تُنشئ الاستثناءات رسائل خطإٍ مماثلة لما يلي: >>> 10 * (1/0) Traceback (most recent call last):   File "<stdin>", line 1, in <module> ZeroDivisionError: division by zero >>> 4 + spam*3 Traceback (most recent call last):   File "<stdin>", line 1, in <module> NameError: name 'spam' ...

تقدّم هذه الوحدة عددًا من الدوال المساعدة لإنشاء أنواع بيانات جديدة بصورة ديناميكية، إضافة إلى أنّها تعرّف أسماءً لبعض أنواع الكائنات التي يستخدمها مفسّر بايثون المعياري، ولكنّها ليست كائنات داخلية مثل int أو str، إلى جانب أنّ هذه الوحدة تقدم بعض الأصناف والدوال المساعدة الخاصة ببعض الأنواع، والتي لا تعدّ أساسية بما يكفي لتصبح أصنافًا ودوالّ داخلية. إنشاء الأنواع ديناميكيًا تقدّم هذه الوحدة ثلاث دوالّ تساعد في إنشاء أنواع البيانات ديناميكيًا: الدالة types.new_class()‎‎ تنشئ هذه الدالة ديناميكيًا كائن صنف باستخدام ...

يعيد هذا التابع السلسلة النصية بحالة casefolded، ويمكن استخدام هذا النوع من السلاسل لإجراء المقارنة دون الاعتماد على حالة الأحرف. البنية العامة x.casefold() القيمة المعادة تعيد هذه الدالة السلسلة النصية بحالة casefolded (جميع الحروف تكون حروفًا صغيرة). توضيح تشبه عملية Casefolding عملية التحويل إلى الحروف الصغيرة lowercasing ولكن بشدّة أكبر؛ وذلك لأنّها تزيل جميع الفوارق ضمن السلسلة النصية. فعلى سبيل المثال الحرف الألماني الصغير 'ß' مكافئ للحرفين "ss"، ولما كان هذا الحرف صغيرًا في الأصل، فإنّ استخدام الدالة lower()‎ لن ...

يجري هذا التابع عمليات التنسيق على السلسلة النصية بواسطة قاموس. البنية العامة x.format_map() المعاملات mapping قاموس تستخدمه الدالة لتنسيق السلسلة النصية. القيمة المعادة يعيد هذا التابع السلسلة النصية بعد إجراء عمليات التنسيق عليها بواسطة القاموس الممرّر في الوسائط. يشبه هذا التابع في عمله التابعَ str.format(**mapping)‎، باستثناء أنّ التابع str.format_map()‎ يستخدم المعامل mapping مباشرة ولا ينسخه إلى قاموس جديد. ملاحظة: هذا التابع جديدٌ في الإصدار 3.2 من اللغة. أمثلة يستخدم المثال التالي قاموسًا لتنسيق السلسلة النصية: >>> name = {'first': 'Samir', ...

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

تستخدم "مواصفات التنسيق" ضمن حقول الاستبدال الموجودة في سلاسل التنسيق النصية لتحديد طريقة تمثيل القيم المفردة فيها. ويمكن تمرير هذه المعايير مباشرة إلى الدالة الداخلية format()‎. ويمكن لكل نوع من أنواع جداول التنسيق formattable أن يحدّد الطريقة التي ستُفسَّر بها معايير التنسيق هذه. صيغة التنسيق تعتمد معظم الأنواع الداخلية في بايثون الخيارات التالية كمواصفات للتنسيق، ولكن بعض الخيارات مدعومة بواسطة الأنواع العددية فقط. يؤدي استخدام سلسلة تنسيق نصية فارغة ("") في العادة إلى الحصول على نفس النتيجة المستحصلة من استدعاء ...

يُقسِّم هذا التابع السلسلة النصية إلى قائمة من الأسطر. البنية العامة x.splitlines() المعاملات keepends قيمة منطقية (Boolean). تُدرج فواصل الأسطر في القائمة المعادة عندما يأخذ هذا المعامل القيمة True. القيمة المعادة يعيد التابع قائمة من الأسطر التي تكوّن السلسلة النصية، وتجري عملية التقسيم عند حدود الأسطر، ولا تُدرج فواصل الأسطر في القائمة المعادة إلا إذا أخذ المعامل keepends القيمة True. يقسم التابع السلاسل النصية عند حدود الأسطر التالية: الفاصل الوصف ‎\n محرف السطر الجديد (Line Feed). ‎\r محرف العودة إلى ...

يعيد التابع‎ الحروف في السلسلة النصية بالاعتماد على جدول التحويل (translation table). البنية العامة x.translate() المعاملات table يجب أن يكون الجدول كائنًا يؤدي عملية الفهرسة (indexing) باستخدام التابع __getitem()‎__ وعادة ما يكون تسلسلًا أو قاموسًا. (راجع التابع str.maketrans()‎ للمزيد من المعلومات حول كيفية إنشاء هذا الجدول). القيمة المعادة يعيد التابع نسخة من السلسلة النصية بعد استبدال الحروف بالاعتماد على جدول الترجمة. عند فهرسة كائن الجدول حسب رتب الترميز الموحد (أعداد صحيحة) يمكن للكائن أن يؤدي ما يلي: إعادة رتبة ترميز ...

يتحقّق هذا التابع ممّا إذا كانت السلسلة النصية تضمّ حروفًا وأرقامًا وأنّها تضمّ حرفًا واحدًا على الأقل. البنية العامة x.isalnum() القيمة المعادة يعيد التابع القيمة True إن كانت جميع الحروف في السلسلة النصية حرفية ورقمية وأنّ هناك على الأقل حرفًا واحدًا فيها، ويعيد القيمة False فيما عدا ذلك. يكون الحرف c حرفيًا ورقميًا إن أعادت إحدى الدوال التالية القيمة True: ‏‎c.isalpha()، أو c.isdecimal()، أو c.isdigit()‎، أو c.isnumeric()‎. أمثلة يبيّن المثال التالي النتائج المعادة من تطبيق التابع isalnum()‎ على أنواع مختلفة ...

يعيد التابع find()‎ أدنى قيمة للفهرس في السلسلة النصية والذي تكون السلسلة الفرعية موجودة فيه ضمن الجزء المقتطع من السلسلة. البنية العامة x.find() المعاملات sub السلسلة الفرعية المراد معرفة موقعها. start الموقع الذي يبدأ منه التابع عملية البحث ضمن السلسلة الأصلية. end الموقع الذي ينهي فيه التابع عملية البحث ضمن السلسلة الأصلية. يسلك هذان المعاملان نفس السلوك المتّبع في عملية اقتطاع السلاسل النصية slicing. القيمة المعادة يعيد التابع أدنى قيمة للفهرس في السلسلة النصية حيث تكون السلسلة الفرعية sub موجودة ...

يحذف التابع الحروف التي يحدّدها المستخدم من بداية السلسلة النصية. البنية العامة x.lstrip() المعاملات chars سلسلة نصية تحدّد مجموعة الحروف المراد حذفها من السلسلة النصية الهدف. في حال عدم تمرير هذا المعامل أو تمرير القيمة None، تحذف الدالة المسافات البيضاء من بداية السلسلة النصية. يحذف التابع أي مزيج من الحروف الموجودة في chars. القيمة المعادة يعيد التابع نسخةً من السلسلة النصية بعد حذف الحروف التي يحدّدها المستخدم من بداية السلسلة النصية. أمثلة يوضح المثال التالي النتائج المعادة من تطبيق هذا ...

يقسّم هذا التابع السلسلة النصية إلى قائمة من السلاسل النصية بالاعتماد على فاصل محدّد. البنية العامة x.split() المعاملات maxsplit يحدد هذا المعامل الحد الأقصى لعمليات التي التقسيم التي سيجريها التابع، وبهذا تمتلك القائمة المعادة maxsplit+1 من العناصر على الأكثر. في حال عدم تحديد قيمة المعامل maxsplit أو كانت قيمته -1، فلن يكون هناك حدّ لعمليات التقسيم (سيجري التابع جميع عمليات التقسيم الممكنة). sep يحدّد هذا المعامل الفاصل الذي سيعتمده التابع في تقسيم السلسلة النصية. في حال تحديد قيمة هذا المعامل ...

يعيد التابع center()‎ أحرف السلسلة النصية مزاحة نحو الوسط ضمن سلسلة نصّية ذات طول محدّد. البنية العامة x.center() المعاملات width يحدّد هذا المعامل طول السلسلة المعادة. fillchar يحدّد هذا المعامل الحرف الذي ستستخدمه الدالة لإجراء عملية الإزاحة، ويأخذ هذا المعامل قيمة افتراضية هي المسافة البيضاء في ترميز ASCII.  القيمة المعادة تعيد الدالة أحرف السلسلة النصية مزاحة نحو الوسط ضمن سلسلة نصّية ذات عرض محدّد، وتزاح الحروف باستخدام حرف يحدّده المستخدم. إذا كانت القيمة المحدّدة للمعامل width أقل من أو تساوي القيمة ...

يقلب التابع‎ حالة الحروف في السلسلة النصية. البنية العامة x.swapcase() القيمة المعادة يعيد التابع سلسلة نصية بعد قلب حالة الحروف فيها، أي تصبح الحروف الكبيرة صغيرة، وتصبح الحروف الصغيرة كبيرة. ملاحظة: ليس بالضرورة أن يعيد التعبير s.swapcase()‎.swapcase()‎ سلسلة نصية مطابقة للسلسلة النصية الأصلية. أمثلة يبيّن المثال التالي النتائج المعادة من تطبيق هذا التابع على السلاسل النصية: >>> str = "Python Programming Language" >>> str.swapcase() 'pYTHON pROGRAMMING lANGUAGE' انظر أيضًا السلاسل النصية في بايثون. التابع str.capitalize()‎: إعادة نسخة من السلسلة النصية مع تحويل ...

يعيد التابع أعلى قيمة للفهرس في السلسلة النصية حيث تجد فيه السلسلة النصية الفرعية. البنية العامة x.rindex() المعاملات sub السلسلة الفرعية المراد معرفة موقعها. start الموقع الذي يبدأ منه التابع عملية البحث ضمن السلسلة الأصلية. end الموقع الذي ينهي فيه التابع عملية البحث ضمن السلسلة الأصلية. يسلك هذان المعاملان نفس السلوك المتّبع في عملية اقتطاع السلاسل النصية slicing. القيمة المعادة يعيد هذا التابع أعلى قيمة للفهرس في السلسلة النصية حيث تجد فيه السلسلة النصية الفرعية، بحيث تكون السلسلة النصية الفرعية ...

يتحقّق التابع ممّا إذا كانت جميع الحروف في السلسلة النصية حروفًا عددية، وأنّ هناك حرفًا واحدًا على الأقل في تلك السلسلة. البنية العامة x.isnumeric() القيمة المعادة يعيد هذا التابع القيمة True إذا كانت جميع الحروف في السلسلة النصية حروفًا عددية، وكان هناك على الأقل حرف واحد في السلسلة، ويعيد القيمة False فيما عدا ذلك. يقصد بالحروف العددية الأعداد وجميع الحروف التي تمتلك خاصية قيمة عددية في الترميز الموحّد، مثل U+2155 والذي يرمز إلى الكسر VULGAR FRACTION ONE FIFTH.  وبصورة عامة، ...

يعيد التابع join()‎ السلسلة النصية الناتجة عن ربط السلاسل النصية التابعة لكائن قابل للتكرار (iterable). البنية العامة x.join() المعاملات iterable كائن قابل للتكرار مثل الصفوف، والقواميس، والقوائم، والسلاسل النصية، والمجموعات. القيمة المعادة يعيد التابع join()‎ السلسلة النصية الناتجة عن ربط السلاسل النصية التابعة لكائن قابل للتكرار (iterable). إذا لم يكن أحد عناصر الكائن القابل للتكرار سلسلة نصية تطلق الدالة الخطأ TypeError. أمثلة يبين المثال التالي القيم المعادة من تطبيق التابع على سلاسل مختلفة: >>> s = ["100", "200", "300", "400", ...

يحوّل هذا التابع السلسلة النصية من جهة اليمين إلى قائمة من السلاسل النصية بالاعتماد على الفاصل الذي يحدّده المستخدم. البنية العامة x.rsplit() المعاملات sep يحدّد هذا المعامل الفاصل الذي سيعتمده التابع في تقسيم السلسلة النصية. إن لم يحمل هذا المعامل قيمة أو كان يحمل القيمة None فإنّ الفاصل يكون مسافة بيضاء. maxsplit يحدد هذا المعامل الحد الأقصى لعمليات التي التقسيم التي سيجريها التابع من الجهة اليمنى في السلسلة النصية. القيمة المعادة يعيد التابع قائمة من السلاسل النصية. أمثلة يبين المثال ...

يحوّل التابع جميع الحروف في السلسلة النصية إلى حروف صغيرة. البنية العامة x.lower() القيمة المعادة يعيد التابع نسخةً من السلسلة النصية بعد تحويل جميع الحروف إلى حروف صغيرة. أمثلة يبين المثال التالي النتائج المعادة من استخدام هذا التابع: >>> s = "Hsoub" >>> s.lower() 'hsoub' >>> s = "HSOUB WIKI" >>> s.lower() 'hsoub wiki' انظر أيضًا السلاسل النصية في بايثون. التابع str.capitalize()‎: إعادة نسخة من السلسلة النصية مع تحويل الحرف الأول إلى حرف كبير، والأحرف الباقية إلى أحرف صغيرة. التابع str.casefold()‎: إعادة السلسلة النصية بحالة ...

يتحقّق التابع ممّا إذا كانت حروف السلسلة النصية حروفًا صغيرة (lowercase). البنية العامة x.islower() القيمة المعادة يعيد التابع القيمة True إذا كانت جميع الحروف في السلسلة النصية حروفًا صغيرة وأنّ السلسل تضمّ على الأقل حرفًا واحدًا يمكن أن يأخذ حالات مختلفة (cased)، ويعيد القيمة False فيما عدا ذلك.  أمثلة يبيّن المثال التالي النتائج المعادة من استخدام هذا التابع: >>> string = "Python" >>> string.islower() False >>> string = "django" >>> string.islower() True انظر أيضًا السلاسل النصية في بايثون. التابع str.capitalize()‎: إعادة نسخة من السلسلة النصية ...

يعيد التابع expandtabs()‎ نسخة من السلسلة النصية بعد تحويل جميع علامات الجدولة إلى مسافة بيضاء واحدة أو أكثر. البنية العامة x.expandtabs() المعاملات tabsize يحدّد مواقع علامات الجدولة في السلسلة النصية (القيمة الافتراضية هي 8، فتكون مواقع علامات الجدولة في الأعمدة 0، 8، 16 وهكذا). القيمة المعادة يعيد التابع expandtabs()‎ نسخة من السلسلة النصية بعد تحويل جميع علامات الجدولة إلى مسافة بيضاء واحدة أو أكثر وذلك بالاعتماد على العمود الحالي وحجم علامة الجدولة المحدد بواسطة المعامل tabsize. توضيح يعمل التابع بجعل ...

يتحقّق التابع ممّا إذا كانت السلسلة النصية تتضمّن معرّفًا صحيحًا (identifier) في لغة بايثون. البنية العامة x.isidentifier() القيمة المعادة يعيد التابع القيمة True إن كانت السلسلة النصية معرّفًا صحيحًا في بايثون، ويعيد القيمة False فيما عدا ذلك. ضمن الترميز ASCII تسمح الإصدارات ‎2.x‎ من بايثون باستخدام الحروف A إلى Z و a إلى z و 0 إلى 9 والشرطة السفلية _ شرط أن لا تكون الشرطة الحرف الأول في المعرّف. قدّم الإصدار 3.0 من بايثون إمكانية استخدام الترميز Unicode لتسمية ...

يعيد التابع أحرف السلسلة النصية مزاحة نحو اليسار ضمن سلسلة نصّية ذات طول محدّد. البنية العامة x.ljust() المعاملات width يحدّد هذا المعامل طول السلسلة المعادة. fillchar يحدّد هذا المعامل الحرف الذي ستستخدمه الدالة لإجراء عملية الإزاحة، ويأخذ هذا المعامل قيمة افتراضية هي المسافة البيضاء في ترميز ASCII. القيمة المعادة يعيد التابع أحرف السلسلة النصية مزاحة نحو اليسار ضمن سلسلة نصية ذات عرض محدّد، وتزاح الحروف باستخدام حرف يحدّده المستخدم. إذا كانت القيمة المحدّدة للمعامل width أقل من أو تساوي القيمة ...

يعيد هذا التابع نسخة من السلسلة النصية مع تحويل الحرف الأول إلى حرف كبير، والأحرف الباقية إلى أحرف صغيرة. البنية العامة x.capitalize() القيمة المعادة يعيد هذا التابع نسخة من السلسلة النصية مع تحويل الحرف الأول إلى حرف كبير، والأحرف الباقية إلى أحرف صغيرة. أمثلة يوضح المثال التالي النتائج المعادة من هذا التابع: >>> name = 'mohammed' >>> name.capitalize() 'Mohammed' >>> name = 'aHMed' >>> name.capitalize() 'Ahmed' انظر أيضًا السلاسل النصية في بايثون. التابع str.casefold()‎: إعادة السلسلة النصية بحالة casefolded، ويمكن استخدام هذا النوع من السلاسل ...

يتحقّق التابع ممّا إذا كانت جميع الحروف في السلسلة النصية قابلة للطباعة أو أن السلسلة النصية فارغة. البنية العامة str.isprintable() القيمة المعادة يعيد التابع القيمة True إذا كانت جميع الحروف ضمن السلسلة النصية قابلة للطباعة أو كانت السلسلة النصية فارغة، ويعيد القيمة False فيما عدا ذلك. الحروف غير القابلة للطباعة هي تلك التي تعرّف في قاعدة بيانات حروف الترميز الموحد بالمسمّى "Other" أو "Separator" باستثناء المسافة البيضاء (0x20) في ترميز ASCII والتي تعدّ حرفًا قابلًا للطباعة. لاحظ أنّ الحروف القابلة ...

يعيد هذا التابع عدد مرات ظهور سلسلة نصية فرعية ضمن السلسلة الأصلية. البنية العامة x.count() المعاملات sub السلسلة النصية الفرعية المراد معرفة عدد مرات ظهورها ضمن السلسلة الأصلية. start معامل اختياري، يحدد الموقع الذي تبدأ منه الدالة عملية البحث ضمن السلسلة الأصلية. end معامل اختياري، يحدد الموقع الذي تنهي فيه الدالة عملية البحث ضمن السلسلة الأصلية. القيمة المعادة يعيد هذا التابع عدد مرات ظهور سلسلة نصية فرعية ضمن النطاق المحدّد بواسطة المعاملين start و end. يسلك هذان المعاملان نفس السلوك ...

يعيد هذا التابع الساكن جدول تحويل يمكن استخدامه بواسطة التابع str.translate()‎. البنية العامة x.maketrans() المعاملات في حال تمرير معامل واحد فإنّه يجب أن يكون قاموسًا يربط أرقام الحروف في الترميز الموحد (Unicode ordinals) وهي أعداد صحيحة أو الحروف (سلاسل نصية ذات حرف واحد) بأرقام الحروف في الترميز الموحد أو سلاسل نصية (ذات عدد غير محدد من الحروف) أو None. بعد ذلك يجري تحويل مفاتيح الحروف إلى أرقام الحروف في الترميز الموحد Unicode. في حال استخدام معاملين فيجب حينئذ أن يكونا ...

يتحقق هذا التابع من وجود سلسلة نصية فرعية في نهاية السلسلة النصية الأصلية. البنية العامة x.endswith() المعاملات suffix السلسلة الفرعية التي يختبر التابع وجودها في نهاية السلسلة الأصلية. start الموقع الذي يبدأ منه التابع عملية الاختبار ضمن السلسلة الأصلية. end الموقع الذي ينهي فيه التابع عملية المقارنة ضمن السلسلة الأصلية. القيمة المعادة يعيد التابع endswith()‎ القيمة True إن كانت السلسلة النصية تنتهي بالقيمة الممرّرة إلى المعامل suffix، ويعيد القيمة False فيما عدا ذلك، ويمكن للمعامل suffix أن يكون صفًّا tuple ...

يتحقّق هذا التابع من أنّ السلسلة النصية تبدأ بالقيمة التي يحدّدها المستخدم. البنية العامة x.startswith() المعاملات prefix السلسل النصية التي سيبحث عنها التابع. يمكن لهذا المعامل أن يكون صفًّا من السلاسل النصية. start الموقع الذي يبدأ منه التابع عملية الاختبار ضمن السلسلة الأصلية. end الموقع الذي ينهي فيه التابع عملية المقارنة ضمن السلسلة الأصلية. القيمة المعادة يعيد التابع startswith()‎ القيمة True إن كانت السلسلة النصية تبدأ بالقيمة الممرّرة إلى المعامل prefix، ويعيد القيمة False فيما عدا ذلك. أمثلة أمثلة نموذجية ...

يعيد التابع encode()‎ نسخة مرمّزة من السلسلة النصية على هيئة بايتات. البنية العامة x.encode() المعاملات encoding يحدّد هذا المعامل الترميز الذي سيستخدمه التابع في عمله، ويأخذ القيمة الافتراضية 'utf-8'. وللاطلاع على قائمة بالترميزات المتاحة راجع قسم الترميزات القياسية. errors يحدّد المعامل error الطريقة المطلوبة للتعامل مع الأخطاء. يأخذ هذا المعامل القيمة الافتراضية 'strict' والتي تعني أنّه في حال حدوث أخطاء أثناء عملية الترميز فستطلق الدالة الخطأ UnicodeError. يمكن أن يأخذ هذا المعامل قيمًا أخرى هي ‎'ignore'، 'replace'، 'xmlcharrefreplace'، 'backslashreplace'‎ وأي ...

يؤدي هذا التابع نفس وظيفة التابع find()‎ ولكنّه يطلق الخطأ ValueError إن لم يعثر على السلسلة الفرعية. البنية العامة x.find() المعاملات sub السلسلة الفرعية المراد معرفة موقعها. start الموقع الذي تبدأ منه الدالة عملية البحث ضمن السلسلة الأصلية. end الموقع الذي تنهي فيه الدالة عملية البحث ضمن السلسلة الأصلية. يسلك هذان المعاملان نفس السلوك المتّبع في عملية اقتطاع السلاسل النصية slicing. القيمة المعادة يعيد التابع أدنى قيمة للفهرس في السلسلة النصية حيث تكون السلسلة الفرعية sub موجودة في الجزء المقتطع ...

يحوّل هذا التابع أوائل الكلمات في السلسلة النصية إلى أحرف كبيرة (Title Case). البنية العامة s.title() القيمة المعادة يعيد التابع نسخة من السلسلة النصية تكون فيها أوائل الكلمات ذات أحرف كبيرة. أمثلة يوضح المثال التالي النتيجة المعادة من تطبيق هذا التابع على سلسلة نصية: >>> 'Hello world'.title() 'Hello World' توضيح تستخدم الدالة خوارزمية بسيطة لا تعتمد على أي لغة (language-independent)، حيث تعرّف الكلمة على أنّها مجموعة من الحروف المتتابعة. هذا التعريف صالح في معظم السياقات، ولكن في هذا التعريف تشكّل الفاصلة ...

يضيف التابع أصفارًا من الترميز ASCII إلى يسار السلسلة النصية لتصبح السلسلة بالطول المحدد من قبل المستخدم. البنية العامة x.zfill() المعاملات width يحدّد الطول المطلوب للسلسلة النصية بعد إضافة الأصفار. إذا كانت القيمة المحدّدة للمعامل width أقل من أو تساوي القيمة المعادة من len(s)‎، فسيعيد التابع السلسلة الأصلية. في حال تضمّنت السلسلة النصية إحدى السابقتين ('+' / '-') فإنّ الأصفار تضاف بعد السابقة وليس قبلها. القيمة المعادة يعيد التابع نسخةً من السلسلة النصية بعد إضافة أصفار من الترميز ASCII إلى ...

يتحقّق التابع ممّا إذا كانت جميع الحروف في السلسلة النصية حروفًا كبيرة. البنية العامة x.isupper() القيمة المعادة يعيد التابع القيمة True إذا كانت جميع الحروف في السلسلة النصية حروفًا كبيرة، ويعيد القيمة False فيما عدا ذلك. أمثلة يبين المثال التالي القيم المعادة من تطبيق التابع على سلاسل نصية مختلفة: >>> s = "HSOUB" >>> s.isupper() True >>> s = "Hsoub" >>> s.isupper() False انظر أيضًا السلاسل النصية في بايثون. التابع str.capitalize()‎: إعادة نسخة من السلسلة النصية مع تحويل الحرف الأول إلى حرف كبير، والأحرف الباقية ...

يتحقّق التابع ممّا إذا كانت أوائل الكلمات في السلسلة النصية حروفًا كبيرة (titlecased). البنية العامة x.istitle() القيمة المعادة يعيد التابع القيمة True إذا كانت أوائل الكلمات في السلسلة النصية حروفًا كبيرة، ويعيد القيمة False فيما عدا ذلك. أمثلة يبين المثال التالي النتائج المعادة من تطبيق التابع على سلاسل نصية مختلفة: >>> s = "Hsoub Academy" >>> s.istitle() True >>> s = "Hsoub academy" >>> s.istitle() False >>> s = "Python Programming Language" >>> s.istitle() True انظر أيضًا السلاسل النصية في بايثون. التابع str.capitalize()‎: إعادة نسخة من السلسلة النصية ...

يتحقّق التابع ممّا إذا كانت السلسلة النصية مكوّنة من حروف مسافات بيضاء فقط وأنّ في السلسلة حرفًا واحدًا على الأقل. البنية العامة str.isspace() يعيد التابع القيمة True إذا كانت السلسلة النصية تضمّ حروف مسافات بيضاء فقط وكان هناك على الأقل حرف واحد في السلسلة، ويعيد القيمة False فيما عدا ذلك. يقصد بحروف المسافات البيضاء تلك التي تعرّف في قاعدة بيانات حروف الترميز الموحد بالمسمّى "Other" أو "Separator" مثل المسافات (spaces) وعلامات الجدولة (tabs) والسطر الجديد (newline) والحروف التي تمتلك خاصية ثنائي ...