Учебник PHP

         

abs

(PHP 3, PHP 4)

abs - абсолютное значение.

Описание

mixed abs (mixed number)

Возвращает абсолютное значение числа. Если аргумент имеет тип float, return-тип также будет float, иначе он будет integer (так как float обычно имеет больший диапазон значений, нежели integer).

Пример 1. abs()
$abs = abs(-4.2); // $abs = 4.2; (double/float)
$abs2 = abs(5); // $abs2 = 5; (integer)
$abs3 = abs(-5); // $abs3 = 5; (integer)

acos

(PHP 3, PHP 4)

acos - арккосинус.

Описание

float acos (float arg)

Возвращает арккосинус аргумента arg в радианах. acos() это дополнительная функция к cos(), что означает, что a==cos(acos(a)) для каждого значения в диапазоне acos().

См. также acosh(), asin() и atan().

acosh

(PHP 4 >= 4.1.0)

acosh - инверсный гиперболический косинус.

Описание

float acosh (float arg)

Возвращает инверсный гиперболический косинус аргумента arg, т.е. значение, чей гиперболический косинус является


arg.

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

См. также acos(), asinh() и atanh().

addcslashes

(PHP 4)

addcslashes - мнемонизирует строку слэшами в стиле C.

Описание

string addcslashes (string str, string charlist)

Возвращает строку с обратными слэшами перед теми символами, которые перечислены в параметре charlist. Мнемонизирует/escape \n, \r и др. в C-подобном стиле, символы с ASCII-кодом меньше 32 и выше 126 конвертируются в восьмеричное представление.

Будьте внимательны, если хотите мнемонизировать символы 0, a, b, f, n, r, t и v. Они будут конвертированы в \0, \a, \b, \f, \n, \r, \t и \v. В PHP только \0 (NULL), \r (carriage return/возврат каретки), \n (newline/новая строка) и \t (tab/табуляция) являются предопределёнными escape-последовательностями, в то время как в C также и все прочие являются предопределёнными escape-последовательностями.

charlist вроде "\0..\31" будет мнемонизировать все символы с ASCII-кодами в диапазоне от 0 до 31.

addslashes

(PHP 3, PHP 4)

addslashes - закавычивает строку слэшами.

Описание

string addslashes (string str)

