Учебник PHP

         

ldap_parse_result

(PHP 4 >= 4.0.5)

ldap_parse_result - извлекает информацию из результата.

Описание

bool ldap_parse_result (resource link, resource result, int errcode, string matcheddn, string errmsg, array referrals)

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

ldap_read

(PHP 3, PHP 4)

ldap_read - читает вхождение.

Описание

resource ldap_read (resource link_identifier, string base_dn, string filter [, array attributes [, int attrsonly [, int sizelimit [, int timelimit [, int deref]]]]])

Возвращает идентификатор результата поиска или FALSE при ошибке.

ldap_read() выполняет поиск специфицированного фильтра filter в директории с областью видимости LDAP_SCOPE_BASE. Так что она эквивалентна чтению вхождения из директории.

Пустые фильтры не допускаются. Если вы хотите запросить абсолютно всю информацию о данном вхождении, используйте фильтр "objectClass=*". Если вы знаете, какие типы вхождений используются на сервере директорий, вы можете использовать подходящий фильтр, такой как "objectClass=inetOrgPerson".

Функция принимает 5 необязательных параметров. См. ldap_search().

Примечание: эти необязательные параметры были добавлены в версии 4.0.2: attrsonly, sizelimit, timelimit, deref.

Начиная с 4.0.5, можно также выполнять параллельные поиски. См. детали в ldap_search().

ldap_rename

(PHP 4 >= 4.0.5)

ldap_rename - модифицирует имя вхождения.

Описание

bool ldap_rename (resource link_identifier, string dn, string newrdn, string newparent, bool deleteoldrdn)

Вхождение, специфицированное параметром, dn, переименовывается/перемещается. Новое RDN специфицируется параметром newrdn, а новое родительское /высшее вхождение специфицируется в newparent. Если параметр deleteoldrdn TRUE, то старое значение(ия) RDN удаляется, иначе старое RDN остаётся как неразличимые значения вхождения. Возвращает TRUE при успехе, FALSE при неудаче.



Примечание: эта функция в настоящее время работает только с LDAPv3. Вам может понадобиться применять ldap_set_option() до связки/binding, чтобы воспользоваться LDAPv3. Эта функция доступна только при использовании OpenLDAP 2.x.x ИЛИ Netscape Directory SDK x.x и была добавлена в PHP 4.0.5.

ldap_search

(PHP 3, PHP 4)

ldap_search - ищет дерево LDAP.

Описание

resource ldap_search (resource link_identifier, string base_dn, string filter [, array attributes [, int attrsonly [, int sizelimit [, int timelimit [, int deref]]]]])

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

ldap_search() выполняет поиск специфицированного фильтра в директории с областью видимости LDAP_SCOPE_SUBTREE. Это эквивалентно поиску по всей директории.
base_dn специфицирует базовый DN для директории.

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

Четвёртый параметр является стандартным строковым PHP-массивом из требуемых атрибутов, например, array("mail","sn","cn"). Заметьте, что "dn" возвращается всегда, вне зависимости от того, атрибуты каких типов запрошены.

Отметьте, также, что некоторые хосты серверов директорий будут сконфигурированы таким образом, чтобы возвращать не более предустановленного количества вхождений. Если это так, сервер укажет, что он возвращает только частичный результирующий набор. Это проявится также в том случае, если шестой параметр sizelimit использован для ограничения подсчёта извлечённых вхождений.

Пятый параметр attrsonly должен иметь значение 1, если нужны только типы атрибутов. Если установлен в 0, - и типы, и значения атрибутов извлекаются. Это поведение по умолчанию.

С помощью шестого параметра sizelimit можно ограничить подсчёт извлечённых вхождений. Значение 0 означает - нет ограничений. ПРИМЕЧАНИЕ: этот параметр НЕ может переопределить серверную установку sizelimit. Но вы можете установить его ниже.

Седьмой параметр timelimit устанавливает количество секунд, отводимых для поиска. Установка 0 означает отсутствие ограничения. ПРИМЕЧАНИЕ: этот параметр НЕ может переопределить серверную установку timelimit. Но вы можете установить его ниже.

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

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

LDAP_DEREF_SEARCHING - псевдонимы должны разыменовываться в процессе поиска, но не разыменовываются при локализации базового объекта поиска.

LDAP_DEREF_FINDING - псевдонимы должны разыменовываться при локализации базового объекта, но не в процессе поиска.

LDAP_DEREF_ALWAYS - псевдонимы должны разыменовываться всегда.

Примечание: следующие необязательные параметры были введены в 4.0.2: attrsonly, sizelimit, timelimit, deref.

Фильтр поиска может быть простым или продвинутым, с использованием булевых операций в формате, описанном в документации LDAP (см. в Netscape Directory SDK полную информацию о фильтрах).

В примере запрашиваются подразделение организации, фамилия, имя и email-адрес всех работников компании "My Company", где фамилия или имя содержит подстроку $person. В этом примере используется булев фильтр для сообщения серверу о поиске информации в более чем одном атрибуте.

ldap_set_option

(PHP 4 >= 4.0.4)

ldap_set_option - устанавливает значение данной опции.

Описание

bool ldap_set_option (resource link_identifier, int option, mixed newval)

Устанавливает значение специфицированной опции - newval. Возвращает TRUE при успехе, FALSE при неудаче.

Параметр option может быть одним из: LDAP_OPT_DEREF, LDAP_OPT_SIZELIMIT, LDAP_OPT_TIMELIMIT, LDAP_OPT_PROTOCOL_VERSION, LDAP_OPT_ERROR_NUMBER, LDAP_OPT_REFERRALS, LDAP_OPT_RESTART, LDAP_OPT_HOST_NAME, LDAP_OPT_ERROR_STRING, LDAP_OPT_MATCHED_DN, LDAP_OPT_SERVER_CONTROLS, LDAP_OPT_CLIENT_CONTROLS. Здесь дано краткое описание, детали см. в draft-ietf-ldapext-ldap-c-api-xx.txt.

Опции LDAP_OPT_DEREF, LDAP_OPT_SIZELIMIT, LDAP_OPT_TIMELIMIT, LDAP_OPT_PROTOCOL_VERSION и LDAP_OPT_ERROR_NUMBER имеют integer-значение, LDAP_OPT_REFERRALS и LDAP_OPT_RESTART имеют boolean-значение, а опции LDAP_OPT_HOST_NAME, LDAP_OPT_ERROR_STRING и LDAP_OPT_MATCHED_DN имеют string-значение. Первый пример иллюстрирует их использование. Опции LDAP_OPT_SERVER_CONTROLS и LDAP_OPT_CLIENT_CONTROLS требуют списка controls, этот значит, что значение обязано быть массивом из controls. Элемент/control состоит из списка oid, идентифицирующих элемент, необязательного value и необязательного флага/flag criticality\критичности. В PHP элемент задаётся массивом, содержащим элемент с ключом oid и строковым значением и два необязательных элемента. Необязательные элементы это ключ value со строковым значением и ключ iscritical с булевым значением. iscritical по умолчанию FALSE, если не предоставлен. См. также второй пример.

