Programming Basics SQL HTML CSS JavaScript Python C++ Java JavaFX Swing Problem Solving English English Conversations Computer Fundamentals Learn Typing

بايثونالدوال الثابتة

  • مفهوم الدوال الثابتة
  • أمثلة شاملة

مفهوم الدوال الثابتة

الدالة الثابتة ( Static Method ) هي دالة تابعة لكلاس محدد و يمكن الوصول إليها مباشر منه بدون الحاجة إلى إنشاء كائن منه.

الدالة الثابتة يمكن استدعاءها بشكل مباشر من الكلاس الموضوعة بداخله.

يمكن استدعاء الدالة الثابتة من خلال كائن تم إنشاؤه من الكلاس الذي يحتويها و لكن الأصل أن يتم استدعاءها من الكلاس نفسه. و حتى لو تم استدعاءها من كائن فإنه لن يتم التعامل معها بالنسبة لهذا الكائن بل سيبقى كأنها تُستدعى بشكل مباشر من الكلاس.


شروط تعريف دالة ثابتة

  • الدالة الثابتة يتم تعريفها كأي دالة عادية في الكلاس مع وضع الكلمة @staticmethod فوقها كمؤشر على أنها دالة ثابتة.
  • يمنع وضع الكلمة self بداخلها لأن هذه الكلمة تُستخدم في الأصل للوصول للخصائص التي سيملكها أي كائن يتم إنشاؤه من الكلاس.
  • للوصول إلى أي متغير موضوع في الكلاس من دالة ثابتة نكتب إسم الكلاس، يليه نقطة، يليه إسم المتغير.

الدالة الثابتة في الكلاس تكون بمثابة دالة عامة في الكلاس نفسه و ليس الهدف منها التعامل مع خصائص كائن يتم إنشاؤه منه و لذلك يمنع وضع الكلمة self كباراميتر فيها، في حين أن دالة العادية في الكلاس تكون بمثابة دالة خاصة للكائنات التي ننشئها منه نكون مجبرين على إضافتها كباراميتر فيها.

أمثلة شاملة

في المثال التالي قمنا بتعريف كلاس إسمه StaticExample وضعنا فيه دالة ثابتة إسمها print_msg() مهمتها فقط طباعة جملة عادية.

المثال الأول

StaticExample.py
# StaticExample هنا قمنا بتعريف الكلاس
class StaticExample:
# هنا قمنا بتعريف دالة ثابتة في الكلاس عند إستدعائها تقوم بطباعة جملة عادية فقط
@staticmethod
def print_msg():
print("Static method can be called directly from the class.")
# StaticExample هنا قمنا بتعريف الكلاس class StaticExample: # هنا قمنا بتعريف دالة ثابتة في الكلاس عند إستدعائها تقوم بطباعة جملة عادية فقط @staticmethod def print_msg(): print("Static method can be called directly from the class.")
Test.py
# حتى نستطيع التعامل معه StaticExample هنا قمنا بتضمين الكلاس
from StaticExample import StaticExample
# بدون الحاجة لإنشاء كائن منه StaticExample بشكل مباشر من الكلاس print_msg() هنا قمنا باستدعاء الدالة الثابتة
StaticExample.print_msg()
# حتى نستطيع التعامل معه StaticExample هنا قمنا بتضمين الكلاس from StaticExample import StaticExample # بدون الحاجة لإنشاء كائن منه StaticExample بشكل مباشر من الكلاس print_msg() هنا قمنا باستدعاء الدالة الثابتة StaticExample.print_msg()

نتيجة تشغيل الملف Test.

Static method can be called directly from the class.

في المثال التالي قمنا بتعريف كلاس إسمه Session وضعنا فيه 4 متغيرات ( title - language - teacher - credits ) بالإضافة إلى دالة ثابتة إسمها print_info() مهمتها طباعة قيم هذه المتغيرات بطريقة مرتبة.

المثال الثاني

