INFORMIX
DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions
Home Contents Index Master Index New Book

mi_value_by_name()

The mi_value_by_name() function retrieves values from a column, given the column name.

Syntax

Important: The "retbuf" parameter points to a character string representation of the value unless the query returning the value is a binary query (MI_QUERY_BINARY), in which case it points to binary data. See the discussion of the "control" parameter in the description of the mi_exec() function.

Return Values

If a value is not a named row or a collection, mi_value() returns MI_NORMAL_VALUE and places the value in retbuf.

If the value is a collection, mi_value() returns MI_COLLECTION_VALUE.

If a value is a named row, mi_value() returns MI_ROW_VALUE. In this case, mi_value() places an MI_ROW pointer in retbuf that points to the named row. To extract the individual values from the named row, invoke mi_value() with the returned MI_ROW pointer.

If a value is NULL, mi_value returns MI_NULL_VALUE.

On failure, mi_value() returns MI_ERROR.

Related Topics

For additional information, see the description of the mi_value() function.




DataBlade API Programmer's Manual, version 9.1
Copyright © 1998, Informix Software, Inc. All rights reserved.