Spec-Zone .ru
спецификации, руководства, описания, API
|
int mysql_stmt_execute(MYSQL_STMT *stmt)
mysql_stmt_execute()
выполняет готовый запрос, связанный с дескриптором
оператора. В настоящий момент связанные значения маркера параметра отправляются серверу во время этого вызова, и
сервер заменяет маркеры этими данными, которыми недавно снабжают.
Обработка оператора после mysql_stmt_execute()
зависит от типа оператора:
Для UPDATE
, DELETE
,
или INSERT
,
число измененных, удаленных, или вставленных строк может быть найдено, вызывая mysql_stmt_affected_rows()
.
Для оператора такой как SELECT
это генерирует набор результатов, следует вызвать mysql_stmt_fetch()
выбирать данные до вызывания любых других функций,
которые приводят к обработке запроса. Для получения дополнительной информации по тому, как выбрать
результаты, обратитесь к Разделу 21.8.11.11,"mysql_stmt_fetch()
".
Не делайте следующего вызова mysql_stmt_execute()
со звонком mysql_store_result()
или mysql_use_result()
. Те функции не предназначаются для того, чтобы
обработать следствия готовых операторов.
Для операторов, которые генерируют набор результатов, можно запросить это mysql_stmt_execute()
откройте курсор для оператора, вызывая mysql_stmt_attr_set()
прежде, чем выполнить оператор. Если Вы выполняете оператор
многократно, mysql_stmt_execute()
завершения любой открытый курсор прежде, чем открыть новый.
Метаданные изменяются на таблицы или просматривают упомянутый готовыми операторами, обнаруживаются и вызывают автоматическую переподготовку оператора, когда это затем выполняется. Для получения дополнительной информации см. Раздел 8.9.4, "Кэширование Готовых Операторов и Сохраненных Программ".
Нуль, если выполнение было успешно. Ненулевой, если ошибка произошла.
Команды выполнялись в неподходящем порядке.
Из памяти.
Сервер MySQL ушел.
Соединение с сервером было потеряно во время запроса.
Произошла неизвестная ошибка.
Следующий пример демонстрирует, как создать и заполнить табличное использование mysql_stmt_init()
, mysql_stmt_prepare()
, mysql_stmt_param_count()
, mysql_stmt_bind_param()
, mysql_stmt_execute()
, и mysql_stmt_affected_rows()
. mysql
переменная, как
предполагается, является допустимым дескриптором соединения. Для примера, который показывает, как получить
данные, см. Раздел
21.8.11.11,"mysql_stmt_fetch()
".
#define STRING_SIZE 50#define DROP_SAMPLE_TABLE "DROP TABLE IF EXISTS test_table"#define CREATE_SAMPLE_TABLE "CREATE TABLE test_table(col1 INT,\ col2 VARCHAR(40),\ col3 SMALLINT,\ col4 TIMESTAMP)"#define INSERT_SAMPLE "INSERT INTO \ test_table(col1,col2,col3) \ VALUES(?,?,?)"MYSQL_STMT *stmt;MYSQL_BIND bind[3];my_ulonglong affected_rows;int param_count;short small_data;int int_data;char str_data[STRING_SIZE];unsigned long str_length;my_bool is_null;if (mysql_query(mysql, DROP_SAMPLE_TABLE)){ fprintf(stderr, " DROP TABLE failed\n"); fprintf(stderr, " %s\n", mysql_error(mysql)); exit(0);}if (mysql_query(mysql, CREATE_SAMPLE_TABLE)){ fprintf(stderr, " CREATE TABLE failed\n"); fprintf(stderr, " %s\n", mysql_error(mysql)); exit(0);}/* Prepare an INSERT query with 3 parameters *//* (the TIMESTAMP column is not named; the server *//* sets it to the current date and time) */stmt = mysql_stmt_init(mysql);if (!stmt){ fprintf(stderr, " mysql_stmt_init(), out of memory\n"); exit(0);}if (mysql_stmt_prepare(stmt, INSERT_SAMPLE, strlen(INSERT_SAMPLE))){ fprintf(stderr, " mysql_stmt_prepare(), INSERT failed\n"); fprintf(stderr, " %s\n", mysql_stmt_error(stmt)); exit(0);}fprintf(stdout, " prepare, INSERT successful\n");/* Get the parameter count from the statement */param_count= mysql_stmt_param_count(stmt);fprintf(stdout, " total parameters in INSERT: %d\n", param_count);if (param_count != 3) /* validate parameter count */{ fprintf(stderr, " invalid parameter count returned by MySQL\n"); exit(0);}/* Bind the data for all 3 parameters */memset(bind, 0, sizeof(bind));/* INTEGER PARAM *//* This is a number type, so there is no need to specify buffer_length */bind[0].buffer_type= MYSQL_TYPE_LONG;bind[0].buffer= (char *)&int_data;bind[0].is_null= 0;bind[0].length= 0;/* STRING PARAM */bind[1].buffer_type= MYSQL_TYPE_STRING;bind[1].buffer= (char *)str_data;bind[1].buffer_length= STRING_SIZE;bind[1].is_null= 0;bind[1].length= &str_length;/* SMALLINT PARAM */bind[2].buffer_type= MYSQL_TYPE_SHORT;bind[2].buffer= (char *)&small_data;bind[2].is_null= &is_null;bind[2].length= 0;/* Bind the buffers */if (mysql_stmt_bind_param(stmt, bind)){ fprintf(stderr, " mysql_stmt_bind_param() failed\n"); fprintf(stderr, " %s\n", mysql_stmt_error(stmt)); exit(0);}/* Specify the data values for the first row */int_data= 10; /* integer */strncpy(str_data, "MySQL", STRING_SIZE); /* string */str_length= strlen(str_data);/* INSERT SMALLINT data as NULL */is_null= 1;/* Execute the INSERT statement - 1*/if (mysql_stmt_execute(stmt)){ fprintf(stderr, " mysql_stmt_execute(), 1 failed\n"); fprintf(stderr, " %s\n", mysql_stmt_error(stmt)); exit(0);}/* Get the number of affected rows */affected_rows= mysql_stmt_affected_rows(stmt);fprintf(stdout, " total affected rows(insert 1): %lu\n", (unsigned long) affected_rows);if (affected_rows != 1) /* validate affected rows */{ fprintf(stderr, " invalid affected rows by MySQL\n"); exit(0);}/* Specify data values for second row, then re-execute the statement */int_data= 1000;strncpy(str_data, " The most popular Open Source database", STRING_SIZE);str_length= strlen(str_data);small_data= 1000; /* smallint */is_null= 0; /* reset *//* Execute the INSERT statement - 2*/if (mysql_stmt_execute(stmt)){ fprintf(stderr, " mysql_stmt_execute, 2 failed\n"); fprintf(stderr, " %s\n", mysql_stmt_error(stmt)); exit(0);}/* Get the total rows affected */affected_rows= mysql_stmt_affected_rows(stmt);fprintf(stdout, " total affected rows(insert 2): %lu\n", (unsigned long) affected_rows);if (affected_rows != 1) /* validate affected rows */{ fprintf(stderr, " invalid affected rows by MySQL\n"); exit(0);}/* Close the statement */if (mysql_stmt_close(stmt)){ fprintf(stderr, " failed while closing the statement\n"); fprintf(stderr, " %s\n", mysql_stmt_error(stmt)); exit(0);}
Для полных примеров на использовании готовых функций оператора обратитесь к файлу tests/mysql_client_test.c
. Этот файл может быть получен из исходного
распределения MySQL или из исходного репозитария Базара.