عرض مصدر Python/str/casefold

<noinclude>{{DISPLAYTITLE:التابع <code>casefold()‎</code> في بايثون}}</noinclude>
يعيد هذا التابع السلسلة النصية بحالة casefolded، ويمكن استخدام هذا النوع من السلاسل لإجراء المقارنة دون الاعتماد على حالة الأحرف.

== البنية العامة ==
<syntaxhighlight lang="python3">
x.casefold()
</syntaxhighlight>

== القيمة المعادة ==
تعيد هذه الدالة السلسلة النصية بحالة casefolded (جميع الحروف تكون حروفًا صغيرة).

== توضيح ==
تشبه عملية Casefolding عملية التحويل إلى الحروف الصغيرة lowercasing ولكن بشدّة أكبر؛ وذلك لأنّها تزيل جميع الفوارق ضمن [[Python/str|السلسلة النصية]]. فعلى سبيل المثال الحرف الألماني الصغير <code>'ß'</code> مكافئ للحرفين <code>"ss"</code>، ولما كان هذا الحرف صغيرًا في الأصل، فإنّ استخدام الدالة <code>[[Python/str/lower|lower()]]</code>‎ لن يغير من الأمر شيئًا، ولكن الدالة <code>casefold()</code>‎ ستحوّل هذا الحرف إلى <code>"ss"</code>.

يمكن الاطلاع على خوارزمية casefolding في الفصل 3.13 من معايير الترميز الموحد Unicode.

'''ملاحظة:''' هذا التابع جديدٌ في الإصدار 3.3.

== أمثلة ==
يوضّح المثال التالي مخرجات التابع <code>casefold()</code>‎:<syntaxhighlight lang="python3">
>>> word = "Hello WORLD"
>>> word.casefold()
'hello world'
>>> gword = "Süßigkeit"
>>> gword.casefold()
'süssigkeit'
</syntaxhighlight>

== انظر أيضًا ==
* [[Python/str|السلاسل النصية في بايثون.]]
* التابع <code>[[Python/str/capitalize|str.capitalize()‎]]</code>: إعادة نسخة من السلسلة النصية مع تحويل الحرف الأول إلى حرف كبير، والأحرف الباقية إلى أحرف صغيرة.
* التابع <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>[[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>: التحقق ممّا إذا كانت حروف السلسلة النصية حروفًا صغيرة (lowercase).
* التابع <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 إلى يسار السلسلة النصية لتصبح السلسلة بالطول المحدد من قبل المستخدم.

== مصادر ==
* [https://docs.python.org/3/library/stdtypes.html#str.casefold قسم casefold في صفحة Types في توثيق بايثون الرسمي.]
[[تصنيف:Python]]
[[تصنيف:Python Method]]
[[تصنيف:Python Types]]
[[تصنيف:Python Str]]