pg_affected_rows
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_affected_rows — 영향을 받는 레코드(튜플)의 수를 반환합니다.
설명
pg_affected_rows(PgSql\Result $result
): int
pg_affected_rows()는 INSERT
, UPDATE
및 DELETE
쿼리의 영향을 받는 튜플(인스턴스/레코드/행)의 수를 반환합니다.
PostgreSQL 9.0 이상부터 서버는 SELECT된 행의 수를 반환합니다. 이전 PostgreSQL은 SELECT에 대해 0을 반환합니다.
메모: 이 함수는 pg_cmdtuples()라고 불렸습니다.
매개변수
result
- pg_query(), pg_query_params() 또는 pg_execute()(특히)에 의해 반환된 PgSql\Result 인스턴스.
반환 값
쿼리의 영향을 받는 행 수입니다. 영향을 받는 튜플이 없으면 0을 반환합니다.
변경 로그
버전 | 설명 |
---|---|
8.1.0 | result 매개변수는 이제 PgSql\Result 인스턴스를 예상합니다. 이전에는 resource가 필요했습니다. |
Examples
예제 #1 pg_affected_rows() 예제
<?php
$result = pg_query($conn, "INSERT INTO authors VALUES ('Orwell', 2002, 'Animal Farm')");
$cmdtuples = pg_affected_rows($result);
echo $cmdtuples . " tuples are affected.\n";
?>
위의 예는 다음을 출력합니다.
1 tuples are affected.
기타
- pg_query() - 쿼리 실행
- pg_query_params() - SQL 명령 텍스트와 별도로 매개변수를 전달할 수 있는 기능으로 서버에 명령을 제출하고 결과를 기다립니다.
- pg_execute() - 주어진 매개변수로 준비된 명령문을 실행하라는 요청을 보내고 결과를 기다립니다.
- pg_num_rows() - 결과의 행 수를 반환합니다.