domain 0.12.0

A DNS library for Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

//! Buffer types and allocation strategies.
use core::ops::Deref;

use std::sync::Arc;
use std::vec::Vec;

//----------- BufSource -----------------------------------------------------

/// A source for creating new buffers.
///
/// A buffer source is used by servers to allocate new buffers when needed,
/// for example to store an incoming request.
///
/// If the size is known in advance a specific size of buffer can be
/// requested, otherwise use the default.
pub trait BufSource {
    /// The type of buffer created by this source.
    type Output: AsRef<[u8]> + AsMut<[u8]>;

    /// Creates a buffer with the default properties for this source.
    fn create_buf(&self) -> Self::Output;

    /// Creates a buffer large enough to hold the specified number of bytes.
    fn create_sized(&self, size: usize) -> Self::Output;
}

impl<T: BufSource> BufSource for Arc<T> {
    type Output = T::Output;

    fn create_buf(&self) -> Self::Output {
        Arc::deref(self).create_buf()
    }

    fn create_sized(&self, size: usize) -> Self::Output {
        Arc::deref(self).create_sized(size)
    }
}

//----------- VecBufSource --------------------------------------------------

/// A source for creating [`Vec<u8>`] based buffers.
#[derive(Clone)]
pub struct VecBufSource;

impl BufSource for VecBufSource {
    type Output = Vec<u8>;

    fn create_buf(&self) -> Self::Output {
        vec![0; 1024]
    }

    fn create_sized(&self, size: usize) -> Self::Output {
        vec![0; size]
    }
}