توابع each() در PHP

توابع آرایه PHP

مثال

نام کلید و مقدار عنصر فعلی را برمی‌گرداند و نشانه داخلی را به سمت جلو حرکت می‌کند:

<?php
$people = array("Bill", "Steve", "Mark", "David");
print_r (each($people));
?>

运行实例

تعریف و استفاده

توابع each() نام کلید و مقدار عنصر فعلی را برمی‌گرداند و نشانه داخلی را به سمت جلو حرکت می‌کند.

نام کلید و مقدار عنصر به آرایه‌ای شامل چهار عنصر برمی‌گردانند. دو عنصر (1 و Value) شامل مقدار کلید هستند، دو عنصر (0 و Key) شامل نام کلید هستند.

روش‌های مرتبط:

  • current() - مقدار عنصر فعلی را برمی‌گرداند
  • end() - نشانه داخلی را به آخرین عنصر آرایه اشاره می‌کند و خروجی می‌دهد
  • next() - نشانه داخلی را به عنصر بعدی آرایه اشاره می‌کند و خروجی می‌دهد
  • prev() - نشانه داخلی را به عنصر قبلی آرایه اشاره می‌کند و خروجی می‌دهد
  • reset() - نشانه داخلی را به اولین عنصر آرایه اشاره می‌کند و خروجی می‌دهد

نحوه استفاده

each(آرایه)
پارامترها توضیح
آرایه ضروری. آرایه‌ای که باید استفاده شود را مشخص می‌کند.

توضیح

توابع each() آرایه‌ای از نام کلید و مقدار عنصر فعلی تولید می‌کند که نشانه داخلی به سمت جلو حرکت می‌کند.

آرایه‌ای که شامل آن‌ها می‌شود شامل چهار عنصر است: نام کلید 0، 1، key و value. واحد 0 و key شامل نام کلید واحد آرایه هستند، 1 و value شامل داده هستند.

اگر نشانه داخلی فراتر از محدوده آرایه رفته باشد، این تابع FALSE را برمی‌گرداند.

جزئیات فنی

مقدار برمی‌گردانده:

نام کلید و مقدار عنصر فعلی را برمی‌گرداند. نام کلید و مقدار به صورت آرایه‌ای شامل چهار عنصر برمی‌گردانند.

دو عنصر (1 و Value) شامل کلید و مقدار هستند، دو عنصر (0 و Key) شامل نام کلید هستند.

اگر هیچ عنصر آرایه‌ای باقی نمانده باشد، تابع FALSE را برمی‌گرداند.
نسخه PHP: 4+

مثال‌های بیشتر

مثال 1

مثل مثال بالای صفحه، اما در این مثال به صورت مداوم تمام آرایه را خروجی می‌دهد:

<?php
$people = array("Bill", "Steve", "Mark", "David");
reset($مردم);
در حالی که (لیست($کلید، $مقدار) = each($people))
  {
  echo "$key => $val<br>";
  }
?>

运行实例

مثال 2

نمایش همه روش‌های مرتبط:

<?php
$people = array("Bill", "Steve", "Mark", "David");
echo current($people) . "<br>"; // عنصر فعلی فعلی است Bill
echo next($people) . "<br>"; // عناصر بعدی Bill است Steve
echo current($people) . "<br>"; // عنصر فعلی فعلی است Steve
echo prev($people) . "<br>"; // عنصر قبلی Steve است Bill
echo end($people) . "<br>"; // عنصر آخر David است
echo prev($people) . "<br>"; // عنصر قبل از David است Mark
echo current($people) . "<br>"; // عنصر فعلی فعلی است Mark
echo reset($people) . "<br>"; // حرکت اشاره‌گر داخلی به ابتدای آرایه، یعنی Bill
echo next($people) . "<br>"; // عناصر بعدی Bill است Steve
print_r (each($people); // بازگشت نام کلید و مقدار فعلی عنصر (در حال حاضر Steve) و حرکت به سمت جلو اشاره‌گر داخلی
?>

运行实例

توابع آرایه PHP