Use 'representable' rather than 'lies in domain'

Author: orlp

library/core/src/num/int_macros.rs

@@ -4085,7 +4085,7 @@ macro_rules! int_impl {
         }
 
         /// Converts `self` to the target integer type, returning `None` if the value
-        /// does not lie in the target type's domain.
+        /// is not representable by the target type.
         ///
         /// # Examples
         ///
@@ -4103,11 +4103,11 @@ macro_rules! int_impl {
         }
 
         /// Converts `self` to the target integer type, panicking if the value
-        /// does not lie in the target type's domain.
+        /// is not representable by the target type.
         ///
         /// # Panics
         ///
-        /// This function will panic if the value does not lie in the target type's domain.
+        /// This function will panic if the value is not representable by the target type.
         ///
         /// # Examples
         ///
@@ -4131,7 +4131,8 @@ macro_rules! int_impl {
             T::strict_cast_from(self)
         }
 
-        /// Converts `self` to the target integer type, assuming the value lies in the target type's domain.
+        /// Converts `self` to the target integer type, assuming the value is
+        /// representable by the target type.
         ///
         /// # Safety
         ///

library/core/src/num/uint_macros.rs

@@ -4257,7 +4257,7 @@ macro_rules! uint_impl {
         }
 
         /// Converts `self` to the target integer type, returning `None` if the value
-        /// does not lie in the target type's domain.
+        /// is not representable by the target type.
         ///
         /// # Examples
         ///
@@ -4275,11 +4275,11 @@ macro_rules! uint_impl {
         }
 
         /// Converts `self` to the target integer type, panicking if the value
-        /// does not lie in the target type's domain.
+        /// is not representable by the target type.
         ///
         /// # Panics
         ///
-        /// This function will panic if the value does not lie in the target type's domain.
+        /// This function will panic if the value is not representable by the target type.
         ///
         /// # Examples
         ///
@@ -4303,7 +4303,8 @@ macro_rules! uint_impl {
             T::strict_cast_from(self)
         }
 
-        /// Converts `self` to the target integer type, assuming the value lies in the target type's domain.
+        /// Converts `self` to the target integer type, assuming the value is
+        /// representable by the target type.
         ///
         /// # Safety
         ///