mysqli_stmt::$affected_rows

(PHP 5, PHP 7, PHP 8)

mysqli_stmt::$affected_rows -- mysqli_stmt_affected_rows — 마지막으로 실행된 명령문에 의해 변경, 삭제, 삽입 또는 일치된 총 행 수를 반환합니다.


설명

객체 지향 스타일

int|string $mysqli_stmt->affected_rows;

절차적 스타일

mysqli_stmt_affected_rows(mysqli_stmt $statement): int|string

INSERT, UPDATE 또는 DELETE 쿼리의 영향을 받는 행 수를 반환합니다. SELECT 문에 대해 mysqli_stmt_num_rows()처럼 작동합니다.


매개변수

statement
절차적 스타일 전용: mysqli_stmt_init()에 의해 반환된 mysqli_stmt 객체.

반환 값

0보다 큰 정수는 영향을 받거나 검색된 행 수를 나타냅니다. 0은 UPDATE 문에 대해 업데이트된 레코드가 없거나 쿼리의 WHERE 절과 일치하는 행이 없거나 쿼리가 아직 실행되지 않았음을 나타냅니다. -1은 쿼리가 오류를 반환했거나 SELECT 쿼리의 경우 mysqli_stmt_store_result()를 호출하기 전에 mysqli_stmt_affected_rows()가 호출되었음을 나타냅니다.

메모: 영향을 받는 행의 수가 최대 PHP int 값보다 크면 영향을 받는 행의 수가 문자열 값으로 반환됩니다.


Examples

예제 #1 mysqli_stmt_affected_rows() 예제

객체 지향 스타일

                  
<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

/* create temp table */
$mysqli->query("CREATE TEMPORARY TABLE myCountry LIKE Country");

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

/* prepare statement */
$stmt = $mysqli->prepare($query);

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

/* execute statement */
$stmt->execute();

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

절차적 스타일

                  
<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

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

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

/* prepare statement */
$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));
                  
                

위의 예는 다음을 출력합니다.

Rows inserted: 17
                

기타