- Documentation Library
- Table of Contents
- MySQL 3.23/4.0/4.1 Manual
- Table of Contents
- 12.1.7 Descrição das Funções de Instrução Preparada da API C
- 12.1.7.1 mysql_prepare()
- 12.1.7.2 mysql_param_count()
- 12.1.7.3 mysql_get_metadata()
- 12.1.7.4 mysql_bind_param()
- 12.1.7.5 mysql_execute()
- 12.1.7.6 mysql_stmt_affected_rows()
- 12.1.7.7 mysql_bind_result()
- 12.1.7.8 mysql_stmt_store_result()
- 12.1.7.9 mysql_stmt_data_seek()
- 12.1.7.10 mysql_stmt_row_seek()
- 12.1.7.11 mysql_stmt_row_tell()
- 12.1.7.12 mysql_stmt_num_rows()
- 12.1.7.13 mysql_fetch()
- 12.1.7.14 mysql_send_long_data()
- 12.1.7.15 mysql_stmt_close()
- 12.1.7.16 mysql_stmt_errno()
- 12.1.7.17 mysql_stmt_error()
- 12.1.7.18 mysql_stmt_sqlstate()
MYSQL_RES *mysql_get_metadata(MYSQL_STMT
*stmt)
Descrição
Se uma instrução passada para
mysql_prepare() rproduziu um resultado,
mysql_get_metadata() retorna o resultado
dos meta dados na forma de um ponteiro para uma estrutura
MYSQL_RES que também pode ser usada para
processar a meta informação como o número total de campos e
informação de campos indivíduais. Este ponteriro para o
resultado pode ser passado como um argumento para qualquer um
dos campos com base na API que processam o resultado dos
metadados, como:
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()
A estrutura do resultado deve estar liberada quando você
acabar de usá-lo. Você pode fazê-lo passando para
mysql_free_result(). É semelhante ao modo
que você libera um resulatdo chamado com
mysql_store_result().
O resultado retornado por
mysql_get_metadata() contém apenas
metadados. Ele não contém qualquer resultado de registro. As
linhas são obtidas usando o handle de instrução com
mysql_fetch().
Valor Retornado
Uma estrutura de resultado MYSQL_RES.
NULL se nenhuma meta informação existe
para a consulta preparada.
Erros
-
CR_OUT_OF_MEMORYFalta de memória
-
CR_UNKNOWN_ERROROcorreu um erro desconhecido
Exemplo
Para utilizar mysql_get_metadata() consulte
o exemplo de Secção 12.1.7.13, “mysql_fetch()”
This is a translation of the MySQL Reference Manual that can be found at dev.mysql.com. The original Reference Manual is in English, and this translation is not necessarily as up to date as the English version.
