dbx_error

(PHP 4 >= 4.0.6, PHP 5 <= 5.0.5, PECL dbx >= 1.1.0)

dbx_error — 使用するモジュールの最新の関数コールにおけるエラーメッセージを出力する

説明

string dbx_error ( object $link_identifier )

dbx_error() は、直近のエラーメッセージを返します。

パラメータ

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

返り値

抽象化されたモジュール（例えば mysql モジュール）の直近の関数コールからエラーメッセージを有する文字列を返します。同じモジュールに複数の接続がある場合、最後のエラーのみが取得されます。別のモジュールに接続がある場合、（link_identifier パラメータで）指定したモジュールに関する直近のエラーのみが返されます。

例

例1 dbx_error() の例


<?php
$link   = dbx_connect(DBX_MYSQL, "localhost", "db", "username", "password")
    or die("接続に失敗しました");

$result = dbx_query($link, "select id from non_existing_table");
if ($result == 0) {
    echo dbx_error($link);
}
dbx_close($link);
?>

注意

注意: モジュール固有のドキュメントも参照ください。
Microsoft SQL Server に関するエラーメッセージは、実際には mssql_get_last_message() 関数の結果となります。
Oracle (oci8) に関するエラーメッセージは、（まだ）実装されていません。