From e53d99b2946d9a545e85e903d1cb3be0181f05b7 Mon Sep 17 00:00:00 2001
From: Michael Amrhein <michael@adrhinum.de>
Date: Tue, 12 Dec 2023 19:50:43 +0100
Subject: [PATCH] Release 0.9.0

fpdec@0.9.0

Generated by cargo-workspaces
---
 CHANGES.TXT |  2 ++
 Cargo.toml  |  2 +-
 README.md   | 32 +++++++++++++++++++++++++++++++-
 3 files changed, 34 insertions(+), 2 deletions(-)

diff --git a/CHANGES.TXT b/CHANGES.TXT
index ff88c57..23324b2 100644
--- a/CHANGES.TXT
+++ b/CHANGES.TXT
@@ -1,5 +1,7 @@
 Version   Changes
 --------  --------------------------------------------------------------------
+0.9.0     Added conversion of Decimal values to primitive ints and floats.
+
 0.8.0     Added optional support for zero-copy serialization via 'rkyv' (thx
           to den-mentiei).
 
diff --git a/Cargo.toml b/Cargo.toml
index f91dcda..bec9eff 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "fpdec"
-version = "0.8.1"
+version = "0.9.0"
 edition = "2021"
 authors = ["Michael Amrhein <michael@adrhinum.de>"]
 description = "Decimal fixed-point arithmetic."
diff --git a/README.md b/README.md
index ec41070..91f94df 100644
--- a/README.md
+++ b/README.md
@@ -25,7 +25,7 @@ Add `fpdec` to your `Cargo.toml`:
 
 ```toml
 [dependencies]
-fpdec = "0.8"
+fpdec = "0.9"
 ```
 
 ## Usage
@@ -152,6 +152,36 @@ let z: Decimal = x.div_rounded(y, 3);
 assert_eq!(z.to_string(), "2.705");
 ```
 
+A `Decimal` value can be converted into a float, maybe rounded to the nearest 
+value representable by the target type:
+
+```rust
+# use fpdec::{Dec, Decimal};
+let d = Dec!(-33820900478.195);
+let f = f64::from(d);
+assert_eq!(f, -33820900478.19499969482421875_f64);
+let f = f32::from(Dec!(0.6));
+assert_eq!(f, 0.60000002384185791015625_f32);
+```
+
+Converting a `Decimal` value to a primitive int is more intricate. It is only 
+supported by try_from / try_into and only giving a value of the target type,
+if the given value represents an integral value fitting the range of values of
+the target type.
+
+```rust
+# use fpdec::{Dec, Decimal, TryFromDecimalError};
+let d = Dec!(3.7);
+let res = i32::try_from(d);
+assert!(res.is_err());
+assert_eq!(res.unwrap_err(), TryFromDecimalError::NotAnIntValue);
+let d = Decimal::MAX;
+let res = i128::try_from(d);
+assert_eq!(res.unwrap(), i128::MAX);
+let res = i64::try_from(d);
+assert!(res.is_err());
+assert_eq!(res.unwrap_err(), TryFromDecimalError::ValueOutOfRange);
+```
 ## Crate features
 
 By default, only the feature `std` is enabled.