fseek
(PHP 4, PHP 5, PHP 7, PHP 8)
fseek — Встановлює зміщення у файловому покажчику
Опис
fseek(resource $stream, int $offset, int $whence = SEEK_SET): int
Встановлює зміщення у файлі, на який посилається stream. Нове усунення, що вимірюється в байтах від початку файлу, виходить шляхом додавання параметра offset до позиції, зазначеної у параметрі whence
Загалом дозволяється вказувати усунення за межами кінця файлу, якщо дані потім будуть записані в цій позиції, читання будь-якої незаписаної області між кінцем файлу та вказаною позицією поверне нульові байти. Однак, певні потоки можуть не підтримувати цю поведінку, особливо якщо вони мають основне сховище фіксованого розміру.
Список параметрів
stream
Вказівник (resource) на файл, який зазвичай створюється за допомогою функції fopen()
offset
Зміщення.
Для усунення позиції перед кінцем файлу необхідно передати негативне значення offsetи установить параметрwhenceв**SEEK_END**
whence
значеннями whenceявляются:
- **
SEEK_SET**- встановити зсув уoffsetбайт. - **
SEEK_CUR**- встановити зсув у поточне положення плюсoffset - **
SEEK_END**- Встановити зміщення до кінця файлу плюсoffset
Значення, що повертаються
У разі успішного виконання повертає 0; інакше повертає -1.
Приклади
Приклад #1 Приклад використання функції fseek()****
Примітки
Зауваження :
Якщо файл відкритий у режимі запису в кінець (
aилиa+), будь-які дані, що записуються в файл, будуть записуватися в кінець, незалежно від позиції файлу, а результат виклику fseek() буде не визначено.
Зауваження :
Не всі потоки підтримують усунення вказівника. Для потоків, що не підтримують цю операцію, зміщення вперед здійснюється читанням та відкиданням даних, інші форми усунення закінчаться помилкою.