defmodule XDR.DoubleFloat do @behaviour XDR.Declaration @moduledoc """ This module is in charge of process the Double-Precision Floating-Point types based on the RFC4506 XDR Standard """ defstruct float: nil @typedoc """ Every double float structure has a float which represent the Double-Precision Floating-Point value which you try to encode """ @type t :: %XDR.DoubleFloat{float: integer | float | binary} alias XDR.Error.DoubleFloat @doc """ this function provides an easy way to create an XDR.DoubleFloat type returns a XDR.DoubleFloat struct with the value received as parameter """ @spec new(float :: float | integer | binary) :: t() def new(float), do: %XDR.DoubleFloat{float: float} defguard valid_float?(value) when is_float(value) or is_integer(value) @impl XDR.Declaration @doc """ this function is in charge of encoding a Double Floating Point value into an XDR if the parameters are wrong an error will be raised, it receives an XDR.DoubleFloat structure which contains the Double-Precision Floating-Point to encode Returns a tuple with the XDR resulted from encoding the Double Floating Point value """ @spec encode_xdr(t()) :: {:ok, binary()} | {:error, :not_number} def encode_xdr(%XDR.DoubleFloat{float: float}) when not valid_float?(float), do: {:error, :not_number} def encode_xdr(%XDR.DoubleFloat{float: float}), do: {:ok, <>} @impl XDR.Declaration @doc """ this function is in charge of encoding a Double Floating Point value into an XDR if the parameters are wrong an error will be raised, it receives an XDR.DoubleFloat structure which contains the Double-Precision Floating-Point to encode Returns the XDR resulted from encoding the Double Floating Point value """ @spec encode_xdr!(t()) :: binary() def encode_xdr!(float) do case encode_xdr(float) do {:ok, binary} -> binary {:error, reason} -> raise(DoubleFloat, reason) end end @impl XDR.Declaration @doc """ This function is in charge of decode the XDR value which represents an Double Floating Point value if the parameters are wrong an error will be raised, it receives an XDR.DoubleFloat structure which contanis the binary to decode Returns a tuple with the Double Floating Point resulted from decode the XDR value and its remaining bits """ @spec decode_xdr(bytes :: binary, opts :: any) :: {:ok, {t(), binary()}} | {:error, :not_binary} def decode_xdr(bytes, opts \\ nil) def decode_xdr(bytes, _opts) when not is_binary(bytes), do: {:error, :not_binary} def decode_xdr(bytes, _opts) do <> = bytes decoded_float = new(float) {:ok, {decoded_float, rest}} end @impl XDR.Declaration @doc """ This function is in charge of decode the XDR value which represents an Double Floating Point value if the parameters are wrong an error will be raised, it receives an XDR.DoubleFloat structure which contanis the binary to decode Returns the Double Floating Point resulted from decode the XDR value and its remaining bits """ @spec decode_xdr!(bytes :: binary, opts :: any) :: {t(), binary()} def decode_xdr!(bytes, opts \\ nil) def decode_xdr!(bytes, opts) do case decode_xdr(bytes, opts) do {:ok, result} -> result {:error, reason} -> raise(DoubleFloat, reason) end end end