White cat - Справочник по PHP
decoct
Производит конвертацию десятичного числа в восьмеричное.
Синтаксис:
string decoct(int number)
Возвращает строку, представляющую собой восьмеричное представление целого числа number. Максимальное число, которое еще может быть преобразовано, равно 2 147 483 647
$x = dechex(2147483647); // $x = 17777777777
hexdec
Производит конвертацию шестнадцатеричного числа в десятичное.
Синтаксис:
int hexdec(string hex_string)
Преобразует шестнадцатеричное число, заданное в строке hex_string, в десятичное число. Максимальное число, которое еще может быть преобразовано, равно 7fffffff
$x = hexdec(7fffffff); // $x = 2147483647
octdec
Производит конвертацию восьмеричного числа в десятичное.
Синтаксис:
int octdec(string octal_string)
Преобразует восьмеричное число, заданное в строке octal_string, в десятичное число. Максимальное число, которое еще может быть преобразовано, равно 17777777777
$x = octdec(17777777777); // $x = 2147483647
deg2rad
Производит конвертацию градусов в радианы.
Синтаксис:
double deg2rad(double number)
Преобразует градусы, заданные в параметре number, в радианы.
rad2deg
Производит конвертацию радианов в градусы.
Синтаксис:
double rad2deg(double number)
Преобразует радианы, заданные в параметре number, в градусы.
number_format
Форматирование числа.
Синтаксис:
number_format($number, $decimals, $dec_point=".", $thousands_sep=",");
Эта функция форматирует число с плавающей точкой с разделением его на триады с указанной точностью. Она может быть вызвана с двумя или четырьмя аргументами, но не с тремя! Параметр $decimals задает, сколько цифр после запятой должно быть у числа в выходной строке.
Параметр $dec_point представляет собой разделитель целой и дробной частей, а параметр $thousands_sep - разделитель триад в числе (если указать на его месте пустую строку, то триады не отделяются друг от друга).
Минимум и максимум
min
Эта функция возвращает наименьшее из чисел, заданных в ее аргументах.
Синтаксис:
mixed min(mixed $arg1 [int $arg2, ..., int $argn])
Различают два способа вызова этой функции: с одним параметром или с несколькими. Если указан лишь один параметр (первый), то он обязательно должен быть массивом и возвращается минимальный элемент этого массива. В противном случае первый (и остальные) аргументы трактуются как числа с плавающей точкой, они сравниваются, и возвращается наименьшее. Тип возвращаемого значения выбирается так: если хотябы одно из чисел, переданных на вход, задано в формате с плавающей точкой, то и результат будет с плавающей точкой, в противном случае результат будет целым числом. С помощью этой функции нельзя лексографически сравнивать строки - только числа.
$x = min(5,3,4,6,5,6,8,9);
// $x = 3
$x[0]=4;
$x[1]=1;
$x[2]=5;
$x[3]=2;
echo min($x); // выведет 1
max
Получение наибольшего аргумента.
Синтаксис:
mixed max(mixed $arg1 [int $arg2, ..., int $argn])
Функция работает аналогично min(), только ищет максимальное значение.
$x = max(5,3,4,6,5,6,8,9);
// $x = 9
$x[0]=4;
$x[1]=1;
$x[2]=5;
$x[3]=2;
echo max($x); // выведет 5
Степенные функции
sqrt
Возвращает квадратный корень из аргумента.
Синтаксис:
float sqrt(float $arg)
Если аргумент отрицателен, то генерируется предупреждение, но работа программы не прекращается!
$x = sqrt(9);
// $x = 3
echo sqrt(25); // выведет 5
echo sqrt(-25); // выведет -1.#IND
log
Возвращает натуральный логарифм аргумента.
Синтаксис:
float log(float $arg)
В случае недопустимого числа печатает предупреждение, но не завершает программу.
$x = log(exp(2)); // exp(2) - e в степени 2
// $x = 2
$x = log(M_E); // $x = 1
echo log(10); // выведет 2.302585092994
log10
Возвращает десятичный логарифм аргумента.
Синтаксис:
float log10(float $arg)
В случае недопустимого числа печатает предупреждение, но не завершает программу.
echo log10(100); // выведет 2
exp
Возвращает e (2,718281828) в степени $arg.
Синтаксис:
float exp(float $arg)
$x = exp(1);
// $x = 2.718281828459
pow
Возведение в степень.
Синтаксис:
float pow(float $base, float $exp)
Возвращает $base в степени $exp.
$x = pow(3,2); // $x = 9
$x = pow("3",2); // $x = 9
Тригонометрия
sin
Возвращает синус аргумента.
Синтаксис:
float sin(float $arg)
Аргумент задается в радианах.
$x = sin(M_PI_2); // $x = 1
cos
Возвращает косинус аргумента.
Синтаксис:
float cos(float $arg)
$x = cos(0); // $x = 0
$x = cos(M_PI); // $x = -1
tan
Возвращает тангенс аргумента, заданного в радианах.
Синтаксис:
float tan(float $arg)
$x = tan(M_PI_4); // $x = 1
acos
Возвращает арккосинус аргумента.
Синтаксис:
float acos(float $arg)
$x = acos(0); // $x = pi/2
$x = acos(1); // $x = 0
asin
Возвращает арксинус.
Синтаксис:
float asin(float $arg)
$x = asin(0); // $x = 0
$x = asin(1); // $x = pi/2
atan
Возвращает арктангенс аргумента.
Синтаксис:
float atan(float $arg)
$x = atan(0); // $x = 0
$x = atan(1); // $x = pi/4
atan2
Получение арктангенса двух чисел.
Синтаксис:
float atan2(float $y, float $x)
Возвращает арктангенс величины $y/$x, но с учетом той четверти, в которой лежит точка ($x,$y). Эта функция возвращает результат в радианах, принадлежащий отрезку от -? до ?.
$x = atan2(1,1); // $x = pi/4
$x = atan2(-1,-1); // $x = -3*pi/4
pi
Возвращает число пи - 3,14.
Синтаксис:
double pi()
Эту функцию обязательно нужно вызывать с парой пустых скобок:
$x = pi()*2 // $x = 31.415926535898
Функции повышенной точности BCMath
bcadd
Сложение двух чисел произвольной точности.
Синтаксис:
string bcadd(string left_operand, string right_operand [, int scale]);
Эта функция возвращает строковое представление суммы двух параметров (left_operand + right_operand) с точностью, которая указана в необязательном параметре scale.
Точность (scale) указывает количество десятичных знаков после запятой).
bccomp
Сравнение двух чисел произвольной точности.
Синтаксис:
int bccomp(string left_operand, string right_operand, [int scale]);
Сравнивает числа (left_operand с right_operand) и возвращает результат типа integer (целое). Параметр scale используется для установки количества цифр после десятичной отметки, используемых при сравнении. При равенстве двух частей возвращается значение 0. Если левая часть больше правой части возвращается +1, и если левая часть меньше правой части возвращается -1.
bcdiv
Операция деления для двух чисел произвольной точности.
Синтаксис:
string bcdiv(string left_operand, string right_operand [, intscale]);
Делит left_operand на right_operand и возвращает результат с точностью (знаками после запятой), заданной в параметре scale.
bcmod
Возвращает остаток целочисленного деления.
Синтаксис:
string bcmod(left_operand, string modulus);
Данная функция возвращает остаток от целочисленного деления left_operand на modulus.
bcmul
Операция умножения для двух чисел произвольной точности.
Синтаксис:
string bcmul(string left_operand, string right_operand [, int scale]);
Производит умножение left_operand на right_operand, и выдает результат в виде строки с точностью, заданной в переменной scale.
bcpow
Возведение одного числа произвольной точности в степень другого.
Синтаксис:
string bcpow(string x, string y, [int scale]);
Возведение x в степень y. Параметр scale может использоваться для установки количества цифр после точки.
bcscale
Устанавливает точность вычислений.
Синтаксис:
string bcscale(int scale);
Эта функция устанавливает заданную по умолчанию точность вычислений для всех математических функций BCMath, которые явно не определяют точность.