Примечание: эта функция доступна только при использовании OpenLDAP 2.x.x OR Netscape Directory SDK x.x и была введена в PHP 4.0.4.

ldap_set_rebind_proc

(PHP 4 >= 4.2.0)

ldap_set_rebind_proc - устанавливает callback-функцию для выполнения повторных связок/binds при ссылочном поиске.

Описание

bool ldap_set_rebind_proc (resource link, string callback)

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

ldap_sort

(PHP 4 >= 4.2.0)

ldap_sort - сортирует результирующие вхождения LDAP.

Описание

bool ldap_sort (resource link, resource result, string sortfilter)

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

ldap_start_tls

(PHP 4 >= 4.2.0)

ldap_start_tls - стартует TLS.

Описание

bool ldap_start_tls (resource link)

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

ldap_t61_to_8859

(PHP 4 >= 4.0.2)

ldap_t61_to_8859 - транслирует t61-символы в 8859-символы.

Описание

string ldap_t61_to_8859 (string value)

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

ldap_unbind

(PHP 3, PHP 4)

ldap_unbind - отвязывает/Unbind от LDAP-директории.

Описание

bool ldap_unbind (resource link_identifier)

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

ldap_unbind() отвязывает от LDAP-директории.

leak

(PHP 3, PHP 4)

leak - создаёт утечку памяти.

Описание

void leak (int bytes)

leak() создаёт утечку специфицированного количества памяти.

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

levenshtein

(PHP 3>= 3.0.17, PHP 4 >= 4.0.1)

levenshtein - высчитывает расстояние Левенштайна/Levenshtein между двумя строками.

Описание

int levenshtein (string str1, string str2)

int levenshtein (string str1, string str2, int cost_ins, int cost_rep, int cost_del)

int levenshtein (string str1, string str2, function cost)

Эта функция возвращает Levenshtein-дистанцию между двумя строками-аргументами или -1, если одна из строк-аргументов длиннее предела в 255 символов (255 должно быть более чем достаточно для имени или словарного сравнения, и никто в здравом уме не будет делать генетический анализ с помощью PHP).

Levenshtein-дистанция определяется как минимальное количество символов, которые вы должны заместить, вставить или удалить, чтобы трансформировать str1 в str2. Сложность алгоритма равна O(m*n), где n и m это длины строк str1 и str2 (несколько лучше по сравнению с similar_text(), которая имеет O(max(n,m)**3), но всё же затратно).

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

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

Третий вариант (ещё не реализованный) будет самым общим и адаптивным, но также и самым медленным. В нём будет вызываться пользовательская функция, которая определит стоимость каждой возможной операции.

Пользовательская функция будет вызвана со следующими аргументами:

применяемая операция: 'I', 'R' или 'D'

фактический символ в строке 1

фактический символ в строке 2

позиция в строке 1

позиция в строке 2

оставшиеся символы в строке 1

оставшиеся символы в строке 2

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

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

См. также soundex(), similar_text() и metaphone().

link

(PHP 3, PHP 4)

link - создаёт жёсткую ссылку.

Описание

int link (string target, string link)

link() создаёт жёсткую ссылку.

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

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

linkinfo

(PHP 3, PHP 4)

linkinfo - получает информацию о ссылке/link.

Описание

int linkinfo (string path)

linkinfo() возвращает поле st_dev UNIX C stat-структуры, возвращённой системным вызовом lstat. Эта функция используется для проверки существования ссылки (на которую указывает path) с использованием того же метода, что и в макросе S_ISLNK, определённом в файле stat.h). Возвращает 0, или FALSE в случае ошибки.

См. также symlink(), link() и readlink().

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

list

(unknown)

list - присваивает значения переменным, как если бы они были массивом.

Описание

void list (mixed ...)

Как и array(), это в действительности не функция, а конструкция языка. list() используется для присвоения списку переменных за одну операцию.

Примечание: list() работает только с числовыми массивами и принимает, что числовые индексы начинаются с 0.

localeconv

(PHP 4 >= 4.0.5)

localeconv - получает информацию о форматировании чисел.

Описание

array localeconv (void)

Возвращает ассоциативный массив, содержащий локализованную информацию о форматировании чисел и валюте.

localeconv() возвращает данные на основе текущих локальных установок, как установлено функцией setlocale(). Ассоциативный массив содержит следующие поля:Элемент массиваОписание decimal_pointСимвол десятичной точкиthousands_sepРазделитель тысяч groupingМассив, содержащий группировки чиселint_curr_symbol Международное обозначение валюты, (например, USD)currency_symbol Локальный символ валюты (например, $)mon_decimal_point Символ денежной десятичной точкиmon_thousands_sep Денежный разделитель тысячmon_grouping Массив, содержащий валютные группировкиpositive_sign Знак для положительных значенийnegative_sign Знак для отрицательных значенийint_frac_digits Международные цифры дробейfrac_digits Локальные цифры дробейp_cs_precedes TRUE, если currency_symbol предшествует положительному значению, FALSE, если следует за нимp_sep_by_spaceTRUE, если пробел отделяет currency_symbol от положительного значения, FALSE в ином случаеn_cs_precedesTRUE, если currency_symbol предшествует положительному значению, FALSE, если следует за нимn_sep_by_spaceTRUE, если пробел отделяет currency_symbol от отрицательного значения, FALSE, в ином случаеp_sign_posn 0 Скобки окружают quantity и currency_symbol 1 Строка знака предшествует quantity и currency_symbol2 Строка знака следует за quantity и currency_symbol3 Строка знака непосредственно предшествует currency_symbol4 Строка знака непосредственно следует за currency_symbol n_sign_posn0 Скобки окружают quantity и currency_symbol1 Строка знака предшествует quantity и currency_symbol2 Строка знака следует за quantity и currency_symbol3 Строка знака непосредственно предшествует currency_symbol4 Строка знака непосредственно следует за currency_symbol

Поля группировки содержат массивы, которые определяют способ группирования чисел. Например, поле группировки для en_US будет содержать массив из 2 элементов со значениями 3 и 3. Чем выше индекс массива, тем левее будет точка группировки. Если элемент массива равен CHAR_MAX, в дальнейшем группировка не выполняется. Если элемент массива равен 0, должен использоваться предыдущий элемент.

localtime

(PHP 4)

localtime - получает локальное время.

Описание

array localtime ([int timestamp [, bool is_associative]])

Функция localtime() возвращает массив, идентичный массиву структуры, возвращаемой вызовом C-функции. Первым аргументом localtime() является timestamp; если он не задан, используется текущее время. Вторым аргументом является is_associative; если установлен 0 или аргумент не предоставлен, то массив возвращается как регулярный индексированный числами массив. Если аргумент равен 1, то localtime() является ассоциативным массивом, содержащим все различные элементы структуры, возвращённой из вызова C-функции в localtime. Имена ключей ассоциативного массива:

