SE_stream_get_string

Gets a string column from the current row

Usage syntax

LONG SE_stream_get_string
(SE_STREAM stream,
SHORT column,
CHAR *string_val);

Parameters
stream The stream handle
column The column number; column numbers start with the number 1.
string_val The returned string
Description

SE_stream_get_string extracts a string column from the current record on the stream. If there is no data for the column, the function returns the warning SE_NULL_VALUE.

It is the caller’s responsibility to allocate enough space for the returned string. The string is null terminated, so the application must allocate one byte more than the size of the given character column. Use SE_stream_describe_column to determine the column size.

Returns

SE_SUCCESS
SE_CONNECTION_IN_USE

SE_INVALID_POINTER

SE_CONNECTION_LOCKED

SE_FUNCTION_SEQUENCE_ERROR

SE_INVALID_PARAM_VALUE

SE_INVALID_STREAM

SE_NULL_VALUE

SE_SDE_NOT_STARTED

SE_WRONG_COLUMN_TYPE