Struct Longitude 

pub struct Longitude(/* private fields */);

A geographic longitude value, constrained to −180 ≤ degrees ≤ 180.

Positive values are east of the international reference meridian; negative values are west.

Examples

use lat_long::{Angle, Longitude};

let lon = Longitude::new(-73, 56, 0.0).unwrap();
assert!(lon.is_western());

Implementations

impl Longitude

pub fn is_on_international_reference_meridian(&self) -> bool

Returns true if this longitude is exactly on the IERS International Reference Meridian (IRM), or 0°.

pub fn is_western(&self) -> bool

Returns true if this longitude is in the western hemisphere (< 0°).

pub fn is_eastern(&self) -> bool

Returns true if this longitude is in the eastern hemisphere (> 0°).

pub fn utm_zone(&self) -> u8

Return the UTM longitude zone number (1–60) covering this longitude.

Zones are 6° wide and are numbered starting at the antimeridian (180° W = zone 1) and increasing eastward.

Examples

use lat_long::{Angle, Longitude};

// Seattle ~ -122.3° falls in zone 10.
let lon = Longitude::try_from(-122.3).unwrap();
assert_eq!(lon.utm_zone(), 10);

Trait Implementations

impl Angle for Longitude

const MIN: Self

The minimum legal value of this angle.

const MAX: Self

The maximum legal value of this angle.

fn new(degrees: i32, minutes: u32, seconds: f32) -> Result<Self, Error>

Construct a new angle from degrees, minutes, and seconds.

fn as_float(&self) -> OrderedFloat<f64>

Returns the underlying decimal-degree value as an OrderedFloat<f64>.

fn to_radians(&self) -> f64

Returns the angle converted from decimal degrees to radians.

fn from_radians(radians: f64) -> Result<Self, Error>

where Self: Sized,

Construct an angle from a value in radians.

fn is_zero(&self) -> bool

Returns true if the angle is exactly zero.

fn is_nonzero_positive(&self) -> bool

Returns true if the angle is positive and non-zero.

fn is_nonzero_negative(&self) -> bool

Returns true if the angle is negative and non-zero.

fn degrees(&self) -> i32

The signed integer degrees component (carries the sign for negative angles).

fn minutes(&self) -> u32

The unsigned minutes component (always in 0..60).

fn seconds(&self) -> f32

The unsigned seconds component (always in 0.0..60.0).

fn abs(self) -> Self

where Self: Sized,

Returns the absolute value of this angle.

fn modulo_max(self) -> Self

where Self: Sized,

Returns this angle taken modulo MAX.

fn checked_abs(self) -> Option<Self>

where Self: Sized,

Checked absolute value. Computes self.abs(), returning None if self == MIN.

fn overflowing_abs(self) -> (Self, bool)

where Self: Sized,

Computes the absolute value of self.

fn saturating_abs(self) -> Self

where Self: Sized,

Saturating absolute value. Computes self.abs(), returning MAX if self == MIN instead of overflowing.

fn strict_abs(self) -> Self

where Self: Sized,

Strict absolute value. Computes self.abs(), panicking if self == MIN.

fn unchecked_abs(self) -> Self

where Self: Sized,

Unchecked absolute value. Computes self.abs(), assuming overflow cannot occur.

fn wrapping_abs(self) -> Self

where Self: Sized,

Wrapping (modular) absolute value. Computes self.abs(), wrapping around at the boundary of the type.

impl Clone for Longitude

fn clone(&self) -> Longitude

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Longitude

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

Formats the value using the given formatter.

impl Default for Longitude

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Longitude

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Longitude

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

Formats the longitude as decimal degrees by default, or as degrees–minutes–seconds when the alternate flag ({:#}) is used.

impl Formatter for Longitude

fn format<W: Write>(&self, f: &mut W, fmt: &FormatOptions) -> Result

Write self to f according to options.

fn to_formatted_string(&self, fmt: &FormatOptions) -> String

Convenience helper: render self into a new String.

impl From<Longitude> for Coordinate

fn from(value: Longitude) -> Self

Converts to this type from the input type.

impl From<Longitude> for OrderedFloat<f64>

fn from(value: Longitude) -> Self

Converts to this type from the input type.

impl From<Longitude> for f64

fn from(value: Longitude) -> Self

Converts to this type from the input type.

impl FromStr for Longitude

type Err = Error

The associated error which can be returned from parsing.

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

Parses a string s to return a value of this type.

impl Hash for Longitude

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 Ord for Longitude

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

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Longitude

fn eq(&self, other: &Longitude) -> 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 PartialOrd for Longitude

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

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl Serialize for Longitude

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<OrderedFloat<f64>> for Longitude

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: OrderedFloat<f64>) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<f64> for Longitude

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl Copy for Longitude

impl Eq for Longitude

impl StructuralPartialEq for Longitude