"tm_sec" - секунды

"tm_min" - минуты

"tm_hour" - часы

"tm_mday" - число месяца

"tm_mon" - месяц, начиная с 0 для January

"tm_year" - год после 1900

"tm_wday" - день недели

"tm_yday" - день года

"tm_isdst" - включён ли переход на летнее время

log

(PHP 3, PHP 4)

log - натуральный логарифм.

Описание

float log (float arg)

Возвращает натуральный логарифм аргумента arg.

log1p

(PHP 4 >= 4.1.0)

log1p - Возвращает log(1 + number), вычисленный способом, который точен даже когда значение number близко к нулю.

Описание

float log1p (float number)

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

log10

(PHP 3, PHP 4)

log10 - логарифм с базой 10.

Описание

float log10 (float arg)

Возвращает логарифм base-10 аргумента arg.

long2ip

(PHP 4)

long2ip - конвертирует (IPv4) Internet сетевой адрес в строку стандартного Internet-формата с точкой.

Описание

string long2ip (int proper_address)

Функция long2ip() генерирует Internet-адрес в формате с точкой (т.е.: aaa.bbb.ccc.ddd) из соответствующего представления адреса.

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

lstat

(PHP 3>= 3.0.4, PHP 4)

lstat - выдаёт информацию о файле или символьной ссылке.

Описание

array lstat (string filename)

Собирает информацию о файле или символьной ссылке filename. Эта функция идентична stat(), но, если параметр filename это символьная ссылка, возвращается статус символьной ссылки, а не статус файла, на который указывает символьная ссылка.

Возвращает массив со статистикой файла со следующими элементами:

    устройство

    inode

    inode-режим защиты

    количество ссылок/links

    user id владельца

    group id владельца

    тип устройства, если inode-устройство *

    размер в байтах

    время последнего доступа

    время последней модификации

    время последнего изменения

    размер блока для I/O файловой системы *

    количество выделенных блоков

* - верно только для систем, поддерживающих тип st_blksize -- другие системы (т.е. Windows) возвращают -1.

lstat() не может использоваться для remote/удалённых файлов.

Результаты этой функции кэшируются. См. детали в clearstatcache().

ltrim

(PHP 3, PHP 4)

ltrim - вырезает пробелы в начале строки.

Описание

string ltrim (string str [, string charlist])

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

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

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

"\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. Просто перечислите все символы, которые вы хотите вырезать. С помощью .. можно специфицировать диапазон символов.

mail

(PHP 3, PHP 4)

mail - отправляет почту.

Описание

bool mail (string to, string subject, string message [, string additional_headers [, string additional_parameters]])

mail() автоматически отправляет сообщение message получателю to. Можно специфицировать несколько получателей, разделив запятой адреса в to. С помощью этой функции можно высылать Email с присоединением/attachment и содержимое специальных типов. Это делается через MIME-кодировку - см. дополнительно эту статью о Zend или PEAR Mime Classes.

Могут помочь и следующие RFC-документы: RFC 1896, RFC 2045, RFC 2046, RFC 2047, RFC 2048 и RFC 2049.

mail() возвращает TRUE, если почта была успешно принята для доставки, FALSE в ином случае.

Предупреждение!Windows-реализация mail() во многом отличается от Unix-реализации. Во-первых, она не использует локальный экзешник для составления сообщений, а работает лишь по прямым сокетам, что означает, что MTA должен прослушивать сетевой сокет (который может находиться на локальной или удалённой машине). Во-вторых, специальные шапки/headers вроде From:, Cc:, Bcc: и Date: не интерпретируются MTA, а разбираются в PHP.
PHP < 4.3 поддерживал только header-элемент Cc: (и был чувствительным к регистру).
PHP >= 4.3 поддерживает все элементы шапки и нечувствителен к регистру символов.

mailparse_determine_best_xfer_encoding

(только 4.1.0 - 4.1.2)

mailparse_determine_best_xfer_encoding - показывает наилучший способ кодирования содержимого, читаемого из указателя файла fp, который обязан быть пригоден для поиска/seek-able.

Описание

int mailparse_determine_best_xfer_encoding (resource fp)

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

mailparse_msg_create

(только 4.1.0 - 4.1.2)

mailparse_msg_create - возвращает дескриптор, который можно использовать для разбора сообщения.

Описание

int mailparse_msg_create (void)

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

mailparse_msg_extract_part

(только 4.1.0 - 4.1.2)

mailparse_msg_extract_part - извлекает/декодирует раздел сообщения. Если callbackfunc не специфицирован, содержимое отправляется в "stdout".

Описание

void mailparse_msg_extract_part (resource rfc2045, string msgbody [, string callbackfunc])

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

mailparse_msg_extract_part_file

(только 4.1.0 - 4.1.2)

mailparse_msg_extract_part_file - извлекает/декодирует раздел сообщения, декодируя кодировку трансфера.

Описание

string mailparse_msg_extract_part_file (resource rfc2045, string filename [, string callbackfunc])

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

mailparse_msg_free

(только 4.1.0 - 4.1.2)

mailparse_msg_free - освобождает дескриптор, выделенный функцией mailparse_msg_crea().

Описание

void mailparse_msg_free (resource rfc2045buf)

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

mailparse_msg_get_part

(только 4.1.0 - 4.1.2)

mailparse_msg_get_part - возвращает дескриптор данного раздела в mime-сообщении.

Описание

int mailparse_msg_get_part (resource rfc2045, string mimesection)

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

mailparse_msg_get_part_data

(только 4.1.0 - 4.1.2)

mailparse_msg_get_part_data - возвращает ассоциативный массив информации о сообщении.

Описание

array mailparse_msg_get_part_data (resource rfc2045)

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

mailparse_msg_get_structure

(только 4.1.0 - 4.1.2)

mailparse_msg_get_structure - возвращает массив имён mime-раздела в предоставленном сообщении.

Описание

array mailparse_msg_get_structure (resource rfc2045)

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

mailparse_msg_parse

(только 4.1.0 - 4.1.2)

mailparse_msg_parse - инкрементный разбор данных в буфер.

Описание

void mailparse_msg_parse (resource rfc2045buf, string data)

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

mailparse_msg_parse_file

(только 4.1.0 - 4.1.2)

mailparse_msg_parse_file - разбирает файл и возвращает ресурс, представляющий структуру.

Описание

resource mailparse_msg_parse_file (string filename)

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

mailparse_rfc822_parse_addresses

(только 4.1.0 - 4.1.2)

mailparse_rfc822_parse_addresses - разбирает адреса и возвращает хэш, содержащий эти данные.

Описание

array mailparse_rfc822_parse_addresses (string addresses)

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

