Учебник PHP

         

SWFTextField->addstring

(unknown)

SWFTextField->addstring - конкатенирует данную строку с текстовым полем.

Описание

void swftextfield->addstring (string string)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

SWFTextField->align

(unknown)

SWFTextField->align - устанавливает выравнивание текстового поля.

Описание

void swftextfield->align (int alignement)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

swftextfield->align() устанавливает выравнивание alignement текстового поля. Правильные значения alignement: SWFTEXTFIELD_ALIGN_LEFT, SWFTEXTFIELD_ALIGN_RIGHT, SWFTEXTFIELD_ALIGN_CENTER и SWFTEXTFIELD_ALIGN_JUSTIFY.

SWFTextField->setbounds

(unknown)

SWFTextField->setbounds - устанавливает ширину и высоту текстового поля.

Описание

void swftextfield->setbounds (int width, int height)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

swftextfield->setbounds() устанавливает ширину width и высоту height текстового поля. Если вы не установите границы, Ming делает разную лажу на тех местах, где должны быть границы.

SWFTextField->setcolor

(unknown)

SWFTextField->setcolor - устанавливает цвет текстового поля.

Описание

void swftextfield->setcolor (int red, int green, int blue [, int a])

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

swftextfield->setcolor() устанавливает цвет текстового поля. По умолчанию - полностью непрозрачный чёрный. Цвет представляется с помощью системы RGB.

SWFTextField->setFont

(unknown)

SWFTextField->setFont - устанавливает шрифт текстового поля.

Описание

void swftextfield->setfont (string font)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

swftextfield->setfont() устанавливает шрифт текстового поля в [определяемый браузером?] шрифт font.

SWFTextField->setHeight

(unknown)

SWFTextField->setHeight - устанавливает высоту шрифта данного текста.

Описание

void swftextfield->setheight (int height)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

swftextfield->setheight() устанавливает высоту height шрифта данного текстового поля. По умолчанию 240.

SWFTextField->setindentation

(unknown)

SWFTextField->setindentation - устанавливает отступ первой строчки.

Описание

void swftextfield->setindentation (int width)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. >

swftextfield->setindentation() устанавливает отступ width первой строчки в текстовом поле.

SWFTextField->setLeftMargin

(unknown)

SWFTextField->setLeftMargin - устанавливает ширину левого поля текстового поля.

Описание

void swftextfield->setleftmargin (int width)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

swftextfield->setleftmargin() устанавливает ширину width левого поля текстового поля. По умолчанию 0.

SWFTextField->setLineSpacing

(unknown)

SWFTextField->setLineSpacing - устанавливает межстрочный интервал/line spacing текстового поля.

Описание

void swftextfield->setlinespacing (int height)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. >

swftextfield->setlinespacing() устанавливает межстрочный интервал height текстового поля. По умолчанию 40.

SWFTextField->setMargins

(unknown)

SWFTextField->setMargins - устанавливает ширину полей текстового поля.

Описание

void swftextfield->setmargins (int left, int right)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

swftextfield->setmargins() устанавливает оба поля за один раз.

SWFTextField->setname

(unknown)

SWFTextField->setname - устанавливает имя переменной.

Описание

void swftextfield->setname (string name)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

swftextfield->setname() устанавливает имя name переменной текстового поля для post-передачи формы и целей action скриптинга.

SWFTextField->setrightMargin

(unknown)

SWFTextField->setrightMargin - устанавливает ширину правого поля текстового поля.

Описание

void swftextfield->setrightmargin (int width)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

swftextfield->setrightmargin() устанавливает ширину width правого поля текстового поля. По умолчанию 0.

sybase_affected_rows

(PHP 3>= 3.0.6, PHP 4)

sybase_affected_rows - получает количество рядов, задействованных в последнем запросе/query.

Описание

int sybase_affected_rows ([int link_identifier])

Возвращает количество рядов, задействованных в последнем запросе.

sybase_affected_rows() возвращает количество рядов, задействованных в последнем запросе INSERT, UPDATE или DELETE на сервере, ассоциированном со специфицированным идентификатором ссылки/link identifier. Если идентификатор ссылки не специфицирован, принимается последняя ссылка.

Эта команда неэффективна для операторов SELECT, а только для оператор, модифицирующих записи. Для запрашивания количества рядов, возвращаемых из SELECT, используйте sybase_num_rows().

Примечание: эта функция доступна только при использовании интерфейса библиотеки CT с Sybase, а не библиотеки DB.

sybase_close

(PHP 3, PHP 4)

sybase_close - закрывает Sybase-соединение.

Описание

bool sybase_close (int link_identifier)

Возвращает TRUE при успехе, FALSE при ошибке.

sybase_close() закрывает ссылку с БД Sybase, ассоциированную со специфицированным идентификатором ссылки. Если link identifier не специфицирован, принимается последняя ссылка.

Обратите внимание, что это обычно не нужно, так как непостоянные открытые ссылки закрываются автоматически в конце выполнения скрипта.

sybase_close() не закроет постоянные ссылки, сгенерированные функцией sybase_pconnect().

См. также sybase_connect(), sybase_pconnect().

sybase_connect

(PHP 3, PHP 4)

sybase_connect - открывает соединение с Sybase-сервером.

Описание

int sybase_connect (string servername, string username, string password [, string charset])

Возвращает положительный идентификатор ссылки Sybase при успехе, FALSE при ошибке.

sybase_connect() устанавливает соединение с Sybase-сервером. Аргумент servername должен быть правильным именем сервера, определённым в файле 'interfaces'.

В случае второго вызова sybase_connect() с теми же аргументами новая ссылка не устанавливается, но возвращается идентификатор уже открытой ссылки.

Ссылка на сервер будет закрыта сразу по окончании выполнения скрипта, если не была закрыта ранее явным вызовом sybase_close().

См. также sybase_pconnect(), sybase_close().

sybase_data_seek

(PHP 3, PHP 4)

sybase_data_seek - перемещает внутренний указатель ряда.

Описание

bool sybase_data_seek (int result_identifier, int row_number)

Возвращает TRUE при успехе, FALSE при неудаче.

sybase_data_seek() перемещает внутренний указатель ряда Sybase-результата, ассоциированного со специфицированным идентификатором результата на специфицированный номер ряда/row_number. Следующий вызов sybase_fetch_row() возвратит этот ряд.

sybase_fetch_array

(PHP 3, PHP 4)

sybase_fetch_array - извлекает ряд как массив.

Описание

array sybase_fetch_array (int result)

Возвращает массив, соответствующий извлечённому ряду, или FALSE, если рядов больше нет.

sybase_fetch_array() это расширенная версия sybase_fetch_row(). Помимо сохранения данных в числовых индексах результирующего массива, она сохраняет также данные в ассоциативных индексах, используя имена полей как ключи.

Важно отметить, что sybase_fetch_array() работает НЕнамного медленнее, чем sybase_fetch_row(), но предоставляет важное дополнительное значение.

Детали см. также в sybase_fetch_row().

sybase_fetch_field

(PHP 3, PHP 4)

sybase_fetch_field - получает информацию поля.

Описание

object sybase_fetch_field (int result [, int field_offset])

Возвращает объект, содержащий информацию поля.

sybase_fetch_field() можно использовать для получения информации о полях в определённом результате запроса. Если смещение поля не специфицировано, возвращается следующее поле, ещё не запрошенное функцией sybase_fetch_field().

Свойства объекта:

name - имя столбца. Если столбец является результатом работы функции, это свойство устанавливается в computed#N, где #N это серийный номер.

column_source - таблица, из которой столбец взят

max_length - максимальный размер столбца

numeric - 1, если столбец числовой

type - datatype столбца

См. также sybase_field_seek().

