pg_lo_tell

(PHP 4 >= 4.2.0, PHP 5, PHP 7)

pg_lo_tell Возвращает текущее положение внутреннего указателя большого объекта

Описание

pg_lo_tell ( resource $large_object ) : int

pg_lo_tell() возвращает текущую позицию (отступ от начала) внутреннего указателя большого объекта.

Операции с использованием интерфейса больших объектов необходимо заключать в блок транзакции.

Список параметров

large_object

Ресурс большого объекта (LOB) PostgreSQL, возвращаемый функцией pg_lo_open().

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

Текущая позиция внутреннего указателя (количество байт от начала) большого объекта. В случае ошибки функция вернет отрицательное значение.

Примеры

Пример #1 Пример использования pg_lo_tell()

<?php
   $doc_oid 
189762345;
   
$database pg_connect("dbname=jacarta");
   
pg_query($database"begin");
   
$handle pg_lo_open($database$doc_oid"r");
   
// Пропустить первые 50000 байт
   
pg_lo_seek($handle50000PGSQL_SEEK_SET);
   
// Проверим, на сколько мы отступили
   
$offset pg_lo_tell($handle);
   echo 
"Текущее положение внутреннего указателя: $offset";
   
pg_query($database"commit");
?>

Результат выполнения данного примера:

Текущее положение внутреннего указателя: 50000

Список изменений

Версия Описание
5.6.0 Добавлена поддержка больших 64-битных объектов PostgreSQL 9.3. И клиент, и сервер должны поддерживать PostgreSQL 9.3, а PHP должен быть собран 64-битным и использовать 64-битные большие объекты.

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

  • pg_lo_seek() - Перемещает внутренний указатель большого объекта