Переместить указатель файла File::seek

Модуль: main — подключать отдельно не нужно

Доступно с версии: 15.0.15

Метод File::seek перемещает указатель файла, который открыл метод open, на позицию от начала файла.

Сигнатура метода в классе Bitrix\Main\IO\File:

public function seek($position)

Параметры

Обязательные параметры обозначены *

Параметр Тип Описание
position* int, float Задает позицию в байтах от начала файла. Если значение больше PHP_INT_MAX, метод перемещает указатель несколькими шагами

Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.

Возвращаемое значение

Метод возвращает результат функции fseek — 0 при успехе и -1 при ошибке.

Исключения

Исключение Когда возникает
Bitrix\Main\IO\FileNotOpenedException Файл не открыт методом open или уже закрыт

Примеры

Пример. Код открывает файл, пропускает первые три байта и читает следующую строку. В блоке finally код удаляет файл:

<?php
use Bitrix\Main\Application;
use Bitrix\Main\IO\File;
use Bitrix\Main\IO\FileStreamOpenMode;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

$path = Application::getDocumentRoot() . '/upload/demo-units.txt';
File::putFileContents($path, "kg\nm\n");

$file = new File($path);
try
{
    $handle = $file->open(FileStreamOpenMode::READ);
    $file->seek(3);
    echo trim(fgets($handle));
    $file->close();
}
finally
{
    $file->delete();
}

Код выведет m.

Смотрите также

Предыдущая
Следующая