Need help with js-xxhash?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

pierrec
222 Stars 26 Forks MIT License 38 Commits 7 Opened issues

Description

Javascript implementation of xxHash

Services available

!
?

Need anything else?

Contributors list

# 149,335
golang
Shell
js
xxhash
20 commits
# 198,195
React
relay-m...
GraphQL
travis
2 commits
# 10,345
npm-scr...
React
node-js
scene-g...
1 commit
# 552,192
xxhash
js
HTML
1 commit
# 483,480
Lua
xxhash
js
Elixir
1 commit
# 417,085
nextjs
Shell
HTML
xxhash
1 commit
# 2,001
JavaScr...
fnproje...
React
ecmascr...
1 commit
# 160,136
Shell
js
appcach...
Webpack
1 commit

Javascript implementation of xxHash

Synopsis

xxHash is a very fast hashing algorithm (see the details here). xxhashjs is a Javascript implementation of it, written in 100% Javascript. Although not as fast as the C version, it does perform pretty well given the current Javascript limitations in handling unsigned 32 bits integers.

Installation

In nodejs:

npm install xxhashjs

In the browser, include the following, and access the constructor with XXH:


Examples

  • In one step:

    javascript
    var h = XXH.h32( 'abcd', 0xABCD ).toString(16)  // seed = 0xABCD
    

    0xCDA8FAE4

  • In several steps (useful in conjunction of NodeJS streams):

    javascript
    var H = XXH.h32( 0xABCD )   // seed = 0xABCD
    var h = H.update( 'abcd' ).digest().toString(16)
    

    0xCDA8FAE4

  • More examples in the examples directory:

    • Compute xxHash from a file data
    • Use xxHashjs in the browser

Usage

  • XXH makes 2 functions available for 32 bits XXH and 64 bits XXH respectively, with the same signature:

    • XXH.h32
    • XXH.h64
  • In one step:

    XXH.h32(, )
    The data can either be a string, an ArrayBuffer or a NodeJS Buffer object. The seed can either be a number or a UINT32 object.
  • In several steps:

    • instantiate a new XXH object H:
      XXH.h32()
      or
      XXH.h32()
      The seed can be set later on with the
      init
      method
    • add data to the hash calculation:
      H.update()
    • finish the calculations:
      H.digest()

The object returned can be converted to a string with

toString()
or a number
toNumber()
. Once
digest()
has been called, the object can be reused. The same seed will be used or it can be changed with
init()
.

Methods

  • XXH.h32()
    • .init()
      Initialize the XXH object with the given seed. The seed can either be a number or a UINT32 object.
    • .update()
      Add data for hashing. The data can either be a string, an ArrayBuffer or a NodeJS Buffer object.
  • digest()
    (UINT32) Finalize the hash calculations and returns an UINT32 object. The hash value can be retrieved with toString().
  • XXH.h64()
    • .init()
      Initialize the XXH object with the given seed. The seed can either be a number or a UINT64 object.
    • .update()
      Add data for hashing. The data can either be a string, an ArrayBuffer or a NodeJS Buffer object.
    • .digest()
      (UINT64) Finalize the hash calculations and returns an UINT64 object. The hash value can be retrieved with toString().

License

MIT

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.