Type Alias Complex32

pub type Complex32 = Complex<f32>;

Alias for a Complex<f32>

Aliased Type

struct Complex32 {
    pub re: f32,
    pub im: f32,
}

Fields

re: f32

Real portion of the complex number

im: f32

Imaginary portion of the complex number

Implementations

impl<T: ConstZero> Complex<T>

pub const ZERO: Self = _

A constant Complex 0.

impl<T: ConstOne + ConstZero> Complex<T>

pub const ONE: Self = _

A constant Complex 1.

pub const I: Self = _

A constant Complex i, the imaginary unit.

impl<T> Complex<T>

pub const fn new(re: T, im: T) -> Self

Create a new Complex

impl<T: Clone + Num> Complex<T>

pub fn i() -> Self

Returns the imaginary unit.

See also Complex::I.

pub fn norm_sqr(&self) -> T

Returns the square of the norm (since T doesn’t necessarily have a sqrt function), i.e. re^2 + im^2.

pub fn scale(&self, t: T) -> Self

Multiplies self by the scalar t.

pub fn unscale(&self, t: T) -> Self

Divides self by the scalar t.

pub fn powu(&self, exp: u32) -> Self

Raises self to an unsigned integer power.

impl<T: Clone + Num + Neg<Output = T>> Complex<T>

pub fn conj(&self) -> Self

Returns the complex conjugate. i.e. re - i im

pub fn inv(&self) -> Self

Returns 1/self

pub fn powi(&self, exp: i32) -> Self

Raises self to a signed integer power.

impl<T: Clone + Signed> Complex<T>

pub fn l1_norm(&self) -> T

Returns the L1 norm |re| + |im| – the Manhattan distance from the origin.

impl<T: FloatCore> Complex<T>

pub fn is_nan(self) -> bool

Checks if the given complex number is NaN

pub fn is_infinite(self) -> bool

Checks if the given complex number is infinite

pub fn is_finite(self) -> bool

Checks if the given complex number is finite

pub fn is_normal(self) -> bool

Checks if the given complex number is normal

Trait Implementations

impl<'a, T: Clone + Num> Add<&'a Complex<T>> for Complex<T>

type Output = Complex<T>

The resulting type after applying the + operator.

fn add(self, other: &Complex<T>) -> Self::Output

Performs the + operation.

impl<'a, T: Clone + Num> Add<&'a T> for Complex<T>

type Output = Complex<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T: Clone + Num> Add<T> for Complex<T>

type Output = Complex<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T: Clone + Num> Add for Complex<T>

type Output = Complex<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<'a, T: Clone + NumAssign> AddAssign<&'a Complex<T>> for Complex<T>

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

Performs the += operation.

impl<'a, T: Clone + NumAssign> AddAssign<&'a T> for Complex<T>

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

Performs the += operation.

impl<T: Clone + NumAssign> AddAssign<T> for Complex<T>

fn add_assign(&mut self, other: T)

Performs the += operation.

impl<T: Clone + NumAssign> AddAssign for Complex<T>

fn add_assign(&mut self, other: Self)

Performs the += operation.

impl<T, U> AsPrimitive<U> for Complex<T>

where T: AsPrimitive<U>, U: 'static + Copy,

fn as_(self) -> U

Convert a value to another, using the as operator.

impl<T> Binary for Complex<T>

where T: Binary + Num + PartialOrd + Clone,

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

Formats the value using the given formatter.

impl<T: Clone> Clone for Complex<T>

fn clone(&self) -> Complex<T>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Clone + Num + ConstOne + ConstZero> ConstOne for Complex<T>

const ONE: Self = Self::ONE

The multiplicative identity element of Self, 1.

impl<T: Clone + Num + ConstZero> ConstZero for Complex<T>

const ZERO: Self = Self::ZERO

The additive identity element of Self, 0.

impl<T: Debug> Debug for Complex<T>

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

Formats the value using the given formatter.

impl<T: Default> Default for Complex<T>

fn default() -> Complex<T>

Returns the “default value” for a type.

impl<'de, T> Deserialize<'de> for Complex<T>

where T: Deserialize<'de>,

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> Display for Complex<T>

where T: Display + Num + PartialOrd + Clone,

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

Formats the value using the given formatter.

impl<'a, T: Clone + Num> Div<&'a Complex<T>> for Complex<T>

