pg_lo_lseek64
Prev | 4.6.Large Object Processing Commands | Next

## pg_lo_lseek64

pg_lo_lseek64 — 64ビット偏移を使い巨大対象の位置を捜索する Seek to a position of a large object, using a 64-bit offset

## 構文 Synopsis

    pg_lo_lseek64 conn descriptor offset whence

## 説明 Description

pg_lo_lseek64は､現在の 読み/書き 位置を､whenceによって指定された位置からの偏移バイトの位置に移動する｡ 偏移は64ビット整数であり､巨大寸法の対象をpg_lo_lseekと比較することを許容する｡ `pg_lo_lseek64` moves the current read/write position to `offset` bytes from the position specified by `whence`. The offset is a 64-bit integer, allowing for larger size objects compare to pg_lo_lseek.

## Arguments

`conn`

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

`descriptor`

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

`offset`

  バイト単位の､64ビット整数としての､新しい捜索位置｡ The new seek position in bytes, as a 64-bit integer.

`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_tell64に返される値と同一であり､且つ､64ビット整数である｡ 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_tell64, and is a 64-bit integer.

不都合が生じると､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.

この命令はpgtclng-2.1.0とpgintcl-3.5.0に加えられた｡ This command was added in pgtclng-2.1.0 and in pgintcl-3.5.0.

この命令はPostgreSQL libpq 機能 lo_lseek64 を使うか模擬する｡ pg_lo_lseek64を利用可能に且つ使用可能にする為には､(pgintcl以外の)外部函数は､PostgreSQL libpq 9.3.0版以降と共に二進翻訳､連結し､PostgreSQL 中央集中処理装置9.3.0版以降に接続せねばならない｡ This command uses or emulates the PostgreSQL libpq function `lo_lseek64`. In order for `pg_lo_lseek64` to be available and usable, the library must be be built and linked with PostgreSQL libpq 9.3.0 or higher (does not apply to pgintcl), and be connected to a PostgreSQL server version 9.3.0 or higher.

Prev | Up | Next
pg_lo_lseek | Home | pg_lo_tell