pg_lo_truncate
Prev | 4.6.Large Object Processing Commands | Next

## pg_lo_truncate

pg_lo_truncate — 巨大対象を切詰め､その寸法を変更する Truncate a large object, changing its size

## Synopsis

    pg_lo_truncate conn descriptor length

## Description

`pg_lo_truncate` は巨大対象の寸法を指定された数に変更する｡もし､新寸法が現在の寸法より小さと､巨大対象は切詰められる｡新寸法が現寸法より大きいと､巨大対象はヌルバイトが充填される｡ `pg_lo_truncate` changes the size of a large object to a specified number of bytes. If the new size is smaller than the current size, the large object is truncated. If the new size is larger than the current size, the large object is padded with null bytes.

## Arguments

`conn`

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

`descriptor`

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

`length`

  巨大対象の為のバイト単位の新しく望ましい寸法｡ The desired new size in bytes for the large object.

## Return Value

なし｡ もし不都合が生じるとtcl不都合が発せられる｡ Nothing. 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_truncate64 を参照されたい｡ This function is limited to using a 32-bit signed length (about 2GB). See pg_lo_truncate64 for 64-bit length support.

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

この命令はPostgreSQL libpq 機能 lo_truncate を使うか模擬する｡ その機能は､libpq と PostgreSQL 中央集中処理装置の第8.3に追加された､もし､古い版を使用すると本命令は利用できなくなる｡ This command uses or emulates the PostgreSQL libpq function `lo_truncate`. That function was added to libpq and the PostgreSQL server in version 8.3, and the command will not be available if using older versions.

Prev | Up | Next
pg_lo_tell64 | Home | pg_lo_truncate64