sybase_fetch_object

(PHP 3, PHP 4)

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

(PHP 3, PHP 4)

sybase_fetch_row - получает ряд как перечислимый массив.

Описание

array sybase_fetch_row (int result)

Возвращает массив, соответствующий извлечённому ряду, или FALSE, если рядов больше нет.

sybase_fetch_row() извлекает один ряд данных из результата, ассоциированного со специфицированным идентификатором результата. Ряд возвращается как массив. Каждый результирующий столбец хранится в смещении массива, начиная со смещения 0.

Последующий вызов sybase_fetch_row() возвратит следующий ряд результирующего набора или FALSE, если рядов больше нет.

См. также sybase_fetch_array(), sybase_fetch_object(), sybase_data_seek(), sybase_fetch_lengths() и sybase_result().

sybase_field_seek

(PHP 3, PHP 4)

sybase_field_seek - устанавливает смещение поля.

Описание

int sybase_field_seek (int result, int field_offset)

Ищет специфицированное смещение поля. Если последующий вызов sybase_fetch_field() не будет содержать смещения поля, поле не будет возвращено.

См. также sybase_fetch_field().

sybase_free_result

(PHP 3, PHP 4)

sybase_free_result - освобождает результирующую память.

Описание

bool sybase_free_result (int result)

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

sybase_get_last_message

(PHP 3, PHP 4)

sybase_get_last_message - возвращает последнее сообщение сервера.

Описание

string sybase_get_last_message (void)

sybase_min_client_severity

(PHP 3, PHP 4)

sybase_min_client_severity - устанавливает минимальный клиентский уровень серьёзности.

Описание

void sybase_min_client_severity (int severity)

Примечание: эта функция доступна только при использовании интерфейса библиотеки CT в Sybase, а не библиотеки DB.

См. также sybase_min_server_severity().

sybase_min_error_severity

(PHP 3, PHP 4)

sybase_min_error_severity - устанавливает минимальный уровень серьёзности.

Описание

void sybase_min_error_severity (int severity)

См. также sybase_min_message_severity().

sybase_min_message_severity

(PHP 3, PHP 4)

sybase_min_message_severity - устанавливает минимальный уровень серьёзности сообщений.

Описание

void sybase_min_message_severity (int severity)

См. также sybase_min_error_severity().

sybase_min_server_severity

(PHP 3, PHP 4)

sybase_min_server_severity - устанавливает минимальный уровень серьёзности сервера.

Описание

void sybase_min_server_severity (int severity)

Примечание: эта функция доступна только при использовании интерфейса библиотеки CT в Sybase, а не библиотеки DB.

См. также sybase_min_client_severity().

sybase_num_fields

(PHP 3, PHP 4)

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

(PHP 3, PHP 4)

sybase_num_rows - получает количество рядов в результате.

Описание

int sybase_num_rows (int result)

sybase_num_rows() возвращает количество рядов в результирующем наборе.

См. также sybase_db_query(), sybase_query() и sybase_fetch_row().

sybase_pconnect

(PHP 3, PHP 4)

sybase_pconnect - открывает постоянное соединение Sybase.

Описание

int sybase_pconnect (string servername, string username, string password [, string charset])

Возвращает положительный идентификатор постоянной ссылки Sybase при успехе, FALSE при ошибке.

sybase_pconnect() работает как sybase_connect() с двумя отличиями.

Во-первых, при соединении функция сначала пытается найти (постоянную) ссылку, уже открытую с теми же host, username и password. Если найдена, возвращается её идентификатор вместо открытия нового соединения.

Во-вторых, соединение с SQL-сервером не будет закрыто по окончании работы скрипта. Ссылка останется открытой для последующего использования (sybase_close() не закрывает ссылки, установленные функцией sybase_pconnect()).

Ссылки этого типа называются поэтому 'persistent/постоянные'.

sybase_query

(PHP 3, PHP 4)

sybase_query - отправляет Sybase-запрос/query.

Описание

int sybase_query (string query, int link_identifier)

Возвращает положительный идентификатор результата Sybase при успехе, FALSE при ошибке.

sybase_query() отправляет запрос текущей активной БД на сервере, ассоциированной со специфицированным идентификатором ссылки. Если link_identifier не специфицирован, принимается последняя открытая ссылка. Если открытой ссылки нет, функция пытается установить ссылку, как при вызове sybase_connect(), и использует её.

См. также sybase_db_query(), sybase_select_db() и sybase_connect().

sybase_result

(PHP 3, PHP 4)

sybase_result - получает результирующие данные.

Описание

string sybase_result (int result, int row, mixed field)

Возвращает содержимое ячейки ряда и смещения в специфицированном результирующем наборе Sybase.

sybase_result() возвращает содержимое одной ячейки из специфицированного результирующего набора Sybase. Аргумент field может быть смещением поля, именем поля или именем таблицы точка именем поля (tablename.fieldname). Если создан псевдоним имени столбца ('select foo as bar from...'), используйте этот псевдоним вместо имени столбца.

При работе с большими результирующими наборами вы должны предусмотреть использование одной из функций, извлекающих целый ряд (специфицированы далее). Поскольку эти функции возвращают содержимое нескольких ячеек в одном вызове функции, они работают НАМНОГО быстрее, чем sybase_result(). Также отметьте, что специфицирование числового смещения для аргумента field намного быстрее, чем специфицирование fieldname или tablename.fieldname.

Рекомендуемые высокопроизводительные альтернативы: sybase_fetch_row(), sybase_fetch_array() и sybase_fetch_object().

sybase_select_db

(PHP 3, PHP 4)

sybase_select_db - выбирает базу данных Sybase.

Описание

bool 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().

symlink

(PHP 3, PHP 4)

symlink - создаёт символическую ссылку.

Описание

int symlink (string target, string link)

symlink() создаёт символическую ссылку, из существующего target, с именем link.

См. также link() для создания жёстких ссылок и readlink() с linkinfo().

Примечание: эта функция не реализована для платформ Windows.

syslog

(PHP 3, PHP 4)

syslog - генерирует системное log-сообщение.

Описание

int syslog (int priority, string message)

syslog() генерирует log-сообщение, которое будет распространено системным логером.
priority это комбинация facility и уровня, значения которых заданы в следующем разделе. Другой аргумент это сообщение для отправки, но два символа %m будут замещены строкой сообщения об ошибке (strerror), соответствующей имеющемуся значению errno.

Таблица 1. Приоритеты syslog() (в нисходящем порядке)
КонстантаОписаниеLOG_EMERGсистема не используема LOG_ALERTакция должна предприниматься немедленноLOG_CRITкритические условия LOG_ERRошибочные условияLOG_WARNINGпредупреждающие условия LOG_NOTICEнормальное, но значащее условиеLOG_INFOинформационное сообщение LOG_DEBUGсообщение отладки

system

(PHP 3, PHP 4)

system - выполняет внешнюю программу и отображает вывод.

Описание

string system (string command [, int return_var])

system() похожа на C-версию этой же функции тем, что выполняет данную команду command и выводит результат. Если предоставлена переменная в качестве второго параметра, то возвращается статус-код выполненной команды, записанный в эту переменную.

Предупреждение!Если вы разрешаете передачу данных из пользовательского ввода в эту функцию, то вы должны использовать escapeshellarg() или escapeshellcmd(), чтобы гарантировать, что пользователь не выкинет какой-нибудь трюк с системой путём выполнения произвольных команд.

Примечание: если вы начинаете программу с использования этой функции и хотите оставить её работать в фоновом режиме, вы должны гарантировать, что вывод этой программы будет перенаправлен в файл или какой-нибудь другой поток вывода, иначе PHP зависнет, пока не закончится выполнение программы.

