Функции, доступные в API C, получаются в итоге здесь и описываются более подробно в более позднем разделе. См. Раздел 22.8.7, "Описания API-функции C".

Прикладные программы должны использовать эту общую схему для того, чтобы взаимодействовать с MySQL:

Цель вызвать mysql_library_init() и mysql_library_end() должен обеспечить надлежащую инициализацию и завершение библиотеки MySQL. Для приложений, которые соединяются с клиентской библиотекой, они обеспечивают улучшенное управление памятью. Если Вы не вызываете mysql_library_end(), блок памяти остается выделенным. (Это не увеличивает объем памяти, используемый приложением, но некоторые детекторы утечки памяти будут жаловаться на это.) Для приложений, которые соединяются со встроенным сервером, эти вызовы запускают и останавливают сервер.

В немногопоточной среде, звонке mysql_library_init() может быть опущен, потому что mysql_init() вызовет это автоматически по мере необходимости. Однако, mysql_library_init() не ориентировано на многопотоковое исполнение в многопоточной среде, и таким образом ни один не mysql_init(), который вызывает mysql_library_init(). Следует или вызвать mysql_library_init() до порождения любых потоков, или иначе использования взаимное исключение, чтобы защитить вызов, вызываете ли Вы mysql_library_init() или косвенно через mysql_init(). Это должно быть сделано до любого другого клиентского вызова библиотеки.

Чтобы соединиться с сервером, вызвать mysql_init() чтобы инициализировать обработчик соединения, затем вызовите mysql_real_connect() с тем обработчиком (наряду с другой информацией, такой как имя хоста, имя пользователя, и пароль). На соединение, mysql_real_connect() наборы reconnect флаг (часть MYSQL структура) к значению 1 в версиях API, более старого чем 5.0.3, или 0 в более новых версиях. Значение 1 поскольку этот флаг указывает на это, если оператор не может быть выполнен из-за потерянного соединения, чтобы попытаться повторно соединиться с сервером перед отказом. Можно использовать MYSQL_OPT_RECONNECT опция к mysql_options() управлять поведением пересоединения. Когда Вы делаетесь с соединением, вызвать mysql_close() завершать это.

В то время как соединение является активным, клиент может отправить SQL-операторы использованию сервера mysql_query() или mysql_real_query(). Различие между этими двумя - это mysql_query() ожидает, что запрос будет определен как завершенная нулем строка тогда как mysql_real_query() ожидает считаемую строку. Если строка содержит двоичных данных (который может включать нулевые байты), следует использовать mysql_real_query().

Для каждого не -SELECT запрос (например, INSERT, UPDATE, DELETE), можно узнать, сколько строк было изменено (влиявшие), вызывая mysql_affected_rows().

Для SELECT запросы, Вы получаете выбранные строки в результате набор. (Отметьте, что некоторые операторы SELECT- как, в котором они возвращают строки. Они включают SHOW, DESCRIBE, и EXPLAIN. Обработайте эти операторы тот же самый путь как SELECT операторы.)

Есть два способа для клиента обработать наборы результатов. Один путь состоит в том, чтобы получить весь набор результатов внезапно, вызывая mysql_store_result(). Эта функция получает от сервера все строки, возвращенные запросом, и хранит их в клиенте. Второй путь для клиента, чтобы инициировать извлечение набора результатов строки строкой, вызывая mysql_use_result(). Эта функция инициализирует извлечение, но фактически не получает строк от сервера.

В обоих случаях Вы получаете доступ к строкам, вызывая mysql_fetch_row(). С mysql_store_result(), mysql_fetch_row() строки доступов, которые были ранее выбраны от сервера. С mysql_use_result(), mysql_fetch_row() фактически получает строку от сервера. Информация о размере данных в каждой строке доступна, вызывая mysql_fetch_lengths().

После того, как Вы делаетесь с набором результатов, вызвать mysql_free_result() освободить память, используемую для этого.

Два механизма извлечения дополнительны. Выберите подход, который является самым подходящим для каждого клиентского приложения. Практически, клиенты склонны использовать mysql_store_result() более обычно.

Преимущество mysql_store_result() это, потому что строки были все выбраны клиенту, не только можно получить доступ к строкам последовательно, можно двинуться вперед-назад в использовании набора результатов mysql_data_seek() или mysql_row_seek() изменить текущую позицию строки в пределах набора результатов. Можно также узнать, сколько строки там, вызывая mysql_num_rows(). С другой стороны, требования к памяти для mysql_store_result() может быть очень высоким для больших наборов результатов, и Вы, более вероятно, встретитесь с условиями из памяти.

Преимущество mysql_use_result() это, клиент требует меньшего количества памяти для набора результатов, потому что это поддерживает только одну строку за один раз (и потому что есть меньше издержек выделения, mysql_use_result() может быть быстрее). Недостатки - то, что следует обработать каждую строку быстро, чтобы избежать связывать сервер, у Вас нет произвольного доступа к строкам в пределах набора результатов (можно только получить доступ к строкам последовательно), и Вы не знаете, сколько строк находится в наборе результатов, пока Вы не получили их всех. Кроме того следует получить все строки, даже если Вы определяете в середине извлечения, что Вы нашли информацию, которую Вы искали.

API позволяет клиентам соответственно ответить на операторы (получающий строки только по мере необходимости), не зная, является ли оператор a SELECT. Можно сделать это, вызывая mysql_store_result() после каждого mysql_query() (или mysql_real_query()). Если вызов набора результатов успешно выполняется, оператор был a SELECT и можно считать строки. Если вызов набора результатов перестал работать, вызвать mysql_field_count() определить, состоял ли результат в том, чтобы фактически ожидаться. Если mysql_field_count() нуль возвратов, оператор, возвращенный никакие данные (указание, что это было INSERT, UPDATE, DELETE, и т.д), и, как ожидали, не возвратит строки. Если mysql_field_count() является ненулевым, оператор должен был возвратить строки, но не сделал. Это указывает, что оператор был a SELECT отказавшее. См. описание для mysql_field_count() для примера того, как это может быть сделано.

Оба mysql_store_result() и mysql_use_result() позвольте Вам получить информацию о полях, которые составляют набор результатов (число полей, их имен и типов, и т.д). Можно получить доступ к информации о поле последовательно в строке, вызывая mysql_fetch_field() неоднократно, или полевым числом в строке, вызывая mysql_fetch_field_direct(). Текущая полевая позиция курсора может быть изменена, вызывая mysql_field_seek(). Установка полевого курсора влияет на последующие звонки mysql_fetch_field(). Можно также получить информацию для полей внезапно, вызывая mysql_fetch_fields().

Для обнаружения и создания отчетов об ошибках, MySQL обеспечивает доступ к информации об ошибке посредством mysql_errno() и mysql_error() функции. Они возвращают код ошибки или сообщение об ошибке для последний раз вызванной функции, которая может успешно выполниться или перестать работать, позволяя Вам определить, когда ошибка произошла и каково это было.