Spec-Zone.ru › MySQL Connectors 1.0

6.4.6 mysql_stmt_bind_result()

bool
mysql_stmt_bind_result(MYSQL_STMT *stmt,
                       MYSQL_BIND *bind)

Описание

mysql_stmt_bind_result() используется для сопоставления (связывания) выходных столбцов в наборе результатов с буферами данных и буферами длин. Когда функция mysql_stmt_fetch() вызывается для извлечения данных, протокол MySQL клиент/сервер помещает данные для связанных столбцов в указанные буферы.

Все столбцы должны быть связаны с буферами до вызова mysql_stmt_fetch(). bind — это адрес массива структур MYSQL_BIND. Библиотека клиента ожидает, что массив будет содержать по одному элементу для каждого столбца набора результатов. Если вы не свяжете столбцы со структурами MYSQL_BIND, функция mysql_stmt_fetch() просто проигнорирует извлечение данных. Буферы должны быть достаточно большими для хранения значений данных, потому что протокол не возвращает значения данных частями.

Столбец можно связать или пересвязать в любое время, даже после частичного извлечения набора результатов. Новое связывание вступает в силу при следующем вызове mysql_stmt_fetch(). Предположим, что приложение связывает столбцы в наборе результатов и вызывает mysql_stmt_fetch(). Протокол клиент/сервер возвращает данные в связанных буферах. Затем предположим, что приложение связывает столбцы с другим набором буферов. Протокол помещает данные в новые связанные буферы при следующем вызове функции mysql_stmt_fetch().

Для связывания столбца приложение вызывает mysql_stmt_bind_result() и передает тип, адрес и длину выходного буфера, в который должно быть сохранено значение. Раздел 6.2, «Структуры данных C API подготовленных заявок» описывает члены каждого элемента MYSQL_BIND и то, как они должны быть настроены для получения выходных значений.

Значения возврата

Ноль для успеха. Неноль, если произошла ошибка.

Ошибки

  • Преобразование не поддерживается. Возможно, значение buffer_type недействительно или не является одним из поддерживаемых типов.

  • Нет памяти.

  • Произошла неизвестная ошибка.

Пример

См. пример в Разделе 6.4.12, «mysql_stmt_fetch()».

© 2025 Oracle
Licensed under the GPLv2 License.
https://docs.oracle.com/cd/E17952_01/c-api-8.4-en/mysql-stmt-bind-result.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API