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

<noinclude>{{DISPLAYTITLE:الدالة <code>str.upper()‎</code> في بايثون}}</noinclude>
تحوّل الدالة‎ الحروف في [[Python/str|السلسلة النصية]] إلى حروف كبيرة.

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

<syntaxhighlight lang="python3">
x.upper()
</syntaxhighlight>

== القيمة المعادة ==
يعيد التابع نسخة من [[Python/str|السلسلة النصية]] تكون فيها جميع الحروف التي تمتلك أكثر من حالة حروفًا كبيرة.

'''ملاحظة:''' قد يعيد التعبير <code>str.upper().isupper()</code>‎ القيمة <code>False</code> إذا تضمنّت [[Python/str|السلسلة النصية]] حروفًا لا تمتلك أكثر من حالة، أو إذا لم تكن الحروف الناتجة ضمن فئة "Lu" في الترميز الموحد ولكن كانت ضمن فئة "Lt".

== أمثلة ==
يبين المثال التالي النتائج المعادة من تطبيق الدالة على [[Python/str|سلاسل نصية]] متنوّعة:

<syntaxhighlight lang="python3">
>>> str = "hsoub wiki"
>>> str.upper()
'HSOUB WIKI'
>>> str = "Python3"
>>> str.upper()
'PYTHON3'
>>> str = "بايثون"
>>> str.upper().isupper()
False
>>> str = "hsoub wiki"
>>> str.upper().isupper()
True
</syntaxhighlight>

== انظر أيضًا ==
* [[Python/str/isupper|الدالة isupper()‎ في بايثون.]]
* [[Python/str/lower|الدالة lower()‎ في بايثون.]]
* [[Python/str/title|الدالة title()‎ في بايثون.]]
* [[Python/str/swapcase|الدالة swapcase()‎ في بايثون.]]
* [[Python/str|السلاسل النصية في بايثون.]]

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