Руководство по РНР 3.0 - Функции ODBC

Описание

Без параметра OnOff эта функция возвращает статус автофиксирования для connection_id . True возвращается, если автофиксирование включено, false если оно выключено или если произошли ошибки.

Если параметр OnOff установлен в true, то автофиксирование включено, если параметр установлен в ложь, то автофиксирование отключено. True возвращается при успешном завершении, false - при ошибке.

По умолчанию автофиксирование включено для соединения. Отключение автофиксирования эквивалентно началу транзакции.

См. также odbc_commit() и odbc_rollback() .

Описание

(ODBC SQL types affected: BINARY, VARBINARY, LONGVARBINARY)

• ODBC_BINMODE_PASSTHRU: Передает двоичные данные

• ODBC_BINMODE_RETURN: Возвращает как есть

• ODBC_BINMODE_CONVERT: Конвертирует в символьный вид и возвращает значение

Когда двоичные данные SQL конвертируются в символьные данные C, каждый байт (8 битов) исходных данных представляется как два ASCII символа. Эти символы являются ASCII-представлением числа в шестнадцатиричной форме. Например, двоичное 00000001 конвертируется в "01" и двоичное 11111111 конвертируется в "FF" .

Если была использована функция odbc_fetch_into() , то передача означает, что для этих полей будет возвращена пустая строка.

Если result_id равен 0 , то установки принимаются по умолчанию для новых результатов.

Замечание: По умолчанию для longreadlen установлено 4096 и binmode по умолчанию - ODBC_BINMODE_RETURN . Обработка двоичных данных типа LONG также осуществляется odbc_longreadlen()

Описание

odbc_close() закрывает соединение с сервером баз данных, связанное с указанным идентификатором соединения.

Замечание: Эта функция выдаст ошибку, если у этого соединения есть запущенные транзакции. Соединение останется открытым в этом случае.

Описание

odbc_close_all() закрывает все соединения с сервером(серверами) баз данных.

Замечание: Эта функция выдаст ошибку, если у этих соединений есть незавершенные транзакции. В этом случае соединения останутся открытыми.

Описание

Возвращает: true при успехе, false при ошибке. Все незаконченные транзакции на connection_id фиксируются.

Описание

возвращает идентификатор ODBC-соединения или 0 ( false ) при ошибке.

Идентификатор соединения, возвращаемый этой функцией, запрашивается другими ODBC функциями. Вы можете иметь несколько соединений открытых одновременно. Для постоянных соединений см. odbc_pconnect() .

Описание

odbc_cursor возвращает имя курсора для указанного result_id.

Описание

odbc_do запускает запрос на указанном соединении

Описание

Возвращает false при ошибке. Возвращает ODBC-идентификатор результата, если SQL команда была запущена успешно.

odbc_exec() посылает SQL-запрос серверу баз данных, определенному параметром connection_id . Этот параметр должен быть правильным идентификатором, возвращенным функцией odbc_connect() or odbc_pconnect() .

См. также: odbc_prepare() and odbc_execute() для многократных запусков SQL-запросов.

Описание

Запускает SQL-запрос, подготовленный функцией odbc_prepare() . Возвращает true при успешном запуске, false о обратном случае. Массив arameters_array необходим только если вы действительно имеете параметры в вашем SQL-запросе.

Описание

Возвращает число столбцов в результате; false при ошибке. result_array может быть любого типа, так как он будет конвертирован в тип массив. Массив будет содержать значения полей начиная с индекса 0 массива.

Описание

Если odbc_fetch_row() прошла успешно (строка существовала), то будет возвращено true . Если больше строк нет, то будет возвращеноfalse.

odbc_fetch_row() Извлекает строку из данных, возвращенных функцией odbc_do() / odbc_exec() . После вызова odbc_fetch_row() , доступ к полям той строки может быть осуществлен с помощью функции odbc_result() .

Если параметр row_number не указан, то odbc_fetch_row() бедет пытаться извлечь следующую строку в результирующем наборе. Вызов функции odbc_fetch_row() можно осуществлять как с, так и без параметра row_number .

