上一节:
下一节:

  PHP mysqli_stmt_affected_rows MySQLi 函数

  • 定义和用法

    mysqli_stmt_affected_rows - 返回最后执行的语句更改，删除或插入的总行数

  • 版本支持

    PHP4 PHP5 PHP7
    不支持 支持 支持

  • 语法

    mysqli_stmt_affected_rows ( mysqli_stmt $stmt )
    返回受INSERT，UPDATE或DELETE查询影响的行数。 此功能仅适用于更新表的查询。 为了从SELECT查询中获取行数，请改用 mysqli_stmt_num_rows()。

  • 参数

    参数 必需的 描述
    stmt 是 由 mysqli_stmt_init() 返回的 statement 标识。

  • 返回值

    大于零的整数表示受影响或已检索的行数。 零表示没有针对UPDATE / DELETE语句更新的记录，没有与查询中的WHERE子句匹配的行，或者尚未执行任何查询。 -1表示查询已返回错误。 NULL表示已向函数提供了无效的参数。
    如果受影响的行数大于最大PHP int值，则受影响的行数将作为字符串值返回。

  • 示例

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

/* check connection */
if (mysqli_connect_errno()) {
    printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

/* create temp table */
mysqli_query($link, "CREATE TEMPORARY TABLE myCountry LIKE Country");

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

/* prepare statement */
if ($stmt = mysqli_prepare($link, $query)) {

    /* Bind variable for placeholder */
    $code = 'A%';
    mysqli_stmt_bind_param($stmt, "s", $code);

    /* execute statement */
    mysqli_stmt_execute($stmt);

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

    /* close statement */
    mysqli_stmt_close($stmt);
}

/* close connection */
mysqli_close($link);

  • 相关函数

    mysqli_stmt_num_rows() - 返回语句结果集中的行数
    mysqli_prepare() - 准备执行一个 SQL 语句
返回全部 MySQLi 参考
上一节:
下一节: