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 &...] )
}

mysqli_stmt_bind_param() は、 mysqli_prepare() に渡された SQL ステートメントの パラメータマーカに変数をバインドするために使用されます。 文字列 types にはひとつまたは複数の文字が 含まれ、これは対応するバインド変数の型を示します。

表 1. 型指定文字

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

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

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

## 返り値

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

## 参考

mysqli_stmt_bind_result()、 mysqli_stmt_execute()、 mysqli_stmt_fetch()、 mysqli_prepare()、 mysqli_stmt_send_long_data()、 mysqli_stmt_errno() そして mysqli_stmt_error()

## 例

例 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; /* プリペアドステートメントを実行します */ mysqi_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_affected_rows | 上に戻る | mysqli_stmt_bind_result