تابع ()fgetcsv

چاپ

تعریف و کاربرد

تابع ()fgetcsv یک خط از داده های یک فایل باز شده ی csv را تجزیه می کند.

تابع ()fgetcsv به هنگام رسیدن به یک خط جدید یا یک طول مشخص یا رسیدن به پایان فایل(EOF) متوقف می شود.

این تابع در صورت موفقیت فیلد های csv را برمی گرداند و در صورت شکست و یا EOF(رسیدن به پایان فایل) false را برمی گرداند.

fgetcsv(file,length,separator,enclosure)

پارامترها	توضیحات
file	ضروری. فایلی که قرار است بررسی شود را مشخص می کند.
length	اختیاری. ماکزیمم طول یک خط را مشخص می کند. باید از طولانی ترین خط(به کاراکتر) در فایل csv بزرگتر باشد. با از قلم انداختن این پارامتر(یا ست کردن آن به 0) طول خط مورد نظر محدود نمی شود. که این کمی کند تر است. نکته: این پارامتر در ورژن های قبل از php 5 ضروری است.
separator	اختیاری. یک کاراکتر که مشخص کننده ی جداکننده ی فیلد است. مقدار پش فرض کاما است.(,)
enclosure	اختیاری. یک کاراکتر که مشخص کننده ی حصار است. مقدار پیش فرض " است.

نکته: لطفا تابع ()fputcsv را نیز مشاهده نمایید.

<?php
$file = fopen("contacts.csv","r");
print_r(fgetcsv($file));
fclose($file);
?>

فایل csv:

Kai Jim, Refsnes, Stavanger, Norway
Hege, Refsnes, Stavanger, Norway

خروجی کد بالا برابر است با:

Array
(
[0] => Kai Jim
[1] => Refsnes
[2] => Stavanger
[3] => Norway
)

<?php
$file = fopen("contacts.csv","r");

while(! feof($file))
  {
  print_r(fgetcsv($file));
  }

fclose($file);
?>

فایل csv:

Kai Jim, Refsnes, Stavanger, Norway
Hege, Refsnes, Stavanger, Norway

خروجی کد بالا برابر است با:

Array
(
[0] => Kai Jim
[1] => Refsnes
[2] => Stavanger
[3] => Norway
)
Array
(
[0] => Hege
[1] => Refsnes
[2] => Stavanger
[3] => Norway
)