Для использования результата более одного раза, вы можете вызвать odbc_fetch_row() с row_number 1, и затем продолжить выполнять odbc_fetch_row() без row_number для просмотра результата. Если драйвер не поддерживает извлечение строк по номеру, то параметр row_number игонорируется.

Описание

odbc_field_name() возвращает имя поля в соответствии с указанным номером столбца в указанном ODBC-идентификаторе результата. Номера полей начинаются с 1. false возвращается при ошибке.

Описание

odbc_field_type() возвращает SQL тип поля в соответствии с номером в указанном ODBC-идентификаторе результата. Номера полей начинаются с 1.

Описание

odbc_field_type() возвращает длину поля в соответствии с номером в указанном ODBC-идентификаторе результата. Номера строк начинаются с 1.

Описание

Всегда возвращает true.

odbc_free_result() необходимо вызывать только если вы беспокоитесь об использовании большого количества памяти во время запуска вашего скрипта. Вся память результата будет автоматически освобождена при завершении скрипта. Но, если вы уверены, что больше нигде в скрипте не будете использовать данные результата, то вы можете вызвать odbc_free_result() , и память, связанная с параметром result_id будет освобождена.

Замечание: Если автофиксирование отключено (см. odbc_autocommit() ) вы можете вызвать odbc_free_result() и перед фиксированием все незавершенные транзакции будут откатаны назад.

Описание

(Обрабатываемые ODBC SQL типы : LONG, LONGVARBINARY) Число байтов, возвращенных PHP, контролируется длиной параметра. Если она установлена в 0, то данные типа Long передаются клиенту.

Замечание: Обработка полей типа LONGVARBINARY также осуществляется odbc_binmode()

Описание

odbc_num_fields() возвращает число полей (столбцов) в результате ODBC. Эта функция вернет -1 при ошибке. Аргумент является правильным результирующим идентификатором, возвращенным odbc_exec() .

Описание

Возвращает идентификатор ODBC соединения или 0 ( false ) при ошибке. Эта функция очень похожа на odbc_connect() , кроме того, что соединение в действительности не закрывается после завершения скрипта. Будующие запросы на соединение с той же комбинацией параметров dsn , user , password (через odbc_connect() и odbc_pconnect() ) могут повторно использовать постоянное соединение.

Замечание: Постоянные соединения не действуют, если PHP используется как CGI программа.

Для подробной информации о постоянных соединениях см. PHP3 FAQ.

Описание

Возвращает false при ошибке.

Возвращает ODBC-идентификатор результата, если SQL команда была подготовлена успешно. Идентификатор результата может быть использован для последеющего запуска запроса с помощью odbc_execute() .

Описание

odbc_num_rows() возвращает число строк в ODBC результате. Эта функция вернет -1 при ошибке. Для команд INSERT, UPDATE и DELETE odbc_num_rows() вернет число обработанных строк. Для случая SELECT это может быть число доступных строк.

Замечание: Использование odbc_num_rows() для определения числа строк, доступных после SELECT вернет -1 у многих драйверов.

Описание

Возвращает содержимое поля.

поле может быть целым числом, содержащим номер столбца необходимого вам поля, или оно может быть строкой, содержащей имя поля. Например:

     $item_3 = odbc_result($Query_ID, 3 );
     $item_val = odbc_result($Query_ID, "val");

Первый вызов odbc_result() вернет значение третьего поля в текущей записи результата запроса. Второй вызов функции odbc_result() возвратит значение поля, имя которого "val" в текущей записи результата запроса. Ошибка возникнет, если параметр номера столбца для поля меньше, чем один или более номеров столбцов (или полей) в текущей записи. Так же ошибка возникнет, если запрашивается поле с именем, не совпадающем с именами полей в запрашиваемой таблице (таблицах).

Номера полей начинаются с 1. Field indices start from 1. Относительно способа возврата двоичных данных и данных типа LONG см. функции odbc_binmode () and odbc_longreadlen() .

Описание

Возвращает число строк в результате или false при ошибке.

odbc_result_all() выдает все строки из идентификатора результата, полученного от odbc_exec() . Результат выдается в формате HTML таблицы. С дополнительным строковым аргументом format , может быть осуществлено дополнительное форматирование таблицы.

Описание

Откатавает все незаконченные запросы на connection_id . Возвращает true при успехе, false при ошибке.