mysqli_stmt_affected_rows

(PHP 5)

mysqli_stmt_affected_rows

(no version information, might be only in CVS)

mysqli_stmt->affected_rows -- 直近に実行されたステートメントで変更・削除・あるいは追加された行の総数を返す

説明

手続き型 :

int mysqli_stmt_affected_rows ( mysqli_stmt stmt )

オブジェクト指向型(プロパティ):

class mysqli_stmt {

int affected_rows

}

INSERTUPDATE あるいは DELETE クエリによって変更された行の数を返します。

この関数は、テーブルを更新するクエリに対してのみ働きます。 SELECT クエリが返す行の数を知るには、 mysqli_stmt_num_rows() 関数を代わりに使用します。

パラメータ

stmt

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

返り値

ゼロより大きい整数の場合、変更した行の数を示します。ゼロの場合は、 UPDATE/DELETE で 1 行も更新されなかった・WHERE 句にマッチする行がなかった・ あるいはまだクエリが実行されていないのいずれかであることを示します。 -1 は、クエリがエラーを返したことを示します。

注意: 変更された行の数が PHP の int 型の最大値をこえる場合は、変更された 行の数は文字列として返されます。

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

<?php
$mysqli
= new mysqli("localhost", "my_user", "my_password", "world");

/* 接続状況をチェックします */
if (mysqli_connect_errno()) {
    
printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

/* 一時テーブルを作成します */
$mysqli->query("CREATE TEMPORARY TABLE myCountry LIKE Country");

$query = "INSERT INTO myCountry SELECT * FROM Country WHERE Code LIKE ?";

/* ステートメントを準備します */
if ($stmt = $mysqli->prepare($query)) {

    
/* プレースホルダに変数をバインドします */
    
$code = 'A%';
    
$stmt->bind_param("s", $code);

    
/* ステートメントを実行します */
    
$stmt->execute();

    
printf("rows inserted: %d\n", $stmt->affected_rows);

    
/* ステートメントを閉じます */
    
$stmt->close();
}

/* 接続を閉じます */
$mysqli->close();
?>

例 2. 手続き型

<?php
$link
= mysqli_connect("localhost", "my_user", "my_password", "world");

/* 接続状況をチェックします */
if (mysqli_connect_errno()) {
    
printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

/* 一時テーブルを作成します */
mysqli_query($link, "CREATE TEMPORARY TABLE myCountry LIKE Country");

$query = "INSERT INTO myCountry SELECT * FROM Country WHERE Code LIKE ?";

/* ステートメントを準備します */
if ($stmt = mysqli_prepare($link, $query)) {

    
/* プレースホルダに変数をバインドします */
    
$code = 'A%';
    
mysqli_stmt_bind_param($stmt, "s", $code);

    
/* ステートメントを実行します */
    
mysqli_stmt_execute($stmt);

    
printf("rows inserted: %d\n", mysqli_stmt_affected_rows($stmt));

    
/* ステートメントを閉じます */
    
mysqli_stmt_close($stmt);
}

/* 接続を閉じます */
mysqli_close($link);
?>

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

rows inserted: 17

参考

mysqli_stmt_num_rows()
mysqli_prepare()