mailparse_stream_encode

(только 4.1.0 - 4.1.2)

mailparse_stream_encode - выводит поток данных из указателя исходного файла, применяя кодирование и запись к destfp.

Описание

bool mailparse_stream_encode (resource sourcefp, resource destfp, string encoding)

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

mailparse_uudecode_all

(unknown)

mailparse_uudecode_all - сканирует данные из fp и извлекает каждый внедрённый uuencoded-файл. Возвращает массив-листинг информации о filename.

Описание

array mailparse_uudecode_all (resource fp)

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

max

(PHP 3, PHP 4)

max - находит наибольшее значение.

Описание

mixed max (mixed arg1, mixed arg2, mixed argn)

max() возвращает наибольшее числовое значение значений параметров.

Если первый параметр является массивом, max() возвращает наибольшее значение этого массива. Если первый параметр является целым числом/integer, string или float, вам необходимо как минимум два параметра, а max() возвращает наибольшее из этих значений. Вы можете сравнивать неограниченное количество чисел.

Если одно или более значений являются float (числами с плавающей точкой), все значения будут рассматриваться как floats, и float будет возвращено. Если ни одно из значений не float, все они будут рассматриваться как integer, и integer будет возвращено.

mb_convert_encoding

(PHP 4 >= 4.0.6)

mb_convert_encoding - конвертирует кодировку символов.

Описание

string mb_convert_encoding (string str, string to-encoding [, mixed from-encoding])

mb_convert_encoding() конвентирует кодировку символов строки str из from-encoding в to-encoding.

str это конвертируемая строка.

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

mb_convert_kana

(PHP 4 >= 4.0.6)

mb_convert_kana - конвертирует "kana" одну в другую ("zen-kaku" ,"han-kaku" и т.д.).

Описание

string mb_convert_kana (string str, string option [, mixed encoding])

mb_convert_kana() выполняет "han-kaku" - "zen-kaku" конвертацию строки str. Возвращает конвертированную строку. Эта функция используется только для японского языка.

option опция конвертации. Значение по умолчанию "KV".

encoding это кодировка символов. Если опущена, используется внутренняя кодировка.

mb_convert_variables

(PHP 4 >= 4.0.6)

mb_convert_variables - конвертирует код символа в переменной(ых).

Описание

string mb_convert_variables (string to-encoding, mixed from-encoding, mixed vars)

mb_convert_variables() конвертирует кодировку символов переменных vars с кодировкой from-encoding в кодировку to-encoding. Возвращает кодировку до конвертации при успехе, FALSE при неудаче.

mb_convert_variables() объединяет строки в массив или объект для определения кодировки, поскольку определение кодировки коротких строк не удастся (?). Отсюда: невозможно смешивать кодировки в одном массиве или объекте.

Если from-encoding  специфицируется массивом или списком с разделением запятыми, она пытается определить кодировку из from-coding. Если encoding опущена, используется detect_order.

vars (3-я и более) это ссылка на конвертируемую переменную. Принимаются String, Array и Object. mb_convert_variables() принимает, что все параметры имеют одну кодировку.

Пример 1. mb_convert_variables()
/* Конвертирует переменные $post1, $post2 во внутреннюю кодировку */
$interenc = mb_internal_encoding();
$inputenc = mb_convert_variables($interenc, "ASCII,UTF-8,SJIS-win", $post1, $post2);

mb_decode_mimeheader

(PHP 4 >= 4.0.6)

mb_decode_mimeheader - декодирует строку в поле MIME-шапки/header.

Описание

string mb_decode_mimeheader (string str)

mb_decode_mimeheader() декодирует строку str в MIME header'е.

Возвращает декодированную строку во внутреннюю кодировку символов.

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

mb_decode_numericentity

(PHP 4 >= 4.0.6)

mb_decode_numericentity - декодирует ссылку числовой строки HTML в символ.

Описание

string mb_decode_numericentity (string str, array convmap [, string encoding])

Конвертирует ссылку числовой строки str в специфицированном блоке в символ. Возвращает конвертированную строку.

array это массив, специфицирующий кодовую область для конвертации.

encoding это кодировка символов. Если опущена, используется внутренняя кодировка.

mb_detect_encoding

(PHP 4 >= 4.0.6)

mb_detect_encoding - определяет кодировку символов.

Описание

string mb_detect_encoding (string str [, mixed encoding-list])

mb_detect_encoding() определяет кодировку символов строки str. Возвращает кодировку.

encoding-list это список кодировок. Порядок кодировок может быть специфицирован массивом или строкой-списком с разделением запятыми.

Если encoding_list опущен, используется detect_order.

mb_detect_order

(PHP 4 >= 4.0.6)

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

Описание

array mb_detect_order ([mixed encoding-list])

mb_detect_order() устанавливает автоматический порядок определения кодировки символов списком encoding-list. Возвращает TRUE при успехе, FALSE при неудаче.

encoding-list это массив или список с разделением запятыми кодировок символов. ("auto" расширяется в "ASCII, JIS, UTF-8, EUC-JP, SJIS").

Если encoding-list опущен, возвращает текущий порядок определения кодировки как массив.

Эти установки влияют на mb_detect_encoding() и mb_send_mail().

Примечание: mbstring в настоящее время реализует следующие фильтры определения кодировки. Если для следующих кодировок имеется неправильная последовательность байтов, определение кодировки терпит неудачу.

UTF-8, UTF-7, ASCII, EUC-JP, SJIS, eucJP-win, SJIS-win, JIS, ISO-2022-JP

ISO-8859-* mbstring всегда определяет как ISO-8859-*.

Для UTF-16, UTF-32, UCS2 и UCS4 определение кодировки всегда терпит неудачу.

mb_encode_mimeheader

(PHP 4 >= 4.0.6)

mb_encode_mimeheader - кодирует строку для MIME-шапки.

Описание

string mb_encode_mimeheader (string str [, string charset [, string transfer-encoding [, string linefeed]]])

mb_encode_mimeheader() конвертирует строку str в кодированное слово для поля шапки/header. Возвращает конвертированную строку в кодировке ASCII.

charset это имя кодировки символов. По умолчанию ISO-2022-JP.

transfer-encoding этот шифровка трансфера. Должна быть "B" (Base64) или "Q" (Quoted-Printable). По умолчанию "B".

linefeed это маркёр конца строки. По умолчанию "\r\n" (CRLF).

mb_encode_numericentity

(PHP 4 >= 4.0.6)

mb_encode_numericentity - кодирует символы в ссылку числовой строки HTML.

Описание

string mb_encode_numericentity (string str, array convmap [, string encoding])

mb_encode_numericentity() конвертирует специфицированные коды символов строки str в ссылку числовой строки HTML. Возвращает конвертированную строку.

array это массив, специфицирующий кодовую область для конвертации.

encoding это кодировка символов.

mb_ereg

