README.md

RationalNumeric

Struct, Rational to represent a rational number with a numerator and denominator.

Features

RationalNumeric represents types that have a numerator and a denominator and support basic math operations by implementing the protocol SignedNumeric through the protocol RationalNumeric. Its usefully when you need to deal with ratios without loss of precission.

The sole type of RationalNumeric is Rational, Rational will always be reduce to its simplest form, as a consequence the initialiser of the form `Rational(Int,Int) can potentially be slow finding the largest common division for the numerator and denominator. Requires Swift 4.2.

Including in your project

To included RationalNumeric in your project, add the files within the folder Type to your project.

Examples

Creating a Rational number

let a = Rational(1,2);
print(a)
// 1/2

let b = Rational(2,4);	
print(b)
// 1/2

let d = Rational(5);	
print(d)
// 5

let f : Rational = 7;	
print(f)
// 7

Rational math

let a = Rational(1,2);
let b = Rational(2,5);

let mul = a*b;
print(mul)
// 1/5

let add = a+b;
print(add)
// 9/10

let div = a/b;
print(div)
// 5/4

let sub = a-b;
print(sub)
// 1/10

Comparing two Rational numbers

let a = Rational(1,2);
let b = Rational(3,6);

print(a==b)
// true

print(a<b)
// false

Getting the numerator and denominator of a Rational numbers

let a = Rational(12,18);

print(a.numerator)
// 2

print(a.denominator)
// 3

Creating a Rational from a floating point number

let a = Rational( 0.251, maxDenominator: 16 );
print(a)
// 1/4

let b = Rational( 0.251, maxDenominator: 256 )
print(a)
// 63/251

Converting a Rational to other Types

let a = Rational( 3,2 );

let d = Double(a);
print(d)
// 1.5

let i = Int(a);
print(i)
// 1

let s = String(a);
print(s)
// "3/2"

License

This project is licensed under the MIT-style license, see source files