- 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()
my_bool mysql_bind_param(MYSQL_STMT *stmt, MYSQL_BIND
*bind)
Descrição
mysql_bind_param() é utilizado para ligar
dados para os marcadores de parâmetros na instrução SQL que
foi passada para mysql_prepare(). Ele
utiliza a estrutura MYSQL_BIND para
fornecer os dados. bind é o endereço de
um vetor de estruturas MYSQL_BIND. A
biblioteca cliente espera que o vetor deve contenha um
elemento para cada marcador de parâmetro ?
que está presente na consulta.
Suponha que você prepare a seguinte instrução:
INSERT INTO mytbl VALUES(?,?,?)
Quando você ligar os parâmetros, o vetor da estrutura
MYSQL_BIND deve conter três elementos e
pode estar declarado assim:
MYSQL_BIND bind[3];
O membro de cada elemento MYSQL_BIND que
deve estar configurado está descrito em
Secção 12.1.5, “Tipos de Dados de Instruções Preparadas da API C”.
Valor Retornado
Zeros se a ligação foi obtida com sucesso. Diferente de zero se ocorrer um erro.
Erros
-
CR_NO_PREPARE_STMTNão existem instruções preparadas
-
CR_NO_PARAMETERS_EXISTSNão existem parâmetros para ligar
-
CR_INVALID_BUFFER_USEIndica se a ligação forncerá dados longos em bolcos e se o tipo de buffer é binário ou não é uma string.
-
CR_UNSUPPORTED_PARAM_TYPEA conversão não é suportada. Possivelmente o valor de
buffer_typeé inválido ou não é um dos tipos suportados listados acima. -
CR_OUT_OF_MEMORYFalta de memória
-
CR_UNKNOWN_ERRORUm erro desconhecido ocorreu.
Exemplo
Para utilizar mysql_bind_param() consulte o
exemplo de Secção 12.1.7.5, “mysql_execute()”.
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.
