قيم الإرجاع

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

ما قيم الإرجاع؟

قيمة الإرجاع هي نتيجة تنفيذ الدالة. وبدلًا من إخراج البيانات مباشرةً، يمكن للدالة إرجاعها لاستخدامها في موضع آخر من البرنامج.

مثال: يمكن لدالة تحسب مساحة مستطيل إرجاع النتيجة إلى الجهة التي استدعتها.

استخدام الكلمة المفتاحية return

لإرجاع قيمة من دالة، استخدموا الكلمة المفتاحية return. مثال:

نصيحة: استخدموا قيم الإرجاع لتمرير البيانات من الدالة مرة أخرى إلى التعليمات البرمجية التي استدعتها.

<?php
  function add($a, $b) {
    return $a + $b;
  }

  $result = add(5, 10);
  echo $result; // Outputs: 15
?>

إرجاع السلاسل النصية

يمكن للدوال إرجاع سلاسل نصية يمكن دمجها أو عرضها. مثال:

مهمة: اكتبوا دالة تُرجع رسالة ترحيب مخصصة.

<?php
  function greet($name) {
    return "Hello, $name!";
  }

  echo greet("Alice"); // Outputs: Hello, Alice!
?>

إرجاع المصفوفات

يمكن للدوال إرجاع مصفوفات، وهي مفيدة لتمرير عدة قيم. مثال:

نصيحة: استخدموا return لتمرير هياكل بيانات معقدة مثل المصفوفات.

<?php
  function getColors() {
    return ["Red", "Green", "Blue"];
  }

  $colors = getColors();
  echo $colors[0]; // Outputs: Red
?>

إرجاع عدة قيم

لإرجاع عدة قيم، استخدموا مصفوفة ترابطية أو كائنًا. مثال:

نقطة أساسية: استخدموا المصفوفات الترابطية لإرجاع قيم مسماة.

<?php
  function getUserInfo() {
    return [
      "name" => "Alice",
      "age" => 25,
      "city" => "New York"
    ];
  }

  $user = getUserInfo();
  echo $user["name"]; // Outputs: Alice
?>

إرجاع القيم الشرطية

يمكن للدوال إرجاع قيم مختلفة استنادًا إلى الشروط. مثال:

نصيحة: استخدموا return لمعالجة المنطق الشرطي داخل الدوال.

<?php
  function checkEligibility($age) {
    if ($age >= 18) {
      return "Eligible";
    } else {
      return "Not Eligible";
    }
  }

  echo checkEligibility(20); // Outputs: Eligible
?>

تصريحات الأنواع لقيم الإرجاع

يتيح لكم PHP التصريح بنوع الإرجاع للدالة. مثال:

نقطة أساسية: تساعد تصريحات نوع الإرجاع على ضمان أن تُرجع الدوال نوع البيانات المتوقع.

<?php
  function multiply(float $a, float $b): float {
    return $a * $b;
  }

  echo multiply(2.5, 4); // Outputs: 10.0
?>

أحسنتم!

تهانينا! لقد تعلمتم كيفية استخدام قيم الإرجاع في دوال PHP، بما في ذلك إرجاع السلاسل النصية والمصفوفات والتعامل مع القيم المتعددة أو الشرطية. في الدرس التالي، سنستكشف دوال لامبدا والدوال المجهولة. واصلوا البرمجة!