pg_fetch_object

(PHP 4, PHP 5, PHP 7, PHP 8)

pg_fetch_object — 행을 객체로 가져옵니다.


설명

pg_fetch_object(
    PgSql\Result $result,
    ?int $row = null,
    string $class = "stdClass",
    array $constructor_args = []
): object|false
                

pg_fetch_object()는 가져온 행의 필드 이름에 해당하는 속성을 가진 객체를 반환합니다. 선택적으로 특정 클래스의 개체를 인스턴스화하고 해당 클래스의 생성자에 매개변수를 전달할 수 있습니다.

메모: 이 함수는 NULL 필드를 PHP null 값으로 설정합니다.

속도 측면에서 이 함수는 pg_fetch_array()와 동일하고 거의 pg_fetch_row()만큼 빠릅니다(차이는 미미합니다).


매개변수

result
pg_query(), pg_query_params() 또는 pg_execute()(특히)에 의해 반환된 PgSql\Result 인스턴스.
row
가져올 결과의 행 번호입니다. 행은 0부터 번호가 매겨집니다. 생략하거나 null이면 다음 행을 가져옵니다.
class
인스턴스화할 클래스의 이름, 속성을 설정하고 반환합니다. 지정하지 않으면 stdClass 객체가 반환됩니다.
constructor_args
class 개체의 생성자에 전달할 매개 변수의 선택적 배열입니다.

반환 값

결과의 각 필드 이름에 대해 하나의 속성이 있는 개체입니다. 데이터베이스 NULL 값은 null로 반환됩니다.

row이 집합의 행 수를 초과하거나 행이 더 이상 없거나 다른 오류가 발생하면 false가 반환됩니다.


변경 로그

버전 설명
8.1.0 result 매개변수는 이제 PgSql\Result 인스턴스를 예상합니다. 이전에는 resource가 필요했습니다.

Examples

예제 #1 pg_fetch_object() 예제

                  
<?php

$database = "store";

$db_conn = pg_connect("host=localhost port=5432 dbname=$database");
if (!$db_conn) {
  echo "Failed connecting to postgres database $database\n";
  exit;
}

$qu = pg_query($db_conn, "SELECT * FROM books ORDER BY author");


while ($data = pg_fetch_object($qu)) {
  echo $data->author . " (";
  echo $data->year . "): ";
  echo $data->title . "<br />";
}

pg_free_result($qu);
pg_close($db_conn);

?>
                  
                

기타