23.8.7.41 mysql_list_dbs()

MYSQL_RES *mysql_list_dbs(MYSQL *mysql, const char *wild)

説明

wild パラメータによって指定された簡単な正規表現に一致するサーバー上のデータベース名から構成される結果セットを返します。wild にはワイルドカード文字 「%」 または 「_」 を含めることができ、またはすべてのデータベースに一致する NULL ポインタにできます。mysql_list_dbs() の呼び出しは、クエリー SHOW DATABASES [LIKE wild] の実行に似ています。

mysql_free_result() によって結果セットを解放する必要があります。

戻り値

成功した場合は MYSQL_RES 結果セット。エラーが発生した場合は NULL。

エラー

• CR_COMMANDS_OUT_OF_SYNC

  コマンドが正しくない順番で実行されました。

• CR_OUT_OF_MEMORY

  メモリー不足。

• CR_SERVER_GONE_ERROR

  MySQL サーバーが存在しなくなりました。

• CR_SERVER_LOST

  サーバーへの接続がクエリー中に失われました。

• CR_UNKNOWN_ERROR

  不明なエラーが発生しました。