int mysql_ping (MYSQL * MYSQL)

检查与服务器的连接是否正常。如果连接已经中断，并且启用了自动重新连接，则会尝试重新连接。如果连接断开，自动重新连接被禁用，mysql_ping ()返回一个错误。

默认情况下，禁用自动重连功能。要启用它，请调用mysql_options ()与MYSQL_OPT_RECONNECT选择。有关详细信息,请参见部分5.4.49”mysql_options ()．

mysql_ping ()可用于长时间闲置的客户端，检查服务器是否已关闭连接，必要时重新连接。

如果mysql_ping ())确实会导致重新连接，没有明确的指示。要确定是否重新连接，请调用mysql_thread_id ()在调用之前获取原始连接标识符mysql_ping (),然后调用mysql_thread_id ()再次查看标识符是否已更改。

如果重新连接，连接的某些特征将被重置。有关这些特性的详细信息，请参见第3.5.6节“自动重连控制”．

如果到服务器的连接是活动的，则为0。如果发生错误，则非零。一个非零返回值并不表示MySQL服务器本身是否关闭;由于网络问题等其他原因，连接可能会中断。