الدالة 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() العناصر التي تقبلها دالة الاستدعاء. ولعدّ مرات ظهور كل قيمة، استخدم 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.