(PHP 4 >= 4.2.0)

mb_ereg - совпадение регулярного выражения с многобайтной поддержкой.

Описание

int mb_ereg (string pattern, string string [, array regs])

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

mb_ereg() выполняет совпадение регулярного выражения с мультибайтной поддержкой и возвращает 1, если совпадения найдены. Если специфицирован необязательный третий параметр, функция возвращает размер совпавшей части в байтах, а массив regs будет содержать подстроку совпавшей строки. Функция возвращает 1, если совпало с пустой строкой. Если совпадение не найдено или возникла ошибка, возвращается FALSE.

Внутренняя кодировка символов или кодировка, специфицированная в mb_regex_encoding(), будет использоваться как кодировка символов.

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

См. также mb_regex_encoding(), mb_eregi().

mb_ereg_match

(PHP 4 >= 4.2.0)

mb_ereg_match - совпадение регулярного выражения для многобайтной строки.

Описание

bool mb_ereg_match (string pattern, string string [, string option])

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

mb_ereg_match() возвращает TRUE, если string совпадает с патэрном регулярного выражения, FALSE, если нет.

Внутренняя кодировка символов или кодировка, специфицированная в mb_regex_encoding(), будет использоваться как кодировка символов.

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

См. также mb_regex_encoding(), mb_ereg().

mb_ereg_replace

(PHP 4 >= 4.2.0)

mb_ereg_replace - замещает регулярное выражение с многобайтной поддержкой.

Описание

string mb_ereg_replace (string pattern, string replacement, string string [, array option])

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

mb_ereg_replace() сканирует строку string на совпадение с патэрном pattern, затем замещает совпавший текст строкой replacement и возвращает результирующую строку или FALSE - при ошибке. Многобайтный символ может использоваться в pattern.

Условие совпадения может быть установлено параметром option. Если i специфицировано для этого параметра, регистр будет игнорироваться. Если специфицировано x, будут игнорироваться пробелы. Если специфицировано m, совпадение будет выполняться в многострочном режиме, и разрыв строки будет включён в '.'. Если специфицировано p, совпадение будет выполняться в режиме POSIX, разрыв строки будет рассматриваться как нормальный символ. Если специфицировано e, строка replacement будет вычисляться как выражение PHP.

Внутренняя кодировка символов или кодировка, специфицированная в mb_regex_encoding(), будет использоваться как кодировка символов.

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

См. также mb_regex_encoding(), mb_eregi_replace().

mb_ereg_search

(PHP 4 >= 4.2.0)

mb_ereg_search - совпадение многобайтного регулярного выражения с предопределённой многобайтной строкой.

Описание

bool mb_ereg_search ([string pattern [, string option]])

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

mb_ereg_search() возвращает TRUE, если многобайтная строка совпадает с регулярным выражением, FALSE в ином случае. Строка для совпадения устанавливается функцией mb_ereg_search_init(). Если pattern не специфицирован, используется предыдущий.

Внутренняя кодировка символов или кодировка, специфицированная в mb_regex_encoding(), будет использоваться как кодировка символов.

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

См. также mb_regex_encoding(), mb_ereg_search_init().

mb_ereg_search_getpos

(PHP 4 >= 4.2.0)

mb_ereg_search_getpos - возвращает стартовую точку для поиска следующего совпадения регулярного выражения.

Описание

array mb_ereg_search_getpos (void)

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

mb_ereg_search_getpos() возвращает точку начала поиска совпадения регулярного выражения для функций mb_ereg_search(), mb_ereg_search_pos(), mb_ereg_search_regs(). Позиция представлена в байтах от начала строки.

Внутренняя кодировка символов или кодировка, специфицированная в mb_regex_encoding(), будет использоваться как кодировка символов.

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

См. также mb_regex_encoding(), mb_ereg_search_setpos().

mb_ereg_search_getregs

(PHP 4 >= 4.2.0)

mb_ereg_search_getregs - запрашивает результат последнего совпадения многобайтного регулярного выражения.

Описание

array mb_ereg_search_getregs (void)

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

mb_ereg_search_getregs() возвращает массив, включающий подстроку совпавшей части из mb_ereg_search(), mb_ereg_search_pos(), mb_ereg_search_regs(). Если есть несколько совпадений, первый элемент будет содержать совпавшую подстроку, второй элемент будет содержать первую часть в квадратных скобках, третий элемент будет содержать вторую часть в квадратных скобках, и так далее. Возвращает FALSE при ошибке.

Внутренняя кодировка символов или кодировка, специфицированная в mb_regex_encoding(), будет использоваться как кодировка символов.

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

См. также mb_regex_encoding(), mb_ereg_search_init().

mb_ereg_search_init

(PHP 4 >= 4.2.0)

mb_ereg_search_init - настраивает строку и регулярное выражение для совпадения многобайтного регулярного выражения.

Описание

array mb_ereg_search_init (string string [, string pattern [, string option]])

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

mb_ereg_search_init() устанавливает string и pattern для многобайтного регулярного выражения. Эти значения используются в mb_ereg_search(), mb_ereg_search_pos(), mb_ereg_search_regs(). Возвращает TRUE при успехе, FALSE при ошибке.

Внутренняя кодировка символов или кодировка, специфицированная в mb_regex_encoding(), будет использоваться как кодировка символов.

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

См. также mb_regex_encoding(), mb_ereg_search_regs().

mb_ereg_search_pos

(PHP 4 >= 4.2.0)

mb_ereg_search_pos - возвращает позицию и длину совпавшей части многобайтного регулярного выражения для предопределённой многобайтной строки.

Описание

array mb_ereg_search_pos ([string pattern [, string option]])

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

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

Строка для совпадения специфицируется в mb_ereg_search_init(). Если не специфицирована, используется предыдущая.

Внутренняя кодировка символов или кодировка, специфицированная в mb_regex_encoding(), будет использоваться как кодировка символов.

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

См. также mb_regex_encoding(), mb_ereg_search_init().

mb_ereg_search_regs

(PHP 4 >= 4.2.0)

mb_ereg_search_regs - возвращает совпавшую часть многобайтного регулярного выражения.

Описание

array mb_ereg_search_regs ([string pattern [, string option]])

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

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

Внутренняя кодировка символов или кодировка, специфицированная в mb_regex_encoding(), будет использоваться как кодировка символов.

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

См. также mb_regex_encoding(), mb_ereg_search_init().

mb_ereg_search_setpos

(PHP 4 >= 4.2.0)

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

Описание

array mb_ereg_search_setpos (void)

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

mb_ereg_search_setpos() устанавливает стартовую точку поиска совпадения для mb_ereg_search().

Внутренняя кодировка символов или кодировка, специфицированная в mb_regex_encoding(), будет использоваться как кодировка символов.

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

См. также mb_regex_encoding(), mb_ereg_search_init().

mb_eregi

(PHP 4 >= 4.2.0)

