Oracle Forms Developer – Form Builder Reference, Volume 1

444
This is an optional parameter. If not specified, the
default value is non-persistent.
source_table An existing PL/SQL table that is used to establish the
bounds and values of the newly-created variant table.
The source table can be of any type.
arrspec Indicates which selected element or elements of a source
table are to be used in the creation of the new variant.
The lower bound always starts at 1. For more
information, see Specifiers for OLE Arrays.
This is an optional parameter. If not specified, the entire
source table or source variant is used.
var An existing OLE variant whose value is to be given to
the new variant. (This source variant may be a table.)
Usage Notes
• This function first creates an empty variant and then gives it a value. It offers a combined version of
the CREATE_VAR and SET_VAR operations.
• This TO_VARIANT function can also be thought of as the inverse version of the VAR_TO_*
function.
• Note that the OLEVAR version of this function differs from the NUMBER, VARCHAR2, and table
versions in that it uses an existing OLE variant as the source, rather than a PL/SQL equivalent value.