int mysql_ping(MYSQL *mysql)
説明
サーバへの接続が作動しているかどうか調べる。接続がダウンしたら、自動再接続がが試みられます。
長い間働いていないままでいるクライアントサーバはこの機能を使って、接続が閉じたかどうか調べ、必要に応じて再接続することができます。
戻り値
サーバへの接続が作動しているかどうか調べるゼロ。エラーが起こった場合ゼロ以外。戻り値がゼロ以外であることは、MySQLサーバがダウンしたか、接続がネットワーク問題を含むその他の原因で破壊された恐れがあることを示します。
エラー
CR_COMMANDS_OUT_OF_SYNC
コマンドが妥当でないオーダーで実行されました。
CR_SERVER_GONE_ERROR
MySQLサーバが立ち去りました。
CR_UNKNOWN_ERROR
未知のエラーが起こりました。