count() ב-PHP: אורך מערך ומספר איברים

count($arr) מחזירה את מספר האיברים במערך: count(['red', 'green', 'blue']) הוא 3. למערכים ב-PHP אין מאפיין length, ולכן count() היא הדרך לקבל את האורך או הגודל של מערך.

<?php
$fruits = ['apple', 'banana', 'cherry'];
echo count($fruits), "\n";

$fruits[] = 'date';
echo count($fruits), "\n";

echo count([]), "\n";                          // empty array
echo count(['a' => 1, 'b' => 2]), "\n";        // keys of any kind

count() מהירה: PHP שומרת את הגודל בתוך המערך, ולכן ספירה של מיליון איברים עולה כמו ספירה של שלושה.

ספירת מערך רב ממדי

כברירת מחדל count() סופרת רק את הרמה העליונה. העבירו COUNT_RECURSIVE (או 1) כארגומנט השני כדי לספור כל איבר בכל עומק. גם המערכים המקוננים עצמם נספרים, ולכן הסכום גדול לעיתים קרובות ממספר ערכי העלים.

<?php
$teams = [
    'red'  => ['Ada', 'Linus'],
    'blue' => ['Grace', 'Margaret', 'Alan'],
];

echo count($teams), "\n";                    // 2 teams
echo count($teams, COUNT_RECURSIVE), "\n";   // 2 teams + 5 names

// Only the leaf values
echo count($teams, COUNT_RECURSIVE) - count($teams), "\n";
echo array_sum(array_map('count', $teams)), "\n";

שני הקיצורים מניחים בדיוק שתי רמות. לקינון עמוק יותר במערך רב ממדי, ספרו את העלים עם array_walk_recursive(): $n = 0; array_walk_recursive($arr, function () use (&$n) { $n++; });.

count מול sizeof

sizeof() היא כינוי של count(): אותם ארגומנטים, אותה תוצאה. השתמשו ב-count(). בה משתמשים כמעט כל קוד ה-PHP והתיעוד, ו-sizeof מרמזת על גודל בבתים לכל מי שמכיר C.

<?php
$items = [1, 2, 3, 4];

echo count($items), "\n";
echo sizeof($items), "\n";
echo sizeof($items) === count($items) ? "same\n" : "different\n";

ספירת ערכים שמתאימים לתנאי

ל-count() אין ארגומנט של תנאי. סננו קודם, ואז ספרו: array_filter() שומרת את האיברים שה-callback שלכם מקבל. כדי לספור כמה פעמים מופיע כל ערך, השתמשו ב-array_count_values().

<?php
$scores = [45, 82, 67, 91, 38, 74];

$passed = count(array_filter($scores, fn($s) => $s >= 50));
echo "$passed of ", count($scores), " passed\n";

$answers = ['yes', 'no', 'yes', 'maybe', 'yes'];
$tally = array_count_values($answers);
print_r($tally);
echo $tally['yes'], "\n";

ספירת תווים במחרוזת

count() מיועדת למערכים. למחרוזת, השתמשו ב-strlen() לבתים או ב-mb_strlen() לתווים; הן נבדלות ברגע שבטקסט יש סימנים דיאקריטיים או יפנית. עמוד strlen מסביר את ההבדל. כדי לספור מילים, פצלו קודם.

<?php
$text = 'naïve café au lait';

echo strlen($text), "\n";             // bytes: ï and é take two each
echo mb_strlen($text), "\n";          // characters
echo str_word_count($text), "\n";     // words (ASCII letters only)
echo count(explode(' ', $text)), "\n"; // pieces split on spaces

str_word_count() מתייחסת לאותיות שאינן ASCII כמפרידים, ולכן naïve נספרת כשתי מילים. פיצול לפי רווחים צפוי יותר לטקסט אמיתי.

count() על null או על מחרוזת זורקת שגיאה

מאז PHP 8, count() מקבלת רק מערכים ואובייקטים שמממשים Countable. כל דבר אחר זורק TypeError, בעוד PHP 7.2 עד 7.4 החזירו 0 (עבור null) או 1 (עבור מחרוזת או מספר) עם אזהרה. הסיבה הרגילה היא משתנה שלפעמים הוא null, כמו מפתח חסר או פונקציה שלא החזירה כלום.

<?php
// This throws a TypeError on purpose
$tags = null;
echo count($tags);

תנו לערך ברירת מחדל של מערך ריק עם ??, והספירה תהיה 0:

<?php
$post = ['title' => 'Hello'];        // no 'tags' key

echo count($post['tags'] ?? []), "\n";

$tags = null;
echo count($tags ?? []), "\n";

echo is_countable($tags) ? count($tags) : 0, "\n";

בדיקה אם מערך ריק

כדי לשאול "האם יש משהו במערך הזה", השוו למערך ריק או השתמשו ב-empty(). גם count($arr) === 0 עובד, אבל רק כש-$arr הוא בוודאות מערך.

<?php
$cart = [];

if ($cart === []) {
    echo "Your cart is empty\n";
}

var_dump(empty($cart));
var_dump(count($cart) > 0);

$cart[] = 'book';
var_dump(empty($cart));

empty($x) אף פעם לא זורקת, גם כש-$x לא מוגדר או null, ולכן היא הבדיקה הבטוחה יותר לערך שאולי אינו מערך. שאר הכללים שלה (גם מחרוזת ריקה ו-"0" נחשבים ריקים) נמצאים בעמוד empty.