type Output = Complex<T>

The resulting type after applying the / operator.

fn div(self, other: &Complex<T>) -> Self::Output

Performs the / operation.

impl<'a, T: Clone + Num> Div<&'a T> for Complex<T>

type Output = Complex<T>

The resulting type after applying the / operator.

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

Performs the / operation.

impl<T: Clone + Num> Div<T> for Complex<T>

type Output = Complex<T>

The resulting type after applying the / operator.

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

Performs the / operation.

impl<T: Clone + Num> Div for Complex<T>

type Output = Complex<T>

The resulting type after applying the / operator.

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

Performs the / operation.

impl<'a, T: Clone + NumAssign> DivAssign<&'a Complex<T>> for Complex<T>

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

Performs the /= operation.

impl<'a, T: Clone + NumAssign> DivAssign<&'a T> for Complex<T>

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

Performs the /= operation.

impl<T: Clone + NumAssign> DivAssign<T> for Complex<T>

fn div_assign(&mut self, other: T)

Performs the /= operation.

impl<T: Clone + NumAssign> DivAssign for Complex<T>

fn div_assign(&mut self, other: Self)

Performs the /= operation.

impl<'a, T: Clone + Num> From<&'a T> for Complex<T>

fn from(re: &T) -> Self

Converts to this type from the input type.

impl<T: Clone + Num> From<T> for Complex<T>

fn from(re: T) -> Self

Converts to this type from the input type.

impl<T: FromPrimitive + Num> FromPrimitive for Complex<T>

fn from_usize(n: usize) -> Option<Self>

Converts a usize to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_isize(n: isize) -> Option<Self>

Converts an isize to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u8(n: u8) -> Option<Self>

Converts an u8 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u16(n: u16) -> Option<Self>

Converts an u16 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u32(n: u32) -> Option<Self>

Converts an u32 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u64(n: u64) -> Option<Self>

Converts an u64 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_i8(n: i8) -> Option<Self>

Converts an i8 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_i16(n: i16) -> Option<Self>

Converts an i16 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_i32(n: i32) -> Option<Self>

Converts an i32 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_i64(n: i64) -> Option<Self>

Converts an i64 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u128(n: u128) -> Option<Self>

Converts an u128 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_i128(n: i128) -> Option<Self>

Converts an i128 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_f32(n: f32) -> Option<Self>

Converts a f32 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_f64(n: f64) -> Option<Self>

Converts a f64 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

impl<T> FromStr for Complex<T>

where T: FromStr + Num + Clone,

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a +/- bi; ai +/- b; a; or bi where a and b are of type T

type Err = ParseComplexError<<T as FromStr>::Err>

The associated error which can be returned from parsing.

impl<T: Hash> Hash for Complex<T>

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: Clone + Num + Neg<Output = T>> Inv for Complex<T>

type Output = Complex<T>

The result after applying the operator.

fn inv(self) -> Self::Output

Returns the multiplicative inverse of self.

impl<T> LowerExp for Complex<T>

where T: LowerExp + Num + PartialOrd + Clone,

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

Formats the value using the given formatter.

impl<T> LowerHex for Complex<T>

where T: LowerHex + Num + PartialOrd + Clone,

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

Formats the value using the given formatter.

impl<'a, T: Clone + Num> Mul<&'a Complex<T>> for Complex<T>

type Output = Complex<T>

The resulting type after applying the * operator.

fn mul(self, other: &Complex<T>) -> Self::Output

Performs the * operation.

impl<'a, T: Clone + Num> Mul<&'a T> for Complex<T>

type Output = Complex<T>

The resulting type after applying the * operator.

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

Performs the * operation.

impl<T: Clone + Num> Mul<T> for Complex<T>

type Output = Complex<T>

The resulting type after applying the * operator.

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

Performs the * operation.

impl<T: Clone + Num> Mul for Complex<T>

type Output = Complex<T>

The resulting type after applying the * operator.

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

Performs the * operation.

impl<T: Clone + Num + MulAdd<Output = T>> MulAdd for Complex<T>

type Output = Complex<T>

The resulting type after applying the fused multiply-add.

fn mul_add(self, other: Complex<T>, add: Complex<T>) -> Complex<T>

Performs the fused multiply-add operation (self * a) + b

impl<'a, 'b, T: Clone + NumAssign + MulAddAssign> MulAddAssign<&'a Complex<T>, &'b Complex<T>> for Complex<T>

