Spec-Zone .ru
спецификации, руководства, описания, API
|
int mysql_options4(MYSQL *mysql, enum mysql_option option, const void *arg1, const void
*arg2)
mysql_options4()
подобно mysql_options()
но имеет дополнительный четвертый параметр так, чтобы два
значения можно было передать для опции, определенной во втором параметре. Эта функция была добавлена в MySQL
5.6.6.
Следующий список описывает разрешенные опции, их эффект, и как arg1
и arg2
используются.
MYSQL_OPT_CONNECT_ATTR_ADD
(типы параметра: char *, char *
)
Эта опция добавляет пару ключ/значение к текущему набору атрибутов соединения, которые передадут к серверу во время соединения. Обоими параметрами являются указатели на завершенные нулем строки. Первые и вторые строки указывают на ключ и значение, соответственно. Если ключ уже существует в текущем наборе атрибутов соединения, новое значение заменяет существующий. Сравнение ключевого имени с существующими ключами является чувствительным к регистру.
Ключевые имена, которые начинаются с подчеркивания (_
) резервируются
для внутреннего пользования и не должен использоваться прикладными программами.
См. также описания для MYSQL_OPT_CONNECT_ATTR_RESET
MYSQL_OPT_CONNECT_ATTR_DELETE
опции в описании mysql_options()
функция.
Атрибуты соединения представляются через session_connect_attrs
и session_account_connect_attrs
Таблицы Схемы производительности. См.
Раздел 21.9.7, "Таблицы
атрибутов Соединения Схемы Производительности".
Нуль для успеха. Ненулевой, если Вы определяете неизвестную опцию.
Этот пример демонстрирует вызовы, которые определяют атрибуты соединения:
MYSQL mysql;mysql_init(&mysql);mysql_options4(&mysql,MYSQL_OPT_CONNECT_ATTR_RESET, 0);mysql_options4(&mysql,MYSQL_OPT_CONNECT_ATTR_ADD, "key1", "value1");mysql_options4(&mysql,MYSQL_OPT_CONNECT_ATTR_ADD, "key2", "value2");mysql_options4(&mysql,MYSQL_OPT_CONNECT_ATTR_ADD, "key3", "value3");mysql_options4(&mysql,MYSQL_OPT_CONNECT_ATTR_DELETE, "key1");if (!mysql_real_connect(&mysql,"host","user","passwd","database",0,NULL,0)){ fprintf(stderr, "Failed to connect to database: Error: %s\n", mysql_error(&mysql));}mysql_options(&mysql,MYSQL_OPT_CONNECT_ATTR_RESET, 0);