PHP マニュアル
前のページ |  | 次のページ

# mysqli_stmt_bind_param

(PHP 5)

mysqli_stmt_bind_param

(no version information, might be only in CVS)

stmt->bind_param() -- プリペアドステートメントのパラメータに変数をバインドする

## 説明

手続き型:

bool mysqli_stmt_bind_param ( mysqli_stmt stmt, string types, mixed &var1 [, mixed &...] )

オブジェクト指向型（メソッド）:

class mysqli_stmt {
bool bind_param ( string types, mixed &var1 [, mixed &...] )
}

変数を、SQL ステートメントのパラメータマーカにバインドします。 この変数は、mysqli_prepare() に渡されたものです。

> 注意: データのサイズがパケットサイズの最大値（max_allowed_packet）を こえた場合、`types` に `b` を 指定して mysqli_stmt_send_long_data() を使用し、 データをパケットに分割して送信する必要があります。

## パラメータ

`stmt`

  手続き型のみ: mysqli_stmt_init() が返すステートメント ID。

`types`

  ひとつあるいは複数の文字で、対応するバインド変数の型を表します。

  表 1. 型指定文字

  文字 | 説明
  --- | ---
  i | 対応する変数の型は integer です。
  d | 対応する変数の型は double です。
  s | 対応する変数の型は string です。
  b | 対応する変数の型は blob で、複数のパケットに分割して送信されます。

`var1`

  変数の数。文字列 `types` の長さは、ステートメント中のパラメータの数と一致する必要があります。

## 返り値

成功した場合に `TRUE` を、失敗した場合に `FALSE` を返します。

## 例

例 1. オブジェクト指向型

`<?php
$mysqli = new mysqli('localhost', 'my_user', 'my_password', 'world');
/* 接続状況をチェックします */
if (mysqli_connect_errno()) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
$stmt = $mysqli->prepare("INSERT INTO CountryLanguage VALUES (?, ?, ?, ?)");
$stmt->bind_param('sssd', $code, $language, $official, $percent);
$code = 'DEU';
$language = 'Bavarian';
$official = "F";
$percent = 11.2;
/* プリペアドステートメントを実行します */
$stmt->execute();
printf("%d Row inserted.\n", $stmt->affected_rows);
/* ステートメントと接続を閉じます */
$stmt->close();
/* CountryLanguage テーブルをクリアします */
$mysqli->query("DELETE FROM CountryLanguage WHERE Language='Bavarian'");
printf("%d Row deleted.\n", $mysqli->affected_rows);
/* 接続を閉じます */
$mysqli->close();
?>`

例 2. 手続き型

`<?php
$link = mysqli_connect('localhost', 'my_user', 'my_password', 'world');
/* 接続状況をチェックします */
if (!$link) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
$stmt = mysqli_prepare($link, "INSERT INTO CountryLanguage VALUES (?, ?, ?, ?)");
mysqli_stmt_bind_param($stmt, 'sssd', $code, $language, $official, $percent);
$code = 'DEU';
$language = 'Bavarian';
$official = "F";
$percent = 11.2;
/* プリペアドステートメントを実行します */
mysqli_stmt_execute($stmt);
printf("%d Row inserted.\n", mysqli_stmt_affected_rows($stmt));
/* ステートメントと接続を閉じます */
mysqli_stmt_close($stmt);
/* CountryLanguage テーブルをクリアします */
mysqli_query($link, "DELETE FROM CountryLanguage WHERE Language='Bavarian'");
printf("%d Row deleted.\n", mysqli_affected_rows($link));
/* 接続を閉じます */
mysqli_close($link);
?>`

上の例の出力は以下となります。

    1 Row inserted.
    1 Row deleted.

## 参考

mysqli_stmt_bind_result()
mysqli_stmt_execute()
mysqli_stmt_fetch()
mysqli_prepare()
mysqli_stmt_send_long_data()
mysqli_stmt_errno()
mysqli_stmt_error()

前のページ | ホーム | 次のページ
mysqli_stmt_attr_set | 上に戻る | mysqli_stmt_bind_result