murmurhash3js

What is murmurhash3js?

The murmurhash3js npm package is a JavaScript implementation of the MurmurHash3 algorithm, which is a non-cryptographic hash function suitable for general hash-based lookup. It is known for its speed and efficiency.

What are murmurhash3js's main functionalities?

Hashing a string

This feature allows you to hash a string using the MurmurHash3 algorithm. The code sample demonstrates how to hash the string 'example string' and print the resulting hash value.

const murmurhash3js = require('murmurhash3js');
const hash = murmurhash3js.x86.hash32('example string');
console.log(hash);

Hashing a string with a seed

This feature allows you to hash a string with a specified seed value. The code sample demonstrates how to hash the string 'example string' with the seed value 12345 and print the resulting hash value.

const murmurhash3js = require('murmurhash3js');
const hash = murmurhash3js.x86.hash32('example string', 12345);
console.log(hash);

Hashing a string to 128-bit hash

This feature allows you to hash a string to a 128-bit hash value using the MurmurHash3 algorithm. The code sample demonstrates how to hash the string 'example string' and print the resulting 128-bit hash value.

const murmurhash3js = require('murmurhash3js');
const hash = murmurhash3js.x64.hash128('example string');
console.log(hash);

Other packages similar to murmurhash3js

murmurhash

The murmurhash package is another JavaScript implementation of the MurmurHash algorithm. It supports MurmurHash2 and MurmurHash3, and provides similar functionality to murmurhash3js. However, murmurhash3js is more focused on MurmurHash3 specifically.

hash.js

The hash.js package provides a variety of hash functions, including SHA-1, SHA-256, and SHA-512, in addition to MurmurHash3. It is more versatile than murmurhash3js, but may be overkill if you only need MurmurHash3 functionality.

xxhashjs

The xxhashjs package is a JavaScript implementation of the xxHash algorithm, which is another non-cryptographic hash function known for its speed. It provides similar performance characteristics to MurmurHash3, but uses a different algorithm.

README

MurmurHash3js

A javascript implementation of MurmurHash3's hashing algorithms.

Installation

npm install murmurhash3js

bower install murmurhash3js

Usage

    // browser
        <script type="text/javascript" src="murmurhash3js.min.js"></script>
    // server
        var murmurHash3 = require("murmurhash3js");

// Return a 32bit hash as a unsigned int:
> murmurHash3.x86.hash32("I will not buy this record, it is scratched.")
  2832214938

// Return a 128bit hash as a unsigned hex:
> murmurHash3.x86.hash128("I will not buy this tobacconist's, it is scratched.")
  "9b5b7ba2ef3f7866889adeaf00f3f98e"
> murmurHash3.x64.hash128("I will not buy this tobacconist's, it is scratched.")
  "d30654abbd8227e367d73523f0079673"

// Specify a seed (defaults to 0):
> murmurHash3.x86.hash32("My hovercraft is full of eels.", 25)
  2520298415

// Rebind murmurHash3:
> somethingCompletelyDifferent = murmurHash3.noConflict()
> murmurHash3
  undefined
> somethingCompletelyDifferent.version
  "3.0.1" // get version

Authors

• Karan Lyons
• Sascha Droste

Changlog

CHANGLELOG.md

MIT License

Copyright © 2012-2015 Karan Lyons, Sascha Droste

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

The software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and non-infringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.