mi_string *mi_lvarchar_to_string(lv_ptr)
   mi_lvarchar *lv_ptr;

lv_ptr

is a pointer to the varying-length structure whose data is to be converted to a null-terminated string.

Valid in Client LIBMI Application?	Valid in User-Defined Routine?
Yes	Yes

The mi_lvarchar_to_string( ) function returns a null-terminated string for the data in the varying-length structure that lv_ptr references. This function allocates memory for the string it returns. Because mi_lvarchar_to_string( ) uses mi_alloc( ), this string memory has the current memory duration. You must use the mi_free( ) function to free this string memory when it is no longer needed.

An mi_string pointer

is a pointer to the newly allocated buffer that contains the string equivalent of the varying-length data.

NULL

indicates that the function was not successful.

See also the descriptions of mi_alloc( ), mi_free( ), mi_new_var( ), mi_string_to_lvarchar( ), mi_var_copy( ), mi_var_free( ), and mi_var_to_buffer( ).