lld_lob

The lld_lob data type is a user-defined type. You can use it to specify the location of a smart large object and to specify whether the object contains binary or character data.

The lld_lob data type is defined for use with the API as follows:

typedef struct
   {
   MI_LO_HANDLE                 lo;
   mi_integer                   type;
   } lld_lob_t;

It is defined for ESQL/C as follows:

typedef struct
   {
   ifx_lo_t                     lo;
   int                          type;
   } lld_lob_t;

lo

is a pointer to the location of the smart large object.

type

is the type of the object. For an object containing binary data, set type to LLD_BLOB; for an object containing character data, set type to LLD_CLOB.

The lld_lob type is equivalent to the CLOB or BLOB type in that it points to the location of a smart large object. In addition, it specifies whether the object contains binary or character data. You can pass the lld_lob type as the lo_pointer field of an lld_locator row. You should set the lld_lob_t.type field to LLD_BLOB for binary data and to LLD_CLOB for character data.

See Using the lld_lob Type for example code that uses that features the lld_lob type.

LOB Locator provides explicit casts from:

• a CLOB type to an lld_lob type.
• a BLOB type to an lld_lob type.
• an lld_lob type to the appropriate BLOB or CLOB type.

You can pass an lld_lob type to these functions, described in Functions:

• LOCopy, page LOCopy
• LOToFile, page LOToFile
• LLD_LobType, page LLD_LobType

Note that LOCopy and LOToFile are overloaded versions of built-in server functions. The only difference is that you pass an lld_lob to the Large Object Locator versions of these functions and a BLOB or CLOB type to the built-in versions.