fgetcsvDosya tanıtıcısından CSV alanlarını çözümleyerek bir satır
döndürür
&reftitle.description;
arrayfalsefgetcsvresourceakımintnulluzunluk&null;stringayraç","stringsınırlayıcı"\""stringöncelem"\\"
Satırı okuyup CSV biçemindeki alanları bir dizi içinde
döndürmesi dışında fgets işlevi gibidir.
Bu işlevde yerel ayarları hesaba katılır. Eğer LANG,
örneğin, tr_TR.UTF-8 ise ISO-8859-9
ile kodlanmış dosyaları bu işlev hatalı okuyacaktır.
&reftitle.parameters;
akımfopen, popenveya
fsockopen tarafından başarıyla açılmış geçerli
bir dosyanın tanıtıcısı.
uzunluk
CSV dosyasındaki en uzun satırdan (satırsonu karakterleri dahil) daha
büyük bir değer içermelidir. Parçalara ayırma sınırlı bir alanda
gerçekleşmeyecekse, satır uzunluk karakterden
oluşan parçalara bölünür.
Bu bağımsız değişkenin belirtilmemesi (veya PHP 8.0.0 ve sonrası için 0 veya
&null; belirtilmesi) durumunda azami satır uzunluğu sınırlanmaz fakat
işlem yavaşlar.
ayraç (separator)
İsteğe bağlı bu bağımsız değişken ile alan ayracı (tek baytlık bir
karakter) belirtilir.
sınırlayıcı (enclosure)
İsteğe bağlı bu bağımsız değişken ile alan sınırlayıcı (tek baytlık bir
karakter) belirtilir.
öncelem (escape)
Belirtilmesi seçimlik olup önceleme karakteri (tek baytlık bir
karakter) belirtmekte kullanılır. Boş dizge ("")
özel önceleme mekanizmasını iptal eder.
Genellikle bir sınırlayıcı karakter bir
alanın içinde çiftlenerek öncelenir; ancak, öndeki karakterin
yerini öncelem karakteri alabilir.
Bu nedenle, öntanımlı "" karakteri ile
\" aynı anlama gelir.
öncelem karakterinin
sınırlayıcı karakteri öncelemek dışında
özel bir anlamı yoktur; kendisini de öncelemesi amaçlanmamıştır.
PHP 8.4.0 ve sonrasında, öncelem öntanımlı
değerine bağlı olarak kullanım dışıdır. Açıkça ya konumsal olarak
ya da isimli bağımsız
değişkenler kullanılarak sağlanması gerekir.
&warning.csv.escape-parameter;
&reftitle.returnvalues;
Başarı durumunda okunan alanları içeren indisli bir
dizi,&return.falseforfailure;.
CSV dosyasındaki boş bir satır tek bir null içeren bir dizi
olarak döndürülür ve bir hata olarak ele alınmaz.
¬e.line-endings;
&reftitle.errors;
ayraç veya sınırlayıcı tek
bayt uzunlukta değilse ValueError istisnası
oluşur.
öncelem tek bayt uzunlukta değilse veya boş dizge
ise ValueError istisnası oluşur.
&reftitle.changelog;
&Version;&Description;8.4.0öncelem bağımsız değişkeninin öntanımlı
değerine güvenmek artık kullanım dışıdır.
8.0.0uzunluk artık &null; olabiliyor.
7.4.0öncelem bağımsız değişkeni özel önceleme
mekanizmasını iptal etmek için boş dizge kabul ediyor.
&reftitle.examples;
- Bir CSV dosyasının okunup basılması
$row satırındaki $num alan: \n";
$row++;
for ($c=0; $c < $num; $c++) {
echo $data[$c] . " \n";
}
}
fclose($handle);
}
?>
]]>
&reftitle.seealso;
fputcsvstr_getcsvSplFileObject::fgetcsvSplFileObject::fputcsvSplFileObject::setCsvControlSplFileObject::getCsvControlexplodefilepack