fn mul_add_assign(&mut self, other: &Complex<T>, add: &Complex<T>)

Performs the fused multiply-add assignment operation *self = (*self * a) + b

impl<T: Clone + NumAssign + MulAddAssign> MulAddAssign for Complex<T>

fn mul_add_assign(&mut self, other: Complex<T>, add: Complex<T>)

Performs the fused multiply-add assignment operation *self = (*self * a) + b

impl<'a, T: Clone + NumAssign> MulAssign<&'a Complex<T>> for Complex<T>

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

Performs the *= operation.

impl<'a, T: Clone + NumAssign> MulAssign<&'a T> for Complex<T>

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

Performs the *= operation.

impl<T: Clone + NumAssign> MulAssign<T> for Complex<T>

fn mul_assign(&mut self, other: T)

Performs the *= operation.

impl<T: Clone + NumAssign> MulAssign for Complex<T>

fn mul_assign(&mut self, other: Self)

Performs the *= operation.

impl<T: Clone + Num + Neg<Output = T>> Neg for Complex<T>

type Output = Complex<T>

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl<T: Num + Clone> Num for Complex<T>

fn from_str_radix(s: &str, radix: u32) -> Result<Self, Self::FromStrRadixErr>

Parses a +/- bi; ai +/- b; a; or bi where a and b are of type T

radix must be <= 18; larger radix would include i and j as digits, which cannot be supported.

The conversion returns an error if 18 <= radix <= 36; it panics if radix > 36.

The elements of T are parsed using Num::from_str_radix too, and errors (or panics) from that are reflected here as well.

type FromStrRadixErr = ParseComplexError<<T as Num>::FromStrRadixErr>

impl<T: NumCast + Num> NumCast for Complex<T>

fn from<U: ToPrimitive>(n: U) -> Option<Self>

Creates a number from another value that can be converted into a primitive via the ToPrimitive trait. If the source value cannot be represented by the target type, then None is returned.

impl<T> Octal for Complex<T>

where T: Octal + Num + PartialOrd + Clone,

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

Formats the value using the given formatter.

impl<T: Clone + Num> One for Complex<T>

fn one() -> Self

Returns the multiplicative identity element of Self, 1.

fn is_one(&self) -> bool

Returns true if self is equal to the multiplicative identity.

fn set_one(&mut self)

Sets self to the multiplicative identity element of Self, 1.

impl<T: PartialEq> PartialEq for Complex<T>