Возвращает строку со слэшами перед символами, которые должны быть закавычены в запросах БД и т.п.. Это одинарная ('), и двойная (") кавычки, обратный слэш/backslash (\)и NUL (NULL-байт).

Примечание: magic_quotes_gpc включены/ON по умолчанию.

См. также stripslashes(), htmlspecialchars() и quotemeta().

apache_child_terminate

(PHP 4 >= 4.0.5)

apache_child_terminate - завершает apache-процесс после данного запроса.

Описание

bool apache_child_terminate (void)

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

Примечание: наличие этой возможности управляется директивой apache.child_terminate в php.ini, которая по умолчанию установлена в off.

Эта возможность также отсутствует во многопоточных версиях Аpache вроде win32-версии.

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

apache_lookup_uri

(PHP 3>= 3.0.4, PHP 4)

apache_lookup_uri - выполняет частичный запрос по специфицированному URI и возвращает всю информацию о нём.

Описание

object apache_lookup_uri (string filename)

Выполняет частичный запрос по URI. Выполняет достаточно, чтобы получить всю важную информацию о данном ресурсе, и возвращает эту информацию в классе.
Свойства возвращаемого класса:statusthe_request status_linemethodcontent_typehandler urifilenamepath_infoargs boundaryno_cacheno_local_copyallowed send_bodyctbytes_sentbyterangeclength unparsed_urimtimerequest_time

Примечание: apache_lookup_uri() работает только тогда, когда PHP установлен как Apache-модуль.

apache_note

(PHP 3>= 3.0.2, PHP 4)

apache_note - получает и устанавливает замечания apache-запроса.

Описание

string apache_note (string note_name [, string note_value])

apache_note() это специфичная для Apache функция, которая получает и устанавливает значения в таблице notes запроса. При вызове с одним аргументом возвращает текущее значение замечания note_name. При вызове с двумя аргументами устанавливает значение замечания note_name как note_value и возвращает предыдущее значение note_name.

apache_setenv

(PHP 4 >= 4.2.0)

apache_setenv - устанавливает Apache-переменную subprocess_env.

Описание

int apache_setenv (string variable, string value [, bool walk_to_top])

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

array

(unknown)

array - создаёт массив.

Описание

array array ([mixed ...])

Возвращает массив параметров. Параметры могут быть заданы по индексу с операцией =>.

Примечание: array() это конструкция языка, используемая для представления литеральных массивов, а не регулярная функция.

Синтаксис пар "индекс => значение", разделённых запятыми, определяет индекс массива и значение по этому индексу.
Индекс может иметь строковой или числовой тип. Если индекс опущен, автоматически генерируется целочисленный/integer индекс, начиная с 0. Если индекс это целое число, следующим сгенерированным индексом будет большее целое число index + 1. Обратите внимание, что, когда определены два идентичных индекса, последний перезаписывает первый.

В следующем примере показано, как создать двухмерный массив, как специфицировать ключи для ассоциативного массива и как skip-and-continue (пропустить-и-продолжить) числовые индексы в нормальных массивах. array_change_key_case >Array ( [FIRST] => 1 [SECOND] => 2 )


         
array_chunk >Array ( [0] => Array ( [0] => a [1] => b ) [1] => Array ( [0] => c [1] => d ) [2] => Array ( [0] => e ) ) Array ( [0] => Array ( [0] => a [1] => b ) [1] => Array ( [2] => c [3] => d ) [2] => Array ( [4] => e ) ) array_count_values >Array ( [1] => 2 [hello] => 2 [world] => 1 )

array_diff

(PHP 4 >= 4.0.1)

array_diff - высчитывает разность массивов.

Описание

array array_diff (array array1, array array2 [, array ...])

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

array_fill >Array ( [5] => banana [6] => banana [7] => banana [8] => banana [9] => banana [10] => banana )

array_filter

(PHP 4 >= 4.0.6)

array_filter - фильтрует элементы массива с использованием callback-функции.

Описание

array array_filter (array input [, mixed callback])

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

Пример 1. array_filter()
array_flip >Array ( [1] => b [2] => c )

         

array_intersect

(PHP 4 >= 4.0.1)

array_intersect - обсчитывает пересечение массивов.

Описание

array array_intersect (array array1, array array2 [, array ...])

array_intersect() возвращает массив, содержащий все значения массива array1, которые имеются во всех аргументах. Обратите внимание, что ключи сохраняются.

array_key_exists

(PHP 4 >= 4.1.0)

array_key_exists - проверяет, существует ли в массиве данный индекс или ключ.

Описание

bool array_key_exists (mixed key, array search)

array_key_exists() возвращает TRUE, если данный key установлен в массиве.
key
может быть любым значением, возможным для индекса массива.

array_keys >Array ( [0] => 0 [1] => color ) Array ( [0] => 0 [1] => 3 [2] => 4 ) Array ( [0] => color [1] => size )

         

Примечание: эта функция была введена в PHP 4, а ниже дана реализация для использования в PHP 3. array_map >Array ( [0] => 1 [1] => 8 [2] => 27 [3] => 64 [4] => 125 )


         

array_merge

(PHP 4)

array_merge - объединяет массивы.

Описание

array array_merge (array array1, array, array2 [, array ...])

array_merge() объединяет элементы двух или более массивов таким образом, что значения присоединяются в конец другого.

Если массивы на входе имеют одни и те же строковые ключи, то последнее значение будет перезаписывать первое. Если, однако, массивы содержат числовые ключи, последнее значение не будет перезаписывать оригинальное значение, а будет присоединено.

array_merge_recursive

PHP 4 >= 4.0.1)

array_merge_recursive - рекурсивно объединяет два или более массивов.

Описание

array array_merge_recursive (array array1, array array2 [, array ...])

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

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

Пример 1. array_merge_recursive()

array_multisort

(PHP 4)

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

Описание

bool array_multisort (array ar1 [, mixed arg [, mixed ... [, array ...]]])

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

Массивы на входе рассматриваются как столбцы таблицы, сортируемые по рядам - это напоминает функциональность операции ORDER BY языка SQL. Первый массив будет primary/первичным для сортировки по нему. Одинаковые ряды (значения) в этом массиве сортируются следующим входящим массивом, и так далее.

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

Флаги порядка сортировки:

SORT_ASC - сортировка в порядке возрастания

SORT_DESC - сортировка в порядке убывания

Флаги сортировки по типу:

SORT_REGULAR - нормальное сравнение элементов

SORT_NUMERIC - числовое сравнение элементов

SORT_STRING - строковое сравнение элементов

После каждого массива нельзя специфицировать два флага сортировки одного типа. Флаги сортировки, специфицированные после аргумента массива, примеряются только к данному массиву - они восстанавливают значения по умолчанию SORT_ASC и SORT_REGULAR перед каждым новым аргументом массива.

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

array_pad

(PHP 4)

array_pad - дополняет массив значением на специфицированную длину.

Описание

array array_pad (array input, int pad_size, mixed pad_value)

array_pad() возвращает копию массива input, дополненного на размер, специфицированный параметром pad_size, значением pad_value. Если pad_size является положительным, то массив дополняется справа, если отрицательным - слева. Если абсолютное значение pad_size меньше и равно длине input, то дополнение не производится.

array_pop

(PHP 4)

array_pop - выталкивает последний элемент массива.

Описание

mixed array_pop (array array)

array_pop() возвращает последнее значение массива array, укорачивая array на один (этот) элемент. Если array пустой (или если это не массив), будет возвращено значение NULL.

array_push

(PHP 4)

