27.7.10.23 mysql_stmt_result_metadata()

MYSQL_RES *mysql_stmt_result_metadata(MYSQL_STMT *stmt)

Description

如果传递给mysql_stmt_prepare()的语句是产生结果集的语句，则mysql_stmt_result_metadata()以指向MYSQL_RES结构的指针的形式返回结果集元数据，该结构可用于处理元信息，例如字段数和各个字段信息。该结果集指针可以作为参数传递给处理结果集元数据的任何基于字段的 API 函数，例如：

• 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()

完成结果集结构后，应将其释放，您可以将其传递给mysql_free_result()。这类似于您释放通过调用mysql_store_result()获得的结果集的方式。

mysql_stmt_result_metadata()返回的结果集仅包含元数据。它不包含任何行结果。通过使用带有mysql_stmt_fetch()的语句处理程序来获得行。

Return Values

MYSQL_RES结果结构。 NULL(如果不存在针对准备好的查询的元信息)。

Errors

• CR_OUT_OF_MEMORY

记不清。

• CR_UNKNOWN_ERROR

出现未知错误。

Example

请参阅第 27.7.10.11 节“ mysql_stmt_fetch()”中的示例。