pg_lo_write
Prev | 4.6.Large Object Processing Commands | Next

## pg_lo_write

pg_lo_write — 巨大対象に書込む Write to a large object

## 構文 Synopsis

    pg_lo_write conn descriptor buf len

## 説明 Description

`pg_lo_write` は､変数 `buf` から巨大対象に､最大限 `len` バイト書込む｡ `pg_lo_write` writes at most `len` bytes from a variable `buf` to a large object.

## 引数 Arguments

`conn`

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

`descriptor`

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

`buf`

  巨大対象に書込むべき文字列(変数名ではなく､値そのもの)｡ The string to write to the large object (not a variable name, but the value itself).

`len`

  書込むべきバイトの最大個数｡書かれる個数はこの値と文字列長さより小さくなる｡ 　 The maximum number of bytes to write. The number written will be the smaller of this value and the length of the string.

## 返り値 Return Value

実際に書かれたバイトの個数が返される； これは通常は要求された数と同じである｡ 　 The number of bytes actually written is returned; this will ordinarily be the same as the number requested.

巨大対象への書込みに不都合が生じると､負数が返される｡それ以外の不都合は Tcl 不都合発生の結果になる｡註意すべきは､この命令の不都合取扱いは､大多数の他の巨大対象命令とは異なる｡ If an error occurs writing to the large object, a negative number will be returned. Other errors result in a Tcl error being thrown. Note that error handling for this command is different from most of the other Large Object commands.

## 註意 Notes

全ての巨大対象操作は SQL 一括処理内部で行われなければならない｡ All large object manipulation must take place within an SQL transaction block.

この命令は PostgreSQL libpq function `lo_write`を使い模擬する｡ This command uses or emulates the PostgreSQL libpq function `lo_write`.

Prev | Up | Next
pg_lo_read | Home | pg_lo_lseek