array_push - вставляет один или более элементов в конец массива.

Описание

int array_push (array array, mixed var [, mixed ...])

array_push() рассматривает массив array как стэк и помещает переданные переменные в конец array. Размер array увеличивается на количество добавленных переменных. Имеет тот же эффект, что:

array_rand

(PHP 4)

array_rand - извлекает из массива одно или более произвольных вхождений.

Описание

mixed array_rand (array input [, int num_req])

array_rand() может пригодиться, если вы захотите извлечь из массива одно или более произвольно выбранных вхождений. Функция принимает массив input и необязательный аргумент num_req, который специфицирует, сколько вхождений вы хотите извлечь - если не специфицирует, по умолчанию будет 1.

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

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

array_reduce

(PHP 4 >= 4.0.5)

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

Описание

mixed array_reduce (array input, mixed callback [, int initial])

array_reduce() итеративно применяет callback-функцию (перебирает) к элементам массива input, уменьшая массив до одиночного значения. Если имеется необязательное initial, оно используется в начале процесса или как финальный результат - если массив пустой.

array_reverse

(PHP 4)

array_reverse - возвращает массив с элементами, развёрнутыми в обратном порядке.

Описание

array array_reverse (array array [, bool preserve_keys])

array_reverse() принимает массив array и возвращает новый массив с элементами в перевёрнутом порядке, сохраняя ключи, если preserve_keys имеет значение TRUE.

array_search

(PHP 4 >= 4.0.5)

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

Описание

mixed array_search (mixed needle, array haystack [, bool strict])

Ищет в haystack значение needle и возвращает ключ, если оно найдено в массиве, FALSE - в противном случае.

Примечание: до PHP 4.2.0 array_search() при неудаче возвращает NULL вместо FALSE.

Если необязательный третий параметр strict установлен TRUE, то array_search() будет также проверять типы needle в haystack.

Предупреждение!Эта функция может возвращать Boolean FALSE, но может также возвращать не-Boolean значение, которое вычисляется в FALSE, такое как 0 или "". Прочтите раздел о Booleans. Используйте операцию === для тестирования return-значения этой функции.

См. также array_keys() и in_array().

array_shift

(PHP 4)

array_shift - удаляет элемент в начале массива и выполняет смещение элементов.

Описание

mixed array_shift (array array)

array_shift() удаляет первый элемент массива array и возвращает его, укорачивая массив array на один элемент и смещая элементы к началу. Если array пустой (или если это не массив), будет возвращено значение NULL.

array_slice

(PHP 4)

array_slice - извлекает участок массива.

Описание

array array_slice (array array, int offset [, int length])

array_slice() возвращает последовательность элементов массива array, специфицированную параметрами offset (смещение) и length (длина).

Если offset положительное, последовательность начинается от этого смещения в массиве array. Если offset отрицательное, отсчёт начала последовательности начнётся от конца array.

Если length задана и положительная, последовательность будет содержать указанное количество элементов. Если length задана и отрицательная, то последовательность остановится на указанное количество элементов от конца массива. Если этот параметр отсутствует, последовательность будет содержать всё от offset до конца array.

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

array_splice

(PHP 4)

array_splice - удаляет часть массива и замещает её чем-либо.

Описание

array array_splice (array input, int offset [, int length [, array replacement]])

array_splice() удаляет элементы, указанные смещением offset и длиной length из массива input и замещает их элементами массива replacement, если он предоставлен. Функция возвращает массив, содержащий извлечённые элементы.

Если offset положительное, то удаляемая часть отсчитывается смещением от начала массива input. Если offset отрицательное, то удаляемая часть начинается на указанную величину от конца массива input.

Если length отсутствует, удаляется всё, начиная от offset до конца массива.
Если length специфицирована и положительная, удаляется указанное количество элементов.
Если length специфицирована и отрицательная, то конец удаляемой части будет находиться на указанное количество элементов от конца массива.
Подсказка: для удаления элементов от offset до конца массива, когда replacement также специфицирован, используйте count($input) для length.

Если массив replacement специфицирован, то удаляемые элементы замещаются элементами из этого массива. Если offset и length таковы, что ничего не удаляется, то элементы массива replacement вставляются вместо специфицированных смещением offset.
Подсказка: если replacement это один элемент, нет необходимости помещать array() вокруг него, если только элемент сам по себе не является массивом.

Следующие эквиваленты:

array_sum

(PHP 4 >= 4.0.4)

array_sum - высчитывает сумму значений массива.

Описание

mixed array_sum (array array)

array_sum() возвращает сумму значений массива как integer или float.

array_unique

(PHP 4 >= 4.0.1)

array_unique - удаляет из массива дублирующиеся значения.

Описание

array array_unique (array array)

array_unique() принимает на входе массив array и возвращает новый массив без дублирующих значений.

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

Примечание: Два элемента считаются равными, если, и только если,
(string) $elem1 === (string) $elem2. Иначе говоря: если строковые представления одинаковы.

