array_slice() ב-PHP: קבלת חלק ממערך

array_slice($array, $offset, $length) מחזירה מערך חדש עם $length איברים החל ממיקום $offset. המערך המקורי לא משתנה. השמיטו את $length כדי לקחת הכול עד הסוף.

<?php
$letters = ["a", "b", "c", "d", "e", "f"];

print_r(array_slice($letters, 0, 3)); // first three
print_r(array_slice($letters, 2));    // from position 2 to the end
print_r($letters);                    // unchanged

ההיסט הוא מיקום (0 הוא האיבר הראשון), לא מפתח. זה חשוב במערכים אסוציאטיביים ובמערכים שהמפתחות שלהם אינם 0, 1, 2.

קבלת N האיברים האחרונים עם היסט שלילי

היסט שלילי נספר מהסוף: -1 הוא האיבר האחרון, -3 מתחיל שלושה מהסוף. אורך שלילי עוצר כמה איברים כאלה לפני הסוף.

<?php
$log = ["boot", "login", "upload", "resize", "logout"];

print_r(array_slice($log, -2));     // last two
print_r(array_slice($log, 1, -1));  // drop the first and the last
print_r(array_slice($log, -3, 2));  // two, starting three from the end

בקשה של יותר איברים ממה שקיים זה בסדר: array_slice($log, 0, 100) מחזירה את כל החמישה.

שמירה על המפתחות המקוריים עם preserve_keys

מפתחות שלמים ממוספרים מחדש מ-0 אלא אם מעבירים true כארגומנט הרביעי. מפתחות מחרוזת תמיד נשמרים.

<?php
$ranked = [10 => "gold", 20 => "silver", 30 => "bronze", 40 => "fourth"];

print_r(array_slice($ranked, 1, 2));
print_r(array_slice($ranked, 1, 2, true));

$prices = ["tea" => 3, "coffee" => 4, "juice" => 5, "water" => 1];
print_r(array_slice($prices, 1, 2)); // string keys kept anyway

השתמשו ב-true כשהמפתחות אומרים משהו, כמו מזהים ממסד נתונים, ותחפשו איברים לפיהם בהמשך.

חלוקת מערך לדפים עם array_slice

הצגה של הדף $page ברשימה עם $perPage פריטים לדף היא חיתוך אחד: ההיסט הוא ($page - 1) * $perPage. הדוגמה הזו מדפיסה רשימת HTML עם קישורים לדפים. הריצו אותה ולחצו על מספר דף: אותו סקריפט ירוץ שוב כש-$_GET['page'] מוגדר מהקישור.

<?php
$items = [];
for ($i = 1; $i <= 23; $i++) {
    $items[] = "Item $i";
}

$perPage = 5;
$pages = (int) ceil(count($items) / $perPage);
$page = max(1, min($pages, (int) ($_GET['page'] ?? 1)));

$visible = array_slice($items, ($page - 1) * $perPage, $perPage);

echo "<p>Page $page of $pages</p>\n<ul>\n";
foreach ($visible as $item) {
    echo "  <li>$item</li>\n";
}
echo "</ul>\n<p>";
for ($p = 1; $p <= $pages; $p++) {
    echo $p === $page ? " <strong>$p</strong>" : " <a href=\"?page=$p\">$p</a>";
}
echo "</p>\n";

השורה max(1, min($pages, ...)) שומרת על ?page=99 או ?page=-1 שהוקלדו ידנית בתוך הטווח התקין. עם מסד נתונים הייתם מבקשים רק דף אחד עם LIMIT ו-OFFSET במקום לטעון כל שורה, אבל ברשימה שכבר נמצאת בזיכרון, array_slice היא כל העבודה.

array_slice מול array_splice

השמות שונים באות אחת והן עושות דברים הפוכים למקור. array_slice מעתיקה חלק החוצה. array_splice חותכת את החלק מתוך המערך שמעבירים לה, ממספרת אותו מחדש ומחזירה את האיברים שהוסרו. היא יכולה גם להכניס איברים חלופיים במקום החיתוך.

<?php
$a = ["mon", "tue", "wed", "thu", "fri"];
$copy = array_slice($a, 1, 2);
echo "slice returned: " . implode(", ", $copy) . "\n";
echo "original now:   " . implode(", ", $a) . "\n\n";

$b = ["mon", "tue", "wed", "thu", "fri"];
$cut = array_splice($b, 1, 2);
echo "splice returned: " . implode(", ", $cut) . "\n";
echo "original now:    " . implode(", ", $b) . "\n\n";

$c = ["mon", "tue", "wed", "thu", "fri"];
array_splice($c, 1, 2, ["TUE", "WED", "extra"]);
echo "replaced: " . implode(", ", $c) . "\n";

לדרכים נוספות למחוק איברים, ראו הסרת איברים ממערך.

פיצול מערך לנתחים

כשאתם צריכים את כל הדפים בבת אחת, למשל כדי לסדר מוצרים בשורות של שלושה, array_chunk עושה את החיתוך החוזר בשבילכם.

<?php
$products = ["Lamp", "Desk", "Chair", "Shelf", "Rug", "Mirror", "Clock"];

foreach (array_chunk($products, 3) as $i => $row) {
    echo "Row " . ($i + 1) . ": " . implode(" | ", $row) . "\n";
}

שנו את ה-3 ל-2 או ל-4 והריצו שוב. הנתח האחרון מחזיק את מה שנשאר.