rustls 0.5.5

Rustls is a modern TLS library written in 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
56
57
58
59
60
61
62
63
64
65

use std::io::Read;
use std::io;

/// This is a byte buffer that is built from a vector
/// of byte vectors.  This avoids extra copies when
/// appending a new byte vector, at the expense of
/// more complexity when reading out.
pub struct ChunkVecBuffer {
    chunks: Vec<Vec<u8>>,
}

impl ChunkVecBuffer {
    pub fn new() -> ChunkVecBuffer {
        ChunkVecBuffer { chunks: Vec::new() }
    }

    pub fn is_empty(&self) -> bool {
        self.chunks.is_empty()
    }

    pub fn append(&mut self, bytes: Vec<u8>) {
        if !bytes.is_empty() {
            self.chunks.push(bytes);
        }
    }

    pub fn take_one(&mut self) -> Vec<u8> {
        self.chunks.remove(0)
    }

    pub fn read(&mut self, buf: &mut [u8]) -> io::Result<usize> {
        let mut offs = 0;

        while offs < buf.len() && !self.is_empty() {
            let used = try!(self.chunks[0].as_slice().read(&mut buf[offs..]));

            if used == self.chunks[0].len() {
                self.chunks.remove(0);
            } else {
                self.chunks[0] = self.chunks[0].split_off(used);
            }

            offs += used;
        }

        Ok(offs)
    }

    pub fn write_to(&mut self, wr: &mut io::Write) -> io::Result<usize> {
        // would desperately like writev support here!
        if self.is_empty() {
            return Ok(0);
        }

        let used = try!(wr.write(&self.chunks[0]));

        if used == self.chunks[0].len() {
            self.chunks.remove(0);
        } else {
            self.chunks[0] = self.chunks[0].split_off(used);
        }

        return Ok(used);
    }
}