mysql_stmt_bind_param

Prototypes


my_bool mysql_stmt_bind_param(MYSQL_STMT *stmt, MYSQL_BIND *bnd);

Description

Lie un paramètre décrit par bnd à l'ordre Sql stmt courant. Chaque paramètre doit être lié par ordre d'apparation dans l'ordre Sql.

Le résultat est différent de 0 en cas de succès.

Voici la description de la structure MYSQL_BIND :

enum enum_field_types buffer_type;
Fixe le type natif du paramètre. Les valeurs possibles sont les suivantes :
- MYSQL_TYPE_BIT.
  Le paramètre est un char où seul le bit de poids faible est utilisé.
- MYSQL_TYPE_TINY.
  Le paramètre est un char.
- MYSQL_TYPE_SHORT.
  Le paramètre est un short.
- MYSQL_TYPE_LONG.
  Le paramètre est un long.
- MYSQL_TYPE_DOUBLE.
  Le paramètre est un double.
- MYSQL_TYPE_BLOB.
  Le paramètre est un unsigned char *.
- MYSQL_TYPE_STRING.
  Le paramètre est un char *.
- MYSQL_TYPE_DATETIME.
  Le paramètre est un MYSQL_TIME *.
my_bool is_unsigned;
Pour MYSQL_TYPE_TINY, MYSQL_TYPE_SHORT ou MYSQL_TYPE_LONG, si Vrai, la valeur numérique est non signée.
void *buffer;
Valeur du paramètre transmis par adresse.
unsigned long buffer_length;
Taille du buffer du paramètre transmis par adresse.
unsigned long length_value;
Taille de la valeur du paramètre transmis par adresse.
unsigned long *length;
Taille de la valeur du paramètre lu.
my_bool is_null_value;
Si Vrai, la valeur du paramètre transmis est nulle.
my_bool *is_null;
Si Vrai, la valeur du paramètre lu est nulle.
my_bool *error;
Pour détecter la troncature de la valeur du paramètre lu.

Exemple


#include <mysql.h>



static MYSQL_STMT *hOrdreSql;

static MYSQL_BIND LiaisonE;

static long E;

static unsigned long TailleE;

static my_bool IndicateurE;

static MYSQL_BIND LiaisonC;

static char C[20];

static unsigned long TailleC;

static my_bool IndicateurC;



...

memset(&LiaisonE, 0, sizeof(MYSQL_BIND));

LiaisonE.buffer_type=MYSQL_TYPE_LONG;

LiaisonE.is_unsigned=0;

LiaisonE.buffer=(void *)&E;

LiaisonE.buffer_length=sizeof(long);

LiaisonE.length_value=sizeof(long);

LiaisonE.length=&TailleE;

LiaisonE.is_null_value=0;

LiaisonE.is_null=&IndicateurE;

if (mysql_stmt_bind_param(hOrdreSql, &LiaisonE))

   {

   ...

   }

...

memset(&LiaisonC, 0, sizeof(MYSQL_BIND));

LiaisonC.buffer_type=MYSQL_TYPE_STRING;

LiaisonC.is_unsigned=0;

LiaisonC.buffer=(void *)C;

LiaisonC.buffer_length=sizeof(char)*20;

LiaisonC.length_value=strlen(C);

LiaisonC.length=&TailleC;

LiaisonC.is_null_value=0;

LiaisonC.is_null=&IndicateurE;

if (mysql_stmt_bind_param(hOrdreSql, &LiaisonC))

   {

   ...

   }

...

Voir aussi

mysql_stmt_bind_result pour lier un résultat d'une requête. mysql_stmt_close pour libérer un ordre Sql.