PHP マニュアル
前のページ |  | 次のページ

# pg_result_status

(PHP 4 >= 4.2.0, PHP 5)

pg_result_status -- クエリ結果のステータスを取得する

## 説明

mixed pg_result_status ( resource result [, int type] )

pg_result_status() は、結果リソースのステータス あるいは結果に関するコマンド補完タグを返します。

## パラメータ

`result`

  pg_query(), pg_query_params() あるいは pg_execute() から返される PostgreSQL の クエリ結果リソース。

`type`

  `result` の数値ステータスを返す `PGSQL_STATUS_LONG`、あるいは `result` のコマンドタグを返す `PGSQL_STATUS_STRING` のいずれかです。 指定しない場合は `PGSQL_STATUS_LONG` がデフォルトです。

## 返り値

`PGSQL_STATUS_LONG` が指定された場合の返り値は 以下のいずれかです。 `PGSQL_EMPTY_QUERY`、 `PGSQL_COMMAND_OK`、`PGSQL_TUPLES_OK`、`PGSQL_COPY_OUT`、 `PGSQL_COPY_IN`、`PGSQL_BAD_RESPONSE`、`PGSQL_NONFATAL_ERROR` および `PGSQL_FATAL_ERROR` 。 それ以外の場合は、PostgreSQL コマンドタグを含む文字列を返します。

## 例

例 1. pg_result_status() の例

`<?php // データベースに接続する $conn = pg_pconnect("dbname=publisher"); // COPY を実行する $result = pg_query($conn, "COPY authors FROM STDIN;"); // 結果ステータスを得る $status = pg_result_status($result); // ステータスの内容を調べる if ($status == PGSQL_COPY_IN) echo "Copy began."; else echo "Copy failed."; ?>`

上の例の出力は以下となります。

    Copy began.

## 参考

pg_connection_status()

前のページ | ホーム | 次のページ
pg_result_seek | 上に戻る | pg_select