Функции коннектора Mariadb

MariaDb
//—————
int mariadb_cancel(MYSQL * mysql); //Немедленно прерывает соединение, приводя к сбою всех последующих операций чтения / записи.
int mariadb_get_infov(MYSQL * mysql, enum mariadb_value value, void * arg, …); //Извлекает общую информацию о соединении. Возвращает ноль в случае успеха, ненулевое значение в случае возникновения ошибки.
my_ulonglong mysql_affected_rows(MYSQL * mysql); //Возвращает количество строк, затронутых последней операцией ( INSERT , UPDATE , DELETE или REPLACE ), или -1, если последний запрос завершился неудачно.
my_bool mysql_autocommit(MYSQL * mysql, my_bool auto_mode); //Включает или выключает режим автоматической фиксации для текущего соединения с базой данных.
my_bool mysql_change_user(MYSQL * mysql, const char * user, const char * passwd, const char * db); //Изменяет пользователя и базу данных по умолчанию для текущего соединения.
const char * mysql_character_set_name(MYSQL * mysql); //Возвращает набор символов клиента по умолчанию для указанного соединения. character set
void mysql_close(MYSQL * mysql); //Закрывает ранее открытое соединение.
my_bool mysql_commit(MYSQL * mysql); //Фиксирует текущую транзакцию для указанного подключения к базе данных. В случае успеха возвращает ноль, в случае ошибки – ненулевое значение.
void mysql_data_seek(MYSQL_RES * result, my_ulonglong offset); //Перемещает внутренний указатель в результате запроса. В случае успеха возвращает ноль, в случае ошибки – ненулевое значение.
void mysql_debug(const char * debug); //Разрешает вывод отладки для целей разработки и отладки с помощью библиотеки DBUG Фреда Фиша.
int mysql_dump_debug_info(MYSQL * mysql); //Эта функция предназначена для выполнения пользователем с привилегией SUPER и используется для выгрузки информации о состоянии сервера в журнал для сервера MariaDB, относящегося к соединению.
unsigned int mysql_errno(MYSQL * mysql); //Возвращает последний код ошибки для самого последнего вызова функции, который может быть успешным или неудачным. Ноль означает, что ошибки не было.
const char * mysql_error(MYSQL * mysql); //Возвращает последнее сообщение об ошибке для последнего вызова функции, который может быть успешным или неудачным. Если ошибок не было, возвращается пустая строка.
MYSQL_FIELD * mysql_fetch_field(MYSQL_RES * result); //Возвращает информацию о колонке из результата запроса в виде объекта MYSQL_FIELD. Вызовите эту функцию несколько раз, чтобы получить информацию обо всех столбцах в наборе результатов.
MYSQL_FIELD * mysql_fetch_fields(MYSQL_RES * res); //Возвращает массив информации о колонках из результата запроса в виде объекта MYSQL_FIELD.
MYSQL_FIELD * mysql_fetch_field_direct(MYSQL_RES * res, unsigned int fieldnr); //Возвращает указатель на структуру MYSQL_FIELD, которая содержит информацию о полях из указанного набора результатов.
unsigned long * mysql_fetch_lengths(MYSQL_RES * result); //Функция mysql_fetch_lengths () возвращает массив, содержащий длины каждого столбца текущей строки в наборе результатов (не включая завершающий нулевой символ) или NULL, если произошла ошибка.
MYSQL_ROW mysql_fetch_row(MYSQL_RES * result); //Выбирает одну строку данных из набора результатов и возвращает ее как массив указателей на символы (MYSQL_ROW), где каждый столбец хранится со смещением, начиная с 0 (нуля). Каждый последующий вызов этой функции будет возвращать следующую строку в наборе результатов или NULL, если строк больше нет.
unsigned int mysql_field_count(MYSQL * mysql); //Возвращает количество столбцов для самого последнего запроса в соединении, представленного параметром ссылки, как целое число без знака.
MYSQL_FIELD_OFFSET mysql_field_seek(MYSQL_RES * result, MYSQL_FIELD_OFFSET offset); //Устанавливает курсор поля на заданное смещение.
MYSQL_FIELD_OFFSET mysql_field_tell(MYSQL_RES * result); //Возвращает текущее смещение курсора поля.
void mysql_free_result(MYSQL_RES * result); //Освобождает память, связанную с набором результатов.
void mysql_get_character_set_info(MYSQL * mysql, MY_CHARSET_INFO * charset); //Возвращает информацию о текущем наборе символов по умолчанию для указанного соединения.
const char * mysql_get_client_info(void ); //Возвращает строку, представляющую версию клиентской библиотеки.
unsigned long mysql_get_client_version(void); //Возвращает число, представляющее версию клиентской библиотеки.
const char * mysql_get_host_info(MYSQL * mysql); //Возвращает тип соединения, включая имя сервера.
int mysql_get_optionv(MYSQL * mysql, enum mysql_option,void * arg, …); //Извлекает значение для данной опции, которая была ранее установлена mysql_optionsv .
unsigned int mysql_get_proto_info(MYSQL * mysql); //Возвращает номер версии протокола для указанного соединения.
const char * mysql_get_server_info(MYSQL * mysql); //Возвращает версию сервера или NULL в случае ошибки.
unsigned long mysql_get_server_version(MYSQL * mysql); //Возвращает целое число, представляющее версию подключенного сервера.
const char *mysql_get_ssl_cipher(MYSQL *mysql); //Возвращает имя текущего используемого шифра TLS-соединения или NULL для не TLS-соединений.
unsigned long mysql_hex_string(char * to, const char * from, unsigned long len); //Эта функция используется для создания шестнадцатеричной строки, которую можно использовать в операторах SQL. INSERT INTO my_blob VALUES(X’A0E1CD’).
const char * mysql_info(MYSQL * mysql); //возвращает строку, содержащую информацию о последнем выполненном запросе.
MYSQL * mysql_init(MYSQL * mysql); //Подготавливает и инициализирует структуру MYSQL для использования с mysql_real_connect().
my_ulonglong mysql_insert_id(MYSQL * mysql); //Функция mysql_insert_id () возвращает идентификатор, сгенерированный запросом к таблице со столбцом, имеющим атрибут AUTO_INCREMENT, или значение для последнего использования LAST_INSERT_ID (expr).
int mysql_kill(MYSQL * mysql, unsigned long); //Эта функция используется, чтобы попросить сервер убить поток MariaDB, указанный параметром processid. При попытке убить собственное соединение следует использовать mysql_thread_id().
int mysql_library_init(int argc, char **argv, char **groups); //Вызовите для инициализации библиотеки перед вызовом других функций, как для встроенных серверов, так и для обычных клиентов. Если используется на встроенном сервере, сервер запускается и инициализируются подсистемы. Возвращает ноль в случае успеха или ненулевое значение в случае возникновения ошибки.
void mysql_library_end(void); //Вызовите по завершении использования библиотеки, например, после отключения от сервера. Во встроенном серверном приложении встроенный сервер отключается и очищается. Для клиентской программы очистка выполняется только путем выполнения задач управления памятью.
my_bool mysql_more_results(MYSQL * mysql); //Указывает, доступны ли один или несколько наборов результатов из предыдущего вызова mysql_real_query () . Возвращает 1, если доступно больше наборов результатов, в противном случае – ноль.
int mysql_next_result(MYSQL * mysql); //Подготавливает следующий набор результатов из предыдущего вызова mysql_real_query (), который может быть получен с помощью mysql_store_result() или | mysql_use_result(). В случае успеха возвращает ноль, в случае ошибки – ненулевое значение.
unsigned int mysql_num_fields(MYSQL_RES * ); //Возвращает количество полей в указанном наборе результатов.
my_ulonglong mysql_num_rows(MYSQL_RES * ); //Возвращает количество строк в наборе результатов.
int mysql_options(MYSQL * mysql, enum mysql_option, const void * arg); //Используется для установки дополнительных параметров подключения и влияния на поведение подключения.
int mysql_optionsv(MYSQL * mysql, enum mysql_option, const void * arg, …); //Используется для установки дополнительных параметров подключения и влияния на поведение подключения. Имеет список аргументов.
int mysql_ping(MYSQL * mysql); //Проверяет, работает ли соединение с сервером. Если он вышел из строя и включен глобальный параметр повторного подключения, будет предпринята попытка автоматического повторного подключения.
int mysql_query(MYSQL * mysql, const char * query); //Выполняет запрос к базе данных, на который указывает строка с завершающим нулем.
MYSQL * mysql_real_connect(MYSQL * mysql, const char * host, const char * user, const char * passwd, const char * db, unsigned int port, const char * unix_socket, unsigned long flags); //Устанавливает соединение с сервером базы данных. Возвращает описатель MYSQL * или NULL, если произошла ошибка.
unsigned long mysql_real_escape_string(MYSQL * mysql, char * to, const char * from, unsigned long); //Экранирует специальные символы в строках для использования в выражениях SQL
int mysql_real_query(MYSQL * mysql, const char * q, unsigned long); //безопасная функция для выполнения запроса на сервере базы данных.
int mysql_refresh(MYSQL * mysql, unsigned int options); //Сбрасывает различные типы информации, хранящейся на сервере.
int mysql_reset_connection(MYSQL * mysql); //Сбрасывает текущее соединение и очищает состояние сеанса.
my_bool mysql_rollback(MYSQL * mysql); //Откатывает текущую транзакцию для базы данных. В случае успеха возвращает ноль, в случае ошибки – ненулевое значение.
MYSQL_ROW_OFFSET mysql_row_seek(MYSQL_RES * result, MYSQL_ROW_OFFSET offset); //Устанавливает указатель строки в произвольную строку в наборе результатов, полученном с помощью mysql_store_result().
MYSQL_ROW_OFFSET mysql_row_tell(MYSQL_RES * res); //Возвращает смещение указателя строки результата.
int mysql_select_db(MYSQL * mysql, const char * db); //Выбирает базу данных по умолчанию. Возвращает ноль в случае успеха, ненулевое значение в случае неудачи.
int mysql_send_query(MYSQL * mysql, const char * q, unsigned long); //Отправляет запрос на сервер, не дожидаясь пакета Server OK и / или набора результатов.
int mysql_session_track_get_first(MYSQL * mysql,enum enum_session_state_type type, const char **data, size_t *length ); //извлекает первую информацию об изменении статуса сеанса, полученную от сервера.
int mysql_session_track_get_next(MYSQL * mysql,enum enum_session_state_type type, const char **data, size_t *length ); //извлекает информацию об изменении статуса сеанса, полученную с сервера после успешного вызова mysql_session_track_get_first().
int mysql_set_character_set(MYSQL * mysql, const char * csname); //Устанавливает набор символов по умолчанию для текущего соединения.
int mysql_set_server_option(MYSQL * mysql, enum enum_mysql_set_option); //Параметр сервера, который может принимать одно из заданных значений.
int mysql_shutdown(MYSQL * mysql, enum mysql_enum_shutdown_level); //Отправляет сообщение о завершении работы на сервер.
const char * mysql_sqlstate(MYSQL * mysql); //Возвращает строку, содержащую код ошибки SQLSTATE для последней вызванной функции, которая может быть успешной или неудачной.
my_bool mysql_ssl_set(MYSQL *mysql, const char *key, const char *cert, const char *ca, const char *capath, const char *cipher); //Используется для установления безопасного TLS-соединения .
const char * mysql_stat(MYSQL * mysql); //возвращает строку с текущим статусом сервера для времени безотказной работы, потоков, запросов, открытых таблиц, сброса таблиц и запросов в секунду.
MYSQL_RES * mysql_store_result(MYSQL * mysql); //Возвращает буферизованный набор результатов из последнего выполненного запроса.
void mysql_thread_end(void ); // Он освободит память для конкретного потока, которая была выделена предыдущим вызовом mysql_thread_init().
unsigned long mysql_thread_id(MYSQL * mysql); //Функция mysql_thread_id () возвращает идентификатор потока для текущего соединения.
my_bool mysql_thread_init(void ); //Инициализация потоков для многопоточных клиентов.
unsigned int mysql_thread_safe(void ); //Указывает, скомпилирована ли клиентская библиотека как потокобезопасная. Возвращает, 1 если клиентская библиотека была скомпилирована как потокобезопасная, в противном случае – ноль.
MYSQL_RES * mysql_use_result(MYSQL * mysql); //Используется для инициирования извлечения набора результатов из последнего запроса, выполненного с помощью функции mysql_real_query () в соединении с базой данных.
unsigned int mysql_warning_count(MYSQL * mysql); //Возвращает количество предупреждений из последнего выполненного запроса или ноль, если предупреждений нет.
my_bool mariadb_reconnect(MYSQL * mysql); // пытается повторно подключиться к серверу в случае, если соединение прервано из-за тайм-аута или других ошибок.