From 7b19dd2257274a61cc5e9ee0bbdc63468a98e422 Mon Sep 17 00:00:00 2001 From: Andrey Gromov Date: Mon, 28 Nov 2016 09:45:46 +0000 Subject: [PATCH] 38 new git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@341203 c90b9560-bf6c-de11-be94-00142212c4b1 --- reference/ifx/functions/ifx-affected-rows.xml | 114 +++++++++++ .../ifx/functions/ifx-blobinfile-mode.xml | 66 +++++++ reference/ifx/functions/ifx-byteasvarchar.xml | 75 ++++++++ reference/ifx/functions/ifx-close.xml | 102 ++++++++++ reference/ifx/functions/ifx-connect.xml | 128 ++++++++++++ reference/ifx/functions/ifx-copy-blob.xml | 76 ++++++++ reference/ifx/functions/ifx-create-blob.xml | 96 +++++++++ reference/ifx/functions/ifx-create-char.xml | 75 ++++++++ reference/ifx/functions/ifx-do.xml | 103 ++++++++++ reference/ifx/functions/ifx-error.xml | 99 ++++++++++ reference/ifx/functions/ifx-errormsg.xml | 91 +++++++++ reference/ifx/functions/ifx-fetch-row.xml | 131 +++++++++++++ .../ifx/functions/ifx-fieldproperties.xml | 105 ++++++++++ reference/ifx/functions/ifx-fieldtypes.xml | 103 ++++++++++ reference/ifx/functions/ifx-free-blob.xml | 75 ++++++++ reference/ifx/functions/ifx-free-char.xml | 75 ++++++++ reference/ifx/functions/ifx-free-result.xml | 78 ++++++++ reference/ifx/functions/ifx-get-blob.xml | 75 ++++++++ reference/ifx/functions/ifx-get-char.xml | 75 ++++++++ reference/ifx/functions/ifx-getsqlca.xml | 106 ++++++++++ .../ifx/functions/ifx-htmltbl-result.xml | 108 +++++++++++ reference/ifx/functions/ifx-nullformat.xml | 66 +++++++ reference/ifx/functions/ifx-num-fields.xml | 96 +++++++++ reference/ifx/functions/ifx-num-rows.xml | 79 ++++++++ reference/ifx/functions/ifx-pconnect.xml | 115 +++++++++++ reference/ifx/functions/ifx-prepare.xml | 130 +++++++++++++ reference/ifx/functions/ifx-query.xml | 182 ++++++++++++++++++ reference/ifx/functions/ifx-textasvarchar.xml | 75 ++++++++ reference/ifx/functions/ifx-update-blob.xml | 85 ++++++++ reference/ifx/functions/ifx-update-char.xml | 85 ++++++++ reference/ifx/functions/ifxus-close-slob.xml | 76 ++++++++ reference/ifx/functions/ifxus-create-slob.xml | 79 ++++++++ reference/ifx/functions/ifxus-free-slob.xml | 75 ++++++++ reference/ifx/functions/ifxus-open-slob.xml | 88 +++++++++ reference/ifx/functions/ifxus-read-slob.xml | 84 ++++++++ reference/ifx/functions/ifxus-seek-slob.xml | 93 +++++++++ reference/ifx/functions/ifxus-tell-slob.xml | 75 ++++++++ reference/ifx/functions/ifxus-write-slob.xml | 84 ++++++++ 38 files changed, 3523 insertions(+) create mode 100644 reference/ifx/functions/ifx-affected-rows.xml create mode 100644 reference/ifx/functions/ifx-blobinfile-mode.xml create mode 100644 reference/ifx/functions/ifx-byteasvarchar.xml create mode 100644 reference/ifx/functions/ifx-close.xml create mode 100644 reference/ifx/functions/ifx-connect.xml create mode 100644 reference/ifx/functions/ifx-copy-blob.xml create mode 100644 reference/ifx/functions/ifx-create-blob.xml create mode 100644 reference/ifx/functions/ifx-create-char.xml create mode 100644 reference/ifx/functions/ifx-do.xml create mode 100644 reference/ifx/functions/ifx-error.xml create mode 100644 reference/ifx/functions/ifx-errormsg.xml create mode 100644 reference/ifx/functions/ifx-fetch-row.xml create mode 100644 reference/ifx/functions/ifx-fieldproperties.xml create mode 100644 reference/ifx/functions/ifx-fieldtypes.xml create mode 100644 reference/ifx/functions/ifx-free-blob.xml create mode 100644 reference/ifx/functions/ifx-free-char.xml create mode 100644 reference/ifx/functions/ifx-free-result.xml create mode 100644 reference/ifx/functions/ifx-get-blob.xml create mode 100644 reference/ifx/functions/ifx-get-char.xml create mode 100644 reference/ifx/functions/ifx-getsqlca.xml create mode 100644 reference/ifx/functions/ifx-htmltbl-result.xml create mode 100644 reference/ifx/functions/ifx-nullformat.xml create mode 100644 reference/ifx/functions/ifx-num-fields.xml create mode 100644 reference/ifx/functions/ifx-num-rows.xml create mode 100644 reference/ifx/functions/ifx-pconnect.xml create mode 100644 reference/ifx/functions/ifx-prepare.xml create mode 100644 reference/ifx/functions/ifx-query.xml create mode 100644 reference/ifx/functions/ifx-textasvarchar.xml create mode 100644 reference/ifx/functions/ifx-update-blob.xml create mode 100644 reference/ifx/functions/ifx-update-char.xml create mode 100644 reference/ifx/functions/ifxus-close-slob.xml create mode 100644 reference/ifx/functions/ifxus-create-slob.xml create mode 100644 reference/ifx/functions/ifxus-free-slob.xml create mode 100644 reference/ifx/functions/ifxus-open-slob.xml create mode 100644 reference/ifx/functions/ifxus-read-slob.xml create mode 100644 reference/ifx/functions/ifxus-seek-slob.xml create mode 100644 reference/ifx/functions/ifxus-tell-slob.xml create mode 100644 reference/ifx/functions/ifxus-write-slob.xml diff --git a/reference/ifx/functions/ifx-affected-rows.xml b/reference/ifx/functions/ifx-affected-rows.xml new file mode 100644 index 000000000..19fc09bcc --- /dev/null +++ b/reference/ifx/functions/ifx-affected-rows.xml @@ -0,0 +1,114 @@ + + + + + + + ifx_affected_rows + Получить число строк затронутых запросом + + + + &reftitle.description; + + intifx_affected_rows + resourceresult_id + + + Возвращает количество строк затронутых запросом, ассоциированным с ресурсом + result_id. + + + Для INSERT, UPDATE и DELETE, это число является корректным + (sqlerrd[2]) количеством затронутых строк. Для SELECT оно является предположительным + (sqlerrd[0]). Не полагайтесь на него. Сервер баз данных никогда не возвращает + количество строк, возвращенных запросом SELECT, потому что он даже не начал + подгружать их на данном этапе (только после "PREPARE", когда оптимизатор составил план + запроса). + + + Полезно использовать после ifx_prepare для ограничения + необходимого результирующего набора. + + + + + &reftitle.parameters; + + + + result_id + + + Корректный идентификатор результата, возвращенный ifx_query + или ifx_prepare. + + + + + + + + + &reftitle.returnvalues; + + Возвращает количество строк в виде целого числа.. + + + + + &reftitle.examples; + + + Informix, затронутые строки + + 1000) { + printf ("Too many rows in result set (%d)\n
", $rowcount); + die ("Please restrict your query
\n"); +} +?> +]]> +
+
+
+
+ + + &reftitle.seealso; + + + ifx_num_rows + + + + +
+ + diff --git a/reference/ifx/functions/ifx-blobinfile-mode.xml b/reference/ifx/functions/ifx-blobinfile-mode.xml new file mode 100644 index 000000000..2e9e9b391 --- /dev/null +++ b/reference/ifx/functions/ifx-blobinfile-mode.xml @@ -0,0 +1,66 @@ + + + + + + + ifx_blobinfile_mode + Устанавливает режим BLOB для всех запросов типа SELECT + + + + &reftitle.description; + + boolifx_blobinfile_mode + intmode + + + Устанавливает режим BLOB для всех запросов типа SELECT. + + + + + &reftitle.parameters; + + + + mode + + + Режим "0" означает, что BLOB будут сохраняться в памяти, а "0", что в файл. + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + + diff --git a/reference/ifx/functions/ifx-byteasvarchar.xml b/reference/ifx/functions/ifx-byteasvarchar.xml new file mode 100644 index 000000000..05a636ca0 --- /dev/null +++ b/reference/ifx/functions/ifx-byteasvarchar.xml @@ -0,0 +1,75 @@ + + + + + + + ifx_byteasvarchar + Установить поведение по умолчанию для BYTE + + + + &reftitle.description; + + boolifx_byteasvarchar + intmode + + + Устанавливает поведение по умолчанию для BYTE для запросов типа SELECT. + + + + + &reftitle.parameters; + + + + mode + + + При режиме "0" будут возвращаться идентификаторы BLOB, при "1" VARCHAR с контентом. + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.seealso; + + + ifx_textasvarchar + + + + + + + diff --git a/reference/ifx/functions/ifx-close.xml b/reference/ifx/functions/ifx-close.xml new file mode 100644 index 000000000..58da23042 --- /dev/null +++ b/reference/ifx/functions/ifx-close.xml @@ -0,0 +1,102 @@ + + + + + + + ifx_close + Закрыть соединение с Informix + + + + &reftitle.description; + + boolifx_close + resourcelink_identifier + + + ifx_close закрывает соединение с базой данных Informix. + + + Обратите внимание, что обычно исользовать эту функцию нет смысла. + Все не постоянные соединения автоматически закрываются по окончанию работы скрипта. + + + ifx_close не закрывает постоянные соединения, полученные + из ifx_pconnect. + + + + + &reftitle.parameters; + + + + link_identifier + + + Идентификатор соединения. Если не задан, то закроется последнее открытое соединение. + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.examples; + + + Закрытие соединения с Informix + + +]]> + + + + + + + &reftitle.seealso; + + + ifx_connect + ifx_pconnect + + + + + + + diff --git a/reference/ifx/functions/ifx-connect.xml b/reference/ifx/functions/ifx-connect.xml new file mode 100644 index 000000000..b05c3431a --- /dev/null +++ b/reference/ifx/functions/ifx-connect.xml @@ -0,0 +1,128 @@ + + + + + + + ifx_connect + Открытия соединения с базой данных Informix + + + + &reftitle.description; + + resourceifx_connect + stringdatabase + stringuserid + stringpassword + + + ifx_connect устанавливает соединение с базой данных Informix. + + + Если функция ifx_connect будет повторно вызвана с такими + же аргументами, то новое соединение не будет установлено и, вместо него, вернется + уже существующее. + + + Соединение с сервером будет автоматически закрыто после окончания работы скрипта. + Либо его можно закрыть самостоятельно функией + ifx_close. + + + + + &reftitle.parameters; + + Все аргументы опциональны. Если они не заданы, то будут использованы значения по + умолчанию, заданные в &php.ini; (ifx.default_host для хоста + (библиотеки Informix будут использовать переменную окружения + INFORMIXSERVER, если значение не задано), + ifx.default_user для пользователя, ifx.default_password для пароля (если не задано, то + будеет пытаться соединиться без пароля). + + + + + database + + + Строка, содержащая имя базы данных. + + + + + userid + + + Строка с именем пользователя. + + + + + password + + + Строка с паролем. + + + + + + + + + &reftitle.returnvalues; + + В случае успеха возвращает идентификатор соединения, в случае ошибки &false;. + + + + + &reftitle.examples; + + + Соединение с базой данных + + +]]> + + + + + + + &reftitle.seealso; + + + ifx_pconnect + ifx_close + + + + + + + diff --git a/reference/ifx/functions/ifx-copy-blob.xml b/reference/ifx/functions/ifx-copy-blob.xml new file mode 100644 index 000000000..537d6bc07 --- /dev/null +++ b/reference/ifx/functions/ifx-copy-blob.xml @@ -0,0 +1,76 @@ + + + + + + + ifx_copy_blob + Создать дубликат заданного объекта BLOB + + + + &reftitle.description; + + intifx_copy_blob + intbid + + + Создает дубликат заданного объекта BLOB. + + + + + &reftitle.parameters; + + + + bid + + + Идентификатор BLOB. + + + + + + + + + &reftitle.returnvalues; + + Возвращает идентификатор нового объекта BLOB, или &false; в случае ошибки. + + + + + &reftitle.seealso; + + + ifx_create_blob + ifx_free_blob + + + + + + + diff --git a/reference/ifx/functions/ifx-create-blob.xml b/reference/ifx/functions/ifx-create-blob.xml new file mode 100644 index 000000000..7766e79f6 --- /dev/null +++ b/reference/ifx/functions/ifx-create-blob.xml @@ -0,0 +1,96 @@ + + + + + + + ifx_create_blob + Создать объект BLOB + + + + &reftitle.description; + + intifx_create_blob + inttype + intmode + stringparam + + + Создает объект BLOB. + + + + + &reftitle.parameters; + + + + type + + + 1 = TEXT, 0 = BYTE + + + + + mode + + + 0 = объект BLOB держит контент в памяти, + 1 = объект BLOB держит контент в файле. + + + + + param + + + Если mode = 0: указывает на контент. + Если mode = 1: указывает на строку с именем файла. + + + + + + + + + &reftitle.returnvalues; + + Возвращает идентификатор нового объекта BLOB, или &false; в случае ошибки. + + + + + &reftitle.seealso; + + + ifx_copy_blob + ifx_free_blob + + + + + + + diff --git a/reference/ifx/functions/ifx-create-char.xml b/reference/ifx/functions/ifx-create-char.xml new file mode 100644 index 000000000..d11453a71 --- /dev/null +++ b/reference/ifx/functions/ifx-create-char.xml @@ -0,0 +1,75 @@ + + + + + + + ifx_create_char + Создает символьный объект + + + + &reftitle.description; + + intifx_create_char + stringparam + + + Создает символьный объект. + + + + + &reftitle.parameters; + + + + param + + + Контент создаваемого объекта. + + + + + + + + + &reftitle.returnvalues; + + Возвращает идентификатор объекта, или &false; в случае ошибки. + + + + + &reftitle.seealso; + + + ifx_free_char + + + + + + + diff --git a/reference/ifx/functions/ifx-do.xml b/reference/ifx/functions/ifx-do.xml new file mode 100644 index 000000000..36ff44a5a --- /dev/null +++ b/reference/ifx/functions/ifx-do.xml @@ -0,0 +1,103 @@ + + + + + + + ifx_do + Запускает подготовленный SQL-запрос + + + + &reftitle.description; + + boolifx_do + resourceresult_id + + + Запускает подготовленный SQL-запрос или открывает для него курсор. + + + НЕ освобождает result_id в случае ошибки. + + + Также задает корректное значение + ifx_affected_rows для не-SELECT запросов. + Извлечь можно функцией ifx_affected_rows. + + + + + &reftitle.parameters; + + + + result_id + + + result_id - идентификатор запроса, полученный + ifx_query или + ifx_prepare (только для запросов типа SELECT!). + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.seealso; + + + Пример использования <function>ifx_do</function> + + +]]> + + + + + + + &reftitle.seealso; + + + ifx_prepare + + + + + + + diff --git a/reference/ifx/functions/ifx-error.xml b/reference/ifx/functions/ifx-error.xml new file mode 100644 index 000000000..d7418399b --- /dev/null +++ b/reference/ifx/functions/ifx-error.xml @@ -0,0 +1,99 @@ + + + + + + + ifx_error + Возвращает код ошибки последней операции Informix + + + + &reftitle.description; + + stringifx_error + resourcelink_identifier + + + Возвращает строку, состоящую из одного символа, описывающего результат в целом, и + значений SQLSTATE и SQLCODE. + + + + + &reftitle.parameters; + + + + link_identifier + + + Идентификатор соединения. + + + + + + + + + &reftitle.returnvalues; + + Коды ошибок Informix (SQLSTATE & SQLCODE) в виде + x [SQLSTATE = aa bbb SQLCODE=cccc]. + + + где x = пробел : нет ошибки + + + E : ошибка + + + N : данных больше нет + + + W : предупреждение + + + ? : не задано + + + Если символ "x" не является пробелом, то подробное описание ошибки можно получить + проанализировав SQLSTATE и SQLCODE. + + + Описание кодов ошибок SQLSTATE и SQLCODE читайте в документации к Informix. + + + + + &reftitle.seealso; + + + ifx_errormsg + + + + + + + diff --git a/reference/ifx/functions/ifx-errormsg.xml b/reference/ifx/functions/ifx-errormsg.xml new file mode 100644 index 000000000..0d1419aca --- /dev/null +++ b/reference/ifx/functions/ifx-errormsg.xml @@ -0,0 +1,91 @@ + + + + + + + ifx_errormsg + Возвращает сообщение об ошибке последнего выполненого оператора Informix + + + + &reftitle.description; + + stringifx_errormsg + interrorcode + + + Возвращает сообщение об ошибке последнего выполненого оператора Informix. + + + + + &reftitle.parameters; + + + + errorcode + + + Если задано, то функция вернет сообщение од ошибке, соответствующее этому коду. + + + + + + + + + &reftitle.returnvalues; + + Возвращает строку с описанием ошибки.. + + + + + &reftitle.examples; + + + Пример использования <function>ifx_errormsg</function> + +", ifx_errormsg(-201)); +?> +]]> + + + + + + + &reftitle.seealso; + + + ifx_error + + + + + + + diff --git a/reference/ifx/functions/ifx-fetch-row.xml b/reference/ifx/functions/ifx-fetch-row.xml new file mode 100644 index 000000000..95e6eff78 --- /dev/null +++ b/reference/ifx/functions/ifx-fetch-row.xml @@ -0,0 +1,131 @@ + + + + + + + ifx_fetch_row + Получить строку в виде ассоциативного массива + + + + &reftitle.description; + + arrayifx_fetch_row + resourceresult_id + mixedposition + + + Извлекает строку в виде ассоциативного массива. + + + Каждый запуск ifx_fetch_row будет возвращать + следующую строку из результирующего набора и &false;, когда строки кончатся. + + + + + &reftitle.parameters; + + + + result_id + + + result_id - идентификатор запроса, полученный + ifx_query или + ifx_prepare (только для запросов типа SELECT!). + + + + + position + + + Опциональный параметр при использовании проматываемого курсора: + NEXT, PREVIOUS, + CURRENT, FIRST, + LAST или число. Если вы укажете число, будет возвращена строка + с данным номером. Этот папаметр опционален и применяется только с курсорами + типа SCROLL. + + + + + + + + + &reftitle.returnvalues; + + Возвращает ассоциативный массив, содержащий строку результирующего набора, либо + &false;, если строки закончились. + + + Столбцы BLOB возвращаются в виде их числовых идентификаторов, которые + можно использовать с функцией ifx_get_blob, если не используется + ifx_textasvarchar(1) или ifx_byteasvarchar(1), в этом случае они будут возвращаться + как VARCHAR. + + + + + &reftitle.examples; + + + Извлечение строк + + 1000) { + printf ("Слишком много строк в результирующем наборе (%d)\n
", $rowcount); + die ("Пожалуйста ограничьте запрос
\n"); +} +if (! ifx_do ($rid)) { + /* ... ошибка ... */ +} +$row = ifx_fetch_row ($rid, "NEXT"); +while (is_array($row)) { + for (reset($row); $fieldname=key($row); next($row)) { + $fieldvalue = $row[$fieldname]; + printf ("%s = %s,", $fieldname, $fieldvalue); + } + printf("\n
"); + $row = ifx_fetch_row($rid, "NEXT"); +} +ifx_free_result ($rid); +?> +]]> +
+
+
+
+ +
+ + diff --git a/reference/ifx/functions/ifx-fieldproperties.xml b/reference/ifx/functions/ifx-fieldproperties.xml new file mode 100644 index 000000000..1474163be --- /dev/null +++ b/reference/ifx/functions/ifx-fieldproperties.xml @@ -0,0 +1,105 @@ + + + + + + + ifx_fieldproperties + Список свойств полей + + + + &reftitle.description; + + arrayifx_fieldproperties + resourceresult_id + + + Возвращает список свойств для каждого поля в запросе в виде ассоциативного массива. + Свойства описываются в следующем формате: + "SQLTYPE;length;precision;scale;ISNULLABLE" где SQLTYPE = тип столбца Informix, например + "SQLVCHAR" и ISNULLABLE = "Y" или "N". + + + + + &reftitle.parameters; + + + + result_id + + + result_id - идентификатор запроса, полученный + ifx_query или + ifx_prepare (только для запросов типа SELECT!). + + + + + + + + + &reftitle.returnvalues; + + Возвращает ассоциативный массив с ключами равными именам столбцов и + значениями, состоящими из описания их свойств для запроса с идентификатором + result_id. + Возвращает &false; в случае ошибки. + + + + + &reftitle.examples; + + + Свойства полей + + $val) { + echo "$fname:\t property = $val\n"; +} +?> +]]> + + + + + + + &reftitle.seealso; + + + ifx_fieldtypes + + + + + + + diff --git a/reference/ifx/functions/ifx-fieldtypes.xml b/reference/ifx/functions/ifx-fieldtypes.xml new file mode 100644 index 000000000..3bfc5f093 --- /dev/null +++ b/reference/ifx/functions/ifx-fieldtypes.xml @@ -0,0 +1,103 @@ + + + + + + + ifx_fieldtypes + Список столбцов + + + + &reftitle.description; + + arrayifx_fieldtypes + resourceresult_id + + + Возвращает ассоциативный массив с ключами равными именам столбцов и + значениями равными их типу для запроса с идентификатором + result_id. + + + + + &reftitle.parameters; + + + + result_id + + + result_id - идентификатор запроса, полученный + ifx_query или + ifx_prepare (только для запросов типа SELECT!). + + + + + + + + + &reftitle.returnvalues; + + Возвращает ассоциативный массив с ключами равными именам столбцов и + значениями равными их типу для запроса с идентификатором + result_id. + Возвращает &false; в случае ошибки. + + + + + &reftitle.examples; + + + Имена и типы столбцов + + $val) { + echo "$fname:\t type = $val\n"; + } +} +?> +]]> + + + + + + + &reftitle.seealso; + + + ifx_fieldproperties + + + + + + + diff --git a/reference/ifx/functions/ifx-free-blob.xml b/reference/ifx/functions/ifx-free-blob.xml new file mode 100644 index 000000000..7f517576b --- /dev/null +++ b/reference/ifx/functions/ifx-free-blob.xml @@ -0,0 +1,75 @@ + + + + + + + ifx_free_blob + Удалить объект BLOB + + + + &reftitle.description; + + boolifx_free_blob + intbid + + + Удаляет объект BLOB по его идентификатору. + + + + + &reftitle.parameters; + + + + bid + + + Идентификатор BLOB. + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.seealso; + + + ifx_create_blob + + + + + + + diff --git a/reference/ifx/functions/ifx-free-char.xml b/reference/ifx/functions/ifx-free-char.xml new file mode 100644 index 000000000..a218b548f --- /dev/null +++ b/reference/ifx/functions/ifx-free-char.xml @@ -0,0 +1,75 @@ + + + + + + + ifx_free_char + Удалить символьный объект + + + + &reftitle.description; + + boolifx_free_char + intbid + + + Удаляет символьный объект по его идентификатору. + + + + + &reftitle.parameters; + + + + bid + + + Идентификатор объекта. + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.seealso; + + + ifx_create_char + + + + + + + diff --git a/reference/ifx/functions/ifx-free-result.xml b/reference/ifx/functions/ifx-free-result.xml new file mode 100644 index 000000000..7bc643025 --- /dev/null +++ b/reference/ifx/functions/ifx-free-result.xml @@ -0,0 +1,78 @@ + + + + + + + ifx_free_result + Высвобождает ресурсы для запроса + + + + &reftitle.description; + + boolifx_free_result + resourceresult_id + + + Высвобождает ресурсы, связанные с идентификатором запроса + result_id. + + + + + &reftitle.parameters; + + + + result_id + + + result_id - идентификатор запроса, полученный + ifx_query или + ifx_prepare (только для запросов типа SELECT!). + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.seealso; + + + ifx_do + + + + + + + diff --git a/reference/ifx/functions/ifx-get-blob.xml b/reference/ifx/functions/ifx-get-blob.xml new file mode 100644 index 000000000..5f98df92e --- /dev/null +++ b/reference/ifx/functions/ifx-get-blob.xml @@ -0,0 +1,75 @@ + + + + + + + ifx_get_blob + Возвращает контент объекта BLOB + + + + &reftitle.description; + + stringifx_get_blob + intbid + + + Возвращает контент объекта BLOB. + + + + + &reftitle.parameters; + + + + bid + + + Идентификатор BLOB. + + + + + + + + + &reftitle.returnvalues; + + Контент объекта BLOB в виде строки, или &false; в случае ошибки. + + + + + &reftitle.seealso; + + + ifx_get_char + + + + + + + diff --git a/reference/ifx/functions/ifx-get-char.xml b/reference/ifx/functions/ifx-get-char.xml new file mode 100644 index 000000000..bd28c90ec --- /dev/null +++ b/reference/ifx/functions/ifx-get-char.xml @@ -0,0 +1,75 @@ + + + + + + + ifx_get_char + Возвращает контент символьного объекта + + + + &reftitle.description; + + stringifx_get_char + intbid + + + Возвращает контент символьного объекта. + + + + + &reftitle.parameters; + + + + bid + + + Идентификатор объекта. + + + + + + + + + &reftitle.returnvalues; + + Возвращает контент символьного объекта в виде строки, или &false; в случае ошибки. + + + + + &reftitle.seealso; + + + ifx_get_blob + + + + + + + diff --git a/reference/ifx/functions/ifx-getsqlca.xml b/reference/ifx/functions/ifx-getsqlca.xml new file mode 100644 index 000000000..8c1d6260a --- /dev/null +++ b/reference/ifx/functions/ifx-getsqlca.xml @@ -0,0 +1,106 @@ + + + + + + + + ifx_getsqlca + Получить содержимое sqlca.sqlerrd[0..5] после выполнения запроса + + + + &reftitle.description; + + arrayifx_getsqlca + resourceresult_id + + + Возвращает псевдостроку с sqlca.sqlerrd[0] ... sqlca.sqlerrd[5] после выполнения + запроса с идентификатором result_id. + + + Для запросов INSERT, UPDATE и DELETE, возвращаемые значение + являются значениями, возвращенными сервером после их выполнения. + Они дают доступ к числу затронутых строк и значению SERIAL для операторов + INSERT. Для запросов SELECT эти значения выставляются + после оператора PREPARE. Это дает доступ к *ожидаемому* количеству + затронутых строк. Использование этой функции сокращает накладные расходы, + которые могут возникнуть при вызове SELECT dbinfo('sqlca.sqlerrdx'), + так как она извлекает значения, сохраненные драйвером ifx. + + + + + &reftitle.parameters; + + + + result_id + + + result_id - идентификатор запроса, полученный + ifx_query или + ifx_prepare (только для запросов типа SELECT!). + + + + + + + + + &reftitle.returnvalues; + + Возвращает ассоциативный массив со следующими полями: + sqlerrd0, sqlerrd1, + sqlerrd2, sqlerrd3, + sqlerrd4 и sqlerrd5. + + + + + &reftitle.examples; + + + Извлечение значений sqlca.sqlerrd[x] + +\n"; +?> +]]> + + + + + + + diff --git a/reference/ifx/functions/ifx-htmltbl-result.xml b/reference/ifx/functions/ifx-htmltbl-result.xml new file mode 100644 index 000000000..f9e30e0ed --- /dev/null +++ b/reference/ifx/functions/ifx-htmltbl-result.xml @@ -0,0 +1,108 @@ + + + + + + + ifx_htmltbl_result + Форматирует все строки запроса в виде таблицы HTML + + + + &reftitle.description; + + intifx_htmltbl_result + resourceresult_id + stringhtml_table_options + + + Форматирует все строки запроса result_id в таблицу HTML. + + + + + &reftitle.parameters; + + + + result_id + + + result_id - идентификатор запроса, полученный + ifx_query или + ifx_prepare (только для запросов типа SELECT!). + + + + + html_table_options + + + Этот опциональный аргумент задает опции тега <table>. + + + + + + + + + &reftitle.returnvalues; + + Возвращает число извлеченных строк, или &false; в случае ошибки. + + + + + &reftitle.examples; + + + Результаты запроса в виде таблицы HTML + + 1000) { + printf ("Too many rows in result set (%d)\n
", $rowcount); + die ("Please restrict your query
\n"); +} +if (! ifx_do($rid)) { + /* ... ошибка ... */ +} + +ifx_htmltbl_result ($rid, "border=\"2\""); + +ifx_free_result($rid); +?> +]]> +
+
+
+
+
+ + diff --git a/reference/ifx/functions/ifx-nullformat.xml b/reference/ifx/functions/ifx-nullformat.xml new file mode 100644 index 000000000..33ce08cfb --- /dev/null +++ b/reference/ifx/functions/ifx-nullformat.xml @@ -0,0 +1,66 @@ + + + + + + + ifx_nullformat + Установить возвращаемое по умолчанию значение для NULL + + + + &reftitle.description; + + boolifx_nullformat + intmode + + + Установить возвращаемое по умолчанию значение для NULL. + + + + + &reftitle.parameters; + + + + mode + + + Режим "0" возвратит "", режим "1" возвратит "&null;". + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + + diff --git a/reference/ifx/functions/ifx-num-fields.xml b/reference/ifx/functions/ifx-num-fields.xml new file mode 100644 index 000000000..96c10ba2c --- /dev/null +++ b/reference/ifx/functions/ifx-num-fields.xml @@ -0,0 +1,96 @@ + + + + + + + ifx_num_fields + Возвращает количество столбцов в запросе + + + + &reftitle.description; + + intifx_num_fields + resourceresult_id + + + После подготовки запроса возвращает число столбцов в нем. + + + + + &reftitle.parameters; + + + + result_id + + + result_id - идентификатор запроса, полученный + ifx_query или + ifx_prepare (только для запросов типа SELECT!). + + + + + + + + + &reftitle.returnvalues; + + Возвращает количество столбцов в запросе + result_id, или &false; в случае ошибки. + + + + + &reftitle.examples; + + + Пример использования <function>ifx_num_fields</function> + + +]]> + + + + + + + &reftitle.seealso; + + + ifx_num_rows + + + + + + + diff --git a/reference/ifx/functions/ifx-num-rows.xml b/reference/ifx/functions/ifx-num-rows.xml new file mode 100644 index 000000000..553a8e202 --- /dev/null +++ b/reference/ifx/functions/ifx-num-rows.xml @@ -0,0 +1,79 @@ + + + + + + + ifx_num_rows + Число строк уже извлененных из запроса + + + + &reftitle.description; + + intifx_num_rows + resourceresult_id + + + Число строк уже извлененных для запроса + result_id после + ifx_query или ifx_do. + + + + + &reftitle.parameters; + + + + result_id + + + result_id - идентификатор запроса, полученный + ifx_query или + ifx_prepare (только для запросов типа SELECT!). + + + + + + + + + &reftitle.returnvalues; + + Возвращает число извлеченных строк или &false; в случае ошибки. + + + + + &reftitle.seealso; + + + ifx_num_fields + + + + + + + diff --git a/reference/ifx/functions/ifx-pconnect.xml b/reference/ifx/functions/ifx-pconnect.xml new file mode 100644 index 000000000..5bada6bcf --- /dev/null +++ b/reference/ifx/functions/ifx-pconnect.xml @@ -0,0 +1,115 @@ + + + + + + + ifx_pconnect + Open persistent Informix connection + + + + &reftitle.description; + + resourceifx_pconnect + stringdatabase + stringuserid + stringpassword + + + ifx_pconnect работает так же как + ifx_connect с двумя значительными отличиями. + + + Первое отличие. При соединении эта функция сперва пытается найти уже открытое постоянное + соединение с такими же хостом, именем пользователя и паролем. Если таковое будет найдено, + то оно будет возвращено вместо создания нового. + + + Второе отличие. Соединение с сервером не будет прервано по окончанию работы скрипта. + Вместо этого данное соединение будет доступно для всех последующих запросов на соединение. + Также, функция ifx_close не работает с ifx_pconnect. + + + This type of links is therefore called 'persistent'. + + + + + &reftitle.parameters; + + Все аргументы опциональны. Если они не заданы, то будут использованы значения по + умолчанию, заданные в &php.ini; (ifx.default_host для хоста + (библиотеки Informix будут использовать переменную окружения + INFORMIXSERVER, если значение не задано), + ifx.default_user для пользователя, ifx.default_password для пароля (если не задано, то + будеет пытаться соединиться без пароля). + + + + + database + + + Строка, содержащая имя базы данных. + + + + + userid + + + Строка с именем пользователя. + + + + + password + + + Строка с паролем. + + + + + + + + + &reftitle.returnvalues; + + Возвращает идентификатор постоянного соединения, либо &false; в случае ошибки. + + + + + &reftitle.seealso; + + + ifx_connect + + + + + + + diff --git a/reference/ifx/functions/ifx-prepare.xml b/reference/ifx/functions/ifx-prepare.xml new file mode 100644 index 000000000..6989c7506 --- /dev/null +++ b/reference/ifx/functions/ifx-prepare.xml @@ -0,0 +1,130 @@ + + + + + + + ifx_prepare + Подготавливает SQL-запрос для выполнения + + + + &reftitle.description; + + resourceifx_prepare + stringquery + resourcelink_identifier + intcursor_def + mixedblobidarray + + + Подготавливает query для использования в + ifx_do. + + + Для запросов типа SELECT задается и открывается курсор. + Остальные типы запросов сразу же запускаются. + + + Для всех типов запросов сохраняется число (реальное или предполагаемое) затронутых строк, + которое можно извлечь функцией ifx_affected_rows. + + + Если контент столбцов TEXT (или BYTE) позволяют, вы можете использовать + ifx_textasvarchar(1) и + ifx_byteasvarchar(1). Это позволит получать контент столбцов TEXT + (или BYTE) как обычный (но длинный) VARCHAR и не заморачиваться + идентификаторов объектов BLOB. + + + С ifx_textasvarchar(0) или + ifx_byteasvarchar(0) (ситуация по умолчанию), запросы типа SELECT + будут возвращать столбцы с BLOB в виде их идентификаторовs (целое число). Контент + данных столбцов придется извлекать из памяти или файла успользуя специальные функции. + + + + + &reftitle.parameters; + + + + query + + + Строка запроса. + + + + + link_identifier + + + Идентификатор соединения. + + + + + cursor_def + + + Опциональный параметр, позволяющий задать тип курсора равным + scroll и/или hold. + Может быть IFX_SCROLL, + IFX_HOLD, или обоими сразу, побитово сложенными (ИЛИ). + + + + + blobidarray + + + Если в запросе используются поля BLOB (BYTE или TEXT), вы можете добавить + параметр blobidarray, содержащий соответствующие + "blob ids", и тогда будет необходимо заменить соответствующие поля в запросе на "?". + + + + + + + + + &reftitle.returnvalues; + + Возвращает идентификатор результата для использования в ifx_do, + или &false; в случае ошибки. + + + + + &reftitle.seealso; + + + ifx_do + + + + + + + diff --git a/reference/ifx/functions/ifx-query.xml b/reference/ifx/functions/ifx-query.xml new file mode 100644 index 000000000..f79f47ccb --- /dev/null +++ b/reference/ifx/functions/ifx-query.xml @@ -0,0 +1,182 @@ + + + + + + + ifx_query + Send Informix query + + + + &reftitle.description; + + resourceifx_query + stringquery + resourcelink_identifier + intcursor_type + mixedblobidarray + + + Посылает query в базу данных используя идентификатор соединения. + + + Для запросов типа SELECT задается и открывается курсор. + Остальные типы запросов сразу же запускаются. + + + Для всех типов запросов сохраняется число (реальное или предполагаемое) затронутых строк, + которое можно извлечь функцией ifx_affected_rows. + + + Если контент столбцов TEXT (или BYTE) позволяют, вы можете использовать + ifx_textasvarchar(1) и + ifx_byteasvarchar(1). Это позволит получать контент столбцов TEXT + (или BYTE) как обычный (но длинный) VARCHAR и не заморачиваться + идентификаторов объектов BLOB. + + + С ifx_textasvarchar(0) или + ifx_byteasvarchar(0) (ситуация по умолчанию), запросы типа SELECT + будут возвращать столбцы с BLOB в виде их идентификаторовs (целое число). Контент + данных столбцов придется извлекать из памяти или файла успользуя специальные функции. + + + + + &reftitle.parameters; + + + + query + + + Строка запроса. + + + + + link_identifier + + + Идентификатор соединения. + + + + + cursor_def + + + Опциональный параметр, позволяющий задать тип курсора равным + scroll и/или hold. + Может быть IFX_SCROLL, + IFX_HOLD, или обоими сразу, побитово сложенными (ИЛИ). + Если вы опустите этот параметр, то курсор будет обычным последовательным курсором. + + + + + blobidarray + + + Если в запросе используются поля BLOB (BYTE или TEXT), вы можете добавить + параметр blobidarray, содержащий соответствующие + "blob ids", и тогда будет необходимо заменить соответствующие поля в запросе на "?". + + + + + + + + + &reftitle.returnvalues; + + Возвращает идентификатор результата, или &false; в случае ошибки. + + + + + &reftitle.examples; + + + + Вывод всех строк таблицы "orders" в виде таблицы HTML + + +%s
\n", ifx_error(), ifx_errormsg()); + die; +} +ifx_htmltbl_result($res_id, "border=\"1\""); +ifx_free_result($res_id); +?> +]]> +
+
+ + Вставка значений в таблицу "catalog" + + +]]> + + +
+
+ + + &reftitle.seealso; + + + ifx_connect + + + + +
+ + diff --git a/reference/ifx/functions/ifx-textasvarchar.xml b/reference/ifx/functions/ifx-textasvarchar.xml new file mode 100644 index 000000000..3300d1e20 --- /dev/null +++ b/reference/ifx/functions/ifx-textasvarchar.xml @@ -0,0 +1,75 @@ + + + + + + + ifx_textasvarchar + Устанавливает режим чтения TEXT + + + + &reftitle.description; + + boolifx_textasvarchar + intmode + + + Устанавливает режим чтения TEXT. + + + + + &reftitle.parameters; + + + + mode + + + Режим "0" вернет идентификаторы BLOB, режим "1" вернет VARCHAR. + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.seealso; + + + ifx_byteasvarchar + + + + + + + diff --git a/reference/ifx/functions/ifx-update-blob.xml b/reference/ifx/functions/ifx-update-blob.xml new file mode 100644 index 000000000..fc31b3911 --- /dev/null +++ b/reference/ifx/functions/ifx-update-blob.xml @@ -0,0 +1,85 @@ + + + + + + + ifx_update_blob + Обновление контента объекта BLOB + + + + &reftitle.description; + + boolifx_update_blob + intbid + stringcontent + + + Обновление контента объекта BLOB с идентификатором + bid. + + + + + &reftitle.parameters; + + + + bid + + + Идентификатор BLOB. + + + + + content + + + Новые данные в виде строки. + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.seealso; + + + ifx_update_char + + + + + + + diff --git a/reference/ifx/functions/ifx-update-char.xml b/reference/ifx/functions/ifx-update-char.xml new file mode 100644 index 000000000..908a30a19 --- /dev/null +++ b/reference/ifx/functions/ifx-update-char.xml @@ -0,0 +1,85 @@ + + + + + + + ifx_update_char + Обновление контента символьного объекта + + + + &reftitle.description; + + boolifx_update_char + intbid + stringcontent + + + Обновление контента символьного объекта с идентификатором + bid. + + + + + &reftitle.parameters; + + + + bid + + + Идентификатор обхекта. + + + + + content + + + Новые данные в виде строки. + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.seealso; + + + ifx_update_blob + + + + + + + diff --git a/reference/ifx/functions/ifxus-close-slob.xml b/reference/ifx/functions/ifxus-close-slob.xml new file mode 100644 index 000000000..75c18ad68 --- /dev/null +++ b/reference/ifx/functions/ifxus-close-slob.xml @@ -0,0 +1,76 @@ + + + + + + + ifxus_close_slob + Удалить объект SLOB + + + + &reftitle.description; + + boolifxus_close_slob + intbid + + + Удалить объект SLOB с идентификатором + bid. + + + + + &reftitle.parameters; + + + + bid + + + Идентификатор объекта. + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.seealso; + + + ifxus_open_slob + + + + + + + diff --git a/reference/ifx/functions/ifxus-create-slob.xml b/reference/ifx/functions/ifxus-create-slob.xml new file mode 100644 index 000000000..84511b67e --- /dev/null +++ b/reference/ifx/functions/ifxus-create-slob.xml @@ -0,0 +1,79 @@ + + + + + + + ifxus_create_slob + Создать и открыть объект SLOB + + + + &reftitle.description; + + intifxus_create_slob + intmode + + + Создать и открыть объект SLOB. + + + + + &reftitle.parameters; + + + + mode + + + Комбинация констант IFX_LO_RDONLY, + IFX_LO_WRONLY, IFX_LO_APPEND + IFX_LO_RDWR, IFX_LO_BUFFER, + IFX_LO_NOBUFFER. + + + + + + + + + &reftitle.returnvalues; + + Возвращает идентификатор нового объекта, или &false; в случае ошибки. + + + + + &reftitle.seealso; + + + ifxus_close_slob + ifxus_free_slob + + + + + + + diff --git a/reference/ifx/functions/ifxus-free-slob.xml b/reference/ifx/functions/ifxus-free-slob.xml new file mode 100644 index 000000000..3a7f059c3 --- /dev/null +++ b/reference/ifx/functions/ifxus-free-slob.xml @@ -0,0 +1,75 @@ + + + + + + + ifxus_free_slob + Удалить объект SLOB + + + + &reftitle.description; + + boolifxus_free_slob + intbid + + + Удаляет объект SLOB. + + + + + &reftitle.parameters; + + + + bid + + + Идентификатор объекта. + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.seealso; + + + ifxus_close_slob + + + + + + + diff --git a/reference/ifx/functions/ifxus-open-slob.xml b/reference/ifx/functions/ifxus-open-slob.xml new file mode 100644 index 000000000..6ec2a82c1 --- /dev/null +++ b/reference/ifx/functions/ifxus-open-slob.xml @@ -0,0 +1,88 @@ + + + + + + + ifxus_open_slob + Открыть объект SLOBt + + + + &reftitle.description; + + intifxus_open_slob + intbid + intmode + + + Открыть объект SLOB. bid должен быть существующим идентификатором SLOB. + + + + + &reftitle.parameters; + + + + bid + + + Идентификатор SLOB. + + + + + mode + + + Комбинация констант IFX_LO_RDONLY, + IFX_LO_WRONLY, IFX_LO_APPEND + IFX_LO_RDWR, IFX_LO_BUFFER, + IFX_LO_NOBUFFER. + + + + + + + + + &reftitle.returnvalues; + + Возвращает идентификатор объекта, или &false; в случае ошибки. + + + + + &reftitle.seealso; + + + ifxus_close_slob + ifxus_free_slob + + + + + + + diff --git a/reference/ifx/functions/ifxus-read-slob.xml b/reference/ifx/functions/ifxus-read-slob.xml new file mode 100644 index 000000000..cce68a630 --- /dev/null +++ b/reference/ifx/functions/ifxus-read-slob.xml @@ -0,0 +1,84 @@ + + + + + + + ifxus_read_slob + Прочитать заданное количество байт из SLOB + + + + &reftitle.description; + + stringifxus_read_slob + intbid + intnbytes + + + Читает nbytes байт из SLOB. + + + + + &reftitle.parameters; + + + + bid + + + Идентификатор SLOB. + + + + + nbytes + + + Количество байт для чтения. + + + + + + + + + &reftitle.returnvalues; + + Возвращает контент SLOB в виде строки, или &false; в случае ошибки. + + + + + &reftitle.seealso; + + + ifxus_write_slob + + + + + + + diff --git a/reference/ifx/functions/ifxus-seek-slob.xml b/reference/ifx/functions/ifxus-seek-slob.xml new file mode 100644 index 000000000..0424d8921 --- /dev/null +++ b/reference/ifx/functions/ifxus-seek-slob.xml @@ -0,0 +1,93 @@ + + + + + + + ifxus_seek_slob + Задать текущий файл или переместится на позицию + + + + &reftitle.description; + + intifxus_seek_slob + intbid + intmode + intoffset + + + Задать текущий файл или переместится на позицию. + + + + + &reftitle.parameters; + + + + bid + + + Идентификатор SLOB. + + + + + mode + + + 0 = LO_SEEK_SET, 1 = LO_SEEK_CUR, 2 = LO_SEEK_END. + + + + + offset + + + Смещение в байтах. + + + + + + + + + &reftitle.returnvalues; + + Возвращает текущую позицию в виде целого числа, или &false; в случае ошибки. + + + + + &reftitle.seealso; + + + ifxus_tell_slob + + + + + + + diff --git a/reference/ifx/functions/ifxus-tell-slob.xml b/reference/ifx/functions/ifxus-tell-slob.xml new file mode 100644 index 000000000..a2637af75 --- /dev/null +++ b/reference/ifx/functions/ifxus-tell-slob.xml @@ -0,0 +1,75 @@ + + + + + + + ifxus_tell_slob + Возвращает текущий файл или позицию + + + + &reftitle.description; + + intifxus_tell_slob + intbid + + + Возвращает текущий файл или позицию объекта SLOB + + + + + &reftitle.parameters; + + + + bid + + + Идентификатор SLOB. + + + + + + + + + &reftitle.returnvalues; + + Возвращает текущую позицию в виде целого числа, или &false; в случае ошибки. + + + + + &reftitle.seealso; + + + ifxus_seek_slob + + + + + + + diff --git a/reference/ifx/functions/ifxus-write-slob.xml b/reference/ifx/functions/ifxus-write-slob.xml new file mode 100644 index 000000000..7c8f94765 --- /dev/null +++ b/reference/ifx/functions/ifxus-write-slob.xml @@ -0,0 +1,84 @@ + + + + + + + ifxus_write_slob + Записать строку в объект SLOB + + + + &reftitle.description; + + intifxus_write_slob + intbid + stringcontent + + + Записать строку в объект SLOB. + + + + + &reftitle.parameters; + + + + bid + + + Идентификатор SLOB. + + + + + content + + + Строка для записи. + + + + + + + + + &reftitle.returnvalues; + + Возвращает число записанных байт, или &false; в случае ошибки. + + + + + &reftitle.seealso; + + + ifxus_read_slob + + + + + + +