Struct pgnumeric::Numeric

#[repr(transparent)]pub struct Numeric { /* fields omitted */ }

A slice of a numeric.

This is an unsized type, meaning that it must always be used behind a pointer like & or Box. For an owned version of this type, see NumericBuf.

Implementations

impl Numeric

pub unsafe fn from_bytes_unchecked(value: &[u8]) -> &Numeric

Creates a Numeric from bytes slice.

Safety

Caller have to guaranteed the value bytes slice is a valid Numeric.

pub fn nan() -> &'static Numeric

Creates a NaN numeric.

pub fn zero() -> &'static Numeric

Creates a zero numeric.

pub fn as_bytes(&self) -> &[u8]

Extracts a byte slice contains the entire numeric.

pub fn is_nan(&self) -> bool

Checks if self is NaN.

pub fn is_negative(&self) -> bool

Checks if self is negative.

pub fn is_positive(&self) -> bool

Checks if self is positive.

pub fn scale(&self) -> Option<i32>

Returns the scale, i.e. the count of decimal digits in the fractional part.

Returns None if self is NaN.

pub fn negate(&self) -> NumericBuf

Negate this value.

pub fn signum(&self) -> NumericBuf

Returns a numeric that represents the sign of self.

• -1 if self is less than 0
• 0 if self is equal to 0
• 1 if self is greater than zero
• NaN if self is NaN

pub fn inc(&self) -> NumericBuf

Increment self by one.

Panics

Panics if overflows.

pub fn checked_add(&self, other: &Self) -> Option<NumericBuf>

Add two numerics, returning None if overflow occurred.

pub fn checked_sub(&self, other: &Self) -> Option<NumericBuf>

Subtract one numeric from another, returning None if overflow occurred.

pub fn checked_mul(&self, other: &Self) -> Option<NumericBuf>

Calculate the product of two numerics, returning None if overflow occurred.

pub fn checked_div(&self, other: &Self) -> Option<NumericBuf>

Checked numeric division. Computes self / other, returning None if other == 0 or the division results in overflow.

pub fn checked_div_trunc(&self, other: &Self) -> Option<NumericBuf>

Computes self / other, truncating the result to an integer.

Returns None if other == 0 or the division results in overflow.

pub fn checked_rem(&self, other: &Self) -> Option<NumericBuf>

Checked numeric remainder. Computes self % other, returning None if rhs == 0 or the division results in overflow.

pub fn round(&self, scale: i32) -> NumericBuf

Round a value to have scale digits after the decimal point. We allow negative scale, implying rounding before the decimal point --- Oracle interprets rounding that way.

Panics

Panics if overflows.

pub fn trunc(&self, scale: i32) -> NumericBuf

Truncate a value to have scale digits after the decimal point. We allow negative scale, implying a truncation before the decimal point --- Oracle interprets truncation that way.

pub fn ceil(&self) -> NumericBuf

Return the smallest integer greater than or equal to the argument.

Panics

Panics if overflows.

pub fn floor(&self) -> NumericBuf

Return the largest integer equal to or less than the argument.

Panics

Panics if overflows.

pub fn abs(&self) -> NumericBuf

Compute the absolute value of self.

pub fn sqrt(&self) -> NumericBuf

Compute the square root of a numeric.

Panics

Panics if self is negative.

pub fn ln(&self) -> NumericBuf

Compute the natural logarithm of self.

Panics

Panics if self <= 0.

pub fn log(&self, base: &Self) -> NumericBuf

Compute the logarithm of self in a given base.

Panics

Panics if self <= 0 or base <= 0.

pub fn log2(&self) -> NumericBuf

Compute the base 2 logarithm of self.

Panics

Panics if self <= 0.

pub fn log10(&self) -> NumericBuf

Compute the base 10 logarithm of self.

Panics

Panics if self <= 0.

pub fn exp(&self) -> Option<NumericBuf>

Raise e to the power of self (e^(self)).

Returns None if overflows.

pub fn pow(&self, exp: &Self) -> Option<NumericBuf>

Raise self to the power of exp.

Returns None if overflows.

Panics

if arguments are invalid:

