BigInt

Infinite digits integers

From/To

Makes a BigInt from an Int

Makes a BigInt from an integer string, positive or negative

fromString "123" == Just (BigInt.Pos ...)
fromString "-123" == Just (BigInt.Neg ...)
fromString "" == Nothing
fromString "this is not a number :P" == Nothing

fromHexString : String -> Maybe BigInt

Makes a BigInt from a base16 hex string, positive or negative.

fromHexString "456" == Just (BigInt.Pos ...)
fromHexString "-123" == Just (BigInt.Neg ...)


fromHexString "0x456" == Just (BigInt.Pos ...)
fromHexString "-0x123" == Just (BigInt.Neg ...)


fromHexString "R2D2" == Nothing
fromHexString "0xC3P0" == Nothing
fromHexString "0x" == Nothing
fromHexString "" == Nothing

Note: String can be prepended with or without any combination of "0x", and "+" or "-".

toString : BigInt -> String

Convert the BigInt to an integer string

toHexString : BigInt -> String

Convert the BigInt to a hex string.

toHexString (BigInt.fromInt 255) == "ff"

Note: "0x" will NOT be prepended to the output.

Operations

add : BigInt -> BigInt -> BigInt

Adds two BigInts

sub : BigInt -> BigInt -> BigInt

Substracts the second BigInt from the first

mul : BigInt -> BigInt -> BigInt

Multiplies two BigInts

div : BigInt -> BigInt -> BigInt

BigInt division. Produces 0 when dividing by 0 (like (//)).

modBy : BigInt -> BigInt -> Maybe BigInt

Modulus.

modBy (BigInt.fromInt 3) (BigInt.fromInt 3)

divmod : BigInt -> BigInt -> Maybe ( BigInt, BigInt )

Division and modulus

pow : BigInt -> BigInt -> BigInt

Power/Exponentiation.

Sign

abs : BigInt -> BigInt

Absolute value

negate : BigInt -> BigInt

Changes the sign of an BigInt

Comparison

compare : BigInt -> BigInt -> Order

Compares two BigInts

gt : BigInt -> BigInt -> Bool

Greater than

gte : BigInt -> BigInt -> Bool

Greater than or equals

lt : BigInt -> BigInt -> Bool

Less than

lte : BigInt -> BigInt -> Bool

Less than or equals

max : BigInt -> BigInt -> BigInt

Returns the largest of two BigInts

min : BigInt -> BigInt -> BigInt

Returns the smallest of two BigInts

Misc

isEven : BigInt -> Bool

Parity Check - Even.

isOdd : BigInt -> Bool

Parity Check - Odd.

Modules

BigInt

cmditch/elm-bigint/1.0.1