直近に発生したエラーのエラーメッセージを取得する

# ingres_error

(PECL ingres >= 1.1.0)

ingres_error — 直近に発生したエラーのエラーメッセージを取得する

### 説明

ingres_error ([ resource `$link` ] ) : string

直近のエラーの内容を文字列で返します。エラーが発生していない場合は NULL を返します。

`link` リソースが ingres_error() に渡された場合、そのリンクに記録された直近のエラーを返します。 リンクが渡されなかった場合、ingres_error() はデフォルトのリンクを使用して直近のエラーを返します。

この関数 ingres_error() は、 データベースクエリを実行した直後にコールしなければなりません。 ingres_error() の前に他の関数がコールされると、 直近の Ingres 関数のコールで発生したエラーメッセージが書き換えられてしまいます。

### パラメータ

`link`

  接続リンク ID。

### 返り値

直近のエラーの内容を文字列で返します。エラーが発生していない場合は NULL を返します。

### 例

例1 直近のエラーメッセージの取得

`<?php
$link = ingres_connect($database, $user, $password);
$result = ingres_query($link, "select * from table");
$error_text = ingres_error();
if (!is_null($error_text)) {
echo "エラーが発生しました - " . $error_text;
}
?>`

### 参考

- ingres_errno() - 直近に発生した ingres エラー番号を取得する
- ingres_errsqlstate() - 直近に発生した SQLSTATE エラーコードを取得する
- ingres_next_error() - 次の Ingres エラーを取得する