Вызов system() пытается также автоматически очистить буфер вывода web-сервера после каждой строчки вывода, если PHP работает как серверный модуль.

Возвращает последнюю строку командного вывода при успехе, FALSE при неудаче.

Если вам нужно выполнить команду и передать все данные из команды непосредственно обратно без интерференции, используйте passthru().

См. также exec(), passthru(), popen(), escapeshellcmd() и операцию backtick.

tan

(PHP 3, PHP 4)

tan - тангенс.

Описание

float tan (float arg)

tan() возвращает тангенс параметра arg. Параметр arg задан в радианах.

См. также atan(), sin(), cos() и deg2rad().

tanh

(PHP 4 >= 4.1.0)

tanh - гиперболический тангенс.

Описание

float tanh (float arg)

Возвращает гиперболический тангенс аргумента arg, определённый как sinh(arg)/cosh(arg).

См. также tan(), atanh(), sin() и cos().

tempnam

(PHP 3, PHP 4)

tempnam - создаёт файл с  уникальным именем.

Описание

string tempnam (string dir, string prefix)

Создаёт файл с уникальным именем filename в специфицированной директории. Если директория не существует, tempnam() может генерировать файл в системной временной директории и возвращать её имя.

До PHP 4.0.6 поведение функции tempnam() зависело от системы. В Windows переменная окружения TMP переопределяет параметр dir, в Linux переменная окружения TMPDIR имеет приоритет, а в SVR4 всегда используется ваш параметр dir, если директория, на которую он указывает, существует. При сомнениях проконсультируйтесь в вашей системной документации о функции tempnam(3).

Возвращает новый временный filename, или строку FALSE при неудаче.

Пример 1. tempnam()
$tmpfname = tempnam ("/tmp", "FOO");
$fp = fopen($tmpfname, "w");
fwrite($fp, "writing to tempfile");
fclose($fp);
// здесь сделать чего-нибудь
unlink($tmpfname);

Примечание: поведение этой функции изменилось в 4.0.3. Создаётся также временный файл, чтобы исключить race-условие, где файл может появиться в файловой системе в период между генерацией строки и до созданием файла скриптом. Заметьте, что вам нужно удалить файл, если он вам больше не нужен, это не будет сделано автоматически.

См. также tmpfile() и unlink().

textdomain

(PHP 3>= 3.0.7, PHP 4)

textdomain - домен по умолчанию.

Описание

string textdomain (string text_domain)

Эта функция устанавливает домен для поиска в нём, когда делаются вызовы gettext(), именуемый обычно после приложения. Возвращается предыдущий домен по умолчанию. Вызывайте её с NULL в качестве параметра для получения текущей установки без изменения.

time

(PHP 3, PHP 4)

time - возвращает текущий UNIX timestamp.

Описание

int time (void)

Возвращает текущее время, измеренное в секундах с начала Unix Epoch (January 1 1970 00:00:00 GMT).

См. также date().

tmpfile

(PHP 3>= 3.0.13, PHP 4)

tmpfile - создаёт временный файл.

Описание

int tmpfile (void)

Создаёт временный файл с уникальным именем в режиме для записи, возвращая дескриптор файла, аналогичный дескриптору, возвращаемому функцией fopen(). Файл автоматически удаляется при закрытии (с помощью fclose()) или по окончании скрипта.

Детали см. в вашей системной документации о функции tmpfile(3), а также header-файле в stdio.h.

touch

(PHP 3, PHP 4)

touch - устанавливает время доступа и модификации файла.

Описание

int touch (string filename [, int time [, int atime]])

Пытается установить время доступа и модификации файла filename в значение, заданное по времени. Если опции time нет, используется текущее время. Это эквивалентно тому, что делает utime (иногда называемая utimes). Если имеется третья опция atime, время доступа данного файла также модифицируется.

Если файл не существует, он создаётся.

Возвращает TRUE при успехе, FALSE при неудаче.

trigger_error

(PHP 4 >= 4.0.1)

trigger_error - генерирует сообщение error/warning/notice пользовательского уровня.

Описание

void trigger_error (string error_msg [, int error_type])

Используется для переключения пользовательского ошибочного условия; может использоваться в соединении со встроенным обработчиком ошибок или с пользовательской функцией, которая установлена как новый обработчик ошибок (set_error_handler()). Работает только с семейством E_USER констант и по умолчанию - с E_USER_NOTICE.

Эта функция используется, если вам нужно сгенерировать определённый ответ на исключение на этапе прогона. Например:

if (assert ($divisor == 0))
trigger_error ("Cannot divide by zero", E_USER_ERROR);

Примечание: см. в set_error_handler() более расширенный пример.

См. также error_reporting(), set_error_handler(), restore_error_handler(), user_error().

trim

(PHP 3, PHP 4)

trim - вырезает пустое пространство в начале и в конце строки.

Описание

string trim (string str [, string charlist])

Примечание: необязательный параметр charlist был введён в PHP 4.1.0.

Эта функция возвращает строку с вырезанными в начале и конце строки str пробелами. Без второго параметра trim() вырезает:

" " (ASCII 32 (0x20)), обычный space/пробел.

"\t" (ASCII 9 (0x09)), символ tab.

"\n" (ASCII 10 (0x0A)), символ новой строки (line feed).

"\r" (ASCII 13 (0x0D)), символ carriage return/возврат каретки.

"\0" (ASCII 0 (0x00)), NUL-байт.

"\x0B" (ASCII 11 (0x0B)), символ vertical tab/вертикальной табуляции.

Вы можете также специфицировать вырезаемые символы в параметре charlist. Просто перечислите все символы, которые вы хотите вырезать. С помощью .. вы можете специфицировать диапазон символов.

uasort

(PHP 3>= 3.0.4, PHP 4)

uasort - сортирует массив пользовательской функцией сравнения и выдерживает ассоциацию индексов.

Описание

void uasort (array array, function cmp_function)

Эта функция сортирует массив так, что индексы массивов сохраняют корреляцию с элементами массива, с которыми они ассоциированы. Это используется в основном при сортировке массивов, где важен фактический порядок элементов. Функция сравнения является пользовательской.

Примечание: посмотрите в usort() и uksort() примеры пользовательских функций сравнения.

Примечание: вместо имени функции может быть предоставлен также массив, содержащий ссылку на объект и имя метода.

См. также usort(), uksort(), sort(), asort(), arsort(), ksort() и rsort().

ucfirst

(PHP 3, PHP 4)

ucfirst - переводит первый символ строки в верхний регистр.

Описание

string ucfirst (string str)

Возвращает строку с первым символом в верхнем регистре, если это алфавитный символ.

Заметьте, что 'алфавитный' определяется текущей locale. Например, в локализации по умолчанию "C" такие символы, как umlaut-a, не будут конвертироваться.

Пример 1. ucfirst()

ucwords

(PHP 3>= 3.0.3, PHP 4)

ucwords - Первый символ каждого слова строки переводится в верхний регистр.

Описание

string ucwords (string str)

Возвращает строку с первыми символами каждого слова, переведёнными в верхний регистр, если это алфавитные символы.

udm_add_search_limit

(PHP 4 >= 4.0.5)

udm_add_search_limit - добавляет различные ограничения поиска.

Описание

int udm_add_search_limit (int agent, int var, string val)

udm_add_search_limit() возвращает TRUE при успехе, FALSE при ошибке. Добавляет ограничения поиска.

agent - ссылка на Agent, полученный после вызова udm_alloc_agent().

var - определяет параметр, обозначающий ограничение.

val - определяет значение текущего параметра.

Возможные значения var:

