indique/elm-bounded-nat/8.0.1

NOTE: the latest version is 13.0.0

Nat.Bound

Min

type Min minimum

Min minimum: At least minimum.

   ↓ minimum
⨯ [✓ ✓ ✓ ✓ ✓ ✓ ✓...

Any natural number:

Nat (Min Nat0)

A number, at least 5:

Nat (Min Nat5)

In

type In minimum maximum

In minimum maximum: Somewhere within a minimum & maximum.

   ↓ minimum   ↓ maximum
⨯ [✓ ✓ ✓ ✓ ✓ ✓ ✓] ⨯ ⨯ ⨯...

Note: maximum >= minimum for every existing Nat (In ...):

percent : Nat (In minimum Nat100)

→ minimum <= Nat100

Only

type alias Only n =
In n n

Just the exact number.

Only useful in function annotations.

byte : Arr (Only Nat8) Bit -> Byte

→ A given Arr must have exact 8 Bits.

repeat : Nat (Only n) -> element -> Arr (Only n)


repeat (Nat.N.toIn nat6) "ok"
--> Arr (Only Nat6)

→ repeating an element n times will give you a Arr of n elements.

→ Every In NatXYZ (NatXYZPlus a) is also a Only NatXYZ, but not the other way around

N

type N n difference otherDifference

The actual value is present in the type.

Looking at the type

nat0 :
    -- natural number
    Nat
        (N
            -- 0 is the exact value at compile time
            Nat0
            -- 0 as a difference is a - a & b - b
            (Is a To a)
            (Is b To b)
        )

An example is Nat.In.addN

addN :
    Nat (N added (Is min To sumMin) (Is max To sumMax))
    -> Nat (In min max)
    -> Nat (In sumMin sumMax)

You can just ignore the second difference if you don't need it (Nat.Min.addN).

addN :
    Nat (N added (Is min To sumMin) x)
    -> Nat (Min min)
    -> Nat (Min sumMin)

If you only want to ensure that it is within a minimum (& maximum), Min or In is the right choice! This is the better choice for most calculations.

type Is a to b

Describe an exact value as the diffference b - a.

N Nat5 (Is myAge To sistersAge) (Is mothersAge To fathersAge)
  • myAge + 5 = sistersAge
  • mothersAge + 5 = fathersAge
type To

No special meaning.

Is a To b