INFORMIX
DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions
Home Contents Index Master Index New Book

mi_large_object_expand()

The mi_large_object_expand() function creates a new smart large object (the destination object) and fills it with user-provided data.

Syntax

Usage

The mi_large_object_expand() function is typically called in the assign() function of a multirepresentational data type to promote a value into a smart large object. You can use this function with either BLOB or CLOB objects.

Use mi_free() to free this handle when it is no longer needed.

Tip: Informix provides the mi_large_object_expand() function for backward compatibility only. Use the mi_lo_expand() function for all new DataBlade routines.

Return Values

On success, returns a smart-large-object handle; on failure, returns NULL.

Related Topics

See the descriptions of the following functions: mi_large_object_pin(), mi_large_object_unpin(), and mi_set_large().




DataBlade API Programmer's Manual, version 9.1
Copyright © 1998, Informix Software, Inc. All rights reserved.