array_count_values()‎

(PHP 4, PHP 5, PHP 7)

تحصي الدالة array_count_values()‎ عدد مرات تكرار كل قيمة موجودة داخل المصفوفة.

الوصف

array array_count_values ( array $array )

تنشئ الدالة array_count_values()‎ مصفوفةً جديدةً تحتوي على القيم الموجودة بالمصفوفة المُمَرََرة بالمعامل array كمفاتيح، وعدد مرات تكرار كل قيمة في هذه المصفوفة كقيم مرتبطة بتلك المفاتيح.

المعاملات

array

مصفوفة تحتوي على قيم تحصي هذه الدالة عدد مرات تكرار كل واحدة منها.

القيم المعادة

تعيد الدالة مصفوفة جديدة من القيم الموجودة بالمصفوفة المُمَرََرة، ويرتبط مع كل قيمة منها عدد مرات تكرارها بالمصفوفة.

الأخطاء والاستثناءات

سترمي الدالة خطأً من النوع E_WARNING لكل عنصر في المصفوفة ليس سلسلةً نصيةً  string أو عددًا صحيحًا integer.

أمثلة

مثال رقم 1: الاستخدام الأساسي للدالة array_count_values()‎

<?php

$array = array(1, "hello", 1, "world", "hello");

print_r(array_count_values($array));

?>

نتيجة المثال السابق

Array

(

   [1] => 2

   [hello] => 2

   [world] => 1

)

مصادر

• صفحة الدالة array_count_values في توثيق PHP الرسمي.