Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_row_create() creates a row, based a row descriptor and column data.

MI_ROW *mi_row_create(conn, row_desc, col_values, col_nulls)

MI_CONNECTION *conn;

MI_ROW_DESC *row_desc;

MI_DATUM col_values[];

mi_boolean col_nulls[];

conn	is a pointer to the connection descriptor a previous call to mi_open(), mi_server_connect(), or mi_server_reconnect() has established.
row_desc	is a pointer to the row descriptor that describes the columns of the row.
col_values	is an array of MI_DATUM structures that contain the values of the columns in the row (or fields in a row type).
col_nulls	is an array that indicates whether a column holds an SQL NULL value. Each array element is set to one of the following values:
	1 (MI_TRUE)	The value of the associated column is an SQL NULL value.
	0 (MI_FALSE)	The value of the associated column is not an SQL NULL value.

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

The mi_row_create() function takes the column data that the col_values and col_nulls arrays hold and creates a row structure that holds this data, based on the column information in the row descriptor that row_desc references. It returns a pointer to the new row structure (MI_ROW) that it creates.

The mi_row_create() function is the constructor function for the row structure. This function uses the col_values and col_nulls arrays to obtain the column values that it copies into the new row structure. The col_values array holds the values for each column of the row. This array sends the column values as MI_DATUM values.

The mi_row_create() function allocates a new row structure with the PER_COMMAND memory duration. Values in the col_values array must be pass by reference or pass by value, depending on the data type of the value.

Values in the col_values array must be pass-by-reference for all data types.

The mi_row_create() function expects an mi_lvarchar variable-length structure as the coldata value for CHAR(n) and NCHAR(n) columns.

The mi_row_create() function puts copies of the col_values and col_nulls arrays into a row buffer that is associated with the row_desc row descriptor. If you call mi_row_create() twice with the same row descriptor, the second call overwrites the results of the first call.

See the descriptions of the following functions: mi_row_desc_create() and mi_row_free().

For more information, see Creating a Row Structure.