int msql
(string database, string query, int link_identifier);
Возвращает положительный идентификатор результата mSQL-запроса или false в случае ошибки.
msql() выбирает базу данных и выполняет на ней запрос. Если не указан необязательный идентификатор связи, функция будет пытаться найти открытую связь с mSQL-сервером и если ни одной связи найдено не будет, функция попытается создать ее, как если бы вызывалась функция msql_connect() без аргументов (см. msql_connect() ).
int msql_affected_rows
(int query_identifier);
Возвращает количество строк результата запроса (т.е. количество строк, возвращаемых SELECT, количество строк, модифицированных UPDATE или количество строк, удаленных DELETE).
См.также: msql_query()
int msql_close
(int link_identifier);
Возвращает true в случае успеха и false в случае ошибки.
msql_close() закрывает связь с базой данных mSQL, которая ассоциирована с указанным идентификатором связи. Если идентификатор связи не указан, закрывается последняя открытая связь.
Заметьте, что обычно нет необходимости это делать, т.к. непостоянные связи автоматически закрываются после исполнения скрипта.
msql_close() не закрывает постоянную связь, открытую с помощью msql_pconnect() .
См.также: msql_connect() и msql_pconnect() .
int msql_connect
(string hostname);
В случае успеха возвращает положительный идентификатор связи или false в случае ошибки.
msql_connect() устанавливает соединение с mSQL сервером. Аргумент hostname - необязателен, и если он пропущен, подразумевается localhost.
В случае второго вызова функции msql_connect() с одинаковыми аргументами, новой связи не образуется, а вместо нее возвращается идентификатор уже открытого соединения.
Связь серверои будет закрыта сразу же, как только прекратится выполнение скрипта или ранее она не будет закрыта вызовом функции msql_close() .
См.также msql_pconnect() , msql_close() .
int msql_create_db
(string database name, int [
link_identifier
]
);
msql_create_db() пытается создать новую базу данных на сервере, ассоциированном с указанным идентификатором связи.
См.также: msql_drop_db() .
int msql_createdb
(string database name, int [
link_identifier
]
);
Идентична msql_create_db() .
int msql_data_seek
(int query_identifier, int row_number);
Возвращает true в случае успеха и false в случае ошибки.
msql_data_seek() передвигает внутренний указатель строки результата msql_data_seek() ассоциированного с указанным идентификатором запроса для того, чтобы указать на строку с конкретным номером. Вызов msql_fetch_row() возвратит эту строку.
См.также: msql_fetch_row() .
string msql_dbname
(int query_identifier, int i);
msql_dbname() возвращает название базы данных записанной в положении i указателя, возвращаемого функцией msql_listdbs() . Для определения количества доступных баз данных может быть использована функция msql_numrows() .
int msql_drop_db
(string database_name, int link_identifier);
Возвращает true в случае успеха и false в случае ошибки.
msql_drop_db() пытается полностью удалить с сервера базу данных, ассоциированную с указанным идентификатором связи.
См.также: msql_create_db() .
См. msql_drop_db() .
string msql_error
( );
Ошибки, идующие от сервера mSQL больше не выдают предупреждений. Вместо них используйте функции для извлечения строки ошибки.
int msql_fetch_array
(int query_identifier);
Возвращает массив, который соответствует извлеченной строке. Если больше строк нет, возвращается false.
msql_fetch_array() это расширенная версия функции msql_fetch_row() . В дополнение к записи данных в массив с цифровыми индексами, данные также записываются в ассоциативный массив, использующий названия полей в качестве ключей.
Будьте осторожны при извлечении данных из запроса, который может возвратить запись, содержащую одно поле со значением 0 (или пустую строку, или NULL).
Важно заметить, что использование msql_fetch_array() работает совсем НЕ медленнее, чем msql_fetch_row() , причем обеспечивает при этом важные дополнения.
За дополнительной информацией обратитесь к msql_fetch_row()
object msql_fetch_field
(int query_identifier, int field_offset);
Возвращает объект, содержащий информацию о поле
msql_fetch_field() может использоваться для извлечения информации о полях в некоторых результатх запросов. Если не указано смещение поля, то возвращается следующее поле не извлеченное функцией msql_fetch_field() поле.
Свойствами объекта являются:
name - название колонки
table - название таблицы, которой принадлежит колонка to
not_null - 1, если колонка не может быть равна null
primary_key - 1, если колонка является первичным ключом
unique - 1, если колонка является уникальным ключом
type - тип колонки
См.также msql_field_seek() .
int msql_fetch_object
(int query_identifier);
Возвращает объект со свойствами, соответствующими извлеченной строке. Если больше нет строк, возвращается false.
msql_fetch_object() эквивалентно msql_fetch_array() , с одним исключением - вместо массива возвращается объект. Это значит, что доступ у данным может производиться только по названию поля, а не по их смещению (числа - неправильные названия полей).
По скорости работы функция иденитична msql_fetch_array() и msql_fetch_row() (разница очень маленькая).
См.также: msql_fetch_array() and msql_fetch_row() .
array msql_fetch_row
(int query_identifier);
Возвращает массив, соответствующий извлеченной строке. Если больше нет строк, то возвращается false.
msql_fetch_row() извлекает одну строку данных из результата, асслциированного с указанным идентификатором. Строка возвращается как массив. Каждая колонка результата записывается в массив со смещение, начиная со смещения 0.
Следующий вызов msql_fetch_row() возвратит следубщую строку из результата. Если строк больше нет, возвратится false.
См.также: msql_fetch_array() , msql_fetch_object() , msql_data_seek() , и msql_result() .
string msql_fieldname
(int query_identifier, int field);
msql_fieldname() возвращает название указанного поля. query_identifier - идентификатор запроса, и field - индекс поля. msql_fieldname($result, 2); возвратит название второго поля результата, ассоциированного с идентификатором результата.
int msql_field_seek
(int query_identifier, int field_offset);
Перемещает указатель на указанное смещение поля. Если последующий вызов msql_fetch_field() не будет включать в себя смещение поля, будет возвращено текущее поле.
См.также: msql_fetch_field() .
int msql_fieldtable
(int query_identifier, int field);
Возвращает название таблицы, откуда было извлечено поле field .
string msql_fieldtype
(int query_identifier, int i);
msql_fieldtype() эквивалентно msql_fieldname() . Аргументы идентичны, но возвращается тип поля. Тип может быть следующим: "int", "string" или "real".
string msql_fieldflags
(int query_identifier, int i);
msql_fieldflags() возвращает флаги указанного поля. В текущий момент они могут быть следующими: "not null", "primary key", их комбинацией или "" (пустая строка).
int msql_fieldlen
(int query_identifier, int i);
msql_fieldlen() возвращает длину указанного поля.
int msql_free_result
(int query_identifier);
msql_free_result() освобождает память, ассоциированную с query_identifier . Когда PHP завершает запрос, эта память осовобождается автоматически, таким образом Вам нужно вызывать эту функцию только тогда, когда Вы хотите быть уверены, что не используете слишком много памяти во время исполнения скрипта.
int msql_list_fields
(string database, string tablename);
msql_list_fields() извлекает информацию о данной таблице. Аргументами являются название базы данных и название таблицы. Возвращается указатель результата, который может быть использован функциями msql_fieldflags() , msql_fieldlen() , msql_fieldname() , и msql_fieldtype() . Идентификатор запроса - положительное целое число. Функция возвращает -1 если возникла ошибка. Строка, описывающая ошибку будет помещена в $phperrmsg , и до тех пор, пока функция не будет вызвана как @msql_list_fields() , строка ошибки будет выводится на печать.
См.также msql_error() .
See msql_list_fields() .
int msql_list_dbs
(void);
msql_list_dbs() возвратит указатель на результат, содержащий базы данных, доступные с текущего msql демона. Используйте функцию msql_dbname() для извлечения имен таблиц.
См. msql_list_dbs() .
int msql_list_tables
(string database);
msql_list_tables() в качестве параметра использует название базы данных, и возвращает у казатель на результат, примерно, как и функция msql() . Для извлечения настоящих названий таблиц должна быть использована функция msql_tablename() , параметром в которую передается указатель на результат.
См. msql_list_tables() .
int msql_num_fields
(int query_identifier);
msql_num_fields() возвращает количество полей в данных резултата.
См.также: msql() , msql_query() , msql_fetch_field() , и msql_num_rows() .
int msql_num_rows
(int query_identifier);
msql_num_rows() возвращает количество строк данных результата.
См.также: msql() , msql_query() , и msql_fetch_row() .
int msql_pconnect
(string hostname);
Возвращает положительный идентификатор соединения в случае успеха или false в случае ошибки.
msql_pconnect() ведет себя во многом также как msql_connect() с двумя главными отличиями:
Во-первых, при соединении функция должна попытаться найти (постоянное) соединение, уж открытое с указанным хостом. Если таковое найдено, вместо открытия нового соединения будет возвращен идентификатор только что найденного.
Во-вторых, соединение с SQl-сервером не закроется, когда завершится исполнение скрипты. Вместо этого, соединение останется открытым для будущего использования ( msql_close() не закроет соединение, установленно с помощью msql_pconnect()).
Такой тип связи, поэтому, называется 'постоянным'.
int msql_query
(string query, int link_identifier);
msql_query() посылает запрос к текущей активной базе данных на сервере, которая задается идентификатором связи. Если идентификатор связи не указан, то будет использоваться последняя открытая связь. Если связи вообще не открыто, то функция пытается установить связь как если бы вызывалась функция msql_connect() .
Возвращает положительный идентификатор запроса в случае успеха или false в случае ошибки.
См.также: msql() , msql_select_db() , and msql_connect() .
См. sql_regcase() .
int msql_result
(int query_identifier, int i, mixed field);
Возвращает содержимое ячейки с указанной строки и смещения в указанном рузльтате.
msql_result() возвращает содержимое одной ячейки из результата. Аргумент field может быть смещением поля или его названием или же названием таблицы, точка, названием поля (fieldname.tablename). Если название колонки является псевдонимом ('select foo as bar from...'), используйте псевдоним вместо названия колонки.
При работе с большими результатами запросов, Вы должны рассмотреть возможность использования одной из функций, которые извлекают колонку целиком. Т.к. эти функции извлекают содержимое нескольких ячеек за один вызов, то они работают НАМНОГО быстрее, чем msql_result(). Также заметьте, что при указании числового смещения поля функция работает гораздо быстрее, чем при указании названия поля или аргумента название_таблицы.название_поля.
В качестве высокоскоростной альтернативы рекомендуем: msql_fetch_row() , msql_fetch_array() , и msql_fetch_object() .
int msql_select_db
(string database_name, int link_identifier);
Возвращает true в случае успеха и false в случае ошибки.
msql_select_db() устанавливает текущую активную базу данных на сервере, которая ассоциируется с указанным идентификатором связи. Если не указан идентификатор связи, используется последняя открытая связь. Если не открыто ни одного соединения, функция попытается установить связь, как если бы вызывалась функция msql_connect(), и в дальнейшем использует установленную связь.
Каждый последующий вызов msql_query() будет сделан на активную базу данных.
См.также: msql_connect() , msql_pconnect() , и msql_query() .
См. msql_select_db() .
string msql_tablename
(int query_identifier, int field);
msql_tablename() использует в качестве аргументов указатель на рузультат, возвращаемый функцией msql_list_tables() и целый индекс и возвращает название таблицы. Функция msql_numrows() может быть использована для определения количества таблиц в результате запроса.
|
Пример 1. Использование msql_tablename()
<?php
msql_connect ("localhost");
$result = msql_list_tables("wisconsin");
$i = 0;
while ($i < msql_numrows($result)) {
$tb_names[$i] = msql_tablename($result, $i);
echo $tb_names[$i] . "<BR>";
$i++;
}
?>
|
Назад | Содержание | Вперед