Руководство по РНР 3.0 - Функции для работы с Sybase
- Содержание
- sybase_affected_rows
- sybase_close
- sybase_connect
- sybase_data_seek
- sybase_fetch_array
- sybase_fetch_field
- sybase_fetch_object
- sybase_fetch_row
- sybase_field_seek
- sybase_free_result
- sybase_num_fields
- sybase_num_rows
- sybase_pconnect
- sybase_query
- sybase_result
- sybase_select_db
sybase_affected_rows
sybase_affected_rows -- возвращает число
строк, измененных последним запросом
Описание
int sybase_affected_rows(int [link_identifier] );
Возвращает: Число строк,измененных
последним запросом.
Функция sybase_affected_rows()
возвращает число строк,
участвовавших в запросе вида INSERT,
UPDATE или DELETE к серверу, указанному с
помощью идентификтора соединения
(link_identifier). Если идентификатор не
задан, используется соединение,
открытое последним.
Эта команда работает только с
операторами, изменяющими записи.
Для получения числа записей,
возвращаемых оператором SELECT
следует использовать функцию sybase_num_rows() .
sybase_close
sybase_close -- завершает соединение с
Sybase
Описание
int sybase_close(int link_identifier);
возвращет: true - в случае успеха, false
- в случае ошибки
Функция sybase_close() завершает
соединение с базой данных Sybase,
обозначенное с помощью
идентификатора соединения. Если он
не указан, используется соединение,
открытое последним.
Отметим, что вызов этой функции не
является обязательным, т.к.
временные соединения закрываются
автоматически после окончания
выполнения скрипта.
Функция sybase_close() не завершает
постоянные соединения, открытые с
помощью sybase_pconnect().
Смотри также: sybase_connect() ,
sybase_pconnect() .
sybase_connect
sybase_connect -- устанавливает
соединение с Sybase - сервером
Описание
int sybase_connect(string servername, string
username, string password);
Возвращает: В случае успеха:
идентификатор соединения
(положительное число), в противном
случае - false.
Функция sybase_connect() устанавливает
соединение с Sybase-сервером. Параметр
'servername' должен содержать
существующее имя сервера,
определенное в файле 'interfaces'.
Если функция sybase_connect() будет
вызвана повторно с теми же
параметрами, то новое соединение не
установится, а будет возвращен
идентификатор уже открытого
соединения.
Соединение с сервером будет
закрыто после завершения скрипта
или раньше, посредством явного
вызова функции sybase_close() .
Смотри также: sybase_pconnect() ,
sybase_close() .
sybase_data_seek
sybase_data_seek -- перемещает внутренний
указатель записей
Описание
int sybase_data_seek(int result_identifier, int
row_number);
Возвращает: true -в случае успеха,
иначе - false
Функция sybase_data_seek() перемещает
внутренний указатель в
результирующем наборе записей,
заданном с помощью идентификатора
result_identifier, на строку с номером
row_number. При последующем вызове
функции sybase_fetch_row()
будет извлечена эта строка.
Смотри также: sybase_data_seek().
sybase_fetch_array
sybase_fetch_array -- извлекает строку в
виде массива
Описание
int sybase_fetch_array(int result);
Возвращает: Массив, содержащий
извлеченную из набора данных
строку или false - если строк больше
нет.
Функция sybase_fetch_array() является
расширенной версией функции sybase_fetch_row() .
Доступ к элементам массива
возможен не только по номерам , но и
по именам столбцов таблицы.
Необходимо отметить, что функция
sybase_fetch_array() работат НЕ намного
МЕДЛЕННЕЕ, чем sybase_fetch_row(), и
предоставляет дополнительные
возможности по сравнению с
последней.
Подробнее смотри также sybase_fetch_row()
sybase_fetch_field
sybase_fetch_field --получает информацию о
столбце из набора данных
Description
object sybase_fetch_field(int result, int
field_offset);
Возвращает объект, содержащий
информацию о столбце
Функцию sybase_fetch_field() можно
использовать для получения данных
о столбцах результирующего набора
result. Если смещение (номер) столбца в
таблице (field_offset) не указано, то при
каждом вызове sybase_fetch_field() будет
извлекаться информация о следующем
по порядку столбце.
Свойства объекта:
- name - имя столбца. Если столбец
является вычслимым, то это
свойство принимает значение
computed#N, где #N - это порядковый
номер;
- column_source - таблица, которой
принадлежит данный столбец;
- max_length - максимальная длина
столбца;
- numeric - 1, если столбец - числовой;
Смотри также sybase_field_seek()
sybase_fetch_object
sybase_fetch_object --извлекает строку в
виде объекта
Описание
int sybase_fetch_object(int result);
Возвращает: Объект, свойства
которого соответствуют
извлеченной из набора данных
строке, или false - если сторк больше
нет.
Функция sybase_fetch_object() аналогична sybase_fetch_array()
за одним исключением - она
возвращает объект, а не массив.
Фактически это означает, что доступ
к данным осществляется по именам
столбцов, а не по их смещению в
строке (числовые значения не могут
быть именами свойств).
С точки зрения скорости
выполнения эта функция идентична sybase_fetch_array() ,
и работает практически также
быстро, как и sybase_fetch_row()
(разница в скорости незначительна).
Смотри также: sybase_fetch-array()
и sybase_fetch-row() .
sybase_fetch_row
sybase_fetch_row -- получает строку в виде
пронумерованного массива
Описание
array sybase_fetch_row(int result);
Возвращает: Массив,
соответствующий извлеченной
строку, или false - если строк больше
нет.
Функция sybase_fetch_row() извлекает
строку данных из результирующего
набора, заданного идентификатором
result .Строка возвращается в виде
массива. Каждый столбец хранится в
виде элемента массива. Нумерация
элементов начинается с 0.
Последующий вызов функции
sybase_fetch_rows() вернет следующую строку
запроса, или false, если строк больше
нет.
Смотри также: sybase_fetch_array() ,
sybase_fetch_object() ,
sybase_data_seek() ,
sybase_fetch_lengths() и sybase_result() .
sybase_field_seek
sybase_field_seek -- указывает смещение
(номер) столбца в строке
Описание
int sybase_field_seek(int result, int
field_offset);
Переходит к указанному столбцу.
Если при следующем вызове sybase_fetch_field()
не будет указан конкретный номер
столбца, то будет возвращен этот
столбец.
Смотри также: sybase_fetch_field() .
sybase_free_result
sybase_free_result --освобождает память,
занятую результирующим набором
данных
Описание
int sybase_free_result(int result);
Функцию sybase_free_result() следует
вызывать, только если вы хотите
уменьшить объем используемой
памяти во время выполнения скрипта.
Все занимаемая память будет
автоматически освобождена после
завершения скрипта. Вы можете
вызвать sybase_free_result() с
идентификатором result в качестве
параметра, и содержащая результаты
выполнения этого запроса память
будет освобождена.
sybase_num_fields
sybase_num_fields -- получает число
столбцов в результирующем наборе
данных
Описание
int sybase_num_fields(int result);
sybase_num_fields() возвращает число
столбцов в результирующем наборе
Смотри также: sybase_db_query(), sybase_query() , sybase_fetch_field() ,
sybase_num_rows() .
sybase_num_rows
sybase_num_rows -- получает число
столбцов в результирующем наборе
данных
Описание
int sybase_num_rows(string result);
sybase_num_rows() rвозвращает число строк
в результирующем наборе
Смотри также: sybase_db_query(), sybase_query() и sybase_fetch_row() .
sybase_pconnect
sybase_pconnect -- открывает постоянное
соединение с Sybase-сервером
Описание
int sybase_pconnect(string servername, string
username, string password);
Возвращает: Идентификатор
соединения с Sybase-сервером
(положительное число) или false в
случае ошибки
Функция sybase_pconnect() выполняется
практически аналогично sybase_connect() с
двумя главными отличиями:
Во-первых, при установлении
соединения функция сначала
пытается найти уже открытое
(постоянное) соединение,
использующее те же имена хоста,
пользователя и пароль. Если такое
соединение уже существует, то
возвращается его идентификатор, и
новое соединение не
устанавливается.
Во-вторых, соединение с
SQL-сервером не завершается после
выполнения скрипта. Вместо этого,
оно остается открытым для
последующего использования.
(Функция sybase_close()
не закрывает соединения,
установленные с помощью sybase_pconnect()).
Поэтому этот тип соединений
называется 'постоянным'.
sybase_query
sybase_query -- посылает запрос на
Sybase-сервер
Описание
int sybase_query(string query, int
link_identifier);
Возвращает: в случае успеха-
идентификатор результирующего
набора данных (положительное
число), или false- в случае ошибки.
Функция sybase_query() посылает запрос к
текущей открытой базе данных на
сервере, заданном иденитификатором
link_identifier. Если этот идентификатор
не указан, то используется
соединение, открытое последним.
Если нет ни одного соединения, то
функция пытается установить новое (
как если бы была вызвана sybase_connect() ),
и затем его использовать.
Смотри также: sybase_db_query(), sybase_select_db()
и sybase_connect() .
sybase_result
sybase_result --получает результирующие
данные
Описание
int sybase_result(int result, int i, mixed
field);
Возвращает: Содержимое ячейки
данных на пересечении указанных
строки и столбца из заданного
результирующего набора данных Sybase.
Функция sybase_result() возвращает
содержимое одной ячейки данных из
результирующего набора Sybase. В
качестве параметра field может быть
указано смещение (номер) столбца,
его имя или имя столбца и имя
таблицы, указанные через точку.
(имя_столбца.имя_таблицы). Если для
столбца был указан псевдоним ('select
foo as bar from...'), то вместо имени столбца
следует использовать этот
псевдоним.
При работе с большими наборами
данных следует использовать
функции (перечисленные ниже),
которые извлекают из таблицы всю
строку целиком. Поскольку эти
функции за один вызов возвращают
несколько ячеек данных, они
работают ГОРАЗДО быстрее, чем
sybase_result(). Кроме того, надо отметить,
что скорость выполнения будет
гораздо выше, если указывать
числовое смещение столбца, а не
параметр вида
имя_столбца.имя_таблицы.
Рекомендуемые
высокопроизводительные
альтернативные функции: sybase_fetch_row() , sybase_fetch_array()
и sybase_fetch_object() .
sybase_select_db
sybase_select_db -- выбирает базу данных
Sybase
Описание
int sybase_select_db(string database_name, int
link_identifier);
Возвращает: true - в случае успеха,
false - в случае ошибки
Функция sybase_select_db() устаналивает
активную базу данных на сервере,
заданном идентификатором link_identifier.
Если это идентификатор не указан,
то используется соединение,
открытое последним. Если нет
открытых соединений, то функция
попытается установить новое (как
если бы была вызвана sybase_connect() ) и
затем его использовать.
Все последующие вызовы sybase_query()
будут работать с данной активной
базой данных.
Смотри также: sybase_connect() ,
sybase_pconnect()
и sybase_query()
Содержание
