أهداف التعلم

في نهاية هذا القسم، ينبغي أن تكون قادرًا على:

• تحديد القيمة المُرجَعة للدالّة.
• استخدام تعليمات الإرجاع في الدوال لإرجاع القيم.

الإرجاع من دالّة

عندما تنهي الدالّة عملها، فإنها تعود وتوفر نتيجة للشِفرة المستدعية. تُنهي تعليمة الإرجاع تنفيذ الدالّة ويمكنها تحديد قيمة لإرجاعها إلى مستدعي الدالّة. الدوال التي تم تقديمها حتى الآن لم تتضمن تعليمة return، وهو ما يعادل إرجاع None، مما يمثل عدم وجود قيمة.

def calc_mpg(miles, gallons):
  mpg = miles/gallons
  return mpg

def calc_sqft(length, width):
  sqft = length * width
  return

def hw_1():
  print("Hello world!")
  return

def hw_2():
  print("Hello world!")

استخدام تعليمات إرجاع متعددة

قد تستخدم الدوال التي تحتوي على مسارات تنفيذ متعددة تعليمات return متعددة. مثال: قد تحتوي الدالّة التي تتضمن تعليمة if-else على تعليمَتَي return لكل فرع. تُنهي تعليمات Return دائمًا الدالّة وتُعيد سير التنفيذ إلى الشِفرة المستدعية.

في الجدول أدناه، تستقبل الدالّة calc_mpg() الأميال المقطوعة وكمية الغالونات المستهلكة من الوقود، وتحسب استهلاك السيارة من الوقود (ميل لكل غالون). تتحقق الدالّة calc_mpg() مما إذا كانت قيمة gallons تساوي 0 (لتجنب القسمة على صفر)، وإذا كان الأمر كذلك، فإنها تُرجع -1، وهي قيمة تُستخدم غالبًا للإشارة إلى وجود مشكلة.

def calc_mpg(miles, gallons):
  if gallons > 0:
    mpg = miles/gallons
    return mpg
  else:
    print("Gallons can't be 0")
    return -1
    
car_1_mpg = calc_mpg(448, 16)
print("Car 1's mpg is", car_1_mpg)
car_2_mpg = calc_mpg(300, 0)
print("Car 2's mpg is", car_2_mpg)

Car 1's mpg is 28.0
Gallons can't be 0
Car 2's mpg is -1

def yarn_weight(num):
  if num == 0:
    return "lace"
  elif num == 1:
    return "sock"
  elif num == 2:
    return "sport"
  elif num == 3:
    return "dk"
  elif num == 4:
    return "worsted"
  elif num == 5:
    return "bulky"
  else:
    return "super bulky"

def inc_volume(level, max):
  if level < max:
    return level
    level += 1
  else:
    return level

vol1 = inc_volume(9, 10)
print(vol1)
vol2 = inc_volume(10, 10)
print(vol2)

استخدام الدوال كقيم

الدوال هي كائنات تُقيّم إلى قيم، لذا يمكن استخدام استدعاءات الدوال في التعبيرات. يمكن دمج استدعاء دالّة مع استدعاءات دوال أخرى، ومُتغيِّرات، وقيم حرفية طالما أن القيمة المُرجَعة متوافقة مع العملية.

def tax(total):
  return .06 * total

def auto_tip(total):
  return .2 * total

bill = 100.0
bill += tax(bill) + auto_tip(bill)

def sq(num):
  return num * num

def offset(num):
  return num - 2

val = 5
val2 = sq(offset(val))