Будет использоваться первый элемент.

Предупреждение!Это отсутствовало в PHP 4.0.4!

array_unshift

(PHP 4)

array_unshift - присоединяет один или более элементов в начало массива.

Описание

int array_unshift (array array, mixed var [, mixed ...])

array_unshift() присоединяет переданные элементы в начало массива array. Заметьте, что список элементов присоединяется как единое целое, и присоединяемые элементы располагаются в том же порядке.

Возвращает новое количество элементов массива array.

Пример 1. array_unshift()

array_values

(PHP 4)

array_values - возвращает все значения массива.

Описание

array array_values (array input)

array_values() возвращает все значения массива input.

array_walk

(PHP 3>= 3.0.3, PHP 4)

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

Описание

int array_walk (array array, string func [, mixed userdata])

Применяет определённую пользователем функцию func к каждому элементу массива array.
Функции func значение элемента массива будет передано как первый параметр, а ключ - как второй параметр. Если userdata предоставлен, он будет передан как третий параметр в пользовательскую функцию.
func
обязана быть определяемой пользователем функцией и не может быть встроенной функцией PHP. Таким образом, вы не можете использовать array_walk() непосредственно с str2lower(), вы обязаны сначала построит с ней пользовательскую функцию, а затем передать эту функцию как аргумент.

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

Если func требует более двух или трёх аргументов, в зависимости от userdata, будет генерироваться предупреждение каждый раз, когда array_walk() вызывает func. Эти предупреждения могут подавляться путём присоединения знака '@' перед вызовом array_walk() или путем использования error_reporting().

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

Модификация массива из func может дать непредсказуемое поведение.

Примечание: передача ключа и userdata в func была введена в версии 4.0.

В PHP 4 reset() должна вызываться по мере необходимости, поскольку array_walk() не восстанавливает по умолчанию значения массива.

Пользователи не могут самостоятельно изменять массив из callback-функции, например, добавлять/удалять элементы, unset массив, к которому array_walk() применяется. Если массив изменяется, поведение функции не определено.

arsort

(PHP 3, PHP 4)

arsort - сортирует массив в обратном порядке и сохраняет ассоциацию индексов.

Описание

void arsort (array array [, int sort_flags])

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

ascii2ebcdic

(PHP 3>= 3.0.17)

ascii2ebcdic - переводит строку из ASCII в EBCDIC.

Описание

int ascii2ebcdic (string ascii_str)

ascii2ebcdic() это специфическая для Apache функция, которая доступна только для ОС на базе EBCDIC OS/390, BS2000). Она переводит кодированную в ASCII строку ascii_str в её EBCDIC-эквивалент (binary safe/безопасный в двоичном режиме) и возвращает результат.

См. также обратную функцию ebcdic2ascii().

asin

(PHP 3, PHP 4)

asin - арксинус.

Описание

float asin (float arg)

Возвращает арксинус аргумента arg  в радианах. asin() это дополнительная функция к sin(), т.е. a==sin(asin(a)) для каждого значения в диапазоне asin().

См. также asinh(), acos() и atan().

asinh

(PHP 4 >= 4.1.0)

asinh - инверсный гиперболический синус.

Описание

float asinh (float arg)

Возвращает инверсный гиперболический синус аргумента arg, т.е. значение, гиперболический синус которого является arg.

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

См. также asin(), acosh() и atanh().

asort

(PHP 3, PHP 4)

asort - сортирует массив и сохраняет ассоциацию индексов.

Описание

void asort (array array [, int sort_flags])

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

aspell_check

(PHP 3>= 3.0.7, PHP 4)

aspell_check - проверяет слово [не рекомендуется].

Описание

bool aspell_check (int dictionary_link, string word)

aspell_check() проверяет синтаксис слова и возвращает TRUE, если слово корректно, FALSE - если нет.

aspell_check_raw

PHP 3>= 3.0.7, PHP 4)

aspell_check_raw - проверяет слово без изменения его регистра или усечения [не рекомендуется].

Описание

bool aspell_check_raw (int dictionary_link, string word)

aspell_check_raw() проверяет слово без изменения его регистра или усечения каким-либо образом и возвращает TRUE, если синтаксис корректен, FALSE - если нет.

aspell_new

(PHP 3>= 3.0.7, PHP 4)

aspell_new - загружает новый словарь/dictionary [не рекомендуется применять].

Описание

int aspell_new (string master [, string personal])

aspell_new() открывает новый словарь и возвращает идентификатор ссылки словаря для использования в других aspell-функциях. Возвращает FALSE при ошибке.

aspell_suggest

(PHP 3>= 3.0.7, PHP 4)

aspell_suggest - предлагает варианты синтаксиса для данного слова [не рекомендуется применять].

Описание

array aspell_suggest (int dictionary_link, string word)

aspell_suggest() возвращает массив возможных вариантов данного слова.

assert

(PHP 4)

