pg_lo_lseek
Prev | 4.6.Large Object Processing Commands | Next

## pg_lo_lseek

pg_lo_lseek — 巨大対象の位置を捜す Seek to a position of a large object

## 構文 Synopsis

    pg_lo_lseek conn descriptor offset whence

## Description

pg_lo_lseek は､現在の 読み/書き 位置から､開始位置に指定された位置から偏移バイトの位置に移動する｡ `pg_lo_lseek` moves the current read/write position to `offset` bytes from the position specified by `whence`.

## Arguments

`conn`

  接続の把持子 The handle of the connection.

`descriptor`

  巨大対象の為の､ pg_lo_openからの記述子｡ A descriptor for the large object from pg_lo_open.

`offset`

  バイト単位の､新しい捜索位置｡ The new seek position in bytes.

`whence`

  新しい捜索位置を計算する為に指定される開始位置: SEEK_CUR (現在位置から),か､ SEEK_END (末尾から), か SEEK_SET (先頭から)｡ Specified from where to calculate the new seek position: `SEEK_CUR` (from current position), `SEEK_END` (from end), or `SEEK_SET` (from start).

## Return Value

捜索完了後の､巨大対象内の､現在の零-基準バイト偏移｡これは pg_lo_tellから返される値と等しい｡ The current zero-based byte offset in the large object, after the seek is complete. This is identical to the value which would be returned by pg_lo_tell.

もし不都合が生じるとtcl不都合が発せられる｡ A Tcl error will be thrown if an error occurs.

## Notes

全ての巨大対象操作はSQL翻訳区域内部で行われねばならない｡ All large object manipulation must take place within an SQL transaction block.

この命令は､符号付き32ビット偏移を使う様制限されている(約 2GB)｡ 64-bit 偏移対応はpg_lo_lseek64を参照されたい｡ This function is limited to using a 32-bit signed offset (about 2GB). See pg_lo_lseek64 for 64-bit offset support.

この命令はPostgreSQL libpq 機能 lo_lseek を使うか模擬する｡ This command uses or emulates the PostgreSQL libpq function `lo_lseek`.

Prev | Up | Next
pg_lo_write | Home | pg_lo_lseek64