Struct domain_core::rdata::rfc1035::Null

pub struct Null { /* fields omitted */ }

Null record data.

Null records can contain whatever data. They are experimental and not allowed in master files.

The Null record type is defined in RFC 1035, section 3.3.10.

Methods

impl Null

pub fn new(data: Bytes) -> Self

Creates new, empty owned Null record data.

pub fn data(&self) -> &Bytes

The raw content of the record.

Methods from Deref<Target = Bytes>

pub fn len(&self) -> usize

Returns the number of bytes contained in this Bytes.

Examples

use bytes::Bytes;

let b = Bytes::from(&b"hello"[..]);
assert_eq!(b.len(), 5);

pub fn is_empty(&self) -> bool

Returns true if the Bytes has a length of 0.

Examples

use bytes::Bytes;

let b = Bytes::new();
assert!(b.is_empty());

pub fn slice(&self, begin: usize, end: usize) -> Bytes

Returns a slice of self for the index range [begin..end).

This will increment the reference count for the underlying memory and return a new Bytes handle set to the slice.

This operation is O(1).

Examples

use bytes::Bytes;

let a = Bytes::from(&b"hello world"[..]);
let b = a.slice(2, 5);

assert_eq!(&b[..], b"llo");

Panics

Requires that begin <= end and end <= self.len(), otherwise slicing will panic.

pub fn slice_from(&self, begin: usize) -> Bytes

Returns a slice of self for the index range [begin..self.len()).

This will increment the reference count for the underlying memory and return a new Bytes handle set to the slice.

This operation is O(1) and is equivalent to self.slice(begin, self.len()).

Examples

use bytes::Bytes;

let a = Bytes::from(&b"hello world"[..]);
let b = a.slice_from(6);

assert_eq!(&b[..], b"world");

Panics

Requires that begin <= self.len(), otherwise slicing will panic.

pub fn slice_to(&self, end: usize) -> Bytes

Returns a slice of self for the index range [0..end).

This will increment the reference count for the underlying memory and return a new Bytes handle set to the slice.

This operation is O(1) and is equivalent to self.slice(0, end).

Examples

use bytes::Bytes;

let a = Bytes::from(&b"hello world"[..]);
let b = a.slice_to(5);

assert_eq!(&b[..], b"hello");

Panics

Requires that end <= self.len(), otherwise slicing will panic.

pub fn slice_ref(&self, subset: &[u8]) -> Bytes

Returns a slice of self that is equivalent to the given subset.

When processing a Bytes buffer with other tools, one often gets a &[u8] which is in fact a slice of the Bytes, i.e. a subset of it. This function turns that &[u8] into another Bytes, as if one had called self.slice() with the offsets that correspond to subset.

This operation is O(1).

Examples

use bytes::Bytes;

let bytes = Bytes::from(&b"012345678"[..]);
let as_slice = bytes.as_ref();
let subset = &as_slice[2..6];
let subslice = bytes.slice_ref(&subset);
assert_eq!(&subslice[..], b"2345");

Panics

Requires that the given sub slice is in fact contained within the Bytes buffer; otherwise this function will panic.

Trait Implementations

impl Compose for Null

fn compose_len(&self) -> usize

Returns the number of bytes this value will need without compression.

fn compose<B: BufMut>(&self, buf: &mut B)

Appends the uncompressed representation of this value to buf.

impl Compress for Null

fn compress(&self, buf: &mut Compressor) -> Result<(), ShortBuf>

Appends the wire-format representation of the value to buf.

impl ParseAll for Null

type Err = ShortBuf

The type returned when parsing fails.

fn parse_all(parser: &mut Parser, len: usize) -> Result<Self, Self::Err>

Parses a value len bytes long from the beginning of the parser.

impl RtypeRecordData for Null

const RTYPE: Rtype

The record type of a value of this type.

impl AsRef<Bytes> for Null

fn as_ref(&self) -> &Bytes

Performs the conversion.

impl AsRef<[u8]> for Null

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

Performs the conversion.

impl From<Bytes> for Null

fn from(data: Bytes) -> Self

Performs the conversion.

impl<N> From<Null> for AllRecordData<N>

fn from(value: Null) -> Self

Performs the conversion.

impl PartialEq<Null> for Null

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

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

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

This method tests for !=.

impl PartialOrd<Null> for Null

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

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

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

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

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

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

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

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

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

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

impl Eq for Null

impl Ord for Null

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

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

impl Clone for Null

fn clone(&self) -> Null

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Null

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

Formats the value using the given formatter.

impl Display for Null

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

Formats the value using the given formatter.

impl Deref for Null

type Target = Bytes

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Hash for Null

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].