reifydb-codec 0.10.1

Unified encoding and decoding for all ReifyDB values, frames, rows, keys, and boundaries
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

// SPDX-License-Identifier: Apache-2.0
// Copyright (c) 2026 ReifyDB

use std::ptr;

use reifydb_value::{
	reifydb_assertions,
	value::{constraint::Constraint, dictionary::DictionaryEntryId, value_type::ValueType},
};

use crate::row::{bytes::RowBuilder, shape::RowShape};

impl RowShape {
	pub fn set_dictionary_id(&self, row: &mut impl RowBuilder, index: usize, entry: &DictionaryEntryId) {
		let field = &self.fields()[index];
		reifydb_assertions! {
			assert!(
				row.len() >= self.total_static_size(),
				"row/shape size mismatch: row.len()={} < total_static_size()={}",
				row.len(),
				self.total_static_size()
			);
			assert_eq!(*field.constraint.get_type().inner_type(), ValueType::DictionaryId);
		}
		let id_type = match field.constraint.constraint() {
			Some(Constraint::Dictionary(_, id_type)) => id_type.clone(),
			_ => ValueType::Uint4,
		};
		let raw = entry.to_u128();
		self.set_valid(row, index, true);
		// SAFETY: row.len() >= total_static_size() puts the slot at field.offset inside the uniquely-owned
		// buffer; each arm writes the slot's read width, which the shape allocated;
		// write_unaligned needs no alignment.
		let written = unsafe {
			let ptr = row.as_mut_slice().as_mut_ptr().add(field.offset as usize);
			match id_type {
				ValueType::Uint1 => u8::try_from(raw).map(|v| ptr.write_unaligned(v)),
				ValueType::Uint2 => {
					u16::try_from(raw).map(|v| ptr::write_unaligned(ptr as *mut u16, v))
				}
				ValueType::Uint8 => {
					u64::try_from(raw).map(|v| ptr::write_unaligned(ptr as *mut u64, v))
				}
				ValueType::Uint16 => {
					ptr::write_unaligned(ptr as *mut u128, raw);
					Ok(())
				}
				_ => u32::try_from(raw).map(|v| ptr::write_unaligned(ptr as *mut u32, v)),
			}
		};
		if written.is_err() {
			panic!("dictionary id {raw} does not fit the {id_type} id slot of field {index}");
		}
	}

	pub fn get_dictionary_id(&self, row: &[u8], index: usize) -> DictionaryEntryId {
		let field = &self.fields()[index];
		reifydb_assertions! {
			assert!(
				row.len() >= self.total_static_size(),
				"row/shape size mismatch: row.len()={} < total_static_size()={}",
				row.len(),
				self.total_static_size()
			);
			assert_eq!(*field.constraint.get_type().inner_type(), ValueType::DictionaryId);
		}
		let id_type = match field.constraint.constraint() {
			Some(Constraint::Dictionary(_, id_type)) => id_type.clone(),
			_ => ValueType::Uint4,
		};
		// SAFETY: row.len() >= total_static_size() puts the slot at field.offset inside the row and it is at
		// least as wide as the id type read; the unsigned targets have no invalid bit patterns.
		unsafe {
			let ptr = row.as_ptr().add(field.offset as usize);
			let raw: u128 = match id_type {
				ValueType::Uint1 => ptr.read_unaligned() as u128,
				ValueType::Uint2 => (ptr as *const u16).read_unaligned() as u128,
				ValueType::Uint4 => (ptr as *const u32).read_unaligned() as u128,
				ValueType::Uint8 => (ptr as *const u64).read_unaligned() as u128,
				ValueType::Uint16 => (ptr as *const u128).read_unaligned(),
				_ => (ptr as *const u32).read_unaligned() as u128,
			};
			DictionaryEntryId::from_u128(raw, id_type).unwrap()
		}
	}

	pub fn try_get_dictionary_id(&self, row: &[u8], index: usize) -> Option<DictionaryEntryId> {
		if self.is_defined(row, index) && self.fields()[index].constraint.get_type() == ValueType::DictionaryId
		{
			Some(self.get_dictionary_id(row, index))
		} else {
			None
		}
	}
}