INFORMIX-ESQL/C Programmer's Manual ESQL/C Function Library

The ifx_var_alloc() function allocates memory for the data buffer of an lvarchar or var binary host variable.

mint ifx_var_alloc(var_bin, var_size)

	var binary **var_bin

		int4 var_size;

mint ifx_var_alloc(lvar, var_size)

	lvarchar **lvar

	int4 var_size;

 



var_bin

is the address of the var binary pointer host variable whose data buffer is allocated. 


lvar

is the address of the lvarchar pointer host variable whose data buffer is allocated.


var_size  

is the size, in bytes, of the data buffer to allocate.

The allocation flag of the ifx_var_flag() function notifies ESQL/C of the allocation method to use for the data buffer. If you set the allocation flag in ifx_var_flag() to 0, you must explicitly allocate memory for the data of a var binary host variable with the ifx_var_alloc() function.

Important: Whether you allocate memory or allow ESQL/C to allocate the memory for you, you must free the allocated memory using the ifx_var_dealloc() function.

Return Codes

0	The function was successful.
<0	The function was not successful and the return value indicates the cause of the error.

ifx_var_dealloc(), ifx_var_flag()