The ifx_var_freevar() function

The ifx_var_freevar() function frees memory that has been allocated for the var binary and lvarchar pointer host variables.

Syntax

int fix_var_freevar(var_bin)
   var binary *var_bin;
var_bin
The address of the var binary or lvarchar pointer host variable.

Usage

Whenever you have a var binary or lvarchar pointer host variable, as shown in the following example, you must explicitly free memory that is allocated for it by using the ifx_var_freevar() function. 
EXEC SQL var binary ‘polygon’ poly;
EXEC SQL lvarchar *c;
The following example illustrates the use of ifx_var_freevar(). You must explicitly free memory that has been allocated for var binary and lvarchar pointer host variables by using the ifx_var_freevar() function. 
ifx_var_freevar(&poly);
ifx_var_freevar(&c);

If you do not use ifx_var_dealloc() to deallocate memory that has been allocated for the data buffer of the var binary host variable, ifx_var_freevar() will do so. It then frees the memory of the var binary and lvarchar pointer host variables. In the preceding example, after ifx_var_freevar() was called, poly and c would be set to null.

Return codes

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