spatial-hasher 0.1.7

A Rust library for deterministic encryption and decryption using 3D spatial parameters with secure authenticated encryption.
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

//! The `point3d` module provides the `Point3D` struct, representing a point in 3D space.

use serde::{Deserialize, Serialize};
use std::hash::{Hash, Hasher};

/// Represents a point in 3D space.
///
/// # Fields
///
/// - `x`: The x-coordinate.
/// - `y`: The y-coordinate.
/// - `z`: The z-coordinate.
///
/// # Examples
///
/// ```
/// use spatial_hasher::Point3D;
///
/// let point = Point3D { x: 1.0, y: 2.0, z: 3.0 };
/// ```
#[derive(Clone, Copy, Debug, Serialize, Deserialize)]
pub struct Point3D {
    /// The x-coordinate.
    pub x: f64,
    /// The y-coordinate.
    pub y: f64,
    /// The z-coordinate.
    pub z: f64,
}

impl Hash for Point3D {
    /// Hashes the `Point3D` by writing the bit representations of its coordinates into the provided hasher.
    ///
    /// This method uses the `to_bits()` function to obtain the raw memory representation of the floating-point numbers, ensuring consistent hashing.
    ///
    /// # Arguments
    ///
    /// * `state` - A mutable reference to a type implementing the `Hasher` trait.
    fn hash<H: Hasher>(&self, state: &mut H) {
        state.write_u64(self.x.to_bits());
        state.write_u64(self.y.to_bits());
        state.write_u64(self.z.to_bits());
    }
}