UDM_LIMIT_URL - определяет ограничения URL документа для поиска в подразделе БД. Поддерживает шаблоны/wildcards SQL % и _ , где % совпадает с любым количеством символов, даже с нуль символов, а _ совпадает точно с одним символом. Например, http://my.domain.__/catalog may stand for http://my.domain.ru/catalog и http://my.domain.ua/catalog.

UDM_LIMIT_TAG - определяет TAG-ограничения сайта. В indexer-conf вы можете присвоить специфические TAGs различным сайтам и частям сайта. Тэги в mnoGoSearch 3.1.x это строчки, которые могут содержать метасимволы % и _. Метасимволы позволяют искать группы тэгов. Например, есть ссылки с тэгами ABCD и ABCE, а поиск ограничен ABC_ - поиск будет выполнен в обоих тэгах.

UDM_LIMIT_LANG - определяет ограничения языка документа.

UDM_LIMIT_CAT - определяет ограничения категории документа. Категории похожи на тэги, но вкладываются. Так что вы можете иметь одну категорию внутри другой и так далее. Вы должны использовать два символа для каждого уровня. Используйте 16-ричное число, начиная с 0-F, или число с базой 36, начиная с 0-Z. Таким образом, категория верхнего уровня, наподобие 'Auto', будет 01. Если она имеет подкатегорию 'Ford', то будет 01 (родительская категория) и 'Ford', которому мы назначили 01. Совместив их, мы получим 0101. Если 'Auto' имеет другую подкатегорию 'VW', то её id будет 01, поскольку она принадлежит категории 'Auto', и 02, поскольку это следующая категория. Таким образом, её id будет 0102. Если VW имеет подкатегорию 'Engine', то её id будет начинаться вновь с 01 и получит 'VW' id 02 и 'Auto' id 01, что даст 010201. Если вы хотите искать сайты под этой категорией, вы передаёте её cat=010201 в url.

UDM_LIMIT_DATE - определяет ограничение по дате модификации документа.

Формат значения параметра: строка с первым символом < или >, затем, без пробелов, дата в формате unixtime, например:

Udm_Add_Search_Limit($udm,UDM_LIMIT_DATE,"<908012006");

Если используется символ >, то поиск ограничен документами, имеющими дату модификации больше, чем введённая. Если <, то меньше.

udm_alloc_agent

(PHP 4 >= 4.0.5)

udm_alloc_agent - размещает сессию mnoGoSearch.

Описание

int udm_alloc_agent (string dbaddr [, string dbmode])

udm_alloc_agent() возвращает идентификатор mnogosearch-агента при успехе, FALSE при ошибке. Эта функция создаёт сессию с параметрами БД.