assert - проверяет, не является утверждение/assertion ложным (FALSE).

Описание

int assert (string|bool assertion)

assert() проверяет данное утверждение assertion и выполняет определённую акцию, если результат FALSE.

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

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

Утверждения не должны использоваться для нормальных операций прогона программы вроде проверки параметров ввода. Основным правилом будет: ваш код всегда должен иметь возможность работать корректно, если проверка утверждения не активирована.

Поведение assert() может конфигурироваться функцией assert_options() или .ini-установками, описанными на странице об этой функции в данном учебнике.

функция assert_options() и/или директива конфигурации ASSERT_CALLBACK позволяют установить callback-функцию для обработки неудавшихся утверждений.

Обратные вызовы/callbacks assert() обычно используются для построения утилит автоматической проверки, поскольку они позволяют легко захватить код, передаваемый в утверждение вместе с информацией о том, где утверждение было сделано. Хотя эта информация может быть захвачена другими методами, использование утверждений позволяет делать это намного быстрее и легче!

Сallback-функция должна принимать три аргумента. Первый аргумент будет содержать файл, в котором утверждение не удалось. Второй аргумент будет содержать строку, в которой утверждение потерпело неудачу, а третий аргумент будет содержать выражение, которое не удалось выполнить (если имеются - такие литеральные значения как 1 или "two" не будут передаваться через этот аргумент).

assert_options

(PHP 4)

assert_options - устанавливает/получает различные флаги утверждения.

Описание

mixed assert_options (int what [, mixed value])

Используя assert_options(), вы можете устанавливать различные опции управления функцией assert() или просто запросить их текущие установки.

Таблица 1. Опции утверждений
опция ini-параметрпо умолчаниюописаниеASSERT_ACTIVE assert.active1включает вычисление assert() ASSERT_WARNINGassert.warning1вызывает РНР-предупреждение для каждого неудачного утверждения ASSERT_BAILassert.bail0прерывает выполнение неудачного утверждения ASSERT_QUIET_EVALassert.quiet_eval0отключает error_reporting при вычислении выражения утверждения ASSERT_CALLBACKassert_callback(NULL) пользовательская функция для вызова в неудавшихся утверждениях

assert_options() возвратит оригинальную установку любой опции или FALSE при ошибках.

atan

(PHP 3, PHP 4)

atan - арктангенс.

Описание

float atan (float arg)

Возвращает арктангенс аргумента arg в радианах. atan() это дополнительная функция к tan(), то есть a==tan(atan(a)) для каждого значения в диапазоне atan().

См. также atanh(), asin() и acos().

atan2

(PHP 3>= 3.0.5, PHP 4)

atan2 - арктангенс двух переменных.

Описание

float atan2 (float y, float x)

Эта функция вычисляет арктангенс переменных x и y. Это напоминает вычисление арктангенса y / x, за исключением того, что знаки обоих аргументов используются для определения квадранта результата.

Эта функция возвращает результат в радианах в диапазоне от -PI до PI (включительно).

См. также acos() и atan().

atanh

(PHP 4 >= 4.1.0)

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

Описание

float atanh (float arg)

Возвращает инверсный гиперболический тангенс аргумента arg, т.е. значение, чей гиперболический тангенс равен arg.

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

См. также atan(), asinh() и acosh().

base_convert

(PHP 3>= 3.0.6, PHP 4)

base_convert - конвертирует число между различными базами.

Описание

string base_convert (string number, int frombase, int tobase)

Возвращает строку, содержащую число number, представленное с базой tobase. База, в которой number даётся, специфицируется в frombase. И frombase, и tobase должны быть в диапазоне от 2 до 36 включительно. Цифры в числах с базой выше 10 будут представлены буквами a-z, когда a означает 10, b означает 11 и z означает 35.

base64_decode

(PHP 3, PHP 4)

base64_decode - декодирует данные, кодированные способом MIME base64.

Описание

string base64_decode (string encoded_data)

base64_decode() декодирует encoded_data и возвращает оригинальные данные. Возвращаемые данные могут быть в двоичной форме.

См. также base64_encode(), RFC2045 раздел 6.8.

base64_encode

(PHP 3, PHP 4)

base64_encode - кодирует данные способом MIME base64.

Описание

string base64_encode (string data)

base64_encode() возвращает data, кодированные методом base64. Эта кодировка была разработана для того, чтобы бинарные (двоичные) данные можно было передавать по транспортным слоям, которые не являются чисто 8-битными, таким как тело mail-сообщения.

Base64-кодированные данные занимают примерно на 33% больше пространства, чем оригинальные данные.

См. также base64_decode(), chunk_split(), RFC2045 раздел 6.8.

basename

(PHP 3, PHP 4)

basename - возвращает компонент filename пути.

Описание

string basename (string path [, string suffix])

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

В Windows и слэш (/), и обратный слэш (\) используются как символ-разделитель. В других средах это слэш (/).

bcadd

(PHP 3, PHP 4)

