The lld_tell() function

This function returns the offset for the next read or write operation on an open large object.

Syntax

API

mi_integer lld_tell(conn, io, offset, error)
   MI_CONNECTION*                conn;
   LLD_IO*                       io,
   mi_int8*                      offset;
   mi_integer*                   error;

ESQL/C

int lld_tell (io, offset, error);
   LLD_IO* io;
EXEC SQL BEGIN DECLARE SECTION;
   PARAMETER int8* offset;
EXEC SQL END DECLARE SECTION;
   int* error;

conn: The connection descriptor established by a previous call to the mi_open() or mi_server_connect() functions. This parameter is for the API interface only. In the ESQL/C and SQL versions of this function, you must already be connected to a server.
io: A pointer to an LLD_IO structure created with a previous call to the lld_open() function.
offset: A pointer to an int8 that you allocate. The function returns the offset in this int8.
error: An output parameter in which the function returns an error code.

Usage

Before calling this function, you must open the large object with a call to lld_open().

Return codes

For an API function, returns MI_OK if the function succeeds and MI_ERROR if it fails.

For an ESQL/C function, returns 0 if the function succeeds and -1 if the function fails.

Context

The lld_open() function

The lld_read() function

The lld_seek() function

The lld_write() function