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
int sybase_close(int link_identifier);
возвращет: true - в случае успеха, false - в случае ошибки
Функция sybase_close() завершает соединение с базой данных Sybase, обозначенное с помощью идентификатора соединения. Если он не указан, используется соединение, открытое последним.
Отметим, что вызов этой функции не является обязательным, т.к. временные соединения закрываются автоматически после окончания выполнения скрипта.
Функция sybase_close() не завершает постоянные соединения, открытые с помощью sybase_pconnect().
Смотри также: sybase_connect(), sybase_pconnect().
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 -- перемещает внутренний указатель записей
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 -- извлекает строку в виде массива
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 --получает информацию о столбце из набора данных
object sybase_fetch_field(int result, int
field_offset);
Возвращает объект, содержащий информацию о столбце
Функцию sybase_fetch_field() можно использовать для получения данных о столбцах результирующего набора result. Если смещение (номер) столбца в таблице (field_offset) не указано, то при каждом вызове sybase_fetch_field() будет извлекаться информация о следующем по порядку столбце.
Свойства объекта:
Смотри также sybase_field_seek()
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 -- получает строку в виде пронумерованного массива
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 -- указывает смещение (номер) столбца в строке
int sybase_field_seek(int result, int
field_offset);
Переходит к указанному столбцу. Если при следующем вызове sybase_fetch_field() не будет указан конкретный номер столбца, то будет возвращен этот столбец.
Смотри также: sybase_fetch_field().
sybase_free_result --освобождает память, занятую результирующим набором данных
int sybase_free_result(int result);
Функцию sybase_free_result() следует вызывать, только если вы хотите уменьшить объем используемой памяти во время выполнения скрипта. Все занимаемая память будет автоматически освобождена после завершения скрипта. Вы можете вызвать sybase_free_result() с идентификатором result в качестве параметра, и содержащая результаты выполнения этого запроса память будет освобождена.
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 -- получает число столбцов в результирующем наборе данных
int sybase_num_rows(string result);
sybase_num_rows() rвозвращает число строк в результирующем наборе
Смотри также: sybase_db_query(), sybase_query() и sybase_fetch_row().
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-сервер
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 --получает результирующие данные
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
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()
Назад | Содержание | Вперед