Home
Client APIs and toolsYou can use the HCL OneDB™ implementation of client APIs to develop applications for HCL OneDB™ database servers.
ESQL/C GuideThe HCL OneDB™ ESQL/C Programmer's Manual explains how to use , the HCL OneDB™ implementation of Embedded Structured Query Language (SQL) for C (ESQL/C), to create client applications with database-management capabilities.
AppendixesThis section contains additional reference information.
The ESQL/C function libraryThese topics describe the syntax and behavior of all the library functions provided with HCL® OneDB® ESQL/C.
The ifx_var_dealloc() functionThe ifx_var_dealloc() function deallocates the memory that was allocated for the data buffer of a var binary host variable.

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 which allocation method to use for the data buffer. Regardless of whether (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.