الفرق بين المراجعتين ل"PHP/Array"
ط (تغيير المصدر) |
Khaled-yassin (نقاش | مساهمات) (إضافة شرح مختصر لبعض الدوال) |
||
| سطر 84: | سطر 84: | ||
== <code>[[PHP/Function/array-multisort|array_multisort()]]</code> == | == <code>[[PHP/Function/array-multisort|array_multisort()]]</code> == | ||
| + | تُرتِّب الدالة <code>array_multisort()</code> عدة مصفوفات أو المصفوفات متعددة الأبعاد. | ||
| + | |||
== <code>[[PHP/Function/array-pad|array_pad()]]</code> == | == <code>[[PHP/Function/array-pad|array_pad()]]</code> == | ||
| + | تملأ الدالة <code>array_pad()</code> المصفوفة بعناصر بقيمة ما لتبلغ الطول المحدد. | ||
| + | |||
== <code>[[PHP/Function/array-pop|array_pop()]]</code> == | == <code>[[PHP/Function/array-pop|array_pop()]]</code> == | ||
| + | تزيل الدالة <code>array_pop()</code> العنصر الأخير في نهاية المصفوفة وتُعيد قيمته. | ||
| + | |||
== <code>[[PHP/Function/array-product|array_product()]]</code> == | == <code>[[PHP/Function/array-product|array_product()]]</code> == | ||
| + | تحسب الدالة <code>array_product()</code> حاصل ضرب قيم عناصر المصفوفة. | ||
| + | |||
== <code>[[PHP/Function/array-push|array_push()]]</code> == | == <code>[[PHP/Function/array-push|array_push()]]</code> == | ||
| + | تدفع الدالة <code>array_push()</code> عنصرًا واحدًا أو أكثر إلى نهاية المصفوفة. | ||
| + | |||
== <code>[[PHP/Function/array-rand|array_rand()]]</code> == | == <code>[[PHP/Function/array-rand|array_rand()]]</code> == | ||
| + | تختار الدالة <code>array_rand()</code> واحدًا أو أكثر من عناصر المصفوفة عشوائيًا. | ||
| + | |||
== <code>[[PHP/Function/array-reduce|array_reduce()]]</code> == | == <code>[[PHP/Function/array-reduce|array_reduce()]]</code> == | ||
| + | تختزل الدالة <code>array_reduce()</code> المصفوفة إلى قيمة واحدة باستخدام دالة مُعرَّفة من المستخدم <nowiki/>[[PHP/Types/callable|callback]]. | ||
| + | |||
== <code>[[PHP/Function/array-replace-recursive|array_replace_recursive()]]</code> == | == <code>[[PHP/Function/array-replace-recursive|array_replace_recursive()]]</code> == | ||
| + | تستبدل الدالة <code>array_replace_recursive()</code> عناصر المصفوفات المُمررة إلى المصفوفة الأولى بشكل متكرر. | ||
| + | |||
== <code>[[PHP/Function/array-replace|array_replace()]]</code> == | == <code>[[PHP/Function/array-replace|array_replace()]]</code> == | ||
| + | تستبدل الدالة <code>array_replace()</code> عناصر المصفوفات المُمررة إلى داخل المصفوفة الأولى. | ||
| + | |||
== <code>[[PHP/Function/array-reverse|array_reverse()]]</code> == | == <code>[[PHP/Function/array-reverse|array_reverse()]]</code> == | ||
| + | تُعيد الدالة <code>array_reverse()</code> المصفوفة وعناصرها مرتبةٌ ترتيبًا معكوسًا. | ||
| + | |||
== <code>[[PHP/Function/array-search|array_search()]]</code> == | == <code>[[PHP/Function/array-search|array_search()]]</code> == | ||
| + | تبحث الدالة <code>array_search()</code> في المصفوفة عن قيمة محددة وتعيد مفتاح أول عنصر يحمل هذه القيمة إذا نجح. | ||
| + | |||
== <code>[[PHP/Function/array-shift|array_shift()]]</code> == | == <code>[[PHP/Function/array-shift|array_shift()]]</code> == | ||
| + | تُزيل الدالة <code>array_shift()</code> عنصرًا من بداية المصفوفة وتُعيد قيمته. | ||
| + | |||
== <code>[[PHP/Function/array-slice|array_slice()]]</code> == | == <code>[[PHP/Function/array-slice|array_slice()]]</code> == | ||
| + | تستخرج الدالة <code>array_slice()</code> قسمًا من المصفوفة. | ||
| + | |||
== <code>[[PHP/Function/array-splice|array_splice()]]</code> == | == <code>[[PHP/Function/array-splice|array_splice()]]</code> == | ||
| + | تُزيل الدالة <code>array_splice()</code> جزءًا من المصفوفة وتستبدله بشيء آخر. | ||
| + | |||
== <code>[[PHP/Function/array-sum|array_sum()]]</code> == | == <code>[[PHP/Function/array-sum|array_sum()]]</code> == | ||
| + | تحسب الدالة <code>array_sum()</code> مجموع قيم عناصر المصفوفة. | ||
| + | |||
== <code>[[PHP/Function/array-udiff-assoc|array_udiff_assoc()]]</code> == | == <code>[[PHP/Function/array-udiff-assoc|array_udiff_assoc()]]</code> == | ||
| + | تحسب الدالة <code>array_udiff_assoc()</code> الفرق بين المصفوفات مع استخدام تحقق إضافي بمقارنة الفهارس، وتقارن البيانات باستخدام دالة <code>[[PHP/Types/callable|callback]]</code> مُعرَّفة من المستخدم . | ||
| + | |||
== <code>[[PHP/Function/array-udiff-uassoc|array_udiff_uassoc()]]</code> == | == <code>[[PHP/Function/array-udiff-uassoc|array_udiff_uassoc()]]</code> == | ||
| + | تحسب الدالة <code>array_udiff_uassoc()</code> الفرق بين المصفوفات مع استخدام تحقق إضافي بمقارنة الفهارس، ومقارنة البيانات والفهارس بواسطة دالة <code>[[PHP/Types/callable|callback]]</code> مُعرّفة من المستخدم. | ||
| + | |||
== <code>[[PHP/Function/array-udiff|array_udiff()]]</code> == | == <code>[[PHP/Function/array-udiff|array_udiff()]]</code> == | ||
| + | تحسب الدالة <code>array_udiff()</code> الفرق بين المصفوفات باستخدام دالة <nowiki/>[[PHP/Types/callable|callback]] مُعرّفة من المستخدم للمقارنة بين البيانات. | ||
| + | |||
== <code>[[PHP/Function/array-uintersect-assoc|array_uintersect_assoc()]]</code> == | == <code>[[PHP/Function/array-uintersect-assoc|array_uintersect_assoc()]]</code> == | ||
== <code>[[PHP/Function/array-uintersect-uassoc|array_uintersect_uassoc()]]</code> == | == <code>[[PHP/Function/array-uintersect-uassoc|array_uintersect_uassoc()]]</code> == | ||
مراجعة 13:23، 21 مارس 2018
تسمح لك هذه الدوال بالتعامل مع المصفوفات وتعديلها بطرائق عديدة. المصفوفات عنصر أساسي لتخزين وإدارة والتعامل مع مجموعاتٍ من المتغيرات.
تدعم لغة PHP المصفوفات أحادية ومتعددة الأبعاد، ويمكن أن ينتجها المستخدم بنفسه أو أن يستخدم دوالًا أخرى لإنشائها. توجد كذلك دوال متخصصة للتعامل مع قواعد البيانات وملأ المصفوفات من نواتج استعلامات قواعد البيانات، وتعيد الكثير من الدوال مصفوفاتٍ أيضًا.
رجاءً تصفَّح نوع البيانات الخاص بالمصفوفات من هذا التوثيق للحصول على شرح تفصيلي عن كيفية استعمال المصفوفات في لغة PHP.
انظر أيضًا إلى صفحة معاملات المصفوفات للتعرف على طرائق أخرى حول كيفية التعامل مع المصفوفات.
ترتيب المصفوفات
تحتوي لغة PHP على الكثير من الدوال التي تتعامل مع ترتيب المصفوفات، الفرق بين تلك الدوال مشروحٌ في هذه الصفحة.
array_change_key_case()
تغير الدالة array_change_key_case() حالة الأحرف اللاتينية لكل المفاتيح الموجودة بالمصفوفة.
array_chunk()
تقسم الدالة array_chunk() المصفوفة إلى أجزاء صغيرة.
array_column()
تعيد الدالة array_column() القيم المتواجدة بعمود واحد للمصفوفة التي تُمرَّر كمعامل للدالة.
array_combine()
تنشئ الدالة array_combine() مصفوفةً جديدةً عن طريق استخدام المفاتيح من أحد المصفوفات والقيم من مصفوفة أخرى.
array_count_values()
تحصي الدالة array_count_values() عدد مرات تكرار كل قيمة موجودة داخل المصفوفة.
array_diff_assoc()
تحسب الدالة array_diff_assoc() الفرق بين عدة مصفوفات مع أخذ مفاتيح المصفوفات بالحسبان.
array_diff_key()
تحسب الدالة array_diff_key() الفرق بين عدة مصفوفات باستخدام المفاتيح للمقارنة.
array_diff_uassoc()
تحسب الدالة array_diff_uassoc() الفرق بين عدة مصفوفات باستخدام دالة مقارنة يوفرها المستخدم.
array_diff_ukey()
تحسب الدالة array_diff_ukey() الفرق بين عدة مصفوفات باستخدام دالة مقارنة يوفرها المستخدم للمقارنة بين مفاتيح المصفوفات.
array_diff()
تحسب الدالة array_diff() الفرق بين عدة مصفوفات.
array_fill_keys()
تملأ الدالة array_fill_keys() المصفوفة بقيم، مع تحديد المفاتيح المستخدمة.
array_fill()
تملأ الدالة array_fill() المصفوفة بقيم محددة.
array_filter()
تُرشِّح الدالة array_filter() عناصر المصفوفة باستخدام دالة يحددها المستخدم.
array_flip()
تستبدل الدالة array_flip() كل مفاتيح المصفوفة بالقيم المرتبطة معها.
array_intersect_assoc()
تحسب الدالة array_intersect_assoc() التقاطع (intersection of arrays) بين المصفوفات مع استخدام تحقق إضافي من الفهرس.
array_intersect_key()
تحسب الدالة array_intersect_key() التقاطع (intersection) بين المصفوفات باستخدام المفاتيح للمقارنة.
array_intersect_uassoc()
تحسب الدالة array_intersect_uassoc() التقاطع (intersection) بين المصفوفات مع استخدام تحقق إضافي للفهارس، وتستخدم دالة يحددها المستخدم لمقارنة الفهارس.
array_intersect_ukey()
تحسب الدالة array_intersect_ukey() التقاطع (intersection) بين المصفوفات باستخدام دالة يحددها المستخدم لمقارنة المفاتيح.
array_intersect()
تحسب الدالة array_intersect() التقاطع (intersection) بين المصفوفات.
array_key_exists()
تتحقق الدالة array_key_exists() من وجود المفتاح أو الفهرس داخل المصفوفة.
array_keys()
تعيد الدالة array_keys() كل مفاتيح المصفوفة أو جزءًا منها.
array_map()
تنفذ الدالة array_map() دالةً أخرى يحددها المستخدم على كل عنصر موجود في المصفوفات المُمرََرَة.
array_merge_recursive()
تدمج الدالة array_merge_recursive() مصفوفتين أو أكثر بشكل تكراري (recursively).
array_merge()
تدمج الدالة array_merge() مصفوفتين أو أكثر.
array_multisort()
تُرتِّب الدالة array_multisort() عدة مصفوفات أو المصفوفات متعددة الأبعاد.
array_pad()
تملأ الدالة array_pad() المصفوفة بعناصر بقيمة ما لتبلغ الطول المحدد.
array_pop()
تزيل الدالة array_pop() العنصر الأخير في نهاية المصفوفة وتُعيد قيمته.
array_product()
تحسب الدالة array_product() حاصل ضرب قيم عناصر المصفوفة.
array_push()
تدفع الدالة array_push() عنصرًا واحدًا أو أكثر إلى نهاية المصفوفة.
array_rand()
تختار الدالة array_rand() واحدًا أو أكثر من عناصر المصفوفة عشوائيًا.
array_reduce()
تختزل الدالة array_reduce() المصفوفة إلى قيمة واحدة باستخدام دالة مُعرَّفة من المستخدم callback.
array_replace_recursive()
تستبدل الدالة array_replace_recursive() عناصر المصفوفات المُمررة إلى المصفوفة الأولى بشكل متكرر.
array_replace()
تستبدل الدالة array_replace() عناصر المصفوفات المُمررة إلى داخل المصفوفة الأولى.
array_reverse()
تُعيد الدالة array_reverse() المصفوفة وعناصرها مرتبةٌ ترتيبًا معكوسًا.
array_search()
تبحث الدالة array_search() في المصفوفة عن قيمة محددة وتعيد مفتاح أول عنصر يحمل هذه القيمة إذا نجح.
array_shift()
تُزيل الدالة array_shift() عنصرًا من بداية المصفوفة وتُعيد قيمته.
array_slice()
تستخرج الدالة array_slice() قسمًا من المصفوفة.
array_splice()
تُزيل الدالة array_splice() جزءًا من المصفوفة وتستبدله بشيء آخر.
array_sum()
تحسب الدالة array_sum() مجموع قيم عناصر المصفوفة.
array_udiff_assoc()
تحسب الدالة array_udiff_assoc() الفرق بين المصفوفات مع استخدام تحقق إضافي بمقارنة الفهارس، وتقارن البيانات باستخدام دالة callback مُعرَّفة من المستخدم .
array_udiff_uassoc()
تحسب الدالة array_udiff_uassoc() الفرق بين المصفوفات مع استخدام تحقق إضافي بمقارنة الفهارس، ومقارنة البيانات والفهارس بواسطة دالة callback مُعرّفة من المستخدم.
array_udiff()
تحسب الدالة array_udiff() الفرق بين المصفوفات باستخدام دالة callback مُعرّفة من المستخدم للمقارنة بين البيانات.