• self is zero and exp is less than zero
• self is less than zero and exp is not a integer.

pub fn normalize(&self) -> String

Returns a normalized string, suppressing insignificant trailing zeroes and then any trailing decimal point.

The intent of this is to produce strings that are equal if and only if the input numeric values compare equal.

Trait Implementations

impl<'_, '_> Add<&'_ Numeric> for &'_ NumericBuf

type Output = NumericBuf

The resulting type after applying the + operator.

fn add(self, other: &Numeric) -> Self::Output

Performs the + operation.

impl<'_> Add<&'_ Numeric> for NumericBuf

type Output = NumericBuf

The resulting type after applying the + operator.

fn add(self, other: &Numeric) -> Self::Output

Performs the + operation.

impl<'_, '_> Add<&'_ Numeric> for &'_ Numeric

type Output = NumericBuf

The resulting type after applying the + operator.

fn add(self, other: &Numeric) -> Self::Output

Performs the + operation.

impl<'_, '_> Add<&'_ NumericBuf> for &'_ Numeric

type Output = NumericBuf

The resulting type after applying the + operator.

fn add(self, other: &NumericBuf) -> Self::Output

Performs the + operation.

impl<'_> Add<NumericBuf> for &'_ Numeric

type Output = NumericBuf

The resulting type after applying the + operator.

fn add(self, other: NumericBuf) -> Self::Output

Performs the + operation.

impl<'_> AddAssign<&'_ Numeric> for NumericBuf

fn add_assign(&mut self, other: &Numeric)

Performs the += operation.

impl AsRef<Numeric> for NumericBuf

fn as_ref(&self) -> &Numeric

Performs the conversion.

impl Borrow<Numeric> for NumericBuf

fn borrow(&self) -> &Numeric

Immutably borrows from an owned value.

impl Debug for Numeric

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Numeric

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'_, '_> Div<&'_ Numeric> for &'_ NumericBuf

type Output = NumericBuf

The resulting type after applying the / operator.

fn div(self, other: &Numeric) -> Self::Output

Performs the / operation.

impl<'_> Div<&'_ Numeric> for NumericBuf

type Output = NumericBuf

The resulting type after applying the / operator.

fn div(self, other: &Numeric) -> Self::Output

Performs the / operation.

impl<'_, '_> Div<&'_ Numeric> for &'_ Numeric

type Output = NumericBuf

The resulting type after applying the / operator.

fn div(self, other: &Numeric) -> Self::Output

Performs the / operation.

impl<'_, '_> Div<&'_ NumericBuf> for &'_ Numeric

type Output = NumericBuf

The resulting type after applying the / operator.

fn div(self, other: &NumericBuf) -> Self::Output

Performs the / operation.

impl<'_> Div<NumericBuf> for &'_ Numeric

type Output = NumericBuf

The resulting type after applying the / operator.

fn div(self, other: NumericBuf) -> Self::Output

Performs the / operation.

impl<'_> DivAssign<&'_ Numeric> for NumericBuf

fn div_assign(&mut self, other: &Numeric)

Performs the /= operation.

impl Eq for Numeric

impl<'a> From<&'a Numeric> for Cow<'a, Numeric>