Session.py
# Session هنا قمنا بتعريف الكلاس
class Session:
# هنا قمنا بوضع 4 متغيرات كخصائص مباشرة في الكلاس
title = 'Python for beginners'
language = 'English'
teacher = 'Sara Smith'
credits = 5
# هنا قمنا بتعريف دالة ثابتة في الكلاس عند إستدعائها تقوم بطباعة قيم خصائص الكلاس بشكل مرتب
# لاحظ أنك مجبر على وضع إسم الكلاس ثم نقطة ثم إسم المتغير الذي تريد الوصول إليه من داخل الدالة
@staticmethod
def print_info():
print('Title:', Session.title)
print('Language:', Session.language)
print('Teacher:', Session.teacher)
print('Credits Number:', Session.credits)
# Session هنا قمنا بتعريف الكلاس class Session: # هنا قمنا بوضع 4 متغيرات كخصائص مباشرة في الكلاس title = 'Python for beginners' language = 'English' teacher = 'Sara Smith' credits = 5 # هنا قمنا بتعريف دالة ثابتة في الكلاس عند إستدعائها تقوم بطباعة قيم خصائص الكلاس بشكل مرتب # لاحظ أنك مجبر على وضع إسم الكلاس ثم نقطة ثم إسم المتغير الذي تريد الوصول إليه من داخل الدالة @staticmethod def print_info(): print('Title:', Session.title) print('Language:', Session.language) print('Teacher:', Session.teacher) print('Credits Number:', Session.credits)
Test.py
# حتى نستطيع التعامل معه Session هنا قمنا بتضمين الكلاس
from Session import Session
# Session مباشرةً من الكلاس print_info() هنا قمنا باستدعاء الدالة الثابتة
Session.print_info()
# حتى نستطيع التعامل معه Session هنا قمنا بتضمين الكلاس from Session import Session # Session مباشرةً من الكلاس print_info() هنا قمنا باستدعاء الدالة الثابتة Session.print_info()

نتيجة تشغيل الملف Test.

Title: Python for beginners
Language: English
Teacher: Sara Smith
Credit Number: 5

في المثال التالي قمنا بتعريف كلاس إسمه MyTools وضعنا فيه دالة ثابتة إسمها print_words_count() الهدف منها طباعة عدد الكلمات الموجودة في النص الذي نمرره لها عند استدعائها.

المثال الثالث

MyTools.py
# MyTools هنا قمنا بتعريف الكلاس
class MyTools:
# و تحتوي على باراميتر واحد print_words_count هنا قمنا بتعريف دالة ثابتة إسمها
@staticmethod
def print_words_count(val):
# هنا قلنا إذا كانت القيمة التي مررناها لها عبارة عن قيمة نصية
if isinstance(val, str):
# إذا كانت هذه القيمة النصية عبارة عن نص فارغ سيتم طباعة أن النص عبارة عن نص فارغ و أن عدد الكلمات فيه هو صفر
if val == '':
print('Empty string, so number of words is 0')
# و من ثم طباعة قيمته words_count إذا لم تكن هذه القيمة النصية عبارة عن نص فارغ سيتم تخزين عدد الكلمات الموجودة فيه في المتغير
else:
words_count = len(val.split())
print('Number of words is:', words_count)
# عبارة عن قيمة نصية سيتم طباعة الجملة التالية val إذا لم تكن قيمة الباراميتر
else:
print('Oops..', val, 'is not a string!')
# MyTools هنا قمنا بتعريف الكلاس class MyTools: # و تحتوي على باراميتر واحد print_words_count هنا قمنا بتعريف دالة ثابتة إسمها @staticmethod def print_words_count(val): # هنا قلنا إذا كانت القيمة التي مررناها لها عبارة عن قيمة نصية if isinstance(val, str): # إذا كانت هذه القيمة النصية عبارة عن نص فارغ سيتم طباعة أن النص عبارة عن نص فارغ و أن عدد الكلمات فيه هو صفر if val == '': print('Empty string, so number of words is 0') # و من ثم طباعة قيمته words_count إذا لم تكن هذه القيمة النصية عبارة عن نص فارغ سيتم تخزين عدد الكلمات الموجودة فيه في المتغير else: words_count = len(val.split()) print('Number of words is:', words_count) # عبارة عن قيمة نصية سيتم طباعة الجملة التالية val إذا لم تكن قيمة الباراميتر else: print('Oops..', val, 'is not a string!')
Test.py
# حتى نستطيع التعامل معه MyTools هنا قمنا بتضمين الكلاس
from MyTools import MyTools
# هنا قمنا بتعريف متغير نصي يحتوي على مجموعة كلمات
text = 'Today, you are studying static methods.'
# text لمعرفة عدد الكلمات الموجودة في المتغير MyTools من الكلاس print_words_count() هنا قمنا باستدعاء الدالة الثابتة
MyTools.print_words_count(text)
# حتى نستطيع التعامل معه MyTools هنا قمنا بتضمين الكلاس from MyTools import MyTools # هنا قمنا بتعريف متغير نصي يحتوي على مجموعة كلمات text = 'Today, you are studying static methods.' # text لمعرفة عدد الكلمات الموجودة في المتغير MyTools من الكلاس print_words_count() هنا قمنا باستدعاء الدالة الثابتة MyTools.print_words_count(text)

