Enum Integer 

pub enum Integer {
    Signed(i64),
    Unsigned(u64),
}

A property-list integer, carrying its signedness.

Plists must represent both u64::MAX and negative values, so the model is the pair of a raw 64-bit payload and a sign flag rather than a single i64. Equality, ordering, and hashing are numeric: no codec preserves signedness for non-negative values, so Signed(5) and Unsigned(5) are the same integer (and hash identically).

Examples

use apple_plist::Integer;

assert_eq!(Integer::from(5i64), Integer::from(5u64));
assert!(Integer::from(-1i8) < Integer::from(0u8));

Variants

Signed(i64)

A signed value; the only representation negative integers have.

Unsigned(u64)

An unsigned value, covering i64::MAX + 1 ..= u64::MAX exclusively.

Implementations

impl Integer

pub const fn as_signed(self) -> Option<i64>

Returns the value as an i64 when it fits.

Examples

use apple_plist::Integer;

assert_eq!(
    Integer::Unsigned(i64::MAX as u64).as_signed(),
    Some(i64::MAX)
);
assert_eq!(Integer::Unsigned(i64::MAX as u64 + 1).as_signed(), None);
assert_eq!(Integer::Signed(-1).as_signed(), Some(-1));

pub const fn as_unsigned(self) -> Option<u64>

Returns the value as a u64 when it is non-negative.

Examples

use apple_plist::Integer;

assert_eq!(Integer::Signed(0).as_unsigned(), Some(0));
assert_eq!(Integer::Signed(-1).as_unsigned(), None);
assert_eq!(Integer::Unsigned(u64::MAX).as_unsigned(), Some(u64::MAX));

Trait Implementations

impl Clone for Integer

fn clone(&self) -> Integer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Integer

impl Debug for Integer

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Integer

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Integer

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

Formats the value using the given formatter.

impl Eq for Integer

impl From<Integer> for Value

fn from(value: Integer) -> Self

Converts to this type from the input type.

impl From<i8> for Integer

fn from(value: i8) -> Self

Converts to this type from the input type.

impl From<i16> for Integer

fn from(value: i16) -> Self

Converts to this type from the input type.

impl From<i32> for Integer

fn from(value: i32) -> Self

Converts to this type from the input type.

impl From<i64> for Integer

fn from(value: i64) -> Self

Converts to this type from the input type.

impl From<u8> for Integer

fn from(value: u8) -> Self

Converts to this type from the input type.

impl From<u16> for Integer

fn from(value: u16) -> Self

Converts to this type from the input type.

impl From<u32> for Integer

fn from(value: u32) -> Self

Converts to this type from the input type.

impl From<u64> for Integer

fn from(value: u64) -> Self

Converts to this type from the input type.

impl Hash for Integer

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 Integer

fn cmp(&self, other: &Self) -> 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 Integer

fn eq(&self, other: &Self) -> 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 Integer

fn partial_cmp(&self, other: &Self) -> 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 Integer

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

where S: Serializer,

Serialize this value into the given Serde serializer.