num_ex

defmodule Decimal_ do
  @moduledoc"""
  A module to perform operations on decimal values
  """

  @doc"""
  Takes two Decimal values and compares them; returns "-1" if the first element is less than the second,
  "1" if it is greater and "0" if the elements are equal

  ## Examples

      iex> Decimal_.compare(1, 5)
      -1
      iex> Decimal_.compare(1, -5)
      1
      iex> Decimal_.compare(4, 4)
      0
  """
  @spec compare(integer, integer) :: integer
  def compare(n,m) do
      cond do
        n < m -> -1
        n == m -> 0
        n > m -> 1
      end
   end

   @doc"""
   Takes two Decimal values and compares them; returns "-1" if the first element is less than the second,
   "1" if it is greater and "0" if the elements are equal. However it helps comparing values like 1 and 1.0

   ## Examples


       iex> Decimal_.compare_total(1, 5)
       -1
       iex> Decimal_.compare_total(1, -5)
       1
       iex> Decimal_.compare_total(4, 4)
       0
       iex> Decimal_.compare_total(1, 1.0)
       -1
   """
   @spec compare_total(integer, integer) :: integer
  def compare_total(n,m) do
       cond do
         n < m -> -1
         n === m -> 0
         n > m -> 1
         true -> -1
       end
  end

  @doc"""
  Takes a Decimal value and returns if the value is signed

  ## Examples

      iex> Decimal_.is_signed(10)
      false
      iex> Decimal_.is_signed(-10)
      true
      iex> Decimal_.is_signed(0)
      false
  """
  @spec is_signed(integer) :: boolean
  def is_signed(n), do: n < 0

  @doc"""
  Takes a Decimal value and returns its absolute value

  ## Examples

      iex> Decimal_.abs(15)
      15
      iex> Decimal_.abs(-32)
      32
  """
  @spec abs(integer) :: integer
  def abs(n) do
      if n < 0 do  -n
      else n
      end
  end

  @doc"""
  Takes three decimal values and performs fast multiplication and addition i.e,
  for the arguments i, j, k the function returns the value i * j + k

  ## Examples

      iex> Decimal_.fma(2, 3, -5)
      1
  """
  @spec fma(integer, integer, integer) :: integer
  def fma(i, j, k) do
  i * j + k
  end

end