نتيجة تشغيل الملف Test.

Number of words is: 6

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

المثال الرابع

StaticExample.py
# StaticExample هنا قمنا بتعريف الكلاس
class StaticExample:
# هنا قمنا بتعريف متغير ( أي خاصية ) في الكلاس و حددنا أن قيمته تساوي 5
x = 5
# الموجود مباشرةُ في الكلاس و ليس في كائن منه x تعرض قيمة المتغير print_x هنا قمنا بتعريف دالة ثابتة إسمها
@staticmethod
def print_x():
print('StaticExample.x =', StaticExample.x)
# StaticExample هنا قمنا بتعريف الكلاس class StaticExample: # هنا قمنا بتعريف متغير ( أي خاصية ) في الكلاس و حددنا أن قيمته تساوي 5 x = 5 # الموجود مباشرةُ في الكلاس و ليس في كائن منه x تعرض قيمة المتغير print_x هنا قمنا بتعريف دالة ثابتة إسمها @staticmethod def print_x(): print('StaticExample.x =', StaticExample.x)
Test.py
# حتى نستطيع الوصول للدالة الموجودة فيه و إنشاء كائن منه أيضاً StaticExample هنا قمنا بتضمين الكلاس
from StaticExample import StaticExample
# obj إسمه StaticExample هنا قمنا بإنشاء كائن من الكلاس
obj = StaticExample()
# من 5 إلى 10 obj الخاصة بالكائن x هنا قمنا بتغيير قيمة
obj.x = 10
# الخاصة بالكائن و التي تساوي 10 x الخاصة بالكلاس، أي 5 و ليس قيمة x لاحظ أنه سيتم طباعة قيمة .obj من الكائن print_x() هنا قمنا باستدعاء الدالة الثابتة
obj.print_x()
# الخاصة بالكلاس x بشكل مباشر و بالتالي سيتم أيضاً طباعة قيمة StaticExample من الكلاس print_x() هنا قمنا باستدعاء الدالة الثابتة
StaticExample.print_x() # الخاصة بالكلاس لأننا نستدعي الدالة الثابتة مباشرةً من الكلاس
# print_x() هي إستدعاءها منه كالتالي و ليس عن طريق الدالة الثابتة obj الخاصة بالكائن x الطريقة الوحيدة لطباعة قيمة
print('obj.x =', obj.x)
# حتى نستطيع الوصول للدالة الموجودة فيه و إنشاء كائن منه أيضاً StaticExample هنا قمنا بتضمين الكلاس from StaticExample import StaticExample # obj إسمه StaticExample هنا قمنا بإنشاء كائن من الكلاس obj = StaticExample() # من 5 إلى 10 obj الخاصة بالكائن x هنا قمنا بتغيير قيمة obj.x = 10 # الخاصة بالكائن و التي تساوي 10 x الخاصة بالكلاس، أي 5 و ليس قيمة x لاحظ أنه سيتم طباعة قيمة .obj من الكائن print_x() هنا قمنا باستدعاء الدالة الثابتة obj.print_x() # الخاصة بالكلاس x بشكل مباشر و بالتالي سيتم أيضاً طباعة قيمة StaticExample من الكلاس print_x() هنا قمنا باستدعاء الدالة الثابتة StaticExample.print_x() # الخاصة بالكلاس لأننا نستدعي الدالة الثابتة مباشرةً من الكلاس # print_x() هي إستدعاءها منه كالتالي و ليس عن طريق الدالة الثابتة obj الخاصة بالكائن x الطريقة الوحيدة لطباعة قيمة print('obj.x =', obj.x)

نتيجة تشغيل الملف Test.

StaticExample.x = 5
StaticExample.x = 5
obj.x = 10