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_lvar_alloc() functionThe ifx_lvar_alloc() function specifies whether to allocate memory when fetching lvarchar data.

The ifx_lvar_alloc() function

The ifx_lvar_alloc() function specifies whether to allocate memory when fetching lvarchar data.

Syntax

mint ifx_lvar_alloc(mintalloc)
    mint alloc;

alloc: The value of the allocation flag; either 1 or 0

Usage

When the flag is set to 1, ESQL/C automatically performs this memory allocation. You can use a flag value of 1 before a SELECT statement when you are unsure of the amount of data that the SELECT statement returns. When the flag is set to 0, ESQL/C does not automatically perform this memory allocation.

Return codes

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