dbaddr - описание БД в URL-стиле. Опции (type, host, database name, port, user и password) для соединения с SQL-БД. Не имеет значения для встроенной поддержки текстовых файлов. Формат: DBAddr DBType:[//[DBUser[:DBPass]@]DBHost[:DBPort]]/DBName/
В настоящее время поддерживаются следующие значения DBType: mysql, pgsql, msql, solid, mssql, oracle, ibase. Фактически это не важно для поддержки встроенных библиотек. Но пользователи ODBC должны специфицировать одно из поддерживаемых значений. Если тип вашей БД не поддерживается, вы можете использовать "unknown".

dbmode - вы можете выбрать режим SQL БД для хранения слов. Если специфицирован "single", все слова хранятся в той же таблице. Если выбран "multi", слова размещаются в разных таблицах, в зависимости от их длины. Режим "multi" обычно быстрее, но требует больше таблиц в БД. Если специфицирован режим "crc", mnoGoSearch хранит 32-битные integer IDы слов, вычисленные алгоритмом CRC32, а не слова. Этот метод требует меньше дискового пространства и быстрее по сравнению с режимами "single" и "multi". "crc-multi" использует ту же структуру хранения, что и "crc", но также хранит слова  в разных таблицах, в зависимости от длины слов, как формат "multi".
Формат: DBMode single/multi/crc/crc-multi

Примечание: dbaddr и dbmode обязаны совпадать с используемыми в ходе индексации.

Примечание: фактически эта функция не открывает соединение с БД и не проверяет, соответственно, login и password. Реальное соединение с БД и проверка login/password выполняется функцией udm_find().

udm_api_version

(PHP 4 >= 4.0.5)

udm_api_version - получает версию mnoGoSearch API.

Описание

int udm_api_version (void)

udm_api_version() возвращает номер версии mnoGoSearch API. Например, если используется mnoGoSearch 3.1.10 API, эта функция возвратит 30110.

Эта функция даёт пользователю возможность идентифицировать, какие API-функции доступны, например, udm_get_doc_count() доступна только в mnoGoSearch 3.1.11 или новее.

Пример:

udm_cat_list

(PHP 4 >= 4.0.6)

udm_cat_list - получает все категории одного уровня с текущей.

Описание

array udm_cat_list (int agent, string category)

udm_cat_list() возвращает массив со списком всех категорий того же уровня, что и текущая категория, с дереве категорий.

Функция может использоваться при разработке браузера дерева категорий.

Возвращает массив следующего формата:

Массив состоит из пар. Элементы с чётными индексами содержат пути категорий, нечётные элементы содержать соответствующие имена категорий.

  $array[0] будет содержать '020300'
  $array[1] будет содержать 'Audi'
  $array[2] будет содержать '020301'
  $array[3] будет содержать 'BMW'
  $array[4] будет содержать '020302'
  $array[5] будет содержать 'Opel'
  ...
 и так далее.

Далее идёт пример ссылок текущего уровня в формате:
  Audi
  BMW
  Opel
  ...
 

udm_cat_path

(PHP 4 >= 4.0.6)

udm_cat_path - получает путь к текущей категории.

Описание

array udm_cat_path (int agent, string category)

udm_cat_path() возвращает массив с описанием пути/path в дереве категорий от корня до текущей категории.

agent - ссылка на идентификатор агента.

category - текущая категория - та, к которой получаем путь.

Возвращает массив в формате:

Массив состоит из пар. Элементы с чётными номерами содержат путь к категориям, нечётные - имена соответствующих категорий.

Например, вызов $array=udm_cat_path($agent, '02031D'); может возвратить следующий массив:

 $array[0] будет содержать ''
 $array[1] будет содержать 'Root'
 $array[2] будет содержать '02'
 $array[3] будет содержать 'Sport'
 $array[4] будет содержать '0203'
 $array[5] будет содержать 'Auto'
 $array[4] будет содержать '02031D'
 $array[5] будет содержать 'Ferrari'
 

udm_check_charset

(PHP 4 >= 4.2.0)

udm_check_charset - проверяет, известен ли данный charset/набор символов в mnogosearch.

Описание

int udm_check_charset (int agent, string charset)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

udm_check_stored

(PHP 4 >= 4.2.0)

udm_check_stored - проверяет соединение со stored.

Описание

int udm_check_stored (int agent, int link, string doc_id)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

udm_clear_search_limits

(PHP 4 >= 4.0.5)

udm_clear_search_limits - очищает все ограничения поиска mnoGoSearch.

Описание

int udm_clear_search_limits (int agent)

udm_clear_search_limits() восстанавливает определённые ограничения поиска и возвращает TRUE.

udm_close_stored

(PHP 4 >= 4.2.0)

udm_close_stored - закрывает соединение со stored.

Описание

int udm_close_stored (int agent, int link)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

udm_crc32

(PHP 4 >= 4.2.0)

udm_crc32 - возвращает контрольную сумму CRC32 данной строки.

Описание

int udm_crc32 (int agent, string str)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

udm_errno

(PHP 4 >= 4.0.5)

udm_errno - получает номер ошибки mnoGoSearch.

Описание

int udm_errno (int agent)

udm_errno() возвращает номер ошибки mnoGoSearch; нуль, если ошибки нет.

agent - ссылка на идентификатор агента, полученная после вызова udm_alloc_agent() .

Получает числовой код ошибки агента.

udm_error

(PHP 4 >= 4.0.5)

udm_error - получает сообщение об ошибке mnoGoSearch.

Описание

string udm_error (int agent)

udm_error() возвращает сообщение об ошибке mnoGoSearch, либо пустую строку, если ошибок нет.

agent - ссылка на идентификатор агента, полученная после вызова udm_alloc_agent().

Получает сообщение агента об ошибке.

udm_find

(PHP 4 >= 4.0.5)

udm_find - выполняет поиск.

Описание

int udm_find (int agent, string query)

udm_find() возвращает результирующий идентификатор ссылки при успехе, FALSE при ошибке.

Теперь о поиске. Первый аргумент - session, следующий - сам запрос/query. Для поиска просто введите слова и нажмите кнопку SUBMIT. Например, "mysql odbc". Вы не должны использовать кавычки " в запросе, они записаны здесь только с целью выделить текст запроса.
mnoGoSearch найдёт все документы, содержащие слово "mysql" и/или слово "odbc". Документы, имеющие больший вес, будут отображены первыми. Если вы используете режим поиска ALL, возвратятся документы, содержащие оба (или более) введённых вами слова. В случае использования режима ANY будет возвращён список документов, содержащих любое из введённых вами слов. Если вы хотите более продвинутых результатов, вы можете использовать язык запросов. Нужно ввести режим совпадений "bool" в форме поиска.

mnoGoSearch понимает следующие булевы операции:

& - логическое AND. Например, "mysql & odbc". mnoGoSearch найдёт любые URLs, содержащие оба слова "mysql" и "odbc".

| - логическое OR. Например, "mysql|odbc". mnoGoSearch найдёт любые URLs, содержащие слово "mysql" или слово "odbc".

~ - логическое NOT. Например, "mysql & ~odbc". mnoGoSearch найдёт URLs, содержащие слово "mysql", но не слово "odbc" одновременно. Заметьте, что ~ просто исключает данное слово из результата поиска. Запрос "~odbc" не найдёт ничего!

() - группирует команды для создания более сложных запросов. Например, "(mysql | msql) & ~postgres". Язык поиска прост и мощен. Просто рассматривайте запрос как обычное булево выражение.

udm_free_agent

(PHP 4 >= 4.0.5)

udm_free_agent - освобождает сессию mnoGoSearch.

Описание

int udm_free_agent (int agent)

udm_free_agent() возвращает TRUE при успехе, FALSE при ошибке.

agent - ссылка на идентификатор агента, полученная ` после вызова udm_alloc_agent().

Освобождает память, выделенную для сессии агента.

udm_free_ispell_data

(PHP 4 >= 4.0.5)

udm_free_ispell_data - освобождает память, выделенную для ispell-данных.

Описание

int udm_free_ispell_data (int agent)

udm_free_ispell_data() всегда возвращает TRUE.

agent - ссылка на идентификатор агента, полученная вызовом udm_alloc_agent().

Примечание: эта функция поддерживается, начиная с версии 3.1.12 mnoGoSearch, и ничего не делает в предыдущих версиях.

udm_free_res

(PHP 4 >= 4.0.5)

udm_free_res - освобождает результат mnoGoSearch.

Описание

int udm_free_res (int res)

udm_free_res() возвращает TRUE при успехе, FALSE при ошибке.

res - ссылка на идентификатор результата, полученная после вызова udm_find().

Освобождает память, выделенную для результатов.

udm_get_doc_count

(PHP 4 >= 4.0.5)

udm_get_doc_count - получает общее количество документов в БД.

Описание

int udm_get_doc_count (int agent)

agent - ссылка на идентификатор агента, полученная после вызова udm_alloc_agent().

Примечание: эта функция поддерживается только в mnoGoSearch 3.1.11 или новее.

udm_get_res_field

(PHP 4 >= 4.0.5)

udm_get_res_field - извлекает поле результата mnoGoSearch.

Описание

string udm_get_res_field (int res, int row, int field)

udm_get_res_field() возвращает значение результирующего поля при успехе, FALSE при ошибке.

res - ссылка на идентификатор результата, полученная после вызова udm_find().

row - количество ссылок на текущей странице. Может иметь значения от 0 до UDM_PARAM_NUM_ROWS-1.

field - идентификатор поля, может иметь значения:

UDM_FIELD_URL - поле URL документа.

UDM_FIELD_CONTENT - поле Content-type документа (например, text/html).

UDM_FIELD_CATEGORY - поле категории документа. Используйте udm_cat_path() для получения полного пути к текущей категории от корня дерева категорий. (Этот параметр доступен только в PHP 4.0.6 или новее).

UDM_FIELD_TITLE - поле title документа.

UDM_FIELD_KEYWORDS - поле keywords документа (из тэга META KEYWORDS).

UDM_FIELD_DESC - поле description документа (из тэга META DESCRIPTION).

UDM_FIELD_TEXT - поле body документа (первая пара строчек, дающая представление, о чём этот документ).

UDM_FIELD_SIZE - размер документа.

UDM_FIELD_URLID - уникальный URL ID ссылки.

UDM_FIELD_RATING - рейтинг страницы (вычисленный mnoGoSearch).

UDM_FIELD_MODIFIED - поле last-modified в формате unixtime.

UDM_FIELD_ORDER - номер текущего документа в наборе найденных документов.

UDM_FIELD_CRC - CRC документа.

udm_get_res_param

(PHP 4 >= 4.0.5)

udm_get_res_param - получает параметры результата mnoGoSearch.

Описание

string udm_get_res_param (int res, int param)

udm_get_res_param() возвращает значение параметра результата при успехе, FALSE при ошибке.

res - ссылка на идентификатор результат, полученная udm_find().

param - идентификатор параметра, может иметь следующие значения:

UDM_PARAM_NUM_ROWS - количество найденных на текущей странице ссылок. Равносильно UDM_PARAM_PAGE_SIZE для всех станиц поиска, на последней странице - оставшиеся ссылки.

UDM_PARAM_FOUND - общее количество результирующих совпадений с запросом.

UDM_PARAM_WORDINFO - информация о найденных словах. Например, поиск "a good book" возвратит "a: stopword, good:5637, book: 120"

UDM_PARAM_SEARCHTIME - время поиска в секундах.

UDM_PARAM_FIRST_DOC - номер первого документа, отображённого на текущей странице.

UDM_PARAM_LAST_DOC - номер последнего документа, отображённого на текущей странице.

udm_load_ispell_data

(PHP 4 >= 4.0.5)

udm_load_ispell_data - загружает ispell-данные.

Описание

int udm_load_ispell_data (int agent, int var, string val1, string val2, int flag)

Возвращает TRUE при успехе, FALSE при ошибке.

agent - ссылка на идентификатор агента, полученная вызовом udm_alloc_agent().

var - параметр, указывающий источник ispell-данных. Может иметь значения, указанные далее.

После использования этой функции, чтобы освободить память, выделенную для ispell-данных, используйте udm_free_ispell_data(), даже если вы применяете режим UDM_ISPELL_TYPE_SERVER.

Самым быстрым режимом является UDM_ISPELL_TYPE_SERVER. UDM_ISPELL_TYPE_TEXT медленнее, а UDM_ISPELL_TYPE_DB - самый медленный. Вышеприведённый патэрн TRUE для mnoGoSearch 3.1.10 - 3.1.11. Планируется ускорить режим DB в будущих версиях, и он будет быстрее режима TEXT.

UDM_ISPELL_TYPE_DB - указывает, что ispell-данные должны быть загружены из SQL. В этом случае параметры val1 и val2 игнорируются и должны быть оставлены пустыми. flag должен быть равен 1.

Примечание: flag указывает, что после загрузки ispell-данных из определённого ресурса они должны быть отсортированы (это необходимо для корректной работы ispell). При загрузке ispell-данных из файлов может быть несколько вызовов udm_load_ispell_data(), нет смысла сортировать данные после каждого вызова, и сортировка делается только после последнего вызова. Поскольку в режиме db все данные загружаются одним вызовом, этот параметр должен иметь значение 1. При ошибке в этом режиме, например, если ispell-таблицы отсутствуют, функция возвратит FALSE, а код и сообщение об ошибке будут доступны через udm_error() м udm_errno().

Пример:

udm_open_stored

(PHP 4 >= 4.2.0)

udm_open_stored - открывает соединение со stored.

Описание

int udm_open_stored (int agent, string storedaddr)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

udm_set_agent_param

(PHP 4 >= 4.0.5)

udm_set_agent_param - устанавливает параметры сессии агента mnoGoSearch.

Описание

int udm_set_agent_param (int agent, int var, string val)

udm_set_agent_param() возвращает TRUE при успехе, FALSE при ошибке. Определяет параметры сессии mnoGoSearch.

Имеются следующие параметры и значения:

UDM_PARAM_PAGE_NUM - используется для выбора номера страницы результата поиска (результаты возвращаются страницей, начиная с 0, с UDM_PARAM_PAGE_SIZE результатов на страницу).

UDM_PARAM_PAGE_SIZE - количество результатов поиска, отображаемых на одной странице.

UDM_PARAM_SEARCH_MODE - режим поиска. Доступны значения: UDM_MODE_ALL - искать все слова; UDM_MODE_ANY - искать любое слово; UDM_MODE_PHRASE - поиск фразы; UDM_MODE_BOOL - булев поиск. См. в udm_find() детали о булевом поиске.

UDM_PARAM_CACHE_MODE - включает/выключает режим кэширования результатов поиска. Если включён, машина поиска сохранит результаты поиска на диске. Если аналогичный поиск выполняется позднее, машина возьмёт результаты из кэша, что быстрее. Доступны значения: UDM_CACHE_ENABLED, UDM_CACHE_DISABLED.

UDM_PARAM_TRACK_MODE - включает/выключает режим trackquery. Начиная с версии 3.1.2, mnoGoSearch имеет поддержку трэкинга запросов. Заметьте, что этот трэкинг реализован только в SQL-версии и недоступен во встроенной БД. Для использования трэкинга вы должны создать таблицы для поддержки трэкинга. Для MySQL используйте create/mysql/track.txt. При выполнении поиска конечный этап использует эти таблицы для хранения слов запроса, количества найденных документов и и текущий UNIX timestamp в секундах. Доступные значения: UDM_TRACK_ENABLED, UDM_TRACK_DISABLED.

UDM_PARAM_PHRASE_MODE - определяет, использует ли индексная БД фразы (параметр "phrase" в indexer.conf). Возможные значения: UDM_PHRASE_ENABLED и UDM_PHRASE_DISABLED. Заметьте, что, если включён поиск фраз (UDM_PHRASE_ENABLED), можно также искать в любом режиме (ANY, ALL, BOOL или PHRASE). В версии 3.1.10 mnoGoSearch поиск фраз поддерживается только в режимах sql и встроенной БД, а, начиная с 3.1.11, фразы поддерживаются также в режиме cachemode.

Примеры фраз для поиска:

"Arizona desert" - этот запрос возвращает все индексированные документы, содержащие фразу "Arizona desert". Заметьте, что нужно поместить двойные кавычки вокруг фразы.

UDM_PARAM_CHARSET - определяет локальный charset/набор символов. Доступны значения: набор charsets, поддерживаемых mnoGoSearch, например, koi8-r, cp1251, ...

UDM_PARAM_STOPFILE - определяет имя и путь к файлу stopwords. (Есть небольшое отличие от mnoGoSearch - в то время как во mnoGoSearch введён относительный путь или никакого пути, он ищет файл относительно UDM_CONF_DIR, модель ищет файл относительно текущего пути, т.е. пути, где выполняется php-скрипт.)

UDM_PARAM_STOPTABLE - загружает stop-слова из данной SQL-таблицы. Вы можете использовать несколько команд StopwordTable. Эта команда не действует, если скомпилировано без поддержки SQL-БД.

UDM_PARAM_WEIGHT_FACTOR - представляет weight-факторы для специфических частей документа. В настоящее время поддерживаются body, title, keywords, description, url. Для активации этой возможности используйте степени 2 в *Weight командах файла indexer.conf.
Представим, что у нас имеются следующие weights:

  URLWeight        1
  BodyWeight       2
  TitleWeight       4
  KeywordWeight  8
  DescWeight     16
 

Поскольку индексатор использует битовую операцию OR для weights слов, когда некоторые слова представлены несколько раз в том же документе, можно на этапе поиска определять появление слова в разных частях документа. Слово, которое появляется только в теле/body, будет иметь агрегатный вес 00000010 (в двоичной нотации). Слово, используемое во всех частях документа, будет иметь агрегатный вес 00011111.

Значением этого параметра является строка 16-ричных цифр ABCDE. Каждая цифра является фактором для соответствующего бита в весе слова. Для данной выше конфигурации весов:


   E это фактор для веса 1  (бит URL Weight)
   D это фактор для веса 2  (бит BodyWeight)
   C это фактор для веса 4  (бит TitleWeight)
   B это фактор для веса 8  (бит KeywordWeight)
   A это фактор для веса 16 (бит DescWeight)
 

Примеры:

UDM_PARAM_WEIGHT_FACTOR=00001 будет искать только в URLs.

UDM_PARAM_WEIGHT_FACTOR=00100 будет искать только в Titles.

UDM_PARAM_WEIGHT_FACTOR=11100 будет искать в Title, Keywords, Description, но не в URL и в Body.

UDM_PARAM_WEIGHT_FACTOR=F9421 будет искать в:


    Description с фактором 15  (F hex)
    Keywords с фактором  9
    Title с фактором  4
    Body с фактором  2
    URL с фактором 1
 

Если переменная UDM_PARAM_WEIGHT_FACTOR опущена, принимается оригинальное weight-значение для сортировки результатов. Для данной выше конфигурации весов это означает, что описание документа имеет самый большой вес 16.

UDM_PARAM_WORD_MATCH - совпадение слова. Вы можете использовать этот параметр для выбора типа совпадения слов. Это работает только в режимах "single" и "multi" с использованием БД на основе SQL и встроенной БД. Не работает в режиме cachemode и других режимах, поскольку они используют CRC слов и не поддерживают поиск подстрок. Доступны значения:

UDM_MATCH_BEGIN - совпадение начала слов;

UDM_MATCH_END - совпадение конца слов;

UDM_MATCH_WORD - совпадение всего слова;

UDM_MATCH_SUBSTR - совпадение подстроки.

UDM_PARAM_MIN_WORD_LEN - определяет минимальную длину слова. Любое слово, короче этого лимита, считается stopword. Заметьте, что значение этого параметра включается, т.е., если UDM_PARAM_MIN_WORD_LEN=3, слово длиной в 3 символа не будет считаться stopword, а слово длиной в 2 символа - считается. По умолчанию значение 1.

UDM_PARAM_ISPELL_PREFIXES - возможные значения: UDM_PREFIXES_ENABLED и UDM_PREFIXES_DISABLED, включающие/выключающие использование префиксов. Например, если слово "tested" имеется в запросе на поиск, также ищутся слова вроде "test", "testing", etc. По умолчанию поддерживаются только суффиксы. Префиксы обычно изменяют значение слов, например, если кто-нибудь ищет слово "tested", то другому нужно только "untested". Поддержка префиксов может понадобиться также для целей проверки правописания на сайте. для включения ispell вы должны загрузить ispell-данные функцией udm_load_ispell_data().

UDM_PARAM_CROSS_WORDS - включает/выключает поддержку перекрёстных слов/crosswords. Возможные значения: UDM_CROSS_WORDS_ENABLED и UDM_CROSS_WORDS_DISABLED.

corsswords даёт возможность присваивать слова между тэгами <a href="xxx"> и </a> также документу, к которому ведёт ссылка. Это работает в режиме SQL-БД и не поддерживается во встроенной БД и в Cachemode.

Примечание: Crosswords поддерживаются только во mnoGoSearch 3.1.11 или новее.

UDM_PARAM_VARDIR - специфицирует специальный путь к директории, где индексатор хранит данные при использовании встроенной БД и режима cache. По умолчанию используется директория /var инсталяции mnoGoSearch. Может иметь только строковые значения. Этот параметр доступен в PHP 4.1.0 или новее.

UDM_PARAM_VARDIR - специфицирует специальный путь к директории, где индексатор хранит данные при использовании встроенной БД и режима cache. По умолчанию используется директория /var инсталяцииmnoGoSearch. Может иметь только строковые значения. Этот параметр доступен в PHP 4.1.0 или новее.

uksort

(PHP 3>= 3.0.4, PHP 4)

uksort - сортирует массив по ключам с использованием пользовательской функции сравнения.

Описание

void uksort (array array, function cmp_function)

Эта функция сортирует ключи массива с помощью пользовательской функции. Если вы хотите отсортировать массив как-то нетривиально, нужно использовать эту функцию.

umask

(PHP 3, PHP 4)

umask - изменяет текущую umask.

Описание

int umask (int mask)

umask() устанавливает PHP-umask в маску & 0777 и возвращает старую маску. Если PHP используется как серверный модуль, umask восстанавливается по окончании каждого запроса.

umask() без аргументов просто возвращает текущую umask.

Примечание: эта функция не реализована для платформ Windows.

uniqid

(PHP 3, PHP 4)

uniqid - генерирует уникальный id.

Описание

string uniqid (string prefix [, bool lcg])

uniqid() возвращает уникальный идентификатор с префиксом на основе текущего времени в микросекундах. Это prefix может использоваться, например, если вы генерируете идентификаторы одновременно на нескольких хостах, что может сгенерировать идентификатор в ту же микросекунду. Prefix может быть длиной до 114 символов.

Если необязательный параметр lcg TRUE, uniqid() добавит дополнительную "combined LCG" энтропию в конце return-значения, что должно сделать результат более уникальным.

С пустым prefix возвращаемая строка будет иметь длину 13 символов. Если lcg равен TRUE, длина будет 23 символа.

Примечание: параметр lcg доступен только в PHP 4 и PHP 3.0.13 и новее.

Если вам нужен уникальный идентификатор или лексема и вы намереваетесь выдать эту лексему пользователю по сети (т.е. как куки сессии), рекомендуется использовать её вместе со строками.

$token = md5(uniqid("")); // без префикса
$better_token = md5(uniqid(rand(),1)); // лучше, труднее взломать

Это создаст 32-символьный идентификатор (128-битное 16-ричное число), который очень трудно угадать.

unixtojd

(PHP 4)

unixtojd - конвертирует UNIX timestamp в Julian Day.

Описание

int unixtojd ([int timestamp])

Возвращает Julian Day для UNIX timestamp (секунд после 1.1.1970) или для текущего дня, если timestamp не задан.

См. также jdtounix().

unlink

(PHP 3, PHP 4)

unlink - удаляет файл.

Описание

int unlink (string filename)

Удаляет filename. Похожа на Unix C unlink()

Возвращает TRUE при успехе, FALSE при неудаче.

См. также в rmdir() об удалении директорий.

unpack

(PHP 3, PHP 4)

unpack - распаковывает данные из бинарной строки.

Описание

array unpack (string format, string data)

unpack() из бинарной строки в массив в соответствии с format. Возвращает массив, содержащий распакованные элементы двоичной строки.

unpack() работает несколько иначе, чем Perl, так как распакованные данные хранятся в ассоциативном массиве. Для этого вы должны именовать разные коды формата и разделить их слэшем /.

unregister_tick_function

(PHP 4 >= 4.0.3)

unregister_tick_function - разрегистрирует функцию для выполнения при каждом тике.

Описание

void unregister_tick_function (string func [, mixed arg])

Разрегистрирует функцию func, и она больше не выполняется при вызове tick.

unserialize

(PHP 3>= 3.0.5, PHP 4)

unserialize - создаёт PHP-значение из хранимого представления.

Описание

mixed unserialize (string str)

unserialize() принимает одну сериализованную переменную (см. serialize()) и конвертирует её обратно в РНР-значение. Возвращается конвертированное значение, которое может быть integer, float, string, array или object.

Примечание: можно установить callback-функцийю, которая будет вызываться, если неопределённый/undefined класс должен быть инстанциирован в процессе десериализации (для предотвращения получения неполного object "__PHP_Incomplete_Class"). Используйте ваш php.ini, ini_set() или .htaccess-файл для определения 'unserialize_callback_func'. Каждый раз, когда undefined класс должен быть инстанциирован, вызывается эта установка. Для отключения этого просто сделайте эту установку пустой.

Пример 1. unserialize_callback_func
$serialized_object='O:1:"a":1:{s:5:"value";s:3:"100";}';
ini_set('unserialize_callback_func','mycallback'); // установить вашу callback_function
function mycallback($classname) {
// просто включите/include файл, содержащий ваше classdefinition
// вы получите $classname для показа того, какое classdefinition необходимо
}

Примечание: в PHP 3 методы не сохраняются при десериализации сериализованного объекта. В PHP 4 это ограничение устранено, и восстанавливаются как свойства, так и методы. См. дополнительно раздел Сериализация объектов в главе Классы и объекты.

unset

(unknown)

unset - разустанавливает данную переменную.

Описание

void unset (mixed var [, mixed var [, ...]])

Примечание: unset() это конструкция языка.

unset() разрушает специфицированные переменные. Заметьте, что в PHP 3 unset() всегда возвращает TRUE(в действительности - integer значение 1). В PHP 4, однако, unset() это больше не true-функция: это теперь оператор. Поскольку никакое значение не возвращается, попытка получить значение unset() даст ошибку разбора.

Пример 1. unset()
// разрушить одну переменную
unset ($foo);
// разрушить один элемент массива
unset ($bar['quux']);
// разрушить более одной переменной
unset ($foo1, $foo2, $foo3);

Поведение unset() внутри функции может варьироваться в зависимости от тог, переменную какого типы вы пытаетесь разрушить.

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

urldecode

(PHP 3, PHP 4)

urldecode - декодирует URL-кодированную строку.

Описание

string urldecode (string str)

Декодирует любую %## кодировку в данной строке. Возвращается декодированная строка.

urlencode

(PHP 3, PHP 4)

urlencode - URL-кодирует строку.

Описание

string urlencode (string str)

Возвращает строку, в которой все не алфавитно-числовые символы (кроме -_.) заменены на знак процентов (%) с последующими двумя 16-ричными цифрами и пробелами, кодированными как знаки плюс (+). Она кодируется тем же способом, что и post данные WWW-формы, то есть как в типе носителя application/x-www-form-urlencoded. Это отличается от RFC1738-кодирования (см. rawurlencode()) тем, что, по историческим соображениям, пробелы кодируются как плюсы (+). Эта функция удобна при кодировании строки для использования в части запроса URL для передачи переменных на следующую страницу:

user_error

(PHP 4)

user_error - генерирует сообщение error/warning/notice пользовательского уровня.

Описание

void user_error (string error_msg [, int error_type])

Это псевдоним функции trigger_error().

См. также error_reporting(), set_error_handler(), restore_error_handler() и trigger_error().

usleep

(PHP 3, PHP 4)

usleep - замедляет выполнение в микросекундах.

Описание

void usleep (int micro_seconds)

usleep() замедляет выполнение программы на данное количество micro_seconds. Микросекунда это одна миллионная доля секунды.

См. также sleep() и set_time_limit().

Примечание: эта функция не работает в системах Windows.

usort

(PHP 3>= 3.0.3, PHP 4)

usort - сортирует массив по значениям, используя пользовательскую функцию сравнения.

Описание

void usort (array array, string cmp_function)

Эта функция отсортирует массив по значениям с помощью пользовательской функции сравнения. Если вам нужно нетривиально отсортировать массив, используйте её.

Функция обязана возвращать integer, меньше, равное или больше нуля, если первый аргумент рассматривается, соответственно, меньше, равным или больше секунды. Если два члена сравниваются как равные, их порядок в отсортированном массиве не определён.

utf8_decode

(PHP 3>= 3.0.6, PHP 4)

utf8_decode - конвертирует строку с символами ISO-8859-1, кодированную с UTF-8, в однобайтные ISO-8859-1.

Описание

string utf8_decode (string data)

Эта функция декодирует data, принимая, что они кодированы в UTF-8, в ISO-8859-1.

См. в utf8_encode() объяснение кодировки UTF-8.

utf8_encode

(PHP 3>= 3.0.6, PHP 4)

utf8_encode - кодирует строку ISO-8859-1 в UTF-8.

Описание

string utf8_encode (string data)

Эта функция кодирует строку data в UTF-8 и возвращает кодированную версию. UTF-8 это стандартный механизм Unicode для кодирования wide character-значений в байтовый поток. UTF-8 прозрачна для обычных ASCII-символов, самосинхронизируется (т.е. программа может указать, где начинаются символы байтового потока) и может использоваться с функциями сравнения нормальных строк для сортировки их как таковых. PHP кодирует UTF-8 символы в блоки до 4 байтов, как здесь:

Таблица 1. Кодирование UTF-8
байтовбитовпредставление17 0bbbbbbb211110bbbbb 10bbbbbb316 1110bbbb 10bbbbbb 10bbbbbb42111110bbb 10bbbbbb 10bbbbbb 10bbbbbb

Каждый b представляет бит, который может использоваться для хранения данных символа.

var_dump

(PHP 3>= 3.0.5, PHP 4)

var_dump - дамп информации о переменной.

Описание

void var_dump (mixed expression [, mixed expression [, ...]])

Эта функция возвращает структурированную информацию об одном или более выражений, которая включает его тип и значение. Массивы обрабатываются рекурсивно со значениями, предназначенными для показа структуры.

Подсказка: как и везде, где результаты выводятся непосредственно в браузер, вы можете использовать функции управления выводом для захвата вывода этой функции и сохранения его - к примеру - в string.

Сравните var_dump() с print_r().

var_export

(PHP 4 >= 4.2.0)

var_export - выводит или возвращает строковое представление переменной.

Описание

mixed var_export (mixed expression [, bool return])

Эта функция возвращает структурированную информацию о переменной, переданной ей. Аналогична var_dump() за исключением того, что возвращённое представление является правильным РНР-кода.

Вы можете также возвратить представление переменной с помощью TRUE в качестве второго параметра.

Сравните var_export() с var_dump().

Функции переменных

PHP поддерживает концепцию функций переменных. Это значит, что, если имя переменной содержит скобки, присоединённые к нему, PHP ищет функцию с тем же именем, в которое вычисляется переменная, и пытается выполнить её. Помимо прочего, это можно использовать для реализации callbacks/обратных вызовов, таблиц функций и так далее.

Функции переменных не работают с такими конструкциями языка, как echo(), unset(), isset(), empty() и include(). Хотя конструкция print() является исключением и будет работать. Это одно из самых важных отличий функций и конструкций языка в PHP.

version_compare

(PHP 4 >= 4.1.0)

version_compare - сравнивает две "PHP-стандартизованные" строки с номером версии.

Описание

int version_compare (string version1, string version2 [, string operator])

Используется, если вы хотите писать программы, работающие только в некоторых версиях PHP.

version_compare() возвращает -1, если первая версия меньше, чем вторая, 0 - если равны и +1, если вторая меньше.

Если вы специфицируете третий необязательный аргумент operator, вы можете тестировать на определённое соотношение. Возможны операции: <, lt, <=, le, >, gt, >=, ge, ==, =, eq, !=, <>, ne соответственно. При использовании этого аргумента функция возвращает 1, если это одно из соотношений, специфицированных операцией, иначе 0.

virtual

(PHP 3, PHP 4)

virtual - выполняет подзапрос Apache.

Описание

int virtual (string filename)

virtual() этот специфичная для Apache функция, которая эквивалентна <!--#include virtual...--> в mod_include. Она выполняет подзапрос Apache. Используется для включения CGI скриптов или .shtml-файлов, или ещё чему-нибудь, что вы хотите разобрать через Apache. Заметьте, что CGI-скрипт обязан генерировать правильные CGI-шапки/headers. Как минимум это означает, что он обязан генерировать шапку Content-type. Для PHP-файлов вам необходимо использовать include() или require(); virtual() не может использоваться для include документа, который сам является РНР-файлом.

Для запуска подзапроса все буферы закрываются и "вымываются" в браузер, запущенные шапки также отправляются.

vpopmail_add_alias_domain

(PHP 4 >= 4.0.5)

vpopmail_add_alias_domain - добавляет псевдоним для виртуального домена.

Описание

bool vpopmail_add_alias_domain (string domain, string aliasdomain)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

vpopmail_add_alias_domain_ex

(PHP 4 >= 4.0.5)

vpopmail_add_alias_domain_ex - добавляет псевдоним существующему виртуальному домену.

Описание

bool vpopmail_add_alias_domain_ex (string olddomain, string newdomain)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

vpopmail_add_domain

(PHP 4 >= 4.0.5)

vpopmail_add_domain - добавляет новый виртуальный домен.

Описание

bool vpopmail_add_domain (string domain, string dir, int uid, int gid)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

vpopmail_add_domain_ex

(PHP 4 >= 4.0.5)

vpopmail_add_domain_ex - добавляет новый виртуальный домен.

Описание

bool vpopmail_add_domain_ex (string domain, string passwd [, string quota [, string bounce [, bool apop]]])

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

vpopmail_add_user

(PHP 4 >= 4.0.5)

vpopmail_add_user - добавляет нового пользователя в специфицированный виртуальный домен.

Описание

bool vpopmail_add_user (string user, string domain, string password [, string gecos [, bool apop]])

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

vpopmail_alias_add

(PHP 4 >= 4.1.0)

vpopmail_alias_add - вставляет виртуальный псевдоним.

Описание

bool vpopmail_alias_add (string user, string domain, string alias)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

vpopmail_alias_del

(PHP 4 >= 4.1.0)

vpopmail_alias_del - удаляет все виртуальные псевдонимы пользователя.

Описание

bool vpopmail_alias_del (string user, string domain)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

vpopmail_alias_del_domain

(PHP 4 >= 4.1.0)

vpopmail_alias_del_domain - удаляет все виртуальные псевдонимы домена.

Описание

bool vpopmail_alias_del_domain (string domain)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

vpopmail_alias_get

(PHP 4 >= 4.1.0)

vpopmail_alias_get - получает все строчки псевдонимов домена.

Описание

array vpopmail_alias_get (string alias, string domain)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.