bcadd - складывает два числа произвольной точности.

Описание

string bcadd (string left_operand, string right_operand [, int scale])

Складывает left_operand с right_operand и возвращает сумму в виде строки. Необязательный параметр scale используется для установки количества цифр после десятичного разделителя в результате.

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

bccomp

(PHP 3, PHP 4)

bccomp - сравнивает два числа произвольной точности.

Описание

int bccomp (string left_operand, string right_operand [, int scale])

Сравнивает left_operand с right_operand и возвращает результат как integer/целое число. Необязательный параметр scale используется для установки количества цифр после десятичного разделителя, используемого при сравнении.
return-значение будет 0, если два операнда равны. Если left_operand больше, чем right_operand, return-значение будет +1, а если left_operand меньше right_operand, return-значение будет -1.

bcdiv

(PHP 3, PHP 4)

bcdiv - делит два числа произвольной точности.

Описание

string bcdiv (string left_operand, string right_operand [, int scale])

Делит left_operand на right_operand и возвращает результат. Необязательный параметр scale используется для установки количества цифр после десятичного разделителя в результате.

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

bcmod

(PHP 3, PHP 4)

bcmod - получает modulus числа произвольной точности.

Описание

string bcmod (string left_operand, string modulus)

Получает modulus (целочисленный остаток от деления) left_operand с использованием modulus.

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

bcmul

(PHP 3, PHP 4)

bcmul - перемножает два числа произвольной точности.

Описание

string bcmul (string left_operand, string right_operand [, int scale])

Умножает left_operand на right_operand и возвращает результат. Необязательный параметр scale используется для установки количества цифр после десятичного разделителя в результате.

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

bcpow

(PHP 3, PHP 4)

bcpow - возводит число произвольной точности в степень (обозначенную другим числом).

Описание

string bcpow (string x, string y [, int scale])

Возводит x в степень y. Необязательный параметр scale используется для установки количества цифр после десятичного разделителя в результате.

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

bcscale

(PHP 3, PHP 4)

bcscale - устанавливает параметр масштабирования/scale по умолчанию для всех bc математических функций.

Описание

string bcscale (int scale)

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

bcsqrt

(PHP 3, PHP 4)

bcsqrt - получает квадратный корень числа произвольной точности.

Описание

string bcsqrt (string operand [, int scale])

Возвращает квадратный корень операнда operand. Необязательный параметр scale используется для установки количества цифр после десятичного разделителя в результате.

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

bcsub

(PHP 3, PHP 4)

bcsub - вычитает одно число произвольно точности из другого.

Описание

string bcsub (string left_operand, string right_operand [, int scale])

Вычитает right_operand из left_operand и возвращает результат в виде строки. Необязательный параметр scale используется для установки количества цифр после десятичного разделителя в результате.

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

bin2hex

(PHP 3>= 3.0.9, PHP 4)

bin2hex - конвертирует двоичные данные в 16-ричное представление.

Описание

string bin2hex (string str)

Возвращает ASCII-строку, содержащую 16-ричное представление str. Конвертация выполняется побайтно, начиная с самого высокого разряда.

См. также pack() и unpack().

bind_textdomain_codeset

(PHP 4 >= 4.2.0)

bind_textdomain_codeset - специфицирует кодировку символов, в которой возвращаются сообщения из DOMAIN-каталога сообщений.

Описание

string bind_textdomain_codeset (string domain, string codeset)

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

bindec

(PHP 3, PHP 4)

bindec - двоичное в десятичное.

Описание

int bindec (string binary_string)

Возвращает 10-ричный эквивалент двоичного числа, представленного аргументом binary_string.

bindec() конвертирует двоичное число в integer. Наибольшее число, которое может быть конвертировано, содержит 31 разряд единиц, или 2147483647 в 10-ричном представлении.

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

bindtextdomain

(PHP 3>= 3.0.7, PHP 4)

bindtextdomain - устанавливает путь домена.

Описание

string bindtextdomain (string domain, string directory)

Функция bindtextdomain() устанавливает путь к домену.

bzclose

(PHP 4 >= 4.0.4)

bzclose - закрывает bzip2-указатель на файл.

Описание

int bzclose (resource bz)

Закрывает bzip2-файл, на который указывает указатель bz.

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

Указатель на файл обязан быть правильным и обязан указывать на файл, успешно открытый функцией bzopen().

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

bzcompress

(PHP 4 >= 4.0.4)

bzcompress - сжимает строку в bzip2-кодированные данные.

Описание

string bzcompress (string source [, int blocksize [, int workfactor]])

bzcompress() сжимает строку source и возвращает её как bzip2-кодированные данные.

Необязательный параметр blocksize специфицирует размер блока, используемый при сжатии, и должен быть числом от 1 до 9, где 9 означает максимальное сжатие, но для этого используется больше ресурсов. blocksize имеет по умолчанию значение 4.