fn eq(&self, other: &Complex<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a, T: 'a + Num + Clone> Product<&'a Complex<T>> for Complex<T>

fn product<I>(iter: I) -> Self

where I: Iterator<Item = &'a Complex<T>>,

Takes an iterator and generates Self from the elements by multiplying the items.

impl<T: Num + Clone> Product for Complex<T>

fn product<I>(iter: I) -> Self

where I: Iterator<Item = Self>,

Takes an iterator and generates Self from the elements by multiplying the items.

impl<'a, T: Clone + Num> Rem<&'a Complex<T>> for Complex<T>

type Output = Complex<T>

The resulting type after applying the % operator.

fn rem(self, other: &Complex<T>) -> Self::Output

Performs the % operation.

impl<'a, T: Clone + Num> Rem<&'a T> for Complex<T>

type Output = Complex<T>

The resulting type after applying the % operator.

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

Performs the % operation.

impl<T: Clone + Num> Rem<T> for Complex<T>

type Output = Complex<T>

The resulting type after applying the % operator.

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

Performs the % operation.

impl<T: Clone + Num> Rem for Complex<T>

type Output = Complex<T>

The resulting type after applying the % operator.

fn rem(self, modulus: Self) -> Self::Output

Performs the % operation.

impl<'a, T: Clone + NumAssign> RemAssign<&'a Complex<T>> for Complex<T>

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

Performs the %= operation.

impl<'a, T: Clone + NumAssign> RemAssign<&'a T> for Complex<T>

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

Performs the %= operation.

impl<T: Clone + NumAssign> RemAssign<T> for Complex<T>

fn rem_assign(&mut self, other: T)

Performs the %= operation.

impl<T: Clone + NumAssign> RemAssign for Complex<T>

fn rem_assign(&mut self, modulus: Self)

Performs the %= operation.

impl<T> Serialize for Complex<T>

where T: Serialize,

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<'a, T: Clone + Num> Sub<&'a Complex<T>> for Complex<T>

type Output = Complex<T>

The resulting type after applying the - operator.

fn sub(self, other: &Complex<T>) -> Self::Output

Performs the - operation.

impl<'a, T: Clone + Num> Sub<&'a T> for Complex<T>

type Output = Complex<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T: Clone + Num> Sub<T> for Complex<T>

type Output = Complex<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T: Clone + Num> Sub for Complex<T>

type Output = Complex<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<'a, T: Clone + NumAssign> SubAssign<&'a Complex<T>> for Complex<T>

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

Performs the -= operation.

impl<'a, T: Clone + NumAssign> SubAssign<&'a T> for Complex<T>

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

Performs the -= operation.

impl<T: Clone + NumAssign> SubAssign<T> for Complex<T>

fn sub_assign(&mut self, other: T)

Performs the -= operation.

impl<T: Clone + NumAssign> SubAssign for Complex<T>

fn sub_assign(&mut self, other: Self)

Performs the -= operation.

impl<'a, T: 'a + Num + Clone> Sum<&'a Complex<T>> for Complex<T>

fn sum<I>(iter: I) -> Self

where I: Iterator<Item = &'a Complex<T>>,

Takes an iterator and generates Self from the elements by “summing up” the items.

impl<T: Num + Clone> Sum for Complex<T>

fn sum<I>(iter: I) -> Self

where I: Iterator<Item = Self>,

Takes an iterator and generates Self from the elements by “summing up” the items.

impl<T: ToPrimitive + Num> ToPrimitive for Complex<T>

fn to_usize(&self) -> Option<usize>

Converts the value of self to a usize. If the value cannot be represented by a usize, then None is returned.

fn to_isize(&self) -> Option<isize>

Converts the value of self to an isize. If the value cannot be represented by an isize, then None is returned.

fn to_u8(&self) -> Option<u8>

Converts the value of self to a u8. If the value cannot be represented by a u8, then None is returned.

fn to_u16(&self) -> Option<u16>

Converts the value of self to a u16. If the value cannot be represented by a u16, then None is returned.

fn to_u32(&self) -> Option<u32>

Converts the value of self to a u32. If the value cannot be represented by a u32, then None is returned.

fn to_u64(&self) -> Option<u64>

Converts the value of self to a u64. If the value cannot be represented by a u64, then None is returned.

fn to_i8(&self) -> Option<i8>

Converts the value of self to an i8. If the value cannot be represented by an i8, then None is returned.

fn to_i16(&self) -> Option<i16>

Converts the value of self to an i16. If the value cannot be represented by an i16, then None is returned.

fn to_i32(&self) -> Option<i32>

Converts the value of self to an i32. If the value cannot be represented by an i32, then None is returned.

fn to_i64(&self) -> Option<i64>

Converts the value of self to an i64. If the value cannot be represented by an i64, then None is returned.

fn to_u128(&self) -> Option<u128>

Converts the value of self to a u128. If the value cannot be represented by a u128 (u64 under the default implementation), then None is returned.

fn to_i128(&self) -> Option<i128>

Converts the value of self to an i128. If the value cannot be represented by an i128 (i64 under the default implementation), then None is returned.

fn to_f32(&self) -> Option<f32>

Converts the value of self to an f32. Overflows may map to positive or negative inifinity, otherwise None is returned if the value cannot be represented by an f32.

fn to_f64(&self) -> Option<f64>

Converts the value of self to an f64. Overflows may map to positive or negative inifinity, otherwise None is returned if the value cannot be represented by an f64.

impl<T> UpperExp for Complex<T>

where T: UpperExp + Num + PartialOrd + Clone,

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

Formats the value using the given formatter.

impl<T> UpperHex for Complex<T>

where T: UpperHex + Num + PartialOrd + Clone,

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

Formats the value using the given formatter.

impl<T: Clone + Num> Zero for Complex<T>

fn zero() -> Self

Returns the additive identity element of Self, 0.

fn is_zero(&self) -> bool

Returns true if self is equal to the additive identity.

fn set_zero(&mut self)

Sets self to the additive identity element of Self, 0.

impl<T: Copy> Copy for Complex<T>

impl<T: Eq> Eq for Complex<T>

impl<T> StructuralPartialEq for Complex<T>