# Phospr Fraction

[![Build Status](https://travis-ci.org/phospr/fraction.svg)](https://travis-ci.org/phospr/fraction)
[![Coverage Status](https://coveralls.io/repos/github/phospr/fraction/badge.svg?branch=master)](https://coveralls.io/github/phospr/fraction?branch=master)

Composer-installable fractions for PHP

## Usage

```php
use Phospr\Fraction;
```

#### Simple Fractions

```php
echo new Fraction(1, 2); // 1/2
echo new Fraction(5, 2); // 2 1/2
```

#### Create Fraction from string

```php
echo Fraction::fromString('1 2/3'); // 1 2/3
echo Fraction::fromString('28/4'); // 7
```

#### Create Fraction from float

```php
echo Fraction::fromFloat(1.5); // 1 1/2
```

#### Auto-simplified

Fractions are simplified at construction

```php
echo new Fraction(4, 6); // 2/3
```

#### Addition

```php
$fraction = new Fraction(2, 7);
echo $fraction->add(new Fraction(3, 11)); // 43/77
```

#### Subtraction

```php
$fraction = new Fraction(6);
echo $fraction->subtract(new Fraction(2, 3)); // 5 1/3
```

#### Multiplication

```php
$fraction = new Fraction(1, 2);
echo $fraction->multiply(new Fraction(1, 2)); // 1/4
```

#### Division

```php
$fraction = new Fraction(6, 13);
echo $fraction->divide(new Fraction(2, 7)); // 1 8/13
```

#### To Float

```php
$fraction = new Fraction(1, 8);
$fraction->toFloat(); // 0.125
```

#### Is Integer?

Check whether a fraction is in fact a whole number.

```php
$fraction = new Fraction(1, 8);
$fraction->isInteger(); // false

$fraction = new Fraction(16, 8);
$fraction->isInteger(); // true
```

## Installation

Add package to your composer.json file

```json

{
    "require": {
        "phospr/fraction": "dev-master"
    }
}
```