Struct Serial 

#[repr(transparent)]
pub struct Serial(pub U32);

Available on crate feature unstable-new only.

Serial number arithmetic.

Serial implements the “Serial number arithmetic” defined in RFC1982 with a SERIAL_BITS value of 32.

Serial should not be used interchangably or be confused with the SOA Serial Number, which is a Serial but not the sole user of “Serial number arithmetic”.

Tuple Fields

0: U32

Implementations

impl Serial

pub const fn new(value: u32) -> Self

Construct a new Serial

pub const fn get(&self) -> u32

Get u32 value of Serial

pub fn unix_time() -> Self

Available on crate feature std only.

Measure the current time (in seconds) in serial number space.

impl Serial

pub fn inc(self, num: i32) -> Self

Increment this by a non-negative number.

The number must be in the range [0, 2^31 - 1]. An i32 is used instead of a u32 because it is easier to understand and implement a non-negative check versus the upper range check.

Section 7 in RFC1982 states, in particular for the SOA Serial Number, but for any Serial number using a “SERIAL_BITS” value of 32: “The maximum defined increment is 2147483647 (2^31 - 1).”

Panics

Panics if the number is negative.

Trait Implementations

impl AsBytes for Serial

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

Interpret this value as a sequence of bytes.

impl BuildBytes for Serial

fn build_bytes<'bytes>( &self, bytes: &'bytes mut [u8], ) -> Result<&'bytes mut [u8], TruncationError>

Serialize into a byte sequence.

fn built_bytes_size(&self) -> usize

The size of self when serialized into a byte sequence.

impl Clone for Serial

fn clone(&self) -> Serial

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Serial

impl Debug for Serial

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

Formats the value using the given formatter.

impl Display for Serial

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

Formats the value using the given formatter.

impl Eq for Serial

impl From<Serial> for u32

fn from(value: Serial) -> Self

Converts to this type from the input type.

impl From<u32> for Serial

fn from(value: u32) -> Self

Converts to this type from the input type.

impl Hash for Serial

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<'bytes> ParseBytes<'bytes> for Serial

where U32: ParseBytes<'bytes>,

fn parse_bytes(bytes: &'bytes [u8]) -> Result<Self, ParseError>

Parse a value of Self from the given byte sequence.

impl ParseBytesZC for Serial

fn parse_bytes_by_ref(bytes: &[u8]) -> Result<&Self, ParseError>

Interpret a byte sequence as an instance of Self.

fn parse_bytes_in<C: ParseBytesInPlace>( container: C, ) -> Result<C::WithParsed<Self>, (C, ParseError)>

Parse bytes within the given container.

impl PartialEq for Serial

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Serial

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

The comparison of Serial Number values is defined in Section 3.2 RFC1982.

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<'bytes> SplitBytes<'bytes> for Serial

where U32: SplitBytes<'bytes>,

fn split_bytes(bytes: &'bytes [u8]) -> Result<(Self, &'bytes [u8]), ParseError>

Parse a value of Self from the start of the byte sequence.

impl SplitBytesZC for Serial

fn split_bytes_by_ref(bytes: &[u8]) -> Result<(&Self, &[u8]), ParseError>

Interpret the start of a byte sequence as an instance of Self.

impl StructuralPartialEq for Serial

impl UnsizedCopy for Serial

type Alignment = (<U32 as UnsizedCopy>::Alignment,)

A type with the same alignment as Self.

fn ptr_with_addr(&self, addr: *const ()) -> *const Self

Change the address of a pointer to Self.

fn unsized_copy_into<T: UnsizedCopyFrom<Source = Self>>(&self) -> T

Copy self into a new container.

fn copy(&self) -> Self

where Self: Sized,

Copy self and return it by value.