ora-lob-assign Function

Summary

Assigns a LOB to another LOB locator.

Package

sql

Signature

ora-lob-assign src-lob-locator &key dest-lob-locator errorp => lob-locator

Arguments

src-lob-locator⇩	A LOB locator.
dest-lob-locator⇩	A LOB locator.
errorp⇩	A generalized boolean.

Values

lob-locator

A LOB locator.

Description

The function ora-lob-assign assigns the underlying LOB for src-lob-locator to another LOB locator.

If dest-lob-locator is nil then a new LOB locator is created and returned. Otherwise dest-lob-locator should be an existing LOB locator which is modified and returned. The default value of dest-lob-locator is nil.

If an error occurs and errorp is true, an error is signaled. If errorp is false, the function returns an object of type sql-database-error. The default value of errorp is nil.

Notes

1. ora-lob-assign is a direct call to OCILobAssign.
2. ora-lob-assign is available only when the "oracle" module is loaded. See the section 23.11 Oracle LOB interface for more information.