{-
	Copyright (C) 2018 Dr. Alistair Ward

	This file is part of BishBosh.

	BishBosh is free software: you can redistribute it and/or modify
	it under the terms of the GNU General Public License as published by
	the Free Software Foundation, either version 3 of the License, or
	(at your option) any later version.

	BishBosh is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
	GNU General Public License for more details.

	You should have received a copy of the GNU General Public License
	along with BishBosh.  If not, see <http://www.gnu.org/licenses/>.
-}
{- |
 [@AUTHOR@]	Dr. Alistair Ward

 [@DESCRIPTION@]	An interface for floating-point data, which provides an alterative to 'Show'.
-}

module BishBosh.Property.ShowFloat(
-- * Type-classes
	ShowFloat(..),
-- * Types
-- ** Type-synonyms
	NDecimalDigits,
-- * Functions
	showsFloatToN
) where

import qualified	Numeric

-- | A number of decimals digits.
type NDecimalDigits	= Int

-- | An alternative to 'Show', for floating-point data.
class ShowFloat a where
	showsFloat	:: (Double -> ShowS) -> a -> ShowS

-- | Render the specified data to the specified number of decimal digits.
showsFloatToN :: ShowFloat a => NDecimalDigits -> a -> ShowS
showsFloatToN nDecimalDigits	= showsFloat (Numeric.showFFloat $ Just nDecimalDigits)