<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="sqlite3stmt.bindparam" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<refnamediv>

<refname>SQLite3Stmt::bindParam</refname>

<refpurpose>Lie un paramètre à une variable de déclaration</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis role="SQLite3Stmt">

<modifier>public</modifier> <type>bool</type><methodname>SQLite3Stmt::bindParam</methodname>

<methodparam><type class="union"><type>string</type><type>int</type></type><parameter>param</parameter></methodparam>

<methodparam><type>mixed</type><parameter role="reference">var</parameter></methodparam>

<methodparam choice="opt"><type>int</type><parameter>type</parameter><initializer><constant>SQLITE3_TEXT</constant></initializer></methodparam>

</methodsynopsis>

<para>

Lie un paramètre à une variable de déclaration.

</para>

<caution>

<para>

Avant PHP 7.2.14 et 7.3.0, respectivement,

<methodname>SQLite3Stmt::reset</methodname> doit être appelé après le premier

appel à <methodname>SQLite3Stmt::execute</methodname> si la valeur liée

devrait être correctement mise à jour lors des appels suivants à

<methodname>SQLite3Stmt::execute</methodname>.

Si <methodname>SQLite3Stmt::reset</methodname> n'est pas appelé, les valeurs

liées ne seront pas modifiées, même si la valeur assignée à la variable passée à

<methodname>SQLite3Stmt::bindParam</methodname> a été modifiée, ou

<methodname>SQLite3Stmt::bindParam</methodname> a été appelé une nouvelle fois.

</para>

</caution>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>param</parameter></term>

<listitem>

<para>

Soit une &string; (pour les paramètres nommés) ou un &integer;

(pour les paramètres positionnels) identifiant la variable de déclaration à

laquelle la valeur doit être liée.

Si un paramètre nommé ne débute pas avec un caractère "deux points"

(<literal>:</literal>) ou un arobase (<literal>@</literal>), "deux points"

(<literal>:</literal>) seront automatiquement préfixés.

Les paramètres positionnels commencent avec <literal>1</literal>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>var</parameter></term>

<listitem>

<para>

Le paramètre à lier à la variable de déclaration.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>type</parameter></term>

<listitem>

<para>

Le type de données du paramètre à lier.

<itemizedlist>

<listitem>

<para>

<constant>SQLITE3_INTEGER</constant> : La valeur est un entier signé,

stocké sur 1, 2, 3, 4, 6, ou 8 octets, suivant la grandeur de la valeur.

</para>

</listitem>

<listitem>

<para>

<constant>SQLITE3_FLOAT</constant> : La valeur est un nombre à virgule

flottante, stocké sur 8 octets.

</para>

</listitem>

<listitem>

<para>

<constant>SQLITE3_TEXT</constant> : La valeur est un texte, stocké

en utilisant l'encodage de la base de données

(UTF-8, UTF-16BE ou UTF-16-LE).

</para>

</listitem>

<listitem>

<para>

<constant>SQLITE3_BLOB</constant> : La valeur est un BLOB, stocké

exactement de la façon dont il a été fourni.

</para>

</listitem>

<listitem>

<para>

<constant>SQLITE3_NULL</constant> : La valeur est la valeur NULL.

</para>

</listitem>

</itemizedlist>

</para>

<para>

À partir de PHP 7.0.7, si <parameter>type</parameter> est omis, il est

automatiquement détecté depuis le type de <parameter>var</parameter> :

&boolean; et &integer; sont traités comme <constant>SQLITE3_INTEGER</constant>,

&float; comme <constant>SQLITE3_FLOAT</constant>,

&null; comme <constant>SQLITE3_NULL</constant>

et tous les autres comme <constant>SQLITE3_TEXT</constant>.

Auparavant, si <parameter>type</parameter> était omis, il était par défaut

<constant>SQLITE3_TEXT</constant>.

</para>

<note>

<para>

Si <parameter>var</parameter> est &null;, c'était toujours traité comme

<constant>SQLITE3_NULL</constant>, peu importe le

<parameter>type</parameter> fourni.

</para>

</note>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Retourne &true; si le paramètre est lié à la variable de déclaration, &false; si

une erreur survient.

</para>

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>7.4.0</entry>

<entry>

<parameter>param</parameter> supporte désormais la notation

<literal>@param</literal>.

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>Utilisation de <function>SQLite3Stmt::bindParam</function></title>

<para>

Cet exemple montre comment une déclaration préparée unique avec un seul

paramètre lié peut être utilisée pour insérer plusieurs lignes avec des

valeurs différentes.

</para>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen role="php">

</screen>

</example>

</para>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<simplelist>

<member><methodname>SQLite3Stmt::bindValue</methodname></member>

<member><methodname>SQLite3::prepare</methodname></member>

</simplelist>

</refsect1>

</refentry>