int
mysql_ping(MYSQL *mysql)

Проверяет, работает ли подключение к серверу. Если подключение прервано, а автоматическое переподключение включено, будет предпринята попытка повторного подключения. Если подключение прервано, а автоматическое переподключение отключено, mysql_ping() возвращает ошибку.

Автоматическое переподключение отключено по умолчанию. Чтобы включить его, вызовите mysql_options() с опцией MYSQL_OPT_RECONNECT. Подробности см. в разделе 5.4.50, «mysql_options()».

mysql_ping() может использоваться клиентами, которые длительное время простаивают, для проверки, не закрыл ли сервер соединение, и для повторного подключения при необходимости.

Если mysql_ping() вызывает повторное подключение, явного указания на это нет. Чтобы определить, произошло ли повторное подключение, вызовите mysql_thread_id() для получения исходного идентификатора подключения перед вызовом mysql_ping(), затем снова вызовите mysql_thread_id(), чтобы увидеть, изменился ли идентификатор.

Если происходит переподключение, некоторые характеристики подключения будут сброшены. Подробности о этих характеристиках см. в разделе 3.6.6, «Управление автоматическим переподключением».

Ноль, если подключение к серверу активно. ненулевое значение, если произошла ошибка. ненулевое возвращаемое значение не указывает, доступен ли сам MySQL-сервер; подключение может быть прервано по другим причинам, таким как проблемы с сетью.