rustls 0.5.0

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
66
67

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);
  }
}