Skip to content

Latest commit

 

History

History
278 lines (205 loc) · 9.37 KB

README.ru_RU.md

File metadata and controls

278 lines (205 loc) · 9.37 KB

English | Русский

MATH CONVERTER CSE HELPERS

Travis (.org) Codecov Scrutinizer code quality

Packagist Minimum PHP Version Packagist GitHub repo size

Данная библиотек состоит из статических методов, которые позволят вам приобразовывать числа.

Репозиторий проекта: https://github.com/cs-eliseev/helpers-math-converter

DEMO

$mb = MathConverter::toMb('300K');
$sub = bcsub(
    MathConverter::roundDecimal($mb, 4),    // 0.293
    MathConverter::cutDecimal($mb, 4),      // 0.2929
    4
);
// 0.0001
MathConverter::binToHex($sub);
// 302e30303031

Описание проекта

CSE HELPERS - это набор из небольших библиотек с простыми функциями написанных на PHP специально для вас.

Несмотря на повсеместное использование PHP в качестве основного языка для WEB разработки, его зачастую недостаточно. MATH CONVERTER CSE HELPERS предоставляет функионал для преобразования чисел.

CSE HELPERS создан для быстрой разработки веб-приложений.

Список библиотек CSE Helpers:

Ниже представлена информация об установке и перечне команд с примерами их использования.

Установка

Самая последняя версия проекта доступна здесь.

Composer

Чтобы установить последнюю версию проекта, выполните следующую команду в терминале:

composer require cse/helpers-math-converter

Или добавьте следующее содержимое в файл composer.json:

{
    "require": {
        "cse/helpers-math-converter": "*"
    }
}

Git

Добавить этот репозиторий локально можно следующим образом:

git clone https://github.com/cs-eliseev/helpers-math-converter.git

Скачать

Скачать последнюю версию проекта можно здесь.

Использование

Данный класс использует статические методы, которые удобно использовать в любом проекте. Смотрите пример examples-math-converter.php.

Преобразовать хекс код в бинарные данные

Пример:

MathConverter::hexToBin('48454c4c4f');
// HELLO

Преобразовать бинарные данные в хекс код

Пример:

MathConverter::binToHex('HELLO');
// 48454c4c4f

Пробразовать мегабайты в байты

Пример:

MathConverter::mbToBytes(1);
// 1048576

Преобразовать байты в мегабайты

Пример:

MathConverter::bytesToMb(1048576);
// 1

Изменить количество знаков после запятой:

MathConverter::bytesToMb(1000000, 4);
// 0.9537

Преобразовать гагабайты в байты

Пример:

MathConverter::gbToBytes(1);
// 1073741824

Преобразовать байты в гагабайты

Пример:

MathConverter::bytesToGb(1073741824);
// 1

Изменить количество знаков после запятой:

MathConverter::bytesToGb(1000000000, 4);
// 0.9313

Преобразовать гагабайты в мегабайты

Пример:

MathConverter::gbToMb(1);
// 1024

Преобразовать мегабайты в гагабайты

Пример:

MathConverter::mbToGb(1024);
// 1

Изменить количество знаков после запятой:

MathConverter::mbToGb(1000, 4);
// 0.9766

Преобразовать в мегабайты

Пример:

MathConverter::toMb('1M');
// 1

Преобразовать петабайты в мегабайты:

MathConverter::toMb('0.001P');
// 1073741.824

Преобразовать терабайты в мегабайты:

MathConverter::toMb('0.1T');
// 104857.6.824

Преобразовать гигабайты в мегабайты:

MathConverter::toMb('1G');
// 1024

Преобразовать килобайты в мегабайты:

MathConverter::toMb('1000K');
// 0.9765625

Преобразовать байты в мегабайты:

MathConverter::toMb('1000000B');
// 0.95367431640625

Отбрость часть оостатка

Пример:

MathConverter::cutDecimal(11.726);
// 11.72

Изменить количество знаков после запятой:

MathConverter::cutDecimal('-67.099', 1);
// -67

Округление остатка

Пример:

MathConverter::roundDecimal(11.726);
// 11.73

Изменить количество знаков после запятой:

MathConverter::roundDecimal('-67.099', 0);
// -67

Тестирование и покрытие кода

PHPUnit используется для модульного тестирования. Данные тесты гарантируют, что методы класса выполняют свою задачу.

Подробную документацию по PHPUnit можно найти по адресу: https://phpunit.de/documentation.html.

Чтобы запустить тесты выполните:

phpunit PATH/TO/PROJECT/tests/

Чтобы сформировать отчет о покрытии тестами кода, необходимо выполнить следующую команду:

phpunit --coverage-html ./report PATH/TO/PROJECT/tests/

Чтобы использовать настройки по умолчанию, достаточно выполнить:

phpunit --configuration PATH/TO/PROJECT/phpunit.xml

Вклад в общее дело

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

Лицензия

MATH CONVERTER CSE HELPERS это PHP-библиотека с открытым исходным кодом распространяемая по лицензии MIT. Для получения более подробной информации, пожалуйста, ознакомьтесь с лицензионным файлом.


GitHub @cs-eliseev