Руководство по РНР 3.0 - Математические функции

Содержание
Abs
Acos
Asin
Atan
Atan2
base_convert
BinDec
Ceil
Cos
DecBin
DecHex
DecOct
Exp
Floor
getrandmax
HexDec
Log
Log10
max
min
mt_rand
mt_srand
mt_getrandmax
number_format
OctDec
pi
pow
rand
round
Sin
Sqrt
srand
Tan

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

Математические константы

Следующие величины определяются как математические константы PHP:

Таблица 1. Математические константы

Константа	Величина	Описание
M_PI	3.14159265358979323846	Значение ¶ (pi)

Abs

Abs -- абсолютная величина

Описание

mixed abs(mixed number);

Возвращает абсолютную величину числа. Если число с плавающей запятой, то также возвращает число с плавающей запятой.

Acos

Acos -- арккосинус

Описание

float acos(float arg);

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

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

Asin

Asin -- арксинус

Описание

float asin(float arg);

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

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

Atan

Atan -- арктангенс

Описание

float atan(float arg);

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

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

Atan2

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

Описание

float atan2(float y, float x);

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

Функция возвращает результат в радианах, находящихся между -PI и PI (включительно).

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

base_convert

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

Описание

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

Возвращает строку, содержащую number, представленное по основанию tobase. Основание, в котором дается число which number указывается в frombase. Основания frombase и tobase должны находиться в диапазоне от 2 до 36 включительно. Цифры в числах с основанием выше, чем 10 будут представлены буквами a-z, со значениями a - 10, b - 11 и z - 36.
Пример 1. base_convert()
$binary = base_convert($hexadecimal, 16, 2);

BinDec

BinDec -- двоичное в десятичное

Описание

int bindec(string binary_string);

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

OctDec конвертирует двоичное число в десятичное. Наибольшее число, которое может быть сконвертировано равно 31 битам или 2147483647 в десятичном виде.

См.также функцию decbin().

Ceil

Ceil -- округлить дробную часть наверх

Описание

int ceil(float number);

Возвращает следующее наивысшее целое значение number. Использование ceil() на целых числах - абсолютная трата времени.

ЗАМЕЧАНИЕ: Функция ceil() в PHP/FI 2 возвращаля число типа float. Используйте: $new = (double)ceil($number); для того, чтобы сэмулировать старое поведение функции.

См.также floor() и round().

Cos

Cos -- косинус

Описание

float cos(float arg);

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

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

DecBin

DecBin -- десятичное в двоичное

Описание

string decbin(int number);

Возвращает строку, содержащую двоичное представление аргумента number. Наибольшее число, которое может быть сконвертировано равно 2147483647 в десятичном виде или 31 бит.

См.также функцию bindec().

DecHex

DecHex -- десятичное в шестнадцатиричное

Описание

string dechex(int number);

Возвращает строку, содержащую шестнадцатиричное представление аргумента number. Наибольшее число, которое может быть сконвертировано равно 2147483647 в десятичном виде или "7fffffff" в шестнадцатиричном.

См. также функцию hexdec().

DecOct

DecOct -- десятичное в восьмеричное

Описание

string decoct(int number);

Возвращает строку, содержащую восьмеричное представление аргумента number. Наибольшее число, которое может быть сконвертировано равно 2147483647 в десятичном виде или "17777777777" в восьмеричном. См.также octdec().

Exp

Exp -- e в степени ...

Описание

float exp(float arg);

Возвращает число e, возведенное в степень arg.

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

Floor

Floor -- округляет дробную часть вниз

Описание

int floor(float number);

Возвращает следующее нижележащее значение после number. Использование floor() на целых числах - абсолютная потеря времени.

ЗАМЕЧАНИЕ: Функция floor() в PHP/FI 2 возвращала число типа float. Используйте: $new = (double)floor($number); для эмулирования старого поведения этой функции.

См.также ceil() и round().

getrandmax

getrandmax -- показывает наибольшую возможную случайную величину

Описание

int getrandmax(void );

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

См.также rand(), srand() mt_rand(), mt_srand() и mt_getrandmax().

HexDec

HexDec -- шестнадцатиричное в десятичное

Описание

int hexdec(string hex_string);

Возвращает десятичный эквивалент числа, представленного аргументом hex_string. HexDec конвертирует шестнадцатиричную сстроку в десятичное число. Наибольшее число, которое может быть сконверьтировано равно 7fffffff в шестнадцатиричном виде или 2147483647 в десятичном.

См. также функцию dechex().

Log

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

Описание

float log(float arg);

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

Log10

Log10 -- логарифм по основанию 10

Описание

float log10(float arg);

Возвращает логарифм по основанию 10 от аргумента arg.

max

max -- находит максимум

Описание

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

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

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

Если одна или более величин типа double, все остальные величины будут обращены double, и, соответственно, возвратится число типа double. Если ни одно из чисел не является double, то все будут обращены в целые и возвратится целое число.

