mysql_bind_param()

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 "Tipos de Dados de Instruções Preparadas da API C".

Valor Retornado

Zeros se a ligação foi obtida corretamente. Diferente de zero se ocorrer um erro.

Erros

• CR_NO_PREPARE_STMT

  Não existem instruções preparadas

• CR_NO_PARAMETERS_EXISTS

  Não existem parâmetros para ligar

• CR_INVALID_BUFFER_USE

  Indica 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_TYPE

  A 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_MEMORY

  Falta de memória

• CR_UNKNOWN_ERROR

  Um erro desconhecido ocorreu.

Exemplo

Para utilizar mysql_bind_param() consulte o exemplo de "mysql_execute()".

Retornar