FNC_UdtSerialize Function | C Library Functions | Teradata Vantage - 17.10 - FNC_UdtSerialize - Advanced SQL Engine - Teradata Database

Teradata Vantageā„¢ - SQL External Routine Programming

Product
Advanced SQL Engine
Teradata Database
Release Number
17.10
Release Date
July 2021
Content Type
Programming Reference
Publication ID
B035-1147-171K
Language
English (United States)

Returns the UDT in its serialized format and 0 if the operation was successful, -1 otherwise.

Syntax

int
FNC_UdtSerialize (UDT_HANDLE        udt,
                  BYTE             *buffer,
                  FNC_LobLength_t   num_bytes,
                  FNC_LobLength_t  *actual_length)

Syntax Elements

udt
the handle of the UDT.
buffer
the user-allocated buffer that will contain the serialized data.
num_bytes
the number of bytes to read.
actual_length
the actual number of bytes that were written to the buffer.

Usage Notes

Before calling this function, do the following:

  1. Call FNC_UdtGetSerializeSize to get the size of the UDT in its serialized form.
  2. Use the size returned by FNC_UdtGetSerializeSize to allocate a buffer that will hold the serialized data. The size of the buffer must be large enough to hold all of the serialized data, which must be read in a single call to FNC_UdtSerialize.
  3. Pass this buffer to FNC_UdtSerialize.

The query will fail if the UDT does not support serialize/deserialize.