oct 0.28.2

Octonary transcodings.
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

// Copyright 2024-2026 Gabriel Bjørnager Jensen.
//
// This Source Code Form is subject to the terms of
// the Mozilla Public License, v. 2.0. If a copy of
// the MPL was not distributed with this file, you
// can obtain one at:
// <https://mozilla.org/MPL/2.0/>.

//! The [`Empty`] type and [`empty`] function.

use crate::io::{ErrorKind, Read, Result, Write};

/// A type that ignores reads and writes.
#[non_exhaustive]
#[derive(Clone, Copy, Debug, Default)]
pub struct Empty;

/// Constructs a new [`Empty`] object.
#[inline(always)]
#[must_use]
pub const fn empty() -> Empty {
	Empty
}

impl Read for Empty {
	#[inline]
	fn read(&mut self, _buf: &mut [u8]) -> Result<usize> {
		// NOTE: We don't actually need to read anything.
		// :P
		Ok(0)
	}

	#[inline]
	fn read_exact(&mut self, buf: &mut [u8]) -> Result<()> {
		if buf.is_empty() {
  			Ok(())
  		} else {
			// NOTE: We, sadly, cannot honour the read.
  			Err(ErrorKind::UnexpectedEof.into())
  		}
	}
}

impl Write for Empty {
	#[inline]
	fn write(&mut self, buf: &[u8]) -> Result<usize> {
		// NOTE: Yeah, it's written, alright.
		Ok(buf.len())
	}

	#[inline(always)]
	fn write_all(&mut self, _buf: &[u8]) -> Result<()> {
		Ok(())
	}

	#[inline(always)]
	fn flush(&mut self) -> Result<()> {
		Ok(())
	}
}

impl Write for &Empty {
	#[inline]
	fn write(&mut self, buf: &[u8]) -> Result<usize> {
		Ok(buf.len())
	}

	#[inline(always)]
	fn write_all(&mut self, _buf: &[u8]) -> Result<()> {
		Ok(())
	}

	#[inline(always)]
	fn flush(&mut self) -> Result<()> {
		Ok(())
	}
}