mb_eregi - совпадение регулярного выражения с игнорированием регистра и с многобайтной поддержкой.

Описание

int mb_eregi( string pattern, string string [, array regs])

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

mb_eregi() выполняет поиск совпадений регулярного выражения с многобайтной поддержкой и возвращает 1, если совпадения найдены. Эта функция игнорирует регистр символов. Если специфицирован необязательный третий параметр, функция возвращает размер совпавшей части в байтах, а массив regs будет содержать подстроку совпавшей строки. Функция возвращает 1, если совпало с пустой строкой. Если совпадение не найдено или возникла ошибка, возвращается FALSE.

Внутренняя кодировка символов или кодировка, специфицированная в mb_regex_encoding(), будет использоваться как кодировка символов.

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

См. также mb_regex_encoding(), mb_ereg().

mb_eregi_replace

(PHP 4 >= 4.2.0)

mb_eregi_replace - замещает регулярное выражение с многобайтной поддержкой и игнорированием регистра.

Описание

string mb_eregi_replace (string pattern, string replace, string string)

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

mb_eregi_replace() сканирует строку string на совпадение с патэрном pattern, затем замещает совпавший текст строкой replacement и возвращает результирующую строку, либо FALSE при ошибке. Многобайтный символ может использоваться в pattern. Регистр игнорируется.

Внутренняя кодировка символов или кодировка, специфицированная в mb_regex_encoding(), будет использоваться как кодировка символов.

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

См. также mb_regex_encoding(), mb_ereg_replace().

mb_get_info

(PHP 4 >= 4.2.0)

mb_get_info - получает внутренние настройки mbstring.

Описание

string mb_get_info ([string type])

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

mb_get_info() возвращает параметр внутренней настройки mbstring.

Если type не специфицирован или специфицирован как "all", будет возвращён массив, содержащий элементы "internal_encoding", "http_output", "http_input", "func_overload".

Если type специфицирован для "http_output", "http_input", "internal_encoding", "func_overload", будет возвращён специфицированный параметр установки.

См. также mb_internal_encoding(), mb_http_output().

mb_http_input

(PHP 4 >= 4.0.6)

mb_http_input - определяет кодировку символов HTTP-ввода.

Описание

string mb_http_input ([string type])

mb_http_input() возвращает результат определения кодировки символов HTTP-ввода.

type: строка ввода специфицирует тип ввода. "G" для GET, "P" для POST, "C" для COOKIE. Если type отсутствует, возвращает последний обработанный тип ввода.

Возвращаемое значение: имя кодировки символов. Если mb_http_input() не обрабатывает специфицированный HTTP-ввод, возвращает FALSE.

См. также mb_internal_encoding(), mb_http_output(), mb_detect_order().

mb_http_output

(PHP 4 >= 4.0.6)

mb_http_output - устанавливает/получает кодировку символов HTTP-вывода.

Описание

string mb_http_output ([string encoding])

Если encoding установлен, mb_http_output() устанавливает кодировку символов HTTP-вывода как encoding. Вывод после этой функции конвертируется в encoding. mb_http_output() возвращает TRUE при успехе, FALSE при неудаче.

Если encoding опущен, mb_http_output() возвращает кодировку символов текущего HTTP-вывода.

См. также mb_internal_encoding(), mb_http_input(), mb_detect_order().

mb_internal_encoding

(PHP 4 >= 4.0.6)

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

Описание

string mb_internal_encoding ([string encoding])

mb_internal_encoding() устанавливает внутреннюю кодировку символов как encoding. Если этот параметр опущен, возвращает текущую внутреннюю кодировку.

encoding используется для конвертации кодировки символов HTTP-ввода, HTTP-вывода и кодировки по умолчанию для строковых функций, определённых модулем mbstring.

encoding это имя кодировки символов.

Возвращаемое значение: если encoding установлен, mb_internal_encoding() возвращает TRUE при успехе, иначе FALSE. Если encoding опущен, возвращает имя текущей кодировки символов.

mb_language

(PHP 4 >= 4.0.6)

mb_language - устанавливает/получает текущий язык.

Описание

string mb_language ([string language])

mb_language() устанавливает язык. Если language опущен, возвращает текущий язык как строку.

language используется для кодирования сообщений e-mail. Правильными значениями являются "Japanese", "ja", "English", "en" и "uni" (UTF-8). mb_send_mail() использует эти установки для кодирования e-mail.

Язык и его установка это ISO-2022-JP/Base64 для Japanese, UTF-8/Base64 для uni, ISO-8859-1/quoted printable для English.

Возвращаемое значение: если language установлен и language является правильным, возвращает TRUE. Иначе возвращает FALSE. Если language опущен, возвращает имя языка как строку. Если язык ранее не установлен, возвращает FALSE.

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

mb_output_handler

(PHP 4 >= 4.0.6)

mb_output_handler - сallback-функция, конвертирующая кодировку символов в буфере вывода.

Описание

string mb_output_handler (string contents, int status)

mb_output_handler() это ob_start()-callback/обратный вызов. mb_output_handler() конвертирует символы в буфере вывода из внутренней кодировки символов в кодировку HTTP-вывода.

В версии 4.1.0 или новее этот обработчик добавляет шапку charset HTTP, если соблюдены следующие условия:

Content-Type не установлен функцией header()

MIME-тип по умолчанию начинается с text/

http_output настройка отлична от pass

contents : содержимое буфера вывода

status : статус буфера вывода

Возвращаемое значение: конвертированная строка

mb_parse_str

(PHP 4 >= 4.0.6)

mb_parse_str - разбирает GET/POST/COOKIE данные и устанавливает глобальную переменную.

Описание

boolean mb_parse_str (string encoded_string [, array result])

mb_parse_str() разбирает GET/POST/COOKIE данные и устанавливает глобальные переменные. Поскольку PHP не предоставляет необработанных POST/COOKIE данных, она в настоящее время может использоваться только для GET данных. Она сжимает (?) URL-кодированные данные, определяет кодировку, конвертирует кодировку в во внутреннюю кодировку и устанавливает значения массива result или глобальных переменных.

encoded_string: URL-кодированные данные.

result: массив, содержащий декодированные и конвертированные значения кодировки символов.

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

См. также mb_detect_order(), mb_internal_encoding().

mb_preferred_mime_name

(PHP 4 >= 4.0.6)

mb_preferred_mime_name - получает строку MIME charset/набора символов.

Описание

string mb_preferred_mime_name (string encoding)

mb_preferred_mime_name() возвращает строку MIME charset для кодировки символов encoding. Возвращает строку charset.

mb_regex_encoding

(PHP 4 >= 4.2.0)

mb_regex_encoding - возвращает текущую кодировку многобайтного regex как строку.

Описание

string mb_regex_encoding ([string encoding])

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

mb_regex_encoding() возвращает кодировку символов, используемую функциями работы с многобайтными regex.

