Oracle Forms Developer – Form Builder Reference, Volume 1

TO_VARIANT built-in
Description
Creates an OLE variant and assigns it a value. There are four versions of the function.
Syntax
FUNCTION TO_VARIANT
(newval NUMBER,
vtype VT_TYPE
persistence BOOLEAN)
RETURN newvar OLEVAR;
...or...
FUNCTION TO_VARIANT
(newval VARCHAR2,
vtype VT_TYPE
persistence BOOLEAN)
RETURN newvar OLEVAR;
...or...
FUNCTION TO_VARIANT
(source_table,
vtype VT_TYPE
arrspec VARCHAR2, persistence BOOLEAN)
RETURN newvar OLEVAR;
...or...
FUNCTION TO_VARIANT
(var OLEVAR,
vtype VT_TYPE
arrspec VARCHAR2, persistence BOOLEAN)
RETURN newvar OLEVAR;
Built-in Type unrestricted function
Returns the newly-created OLE variant.
Parameters
newval The value to be given to the newly-created OLE variant.
vtype The OLE VT_TYPE to be given to the newly-created
variant.
This is an optional parameter. If not specified, the
default value for the NUMBER version of the function is
VT_R8. For the VARCHAR2 version, the default is
VT_BSTR. For the table version, the default is
determined from the PL/SQL types of the table For the
OLEVAR version, the default is the type of the source
variant.
persistence Controls the persistence of the variant after its creation.
A boolean value of TRUE establishes the variant as
persistent; a value of FALSE establishes the variant as
non-persistent.
443