min

min -- находит минимум

Описание

mixed min(mixed arg1, mixed arg2, mixed argn);

min() возвращает наименьшее значение из указанных в аргументах.

Если первый параметр - массив, min() возвратит наименьшую величину массива. Если первый параметр - целое число, строка или double, следует указать минимум два парметра и min() возвратит наименьшую из них величину. Вы можете сравнивать неограниченно количество величин.

mt_rand

mt_rand -- генерирует наилучшее случаное число

Описание

int mt_rand([int min], [int max]);

Множество генераторов случайных чисел, написанных на старой библиотеке libcs, имеют неясные или неизвестные характеристики, и к тому же, медленны. По умолчанию с функцией rand() PHP использует генератор случайных чисел, написанный на libc. Функция mt_rand() является его полной заменой. Она использует генератор случайных чисел с известными характеристиками (Mersenne Twister), который производит случайные числа, пригодные для использования в криптографии и работает в четыре раза быстрее, чем средняя скорость, которую обеспечивает libc. Домашняя страница Mersenne Twister'а Вы можете найти по адресу http://www.math.keio.ac.jp/~matumoto/emt.htm, а оптимизированную версию исходных текстов на http://www.scp.syr.edu/~marc/hawk/twister.htm.

Если функция вызывается без необязательных аргументов min и max, mt_rand() возвращает псевдо-случайное число между 0 и RAND_MAX. Если Вы хотите получить случайное число между 5 и 15 (включительно), то можно использовать следующий вызов функции: mt_rand(5,15).

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

См.также mt_srand(), mt_getrandmax(), srand(), rand() и getrandmax().

mt_srand

mt_srand -- инициализирует лучший генератор случаных чисел

Описание

void mt_srand(int seed);

Инициализирует генератор случайных чисел значением seed.

// инициализируется количеством микросекунд с посленей "целой" секунды
mt_srand((double)microtime()*1000000);
$randval = mt_rand();

См.также mt_rand(), mt_getrandmax(), srand(), rand() и getrandmax().

mt_getrandmax

mt_getrandmax -- показывает наибольшее возможное случайное число

Описание

int mt_getrandmax(void );

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

См.также mt_rand(), mt_srand() rand(), srand() и getrandmax().

number_format

number_format -- форматирует число с сгруппированными тысячами

Описание

string number_format(float number, int decimals, string dec_point, string thousands_sep);

number_format() возвращает форматированную версию числа number. Эта функция принимает один, два или четыре параметра (не три):

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

Если дано два параметра, число number will будет отформатировано с десятичным знаком decimals с точкой (".") впереди и запятой (",") между каждой группой тысяч.

Если даны все четыре параметра, то число number будет отформатировано с десятичным знаком decimals, dec_point вместо точки (".") перед десятичным знаком и thousands_sep вместо запятой (",") между каждой группой тысяч.

OctDec

OctDec -- восьмеричное в десятичное

Описание

int octdec(string octal_string);

Возвращает десятичный эквивалент восьмеричного числа, представленного аргументом octal_string. OctDec конвертирует восьмеричное число в десятичное. Максимальное число, которое может быть сконвертировано равно 17777777777 или 2147483647 в десятичном виде.

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

pi -- величина pi

Описание

double pi(void );

Вохвращает аппроксимированное значение pi.

pow

pow -- степень числа

Описание

float pow(float base, float exp);

Возвращает base, возведенное в степень exp.

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

rand

rand -- генерирует случаную величину

Описание

int rand([int min], [int max]);

Если функция вызывается без необязательных параметров min и max, rand() возвращает псевдо-случайную величину между 0 и RAND_MAX. При желании получить случайное число между 5 и 15 (включительно), используйте rand(5,15).

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

См.также srand(), getrandmax(), mt_rand(), mt_srand() и mt_getrandmax().

round

round -- округляет число с плавающей запятой

Описание

double round(double val);

Возвращает округленную величину val.

$foo = round( 3.4 );   // $foo == 3.0
$foo = round( 3.5 );   // $foo == 4.0
$foo = round( 3.6 );   // $foo == 4.0

См.также ceil() and floor().

Sin

Sin -- синус

Описание

float sin(float arg);

Возврашает синус аргумента.

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

Sqrt

Sqrt -- квадратный корень

Описание

float sqrt(float arg);

Возвращает квадратный корень аргумента.

srand

srand -- инициализирует генератор случайных чисел

Описание

void srand(int seed);

Инициализирует генератор случайных чисел значением seed.

// инициализируется числом микросекунд с последней "целой" секунды
srand((double)microtime()*1000000);
$randval = rand();

См.также rand(), getrandmax(), mt_rand(), mt_srand() и mt_getrandmax().

Tan

Tan -- тангенс

Описание

float tan(float arg);

Возвращает тангенс аргумента.

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

Содержание