Home | Previous Page | Next Page   Function Descriptions >

mi_column_count( )

The mi_column_count( ) function obtains the number of columns in a row descriptor.

Syntax

mi_integer mi_column_count(row_desc)
   MI_ROW_DESC *row_desc;
row_desc
is a pointer to the row descriptor for which to count columns.
Valid in Client LIBMI Application? Valid in User-Defined Routine?
Yes Yes

Usage

A row descriptor can describe the structure of a row in a table or the structure of a row type. From the row descriptor that row_desc references, the mi_column_count( ) function obtains the column count for either structure:

Use the mi_column_count( ) function to process returned row data on a column-by-column (or field-by-field) basis.

Return Values

>=0
is the number of columns or fields in the specified row descriptor.
MI_ERROR
indicates that the function was not successful.

Related Topics

See also the descriptions of mi_column_id( ), mi_column_name( ), mi_column_nullable( ), mi_column_precision( ), mi_column_scale( ), mi_column_type_id( ), mi_column_typedesc( ), mi_get_row_desc( ), and mi_get_row_desc_without_row( ).

For more information about row descriptors, see the IBM Informix: DataBlade API Programmer's Guide.

Home | [ Top of Page | Previous Page | Next Page | Contents | Index ]