Если необязательный параметр encoding специфицирован, он устанавливает кодировку символов многобайтного regex. По умолчанию значением является внутренняя кодировка символов.

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

См. также mb_internal_encoding(), mb_ereg().

mb_send_mail

(PHP 4 >= 4.0.6)

mb_send_mail - отправляет кодированную почту.

Описание

boolean mb_send_mail (string to, string subject, string message [, string additional_headers [, string additional_parameter]])

mb_send_mail() отправляет email. Шапки и сообщение конвертируются и кодируются в соответствии с установкой mb_language(). mb_send_mail() является функцией-оболочкой для mail(). См. mail().

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

subject это тема/subject почты.

message это почтовое сообщение.

additional_headers вставляется в конце шапки/header. Он обычно используется для вставки дополнительных шапок. Несколько дополнительных шапок разделяются символами newline ("\n").

additional_parameter это параметр командной строки MTA. Он используется при установке корректной шапки Return-Path для sendmail.

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

См. также mail(), mb_encode_mimeheader() и mb_language().

mb_split

(PHP 4 >= 4.2.0)

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

Описание

array mb_split (string pattern, string string [, int limit])

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

mb_split() делит многобайтную строку string с использованием патэрна регулярного выражения pattern и возвращает результат как массив.

Если необязательный параметр limit специфицирован, разделение будет сделано максимум на limit элементов.

Внутренняя кодировка или кодировка символов, специфицированная в mb_regex_encoding(), будет использована как кодировка символов.

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

См. также mb_regex_encoding(), mb_ereg().

mb_strcut

(PHP 4 >= 4.0.6)

mb_strcut - получает часть строки.

Описание

string mb_strcut (string str, int start [, int length [, string encoding]])

mb_strcut() возвращает часть строки str, специфицированную параметрами start и length.

mb_strcut() выполняет операцию, эквивалентную mb_substr(), но другим методом. Если позиция start является вторым или более байтом многобайтного символа, функция стартует с первого байта многобайтного символа.

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

encoding это кодировка символов. Если не установлена, используется внутренняя кодировка.

См. также mb_substr(), mb_internal_encoding().

mb_strimwidth

(PHP 4 >= 4.0.6)

mb_strimwidth - получает усечённую строку со специфицированной шириной.

Описание

string mb_strimwidth (string str, int start, int width, string trimmarker [, string encoding])

mb_strimwidth() усекает строку str до специфицированной width. Возвращает усечённую строку.

Если trimmarker установлен, trimmarker присоединяется к return-значению.

start это смещение стартовой позиции. Количество символов от начала строки (первый символ 0).

trimmarker это строка, которая добавляется в конец строки при её усечении.

encoding это кодировка символов. Если опущен, используется внутренняя кодировка.

mb_strlen

(PHP 4 >= 4.0.6)

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

Описание

string mb_strlen (string str [, string encoding])

mb_strlen() возвращает количество символов в строке str, имеющих кодировку символов encoding. Многобайтный символ вычисляется как 1.

encoding это кодировка символов для str. Если encoding опущен, используется внутренняя кодировка.

См. также mb_internal_encoding(), strlen().

mb_strpos

(PHP 4 >= 4.0.6)

mb_strpos - находит позицию первого появления строки в строке.

Описание

int mb_strpos (string haystack, string needle [, int offset [, string encoding]])

mb_strpos() возвращает числовую позицию первого появления needle в строке haystack. Если needle не найдена, возвращает FALSE.

mb_strpos() выполняет многобайтную безопасную strpos()-операцию на основе количества символов.
Позиция needle вычисляется от начала haystack. Первая позиция равна 0. Позиция второго символа равна 1, и так далее.

Если encoding опущен, используется внутренняя кодировка. mb_strrpos() принимает string для needle, где strrpos() принимает только символ.

offset это смещение поиска. Если не специфицировано, используется 0.

encoding имя кодировки символов. Если опущено, используется внутренняя кодировка символов.

См. также mb_internal_encoding(), strpos().

mb_strrpos

(PHP 4 >= 4.0.6)

mb_strrpos - находит позицию последнего появления строки в строке.

Описание

int mb_strrpos (string haystack, string needle [, string encoding])

mb_strrpos() возвращает числовую позицию последнего появления needle в строке haystack. Если needle не найдена, возвращает FALSE.

mb_strrpos() выполняет многобайтную безопасную strpos()-операцию на основе количества символов.
Позиция needle вычисляется от начала haystack. Первая позиция равна 0. Позиция второго символа равна 1, и так далее.

Если encoding опущен, используется внутренняя кодировка. mb_strrpos() принимает string для needle, где strrpos() принимает только символ.

encoding это кодировка символов. Если опущена, используется внутренняя кодировка символов.

См. также mb_strpos(), mb_internal_encoding(), strrpos().

mb_strwidth

(PHP 4 >= 4.0.6)

mb_strwidth - возвращает ширину строки.

Описание

int mb_strwidth (string str [, string encoding])

mb_strwidth() возвращает ширину строки str.

Многобайтный символ обычно в два раза больше по ширине по сравнению с однобайтным символом.

mb_substitute_character

(PHP 4 >= 4.0.6)

mb_substitute_character - устанавливает/получает замещающий символ.

Описание

mixed mb_substitute_character ([mixed substrchar])

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

Эта установка влияет на mb_detect_encoding() и mb_send_mail().

substchar : специфицирует Unicode-значение как integer или как строку таким образом:

"none" : нет вывода

"long" : кодовое значение символа (Пример: U+3000,JIS+7E7E)

Возвращаемое значение: если substchar установлен, возвращает TRUE при успехе, иначе FALSE. Если substchar не установлен, возвращает Unicode-значение или "none"/"long".

mb_substr

(PHP 4 >= 4.0.6)

mb_substr - получает часть строки.

Описание

string mb_substr (string str, int start [, int length [, string encoding]])

mb_substr() возвращает часть строки str, специфицированную параметрами start и length.

mb_substr() выполняет многобайтную безопасную операцию substr() на основе количества символов. Позиция вычисляется относительно начала str. Позиция первого символа равна 0. Второго 1, и так далее.

Если encoding опущен, принимается внутренняя кодировка.

encoding это кодировка символов. Если опущена, используется внутренняя кодировка.

См. также mb_strcut(), mb_internal_encoding().

mcal_append_event

(PHP 4)

mcal_append_event - сохраняет новое событие в MCAL-календаре.

Описание

int mcal_append_event (int mcal_stream)

mcal_append_event() сохраняет глобальное событие в MCAL-календаре для данного потока.

Возвращает id вновь вставленного события.

mcal_close

(PHP 3>= 3.0.13, PHP 4)

mcal_close - закрывает MCAL-поток.

Описание

int mcal_close (int mcal_stream, int flags)

Закрывает данный mcal-поток.

mcal_create_calendar

(PHP 3>= 3.0.13, PHP 4)

