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.