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

}

mysqli_stmt_affected_rows() は INSERT、UPDATE あるいは DELETE クエリにより変更された行の数を返します。 直近のクエリが不正な形式であった場合、この関数は -1 を返します。

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

返り値

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

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

参考

mysqli_stmt_num_rows() そして mysqli_prepare()

例 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