mcal_create_calendar - создаёт новый MCAL-календарь.

Описание

string mcal_create_calendar (int stream, string calendar)

Создаёт новый календарь calendar.

mcal_date_compare

(PHP 3>= 3.0.13, PHP 4)

mcal_date_compare - сравнивает две даты.

Описание

int mcal_date_compare (int a_year, int a_month, int a_day, int b_year, int b_month, int b_day)

mcal_date_compare() сравнивает две даты, возвращая <0, 0, >0, если a<b, a==b, a>b, соответственно.

mcal_date_valid

(PHP 3>= 3.0.13, PHP 4)

mcal_date_valid - возвращает TRUE, если данные year, month, day являются верной датой.

Описание

int mcal_date_valid (int year, int month, int day)

mcal_date_valid() возвращает TRUE, если данные year, month и day являются правильной датой, FALSE - если нет.

mcal_day_of_week

(PHP 3>= 3.0.13, PHP 4)

mcal_day_of_week - возвращает день недели данной даты.

Описание

int mcal_day_of_week (int year, int month, int day)

mcal_day_of_week() возвращает день недели данной даты. Возможные return-значения находятся в диапазоне от 0 для Sunday до 6 для Saturday.

mcal_day_of_year

(PHP 3>= 3.0.13, PHP 4)

mcal_day_of_year - возвращает день года данной даты.

Описание

int mcal_ (int year, int month, int day)

mcal_day_of_year() возвращает день года данной даты.

mcal_days_in_month

(PHP 3>= 3.0.13, PHP 4)

mcal_days_in_month - возвращает количество дней в данном месяце.

Описание

int mcal_days_in_month (int month, int leap year)

mcal_days_in_month() возвращает количество дней в данном месяце с учётом високосного года.

mcal_delete_calendar

(PHP 3>= 3.0.13, PHP 4)

mcal_delete_calendar - удаляет MCAL-календарь.

Описание

string mcal_delete_calendar (int stream, string calendar)

Удаляет календарь calendar.

mcal_delete_event

(PHP 3>= 3.0.13, PHP 4)

mcal_delete_event - удаляет событие из MCAL-календаря.

Описание

int mcal_delete_event (int mcal_stream [, int event_id])

mcal_delete_event() удаляет календарное событие event_id.

Возвращает TRUE.

mcal_event_add_attribute

(PHP 3>= 3.0.15, PHP 4)

mcal_event_add_attribute - добавляет атрибут и значение в структуру глобальных событий потока.

Описание

void mcal_event_add_attribute (int stream, string attribute, string value)

mcal_event_add_attribute() добавляет атрибут в структуру глобальных событий потока со значением, заданным параметром "value".

mcal_event_init

(PHP 3>= 3.0.13, PHP 4)

mcal_event_init - инициализирует структуру глобальных событий потока.

Описание

int mcal_event_init (int stream)

mcal_event_init() инициализирует структуру глобальных событий потока. Эффективно устанавливает все элементы структуры в 0 либо в значения по умолчанию.

Возвращает TRUE.

mcal_event_set_alarm

(PHP 3>= 3.0.13, PHP 4)

mcal_event_set_alarm - устанавливает напоминание структуры глобальных событий потока.

Описание

int mcal_event_set_alarm (int stream, int alarm)

mcal_event_set_alarm() устанавливает напоминание структуры глобальных событий потока на данное количество минут до события.

Возвращает TRUE.

mcal_event_set_category

(PHP 3>= 3.0.13, PHP 4)

mcal_event_set_category - устанавливает категорию структуры глобальных событий потока.

Описание

int mcal_event_set_category (int stream, string category)

mcal_event_set_category() устанавливает структуры глобальных событий потока для данной строки.

Возвращает TRUE.

mcal_event_set_class

(PHP 3>= 3.0.13, PHP 4)

mcal_event_set_class - устанавливает класс структуры глобальных событий потока.

Описание

int mcal_event_set_class (int stream, int class)

mcal_event_set_class() устанавливает класс структуры глобальных событий потока в данное значение. Класс буде 1 для public или 0 для private.

Возвращает TRUE.

mcal_event_set_description

(PHP 3>= 3.0.13, PHP 4)

mcal_event_set_description - устанавливает описание структуры глобальных событий потока.

Описание

int mcal_event_set_description (int stream, string description)

mcal_event_set_description() устанавливает структуры глобальных событий потока для данной строки.

Возвращает TRUE.

mcal_event_set_end

(PHP 3>= 3.0.13, PHP 4)

mcal_event_set_end - устанавливает конечные дату и время структуры глобальных событий потока.

Описание

int mcal_event_set_end (int stream, int year, int month [, int day [, int hour [, int min [, int sec]]]])

mcal_event_set_end() устанавливает конечные дату и время структуры глобальных событий потока в данные значения.

Возвращает TRUE.

mcal_event_set_recur_daily

(PHP 3>= 3.0.13, PHP 4)

mcal_event_set_recur_daily - устанавливает повторение структуры глобальных событий потока.

Описание

int mcal_event_set_recur_daily (int stream, int year, int month, int day, int interval)

mcal_event_set_recur_daily() устанавливает повторение структуры глобальных событий потока в данное значение, чтобы выполнять повторение ежедневно до истечения заданной даты.

mcal_event_set_recur_monthly_mday

(PHP 3>= 3.0.13, PHP 4)

mcal_event_set_recur_monthly_mday - устанавливает повторение структуры глобальных событий потока.

Описание

int mcal_event_set_recur_monthly_mday (int stream, int year, int month, int day, int interval)

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

mcal_event_set_recur_monthly_wday

(PHP 3>= 3.0.13, PHP 4)

mcal_event_set_recur_monthly_wday - устанавливает повторение структуры глобальных событий потока.

Описание

int mcal_event_set_recur_monthly_wday (int stream, int year, int month, int day, int interval)

mcal_event_set_recur_monthly_wday() устанавливает структуры глобальных событий потока в данное значение для повторения помесячно на еженедельной основе при окончании на заданной дате.

mcal_event_set_recur_none

(PHP 3>= 3.0.15, PHP 4)

mcal_event_set_recur_none - устанавливает повторение структуры глобальных событий потока.

Описание

int mcal_event_set_recur_none (int stream)

mcal_event_set_recur_none() устанавливает отсутствие повторения структуры глобальных событий потока (в event->recur_type устанавливается MCAL_RECUR_NONE).

mcal_event_set_recur_weekly

(PHP 3>= 3.0.13, PHP 4)

mcal_event_set_recur_weekly - устанавливает повторение структуры глобальных событий потока.

Описание

int mcal_event_set_recur_weekly (int stream, int year, int month, int day, int interval, int weekdays)

mcal_event_set_recur_weekly() устанавливает повторение структуры глобальных событий потока в данное значение для еженедельного повторения с окончанием на заданной дате.