الدالة str_getcsv()‎ في PHP

من موسوعة حسوب
< PHP

(PHP 5 >= 5.3.0, PHP 7)

تُحَوِّلُ الدالةstr_getcsv() ‎ سلسلة نصية بصيغة CSV إلى مصفوفة.

الوصف

array str_getcsv ( string $input [, string $delimiter = "," [, string $enclosure = '"' [, string $escape = "\\" ]]] )

تحول الدالةstr_getcsv() ‎ السلسلة النصية المُدخلة بتنسيق CSV وتعيد مصفوفة تحتوي على الحقول الموجودة فيها.

المعاملات

input

السلسلة النصية المراد تحويلها.

delimiter

يُعيِّن المعامل delimiter محدد الحقل (حرف واحد فقط).

enclosure

يُعيِّن المعامل enclosure حرف الحقل الملحق (حرف واحد فقط).

escape

يعين المعامل escape حرف التهريب (حرف واحد فقط). يحدد افتراضيًا بخط مائل عكسي (\).

ملاحظة: عادة ما يُهمَل حرف enclosure داخل الحقل عن طريق مضاعفته. ومع ذلك، يمكن استخدام حرف escape كبديل. لذلك، بالنسبة لقيم المعامل الافتراضية "" و ‎\"‎ لها نفس المعنى. بخلاف السماح بتهريب حرف enclosure، لا يكون لحرف escape معنى خاص؛ ولا يعني حتى تهريب نفسه.

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

تعيد الدالةstr_getcsv() ‎ مصفوفة مفهرسة تحتوي على الحقول التي أمكنت قراءتها.

انظر أيضًا

  • الدالةfgetcsv() ‎: الحصول على سطر من مؤشر الملف وتفسير قيمته كما لو أنها بصيغة CSV.

مصادر