الفرق بين المراجعتين ل"PHP/str getcsv"
| سطر 2: | سطر 2: | ||
(PHP 5 >= 5.3.0, PHP 7) | (PHP 5 >= 5.3.0, PHP 7) | ||
| − | تُحَوِّلُ | + | تُحَوِّلُ الدالة<code>str_getcsv()</code> سلسلة نصية بصيغة CSV إلى مصفوفة. |
== الوصف == | == الوصف == | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
array str_getcsv ( string $input [, string $delimiter = "," [, string $enclosure = '"' [, string $escape = "\\" ]]] ) | array str_getcsv ( string $input [, string $delimiter = "," [, string $enclosure = '"' [, string $escape = "\\" ]]] ) | ||
| − | </syntaxhighlight>تحول | + | </syntaxhighlight>تحول الدالة<code>str_getcsv()</code> السلسلة النصية المُدخلة بتنسيق CSV وتعيد مصفوفة تحتوي على الحقول الموجودة فيها. |
== المعاملات == | == المعاملات == | ||
| − | === input === | + | === <code>input</code> === |
السلسلة النصية المراد تحويلها. | السلسلة النصية المراد تحويلها. | ||
| − | === delimiter === | + | === <code>delimiter</code> === |
| − | يُعيِّن المعامل delimiter محدد الحقل (حرف واحد فقط). | + | يُعيِّن المعامل <code>delimiter</code> محدد الحقل (حرف واحد فقط). |
| − | === enclosure === | + | === <code>enclosure</code> === |
| − | يُعيِّن المعامل enclosure حرف الحقل الملحق (حرف واحد فقط). | + | يُعيِّن المعامل <code>enclosure</code> حرف الحقل الملحق (حرف واحد فقط). |
| − | === escape === | + | === <code>escape</code> === |
| − | يعين المعامل escape حرف التهريب (حرف واحد فقط). يحدد افتراضيًا بخط مائل عكسي (\). | + | يعين المعامل <code>escape</code> حرف التهريب (حرف واحد فقط). يحدد افتراضيًا بخط مائل عكسي (<code>\</code>). |
| − | ملاحظة: عادة ما يُهمَل حرف enclosure داخل الحقل عن طريق مضاعفته. ومع ذلك، يمكن استخدام حرف escape كبديل. لذلك، بالنسبة لقيم المعامل الافتراضية "" و \" لها نفس المعنى. بخلاف السماح بتهريب حرف | + | ملاحظة: عادة ما يُهمَل حرف <code>enclosure</code> داخل الحقل عن طريق مضاعفته. ومع ذلك، يمكن استخدام حرف <code>escape</code> كبديل. لذلك، بالنسبة لقيم المعامل الافتراضية <code>""</code> و <code>\"</code> لها نفس المعنى. بخلاف السماح بتهريب حرف <code>enclosure</code>، لا يكون لحرف <code>escape</code> معنى خاص؛ ولا يعني حتى تهريب نفسه. |
== القيم المعادة == | == القيم المعادة == | ||
| − | تعيد | + | تعيد الدالة<code>str_getcsv()</code> مصفوفة مفهرسة تحتوي على الحقول التي أمكنت قراءتها. |
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * | + | * الدالة<code>[[PHP/fgetcsv|fgetcsv()]]</code> : الحصول على سطر من مؤشر الملف وتفسير قيمته كما لو أنها بصيغة CSV. |
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 12:38، 9 أبريل 2018
(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.