Rust高性能哈希库fasthash-sys的使用，提供快速稳定的非加密哈希算法实现

安装

在你的项目目录中运行以下Cargo命令：

cargo add fasthash-sys

或者在Cargo.toml中添加以下行：

fasthash-sys = "0.3.2"

使用示例

以下是一个使用fasthash-sys库的完整示例：

use fasthash_sys::{city, farm, metro, mum, murmur, spooky, xx};

fn main() {
    let data = b"hello world";
    
    // 计算CityHash32哈希值
    let city_hash = unsafe { city::hash32(data.as_ptr() as *const _, data.len()) };
    println!("CityHash32: {}", city_hash);
    
    // 计算FarmHash32哈希值
    let farm_hash = unsafe { farm::hash32(data.as_ptr() as *const _, data.len()) };
    println!("FarmHash32: {}", farm_hash);
    
    // 计算MetroHash64哈希值
    let metro_hash = unsafe { metro::hash64(data.as_ptr() as *const _, data.len()) };
    println!("MetroHash64: {}", metro_hash);
    
    // 计算MumHash64哈希值
    let mum_hash = unsafe { mum::hash64(data.as_ptr() as *const _, data.len()) };
    println!("MumHash64: {}", mum_hash);
    
    // 计算MurmurHash32哈希值
    let murmur_hash = unsafe { murmur::hash32(data.as_ptr() as *const _, data.len()) };
    println!("MurmurHash32: {}", murmur_hash);
    
    // 计算SpookyHash32哈希值
    let spooky_hash = unsafe { spooky::hash32(data.as_ptr() as *const _, data.len()) };
    println!("SpookyHash32: {}", spooky_hash);
    
    // 计算XXHash32哈希值
    let xx_hash = unsafe { xx::hash32(data.as_ptr() as *const _, data.len()) };
    println!("XXHash32: {}", xx_hash);
}

完整示例demo

use fasthash_sys::{city, farm, metro, mum, murmur, spooky, xx};
use std::time::Instant;

fn benchmark<F>(name: &str, f: F) 
where
    F: Fn(&[u8]) -> u64
{
    let data = b"benchmarking hash performance with fasthash-sys";
    let start = Instant::now();
    
    for _ in 0..1_000_000 {
        f(data);
    }
    
    let duration = start.elapsed();
    println!("{}: {:?}", name, duration);
}

fn main() {
    let data = b"hello world";
    
    // 计算并打印各种哈希值
    println!("Hashing 'hello world':");
    
    let city_hash = unsafe { city::hash32(data.as_ptr() as *const _, data.len()) };
    println!("CityHash32: {}", city_hash);
    
    let farm_hash = unsafe { farm::hash32(data.as_ptr() as *const _, data.len()) };
    println!("FarmHash32: {}", farm_hash);
    
    let metro_hash = unsafe { metro::hash64(data.as_ptr() as *const _, data.len()) };
    println!("MetroHash64: {}", metro_hash);
    
    let mum_hash = unsafe { mum::hash64(data.as_ptr() as *const _, data.len()) };
    println!("MumHash64: {}", mum_hash);
    
    let murmur_hash = unsafe { murmur::hash32(data.as_ptr() as *const _, data.len()) };
    println!("MurmurHash32: {}", murmur_hash);
    
    let spooky_hash = unsafe { spooky::hash32(data.as_ptr() as *const _, data.len()) };
    println!("SpookyHash32: {}", spooky_hash);
    
    let xx_hash = unsafe { xx::hash32(data.as_ptr() as *const _, data.len()) };
    println!("XXHash32: {}", xx_hash);
    
    // 性能基准测试
    println!("\nBenchmarking hash functions (1,000,000 iterations):");
    
    benchmark("CityHash32", |d| unsafe { 
        city::hash32(d.as_ptr() as *const _, d.len()) as u64 
    });
    
    benchmark("FarmHash32", |d| unsafe { 
        farm::hash32(d.as_ptr() as *const _, d.len()) as u64 
    });
    
    benchmark("MetroHash64", |d| unsafe { 
        metro::hash64(d.as_ptr() as *const _, d.len()) 
    });
    
    benchmark("MumHash64", |d| unsafe { 
        mum::hash64(d.as_ptr() as *const _, d.len()) 
    });
    
    benchmark("MurmurHash32", |d| unsafe { 
        murmur::hash32(d.as_ptr() as *const _, d.len()) as u64 
    });
    
    benchmark("SpookyHash32", |d| unsafe { 
        spooky::hash32(d.as_ptr() as *const _, d.len()) as u64 
    });
    
    benchmark("XXHash32", |d| unsafe { 
        xx::hash32(d.as_ptr() as *const _, d.len()) as u64 
    });
}

说明

fasthash-sys库提供了多种快速稳定的非加密哈希算法实现，包括：

• CityHash
• FarmHash
• MetroHash
• MumHash
• MurmurHash
• SpookyHash
• XXHash

这些哈希算法适合用于哈希表、布隆过滤器等需要快速哈希的场景，但不适用于加密用途。

注意：由于这是底层系统绑定库，使用时需要注意unsafe操作。大多数函数需要传入原始指针和数据长度，调用时需要确保指针和数据的安全性和有效性。