ring/aead/
iv.rs

1// Copyright 2018 Brian Smith.
2//
3// Permission to use, copy, modify, and/or distribute this software for any
4// purpose with or without fee is hereby granted, provided that the above
5// copyright notice and this permission notice appear in all copies.
6//
7// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHORS DISCLAIM ALL WARRANTIES
8// WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
9// MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
10// SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
11// WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
12// OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
13// CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
14
15/// The IV for a single block encryption.
16///
17/// Intentionally not `Clone` to ensure each is used only once.
18#[repr(C)]
19pub struct Iv([u8; IV_LEN]);
20
21pub const IV_LEN: usize = 16;
22
23impl Iv {
24    #[inline]
25    pub fn assume_unique_for_key(a: [u8; IV_LEN]) -> Self {
26        Self(a)
27    }
28
29    #[inline]
30    pub fn into_bytes_less_safe(self) -> [u8; IV_LEN] {
31        self.0
32    }
33}