The ifx_var_dealloc() function

The ifx_var_dealloc() function deallocates the memory that was allocated for the data buffer of a var binary host variable.

Syntax

var binary
mint ifx_var_dealloc(var_bin)
   var binary **var_bin;
lvarchar
mint ifx_var_dealloc(lvar)
   lvarchar **lvar;
var_bin
The address of the var binary pointer host variable whose data buffer is deallocated.
lvar
The address of the lvarchar pointer host variable whose data buffer is allocated.

Usage

The allocation flag of the ifx_var_flag() function tells Informix® ESQL/C which allocation method to use for the data buffer. Regardless of whether Informix® ESQL/C (allocation flag set to 1) or your application (allocation flag set to 0) allocates the memory, you must explicitly deallocate memory that was allocated to an lvarchar or the data buffer of var binary host variable.

Return codes

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