pg_fetch_object

(PHP 3>= 3.0.1, PHP 4 )

pg_fetch_object -- 行をオブジェクトとして得る

説明

object pg_fetch_object ( resource result, int row [, int result_type])

pg_fetch_object()は、取得した行に対応するプロ パティを有するオブジェクトを返します。この関数は、行がもうない場 合またはエラーにはFALSEを返します。

pg_fetch_object()pg_fetch_array()に似ていますが、配列の代わりに オブジェクトが返されという違いがあります。間接的に、このことはデー タがオフセットではなくフィールド名によってのみアクセス可能である ことを意味します。(数字はプロパティ名として使用できません。)

result_typeは、返り値の初期化方法を制御す るオプションのパラメータです。result_type は定数であり、次の値のどれかとすることが可能です。: PGSQL_ASSOC, PGSQL_NUM, and PGSQL_BOTH。 pg_fetch_array()は、PGSQL_ASSOCのキーとしてフィー ルド名がある連想配列を返します。PGSQL_NUMをキーとした場合はフィー ルド添字、PGSQL_BOTHをキーとした場合はフィールド名/添字です。デフォ ルトは、PGSQL_BOTHです。

注意 result_typeはPHP4.0で追加されました。

速度面では、この関数は、pg_fetch_array()と同じであり、 pg_fetch_row()とほとんど同じ程度です。 (違いはわずかです)

pg_exec(), pg_fetch_array(), pg_fetch_row(), pg_result() も参照下さい。

例 1Postgres によりオブジェクトを取得する

<?php 
$database = "verlag";
$db_conn = pg_connect ("host=localhost port=5432 dbname=$database");
if (!$db_conn): ?>
    <H1>Failed connecting to postgres database <? echo $database ?></H1> <?php
    exit;
endif;
 
$qu = pg_exec ($db_conn, "SELECT * FROM verlag ORDER BY autor");
$row = 0; // Postgresでは他のデータベースと異なり、行カウンタが必要
 
while ($data = pg_fetch_object ($qu, $row)) {
    echo $data->autor." (";
    echo $data->jahr ."): ";
    echo $data->titel."<BR>";
    $row++;
}
?>
<PRE>
<?php
$fields[] = Array ("autor", "Author");
$fields[] = Array ("jahr",  "  Year");
$fields[] = Array ("titel", " Title");
 
$row= 0; // Postgresでは他のデータベースと異なり、行カウンタが必要
while ($data = pg_fetch_object ($qu, $row)) {
    echo "----------\n";
    reset ($fields);
    while (list (,$item) = each ($fields)):
        echo $item[1].": ".$data->$item[0]."\n";
    endwhile;
    $row++;
}
echo "----------\n"; ?>
</PRE> 
<?php
pg_freeresult ($qu);
pg_close ($db_conn);
?>

注意 4.1.0以降、rowはオプションです。