Git Product home page Git Product logo

bcmath's Introduction

BC::math

Software License Gitter

Latest Version Build Status Codecov Total Downloads

PHP bcmath as a static class, with several enhancements.

Installation

Use Composer:

composer require danhunsaker/bcmath

Usage

Usage is nearly identical to the bcmath extension functions. The main difference is that the bc prefix is replaced by the Danhunsaker\BC class name (which you can easily alias in your project(s) via use Danhunsaker\BC).

In other words:

There are also some additional convenience methods available, that aren't present in the extension:

  • BC::epow() raises e to the argument's power.
  • BC::fact() calculates the factorial of the argument.
  • BC::intval() truncates the fractional portion of the argument, if any.
  • BC::ln() gives the natural logarithm of the argument.
  • BC::log() gives the base 10 logarithm of the argument (uses ln $val/ln 10).
  • BC::max() returns the largest value in an array (the first argument).
  • BC::min() returns the smallest value in an array (the first argument).
  • BC::modfrac() behaves exactly like BC::mod(), except it will return the fractional part of any remainder as well as the integer part.
  • BC::powfrac() supports fractional exponents, allowing roots other than the square to be calculated.
  • BC::root() is a complement to BC::powfrac(), and is in fact just a convenience wrapper for it.
  • BC::round() rounds a value to a given scale.

Expression Parser

There's also BC::parse(), which lets you write your calculations as expressions instead of method calls. It doesn't (yet) support everything available via method calls, but this is planned for a later release. For the moment, here's a list of which ones are supported, and how to specify each in your expressions:

  • BC::add(a, b) => 'a + b'
  • BC::div(a, b) => 'a / b'
  • BC::div(a, b, 0) => 'a \ b'
  • BC::mod(a, b) => 'a % b'
  • BC::modfrac(a, b) => 'a %% b'
  • BC::mul(BC::div(a, b, 0), b) => 'a \* b'
  • BC::sub(a, BC::mod(a, b)) => 'a -% b'
  • BC::mul(a, b) => 'a * b'
  • BC::pow(a, b) => 'a ** b'
  • BC::powfrac(a, b) => 'a ^ b'
  • BC::sub(a, b) => 'a - b'

There are also some logical expressions available, all of which will return a boolean value (true/false) instead of a number:

  • BC::comp(a, b) == 0 => 'a = b' or 'a == b'
  • BC::comp(a, b) == 1 => 'a > b'
  • BC::comp(a, b) == -1 => 'a < b'
  • BC::comp(a, b) >= 0 => 'a >= b'
  • BC::comp(a, b) <= 0 => 'a <= b'
  • BC::comp(a, b) != 0 => 'a != b' or 'a <> b'
  • a and b => 'a & b' or 'a && b'
  • a or b => 'a | b' or 'a || b'
  • a xor b => 'a ~ b' or 'a ~~ b'

The expression parser recognizes parentheses, so you can use those to group your subexpressions as needed. It also supports variables:

BC::parse('{m} * {x} + {b}', ['m' => 0.5, 'x' => 5, 'b' => 0]);

Need to specify a scale for your expression? No problem, just pass it along in the third parameter:

BC::parse('{m} * {x} + {b}', ['m' => 0.5, 'x' => 5, 'b' => 0], 18);

You can, of course, skip the variable list by passing null as the second argument:

BC::parse('{m} * {x} + {b}', null, 18);

// Any unrecognized variables are assumed to be zero,
// so the above is the same as:

BC::parse('0 * 0 + 0', null, 18);

Contributions

Contributions are welcome at any time on GitHub.

Security issues should be reported directly to Dan Hunsaker via email.

bcmath's People

Contributors

danhunsaker avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.