تابع ()fseek

چاپ

 تابع ()fseek


PHP Filesystem Reference توابع کار با فایل ها در PHP


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

تابع ()fseek در یک فایل باز شده پویش می کند. 

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

این تابع در صورت موفقیت 0 را برمی گرداند و در صورت شکست 1- برگردانده خواهد شد. پویش در گذشته از EOF(پایان فایل) باعث ایجاد خطا نخواهد شد. 

نحوه نوشتن

fseek(file,offset,whence)
پارامترهاتوضیحات
file

ضروری. فایل بازشده ای را مشخص می کند که قرار است مورد پویش قرار بگیرد. 

offset

ضروری. مکان جدید را مشخص می کند(با محاسبه به صورت بایت، از ابتدای فایل مورد نظر).

whence

اختیاری. (اضافه شده در php4). مقادیر امکان پذیر:

  • SEEK_SET - پیش فرض. برابر کردن مکان(position) با offset.
  • SEEK_CUR - ست کردن مکان(position) به مکان جاری بعلاوه ی offset. 
  • SEEK_END  - ست کردن position به EOF بعلاوه ی offset(برای قرار دادن position به قبل از EOF(پایان فایل) offset باید یک مقدار منفی باشد. 

نکات قابل توجه

نکته: با استفاده از تابع ()ftell می توانید مکان کنونی را پیدا کنید. 


مثال

<?php
$file = fopen("test.txt","r");
// read first line
fgets($file);
// move back to beginning of file
fseek($file,0);
?>

PHP Filesystem Reference توابع کار با فایل ها در PHP