fn from(n: &'a Numeric) -> Cow<'a, Numeric>

Performs the conversion.

impl Hash for Numeric

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl LowerExp for Numeric

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'_, '_> Mul<&'_ Numeric> for &'_ Numeric

type Output = NumericBuf

The resulting type after applying the * operator.

fn mul(self, other: &Numeric) -> Self::Output

Performs the * operation.

impl<'_> Mul<&'_ Numeric> for NumericBuf

type Output = NumericBuf

The resulting type after applying the * operator.

fn mul(self, other: &Numeric) -> Self::Output

Performs the * operation.

impl<'_, '_> Mul<&'_ Numeric> for &'_ NumericBuf

type Output = NumericBuf

The resulting type after applying the * operator.

fn mul(self, other: &Numeric) -> Self::Output

Performs the * operation.

impl<'_, '_> Mul<&'_ NumericBuf> for &'_ Numeric

type Output = NumericBuf

The resulting type after applying the * operator.

fn mul(self, other: &NumericBuf) -> Self::Output

Performs the * operation.

impl<'_> Mul<NumericBuf> for &'_ Numeric

type Output = NumericBuf

The resulting type after applying the * operator.

fn mul(self, other: NumericBuf) -> Self::Output

Performs the * operation.

impl<'_> MulAssign<&'_ Numeric> for NumericBuf

fn mul_assign(&mut self, other: &Numeric)

Performs the *= operation.

impl<'_> Neg for &'_ Numeric

type Output = NumericBuf

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl Ord for Numeric

fn cmp(&self, other: &Self) -> Ordering

This method returns an [Ordering] between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl<'_> PartialEq<&'_ Numeric> for NumericBuf

fn eq(&self, other: &&Numeric) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_> PartialEq<&'_ Numeric> for Numeric

fn eq(&self, other: &&Numeric) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<Numeric> for Numeric

fn eq(&self, other: &Numeric) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<Numeric> for NumericBuf

fn eq(&self, other: &Numeric) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_> PartialEq<Numeric> for &'_ Numeric

fn eq(&self, other: &Numeric) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<NumericBuf> for Numeric

fn eq(&self, other: &NumericBuf) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_> PartialEq<NumericBuf> for &'_ Numeric

fn eq(&self, other: &NumericBuf) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_> PartialOrd<&'_ Numeric> for NumericBuf

fn partial_cmp(&self, other: &&Numeric) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'_> PartialOrd<&'_ Numeric> for Numeric

fn partial_cmp(&self, other: &&Numeric) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<Numeric> for Numeric

fn partial_cmp(&self, other: &Numeric) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<Numeric> for NumericBuf

fn partial_cmp(&self, other: &Numeric) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'_> PartialOrd<Numeric> for &'_ Numeric

fn partial_cmp(&self, other: &Numeric) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<NumericBuf> for Numeric

fn partial_cmp(&self, other: &NumericBuf) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'_> PartialOrd<NumericBuf> for &'_ Numeric

fn partial_cmp(&self, other: &NumericBuf) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'_, '_> Rem<&'_ Numeric> for &'_ NumericBuf

type Output = NumericBuf

The resulting type after applying the % operator.

fn rem(self, other: &Numeric) -> Self::Output

Performs the % operation.

impl<'_> Rem<&'_ Numeric> for NumericBuf

type Output = NumericBuf

The resulting type after applying the % operator.

fn rem(self, other: &Numeric) -> Self::Output

Performs the % operation.

impl<'_, '_> Rem<&'_ Numeric> for &'_ Numeric

type Output = NumericBuf

The resulting type after applying the % operator.

fn rem(self, other: &Numeric) -> Self::Output

Performs the % operation.

impl<'_, '_> Rem<&'_ NumericBuf> for &'_ Numeric

type Output = NumericBuf

The resulting type after applying the % operator.

fn rem(self, other: &NumericBuf) -> Self::Output

Performs the % operation.

impl<'_> Rem<NumericBuf> for &'_ Numeric

type Output = NumericBuf

The resulting type after applying the % operator.

fn rem(self, other: NumericBuf) -> Self::Output

Performs the % operation.

impl<'_> RemAssign<&'_ Numeric> for NumericBuf

fn rem_assign(&mut self, other: &Numeric)

Performs the %= operation.

impl<'_, '_> Sub<&'_ Numeric> for &'_ Numeric

type Output = NumericBuf

The resulting type after applying the - operator.

fn sub(self, other: &Numeric) -> Self::Output

Performs the - operation.

impl<'_> Sub<&'_ Numeric> for NumericBuf

type Output = NumericBuf

The resulting type after applying the - operator.

fn sub(self, other: &Numeric) -> Self::Output

Performs the - operation.

impl<'_, '_> Sub<&'_ Numeric> for &'_ NumericBuf

type Output = NumericBuf

The resulting type after applying the - operator.

fn sub(self, other: &Numeric) -> Self::Output

Performs the - operation.

impl<'_, '_> Sub<&'_ NumericBuf> for &'_ Numeric

type Output = NumericBuf

The resulting type after applying the - operator.

fn sub(self, other: &NumericBuf) -> Self::Output

Performs the - operation.

impl<'_> Sub<NumericBuf> for &'_ Numeric

type Output = NumericBuf

The resulting type after applying the - operator.

fn sub(self, other: NumericBuf) -> Self::Output

Performs the - operation.

impl<'_> SubAssign<&'_ Numeric> for NumericBuf

fn sub_assign(&mut self, other: &Numeric)

Performs the -= operation.

impl ToOwned for Numeric

type Owned = NumericBuf

The resulting type after obtaining ownership.

fn to_owned(&self) -> NumericBuf

Creates owned data from borrowed data, usually by cloning.

fn clone_into(&self, target: &mut Self::Owned)

🔬 This is a nightly-only experimental API. (toowned_clone_into)

recently added

Uses borrowed data to replace owned data, usually by cloning.

impl<'_> TryFrom<&'_ Numeric> for i8

type Error = NumericTryFromError

The type returned in the event of a conversion error.

fn try_from(value: &Numeric) -> Result<Self, Self::Error>

Performs the conversion.

impl<'_> TryFrom<&'_ Numeric> for i16

type Error = NumericTryFromError

The type returned in the event of a conversion error.

fn try_from(value: &Numeric) -> Result<Self, Self::Error>

Performs the conversion.

impl<'_> TryFrom<&'_ Numeric> for isize

type Error = NumericTryFromError

The type returned in the event of a conversion error.

fn try_from(value: &Numeric) -> Result<Self, Self::Error>

Performs the conversion.

impl<'_> TryFrom<&'_ Numeric> for usize

type Error = NumericTryFromError

The type returned in the event of a conversion error.

fn try_from(value: &Numeric) -> Result<Self, Self::Error>

Performs the conversion.

impl<'_> TryFrom<&'_ Numeric> for f32

type Error = NumericTryFromError

The type returned in the event of a conversion error.

fn try_from(value: &Numeric) -> Result<Self, Self::Error>

Performs the conversion.

impl<'_> TryFrom<&'_ Numeric> for f64

type Error = NumericTryFromError

The type returned in the event of a conversion error.

fn try_from(value: &Numeric) -> Result<Self, Self::Error>

Performs the conversion.

impl<'_> TryFrom<&'_ Numeric> for i32

type Error = NumericTryFromError

The type returned in the event of a conversion error.

fn try_from(value: &Numeric) -> Result<Self, Self::Error>

Performs the conversion.

impl<'_> TryFrom<&'_ Numeric> for i64

type Error = NumericTryFromError

The type returned in the event of a conversion error.

fn try_from(value: &Numeric) -> Result<Self, Self::Error>

Performs the conversion.

impl<'_> TryFrom<&'_ Numeric> for i128

type Error = NumericTryFromError

The type returned in the event of a conversion error.

fn try_from(value: &Numeric) -> Result<Self, Self::Error>

Performs the conversion.

impl<'_> TryFrom<&'_ Numeric> for u8

type Error = NumericTryFromError

The type returned in the event of a conversion error.

fn try_from(value: &Numeric) -> Result<Self, Self::Error>

Performs the conversion.

impl<'_> TryFrom<&'_ Numeric> for u16

type Error = NumericTryFromError

The type returned in the event of a conversion error.

fn try_from(value: &Numeric) -> Result<Self, Self::Error>

Performs the conversion.

impl<'_> TryFrom<&'_ Numeric> for u32

type Error = NumericTryFromError

The type returned in the event of a conversion error.

fn try_from(value: &Numeric) -> Result<Self, Self::Error>

Performs the conversion.

impl<'_> TryFrom<&'_ Numeric> for u64

type Error = NumericTryFromError

The type returned in the event of a conversion error.

fn try_from(value: &Numeric) -> Result<Self, Self::Error>

Performs the conversion.

impl<'_> TryFrom<&'_ Numeric> for u128

type Error = NumericTryFromError

The type returned in the event of a conversion error.

fn try_from(value: &Numeric) -> Result<Self, Self::Error>

Performs the conversion.

impl UpperExp for Numeric

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.