Необязательный параметр workfactor управляет тем, как проходит фаза компрессии, когда входные данные представлены неправильным регистром, что бывает очень. Значение может быть в диапазоне от 0 до 250, где 0 это специальный регистр, а 30 это значение по умолчанию. Вне зависимости от workfactor, генерируемый вывод будет тем же.

bzdecompress

(PHP 4 >= 4.0.4)

bzdecompress - выполняет декомпрессию bzip2-кодированных данных.

Описание

string bzdecompress (string source [, int small])

bzdecompress() выполняет декомпрессию строки source, содержащей bzip2-кодированные данные, и возвращает их. Если необязательный параметр small имеет значение TRUE, будет использоваться альтернативный алгоритм декомпрессии с меньшим расходом памяти (максимальное требование к памяти находится где-то в районе 2300K), но он работает примерно с в два раза меньшей скоростью. См. дополнительно документацию по bzip2.

bzerrno

(PHP 4 >= 4.0.4)

bzerrno - возвращает номер ошибки bzip2.

Описание

int bzerrno (resource bz)

Возвращает номер ошибки bzip2, возвращаемой указателем файла bz.

См. также bzerror() и bzerrstr().

bzerror

(PHP 4 >= 4.0.4)

bzerror - возвращает номер ошибки bzip2 и строку в массиве.

Описание

array bzerror (resource bz)

Возвращает номер ошибки и строку в ассоциативном массиве для любой bzip2-ошибки, возвращённой файловым указателем bz.

bzerrstr

(PHP 4 >= 4.0.4)

bzerrstr - возвращает строку с ошибкой bzip2.

Описание

string bzerrstr (resource bz)

Возвращает строку ошибки любой bzip2-ошибки, возвращённой файловым указателем bz.

См. также bzerrno() и bzerror().

bzflush

(PHP 4 >= 4.0.4)

bzflush - форсирует запись всех буферизованных данных.

Описание

int bzflush (resource bz)

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

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

См. также bzread() и bzwrite().

bzopen

(PHP 4 >= 4.0.4)

bzopen - открывает bzip2-сжатый файл.

Описание

resource bzopen (string filename, string mode)

Открывает bzip2 (.bz2) файл для чтения или записи.
filename это имя открываемого файла.
mode
похож на функцию fopen() ('r' для чтения/read, 'w' для записи/write, etc.).

Если открыть файл не удаётся, функция возвращает FALSE, иначе возвращает указатель на вновь открытый файл.

bzread

(PHP 4 >= 4.0.4)

bzread - безопасное в двоичном режиме чтение bzip2-файла.

Описание

string bzread (resource bz [, int length])

bzread() читает length байтов из bzip2-указателя на файл, на который ссылается bz. Чтение останавливается, когда прочитаны length (несжатых) байтов или когда достигнут EOF (конец файла), в зависимости от того, что впёред. Если необязательный параметр length не специфицирован, bzread() будет читать 1024 (несжатых) байтов за раз.

bzwrite

(PHP 4 >= 4.0.4)

bzwrite - безопасная в двоичном режиме запись в bzip2-файл.

Описание

int bzwrite (resource bz, string data [, int length])

bzwrite() записывает содержимое строки data в поток bzip2-файла, на который указывает bz. Если задан необязательный аргумент length, запись остановится после записи length (несжатых) байтов или по достижении конца строки, смотря что произойдёт вперёд.

cal_days_in_month

(PHP 4 >= 4.1.0)

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

Описание

int cal_days_in_month (int calendar, int month, int year)

Эта функция возвращает количество дней месяца month года year для специфицированного calendar.

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

cal_from_jd

(PHP 4 >= 4.1.0)

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

Описание

array cal_from_jd (int jd, int calendar)

cal_info

(PHP 4 >= 4.1.0)

cal_info - возвращает информацию об определённом календаре.

Описание

array cal_info (int calendar)

cal_to_jd

(PHP 4 >= 4.1.0)

cal_to_jd - конвертирует из поддерживаемого календаря в Юлианский.

Описание

int cal_to_jd (int calendar, int month, int day, int year)

call_user_func

(PHP 3>= 3.0.3, PHP 4)

call_user_func - вызывает пользовательскую функцию, заданную первым параметром.

Описание

mixed call_user_func (string function_name [, mixed parameter [, mixed ...]])

Вызывает определённую пользователем функцию, заданную параметром function_name.
Выглядит так:

function barber ($type) {
print "You wanted a $type haircut, no problem";
}
call_user_func ('barber', "mushroom");
call_user_func ('barber', "shave");

См. также call_user_func_array(), call_user_method(), call_user_method_array().

call_user_func_array

(PHP 4 >= 4.0.4)

call_user_func_array - вызывает пользовательскую функцию с массивом параметров.

Описание

mixed call_user_func_array (string function_name [, array paramarr])

Вызывает определённую пользователем функцию, заданную аргументом function_name, с параметрами в массиве paramarr. Например:

function debug($var, $val)
echo "***DEBUGGING\nVARIABLE: $var\nVALUE:";
if (is_array($val) || is_object($val) || is_resource($val))
print_r($val);
else
echo "\n$val\n";
echo "***\n";
}
$c = mysql_connect();
$host = $_SERVER["SERVER_NAME"];
call_user_func_array ('debug', array("host", $host));
call_user_func_array ('debug', array("c", $c));
call_user_func_array ('debug', array("_POST", $_POST));

См. также call_user_func(), call_user_method(), call_user_method_array().

Примечание: эта функция была введена в CVS-код после релиза PHP 4.0.4pl1.

call_user_method

(PHP 3>= 3.0.3, PHP 4)

call_user_method - вызывает пользовательский метод на специфицированном объекте [не рекомендуется применять].

Описание

mixed call_user_method (string method_name, object obj [, mixed parameter [, mixed ...]])

Предупреждение!Функцию call_user_method() применять не рекомендуется, начиная с PHP 4.1.0, используйте вместо неё вариант call_user_func() с синтаксисом array(&$obj, "method_name").

Вызывает метод, на который ссылается method_name, пользовательского объекта obj. Пример использования дан ниже, где мы определяем класс, инстанциируем (создаём экземпляр) объект и используем call_user_method() для непрямого вызова метода print_info этого объекта.

<?php
class Country {
var $NAME;
var $TLD;
function Country($name, $tld) {
$this->NAME = $name;
$this->TLD = $tld;
}
function print_info($prestr="") {
echo $prestr."Country: ".$this->NAME."\n";
echo $prestr."Top Level Domain: ".$this->TLD."\n";
}
}
$cntry = new Country("Peru","pe");
echo "* Вызов метода объекта напрямую\n";
$cntry->print_info();
echo "\n* Непрямой вызов того же самого метода\n";
call_user_method ("print_info", $cntry, "\t");
?>

См. также call_user_func_array(), call_user_func() и call_user_method_array().

call_user_method_array

(PHP 4 >= 4.0.5)

call_user_method_array - вызывает пользовательский метод с параметрами в виде массива [не рекомендуется применять].

Описание

mixed call_user_method_array (string method_name, object obj [, array paramarr])

Предупреждение!Функцию call_user_method_array() применять не рекомендуется, начиная с PHP 4.1.0, используйте вместо неё вариант call_user_func_array() с синтаксисом
array(&$obj, "method_name").

Вызывает метод, на который ссылается method_name, пользовательского объекта obj, используя параметры из массива paramarr.

См. также: call_user_func_array(), call_user_func(), call_user_method().

Примечание: эта функция была добавлена в CVS-код после релиза PHP 4.0.4pl1.

ccvs_add

(PHP 4 >= 4.0.2)

ccvs_add - добавить данные в транзакцию.

Описание

string ccvs_add (string session, string invoice, string argtype, string argval)

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

ccvs_auth

(PHP 4 >= 4.0.2)

ccvs_auth - выполняет проверку авторизации при выполнении транзакции.

Описание

string ccvs_auth (string session, string invoice)

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

ccvs_command

(PHP 4 >= 4.0.2)

ccvs_command - выполняет команду, специфичную для одного протокола и, следовательно, недоступную в общем CCVS API.

Описание

string ccvs_command (string session, string type, string argval)

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

ccvs_count

(PHP 4 >= 4.0.2)

ccvs_count - определяет, сколько транзакций данного типа хранятся в системе.

Описание

int ccvs_count (string session, string type)

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

ccvs_delete

(PHP 4 >= 4.0.2)

ccvs_delete - удаляет транзакцию.

Описание

string ccvs_delete (string session, string invoice)

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

ccvs_done

(PHP 4 >= 4.0.2)

ccvs_done - прерывает работу CCVS-машины и выполняет зачистку.

Описание

string ccvs_done (string sess)

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

ccvs_init

(PHP 4 >= 4.0.2)

ccvs_init - инициализирует CCVS для использования.

Описание

string ccvs_init (string name)

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

ccvs_lookup

(PHP 4 >= 4.0.2)

ccvs_lookup - ищет элемент определённого типа в базе данных #

Описание

string ccvs_lookup (string session, string invoice, int inum)

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

ccvs_new

(PHP 4 >= 4.0.2)

ccvs_new - создаёт новую чистую транзакцию.

Описание

string ccvs_new (string session, string invoice)

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

ccvs_report

(PHP 4 >= 4.0.2)

ccvs_report - возвращает статус фонового процесса взаимодействия.

Описание

string ccvs_report (string session, string type)

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

ccvs_return

(PHP 4 >= 4.0.2)

ccvs_return - переносит фонды от продавца владельцу кредитной карты.

Описание

string ccvs_return (string session, string invoice)

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

ccvs_reverse

(PHP 4 >= 4.0.2)

ccvs_reverse - выполняет полную перестановку уже проведённой авторизации.

Описание

string ccvs_reverse (string session, string invoice)

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