mysql_stmt_result_metadata

mysql_stmt_result_metadata retrieves result-set metadata from a Connector/C prepared statement; the returned MYSQL_RES contains field information but no row data.

Syntax

MYSQL_RES * mysql_stmt_result_metadata(MYSQL_STMT * stmt);

Parameter

• stmt - a statement handle, which was previously allocated by mysql_stmt_init().

Description

If a statement passed to mysql_stmt_prepare() is one that produces a result set, mysql_stmt_result_metadata() returns the result set that can be used to process the meta information such as the total number of fields and individual field information.

Return Value

Returns a result set that can be used to process metadata information.

• The result set returned by mysql_stmt_result_metadata() contains only metadata. It does not contain any row results. The rows are obtained by mysql_stmt_fetch().

• This result set pointer can be passed as an argument to any of the field-based functions that process result set metadata, such as: mysql_num_fields(), mysql_fetch_field(), mysql_fetch_field_direct(), mysql_fetch_fields(), mysql_field_count(), mysql_field_seek(), mysql_field_tell(), mysql_free_result()

See Also

• mariadb_stmt_fetch_fields()

• mysql_free_result()

• mysql_stmt_prepare()

_{This page is: Copyright © 2026 MariaDB. All rights reserved.}