搜尋套件、儲存庫與 APP 分類

套件詳情v1.2.0

xxh3

xxHash 的 XXH3 摘要演算法的 Dart 實現(移植)。

AndroidiOSWebmacOSWindowsLinux
近 30 天下載
78.4萬
喜歡數
15
Pub 分數
160

安裝套件

flutter pub add xxh3

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

XXH3 哈希演算法的 Dart 實作,最初由 Yann Collet 開發。此套件提供高速、安全的雜湊功能,適用於需要快速且可靠的資料完整性檢查之應用程式。它是對原始 xxHash 庫的直接移植,針對多個平台進行效能最佳化。非常適合用於快取、校驗和以及資料去重情境,其中速度與低衝突率至關重要。

適用情境

  • 資料完整性驗證
  • 快取系統
  • 檔案和串流雜湊
  • 加密校驗和
  • 快速數據去重

主要特色

  • 高性能哈希
  • 跨平台相容性
  • 低碰撞率
  • 簡單 API
  • 針對速度進行了優化

適合對象

  • 效能關鍵的應用程式
  • 大規模數據處理
  • 即時系統
  • 安全敏感環境
  • 需要快速雜湊生成的應用程式

使用建議

  • 不適合用於密碼雜湊等加密安全性場景
  • 不提供加密
  • 最適合用於完整性,而非機密性
  • 在敏感情境中需要謹慎處理
  • 不建議用於加密金鑰衍生

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

xxh3 (for Dart)

Pub Publisher Pub Version GitHub Workflow Status Codecov MIT License

Port of the XXH3 hashing algorithm in Dart.

Presently, only the 64-bit version of XXH3 (XXH3-64) is supported. Please feel free to open a GitHub issue if you need support for XXH3-128.

import 'dart:convert' show utf8;
import 'dart:typed_data';

import 'package:xxh3/xxh3.dart';

void main() {
  // Get the string as UTF-8 bytes.
  final helloWorldBytes = utf8.encode("Hello, world!");
  
  // Use XXH3 to hash the byte array (returns an int).
  // XXH3 is a 64-bit hash, so the value is returned in the
  // form of a 64-bit integer.
  final int digest = xxh3(helloWorldBytes);
  print(digest); // -881777603154417559
  
  // Alternatively, in version 1.1.0+, you can use the
  // xxh3String convenience method to get a hexadecimal
  // string representation of the hash.
  final String hexDigest = xxh3String(helloWorldBytes);
  print(hexDigest); // f3c34bf11915e869

  // Similarly, in version 1.2.0+, you can use the
  // stream API to process your data in blocks.
  final hashStream = xxh3Stream();
  hashStream.update(helloWorldBytes);
  print(hashStream.digest()); // -881777603154417559
  print(hashStream.digestString()); // f3c34bf11915e869
  
  // See the examples and documentation for more...
}

Refer to the Example tab for a 'quick start guide', or for more details refer to the API Documentation.

Performance

As it stands, this is a port written entirely in Dart. At the time of writing it has a throughput of ~0.29 ns/byte (3.16 GB/s) on an Apple M-series processor in JIT mode or ~0.28 ns/byte (3.23 GB/s) in AOT mode.

The streaming APIs currently have no further optimization and are therefore about 0.4-0.6ns/byte slower than the buffered APIs.

You can run the benchmarks yourself on your machine with the following commands:

# For JIT mode
dart run tool/benchmark.dart
# For AOT mode
dart compile exe tool/benchmark.dart -o benchmark
./benchmark

If better performance is needed, dart:ffi can be used to call the original C implementation. This is not currently implemented in this package, but feel free to open a ticket on GitHub if you would like this.

This assumes that the int type is a 64-bit integer, so this will likely not provide correct results for Dart web (JavaScript), where after 2^53, integers become floating point numbers. If there is demand for this, that could probably be addressed by using a custom integer type or a JavaScript Uint8Array.

WebAssembly could also be a potential workaround, but I have not investigated this yet.

所屬分類

原始碼儲存庫

使用此套件的專案

暫無相關資料。