ds 1.2.4

A library for controlling FIRST Robotics Competition robots
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

use bytes::Buf;
use std::io::{Error, ErrorKind, Result};

/// Trait containing functions for reading integers from `Buf`
/// Wraps existing functions, providing a safer API without panics
pub trait BufExt: Buf {
    /// Reads an unsigned byte from `self`
    fn read_u8(&mut self) -> Result<u8> {
        if self.remaining() >= 1 {
            Ok(self.get_u8())
        } else {
            Err(Error::new(ErrorKind::UnexpectedEof, "self.remaining() < 1"))
        }
    }

    /// Reads an unsigned big endian short from `self`
    fn read_u16_be(&mut self) -> Result<u16> {
        if self.remaining() >= 2 {
            Ok(self.get_u16())
        } else {
            Err(Error::new(ErrorKind::UnexpectedEof, "self.remaining() < 2"))
        }
    }

    /// Reads an unsigned big endian integer from `self`
    fn read_u32_be(&mut self) -> Result<u32> {
        if self.remaining() >= 4 {
            Ok(self.get_u32())
        } else {
            Err(Error::new(ErrorKind::UnexpectedEof, "self.remaining() < 4"))
        }
    }

    /// Reads an unsigned big endian long from `self`
    fn read_u64_be(&mut self) -> Result<u64> {
        if self.remaining() >= 8 {
            Ok(self.get_u64())
        } else {
            Err(Error::new(ErrorKind::UnexpectedEof, "self.remaining() < 8"))
        }
    }

    /// Reads a signed byte from `self`
    fn read_i8(&mut self) -> Result<i8> {
        if self.remaining() >= 1 {
            Ok(self.get_i8())
        } else {
            Err(Error::new(ErrorKind::UnexpectedEof, "self.remaining() < 1"))
        }
    }

    /// Reads a signed big endian short from `self`
    fn read_i16_be(&mut self) -> Result<i16> {
        if self.remaining() >= 2 {
            Ok(self.get_i16())
        } else {
            Err(Error::new(ErrorKind::UnexpectedEof, "self.remaining() < 2"))
        }
    }

    /// Reads a signed big endian integer from `self`
    fn read_i32_be(&mut self) -> Result<i32> {
        if self.remaining() >= 4 {
            Ok(self.get_i32())
        } else {
            Err(Error::new(ErrorKind::UnexpectedEof, "self.remaining() < 4"))
        }
    }

    /// Reads a signed big endian long from `self`
    fn read_i64_be(&mut self) -> Result<i64> {
        if self.remaining() >= 8 {
            Ok(self.get_i64())
        } else {
            Err(Error::new(ErrorKind::UnexpectedEof, "self.remaining() < 8"))
        }
    }

    fn read_f32_be(&mut self) -> Result<f32> {
        if self.remaining() >= 4 {
            Ok(self.get_f32())
        } else {
            Err(Error::new(ErrorKind::UnexpectedEof, "self.remaining() < 4"))
        }
    }

    /// Reads a double precision floating point number big endian from `self`
    fn read_f64_be(&mut self) -> Result<f64> {
        if self.remaining() >= 8 {
            Ok(self.get_f64())
        } else {
            Err(Error::new(ErrorKind::UnexpectedEof, "self.remaining() < 8"))
        }
    }
}

impl<B: Buf> BufExt for B {}