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

# dbx_query

(PHP 4 >= 4.0.6, PHP 5 <= 5.0.4)

dbx_query -- クエリを送信し、(ある場合には)結果を全て取得する

## 説明

mixed dbx_query ( object link_identifier, string sql_statement [, int flags] )

クエリを送信し、すべての結果を取得します。

## パラメータ

`link_identifier`

  dbx_connect() が返す DBX リンクオブジェクト。

`sql_statement`

  SQL 文。

`flags`

  比較するカラム。

`flags`

  `flags` パラメータは、返される情報の量を制御する ために使用されます。以下の定数の組み合わせを、論理 OR 演算子 (|) で連結したものとなります。DBX_COLNAMES_* フラグは `php.ini` の dbx.colnames_case 設定を上書きします。

  `DBX_RESULT_INDEX`

    これは常に設定され、結果に二次元配列の data プロパティを含めます。たとえば `data[2][3]` では `2` が行番号 （レコード番号）を表し、`3` がカラム番号 （フィールド番号）を表します。最初の行やカラムの番号は 0 です。

    `DBX_RESULT_ASSOC` が指定された場合、返される オブジェクトには `DBX_RESULT_INFO` に関連する 情報が（指定していなくても）含まれます。

  `DBX_RESULT_INFO`

    カラムに関する情報、つまりフィールド名とフィールドの型を含めます。

  `DBX_RESULT_ASSOC`

    返されるオブジェクトの data プロパティの キーとして、関連するカラム名の値がアクセスされます。

    関連付けられた結果は数値添字となっているので、 `data[0][0]` を変更すると `data[0]['最初のカラムのフィールド名']` も同様に 変更されます。

  `DBX_RESULT_UNBUFFERED` (PHP 5)

    このフラグは data プロパティを作成せず、 rows プロパティの初期値を 0 に設定します。 結果セットが大きくなる場合にこのフラグを使用し、 dbx_fetch_row() を使用して結果を 1 行ごとに 取得してください。

    dbx_fetch_row() 関数は、このクエリで設定した フラグの内容を反映じた行を返します。また、この関数がコールされる たびに rows が更新されます。

  `DBX_COLNAMES_UNCHANGED` (PHP 4.3.0 以降で使用可能)

    返されるカラム名の大文字小文字を変更しません。

  `DBX_COLNAMES_UPPERCASE` (PHP 4.3.0 以降で使用可能)

    返されるカラム名を大文字に変更します。

  `DBX_COLNAMES_LOWERCASE` (PHP 4.3.0 以降で使用可能)

    返されるカラム名を小文字に変更します。

  `flags` パラメータの実際の値にかかわらず、常に `DBX_RESULT_INDEX` が有効となることに注意しましょう。 つまり、結果的に使用可能なのは以下の組み合わせだけであるということです。

  - `DBX_RESULT_INDEX`

  - `DBX_RESULT_INDEX` | `DBX_RESULT_INFO`

  - `DBX_RESULT_INDEX` | `DBX_RESULT_INFO` | `DBX_RESULT_ASSOC` - `flags` を指定しなかった場合、これがデフォルトです。

## 返り値

dbx_query() は、成功した場合に オブジェクトあるいは `1`、失敗した場合に `0` を返します。 結果オブジェクトが返されるのは、`sql_statement` で指定されたクエリが結果セットを生成する場合（例: SELECT クエリ。結果が 0 件の場合も含む）のみです。

返される`object` は、`flags` の設定により 4 つまたは 5 つのプロパティを保持します。

handle

  接続したデータベースの有効なハンドルで、モジュール専用関数で （必要ならば）使用されます。

  `<?php $result = dbx_query($link, "SELECT id FROM table"); mysql_field_len($result->handle, 0); ?>`

cols および rows

  これらは、それぞれカラム数（フィールド数）および行数（レコード数） を表します。

  `<?php $result = dbx_query($link, 'SELECT id FROM table'); echo $result->rows; // レコード数 echo $result->cols; // フィールド数 ?>`

info (オプション)

  `flags` パラメータに `DBX_RESULT_INFO` あるいは `DBX_RESULT_ASSOC` が指定されている場合のみ 返されます。2 次元の配列で、2 つのキー（`name` および `type`）を持ち、カラムの情報を取得するために 使用します。

  例 1. 各フィールドの名前と型を一覧表示する

  `<?php $result = dbx_query($link, 'SELECT id FROM table', DBX_RESULT_INDEX | DBX_RESULT_INFO); for ($i = 0; $i < $result->cols; $i++ ) { echo $result->info['name'][$i] . "\n"; echo $result->info['type'][$i] . "\n"; } ?>`

data

  このプロパティには結果のデータが含まれます。`flags` の設定によってはこのデータはカラム名と関連付けられているでしょう。 `DBX_RESULT_ASSOC` が設定されていた場合、 `$result->data[2]["field_name"]` のように使用可能です。

  例 2. data プロパティの内容を HTML テーブルで表示する

  `<?php $result = dbx_query($link, 'SELECT id, parentid, description FROM table'); echo "<table>\n"; foreach ($result->data as $row) { echo "<tr>\n"; foreach ($row as $field) { echo "<td>$field</td>"; } echo "</tr>\n"; } echo "</table>\n"; ?>`

  例 3. UNBUFFERED クエリの処理法

  `<?php $result = dbx_query ($link, 'SELECT id, parentid, description FROM table', DBX_RESULT_UNBUFFERED); echo "<table>\n"; while ($row = dbx_fetch_row($result)) { echo "<tr>\n"; foreach ($row as $field) { echo "<td>$field</td>"; } echo "</tr>\n"; } echo "</table>\n"; ?>`

## 例

例 4. 返り値を処理する方法

`<?php $link = dbx_connect(DBX_ODBC, "", "db", "username", "password") or die("接続できませんでした"); $result = dbx_query($link, 'SELECT id, parentid, description FROM table'); if (is_object($result) ) { // ... ここで何かを行います。詳細は以下の例で示します。 ... // まず、フィールド名とデータ型を表示します。 // 次に、返されたフィールド値をもとに表を作成します。 } else { exit("クエリに失敗しました"); } dbx_close($link); ?>`

## 注意

> 注意: モジュール固有のドキュメントも参照ください。

> Oracle データベースでは、クエリ結果のカラム名は小文字で返されます。

## 参考

dbx_escape_string()
dbx_fetch_row()
dbx_connect()

前のページ | ホーム | 次のページ
dbx_fetch_row | 上に戻る | dbx_sort