# fast-crc32c

> CRC32C algorithm with hardware acceleration and software fallback.

Latest version **2.0.0** (published 2019-10-05) · MIT license · 0 weekly downloads

## Install

```sh
npm install fast-crc32c
pnpm add fast-crc32c
yarn add fast-crc32c
bun add fast-crc32c
```

## Health

**Score 23/100 (F)** — status: abandoned.

Positive: has types package; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.0.0 |
| Published | 2019-10-05 |
| First published | 2014-05-21 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | separate (@types/fast-crc32c) |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 8.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 30 |
| Author | Xiaoyi Shi |
| Maintainers | ashi009 |
| Keywords | crc, crc32, crc32c, sse, sse4, sse4.2 |

## Links

- npm: https://www.npmjs.com/package/fast-crc32c
- Repository: https://github.com/ashi009/node-fast-crc32c
- Homepage: https://github.com/ashi009/node-fast-crc32c#readme
- Issues: https://github.com/ashi009/node-fast-crc32c/issues
- npm.io page: https://npm.io/package/fast-crc32c

## Dependencies (1)

- [sse4_crc32](https://npm.io/package/sse4_crc32.md) ^6.0.1

## Alternatives

- [jsforce](https://npm.io/package/jsforce.md) — 851.2K weekly downloads
- [react-native-qrcode-svg](https://npm.io/package/react-native-qrcode-svg.md) — 693.5K weekly downloads
- [@salesforce/plugin-data](https://npm.io/package/@salesforce/plugin-data.md) — 394.9K weekly downloads
- [@backstage/plugin-search-common](https://npm.io/package/@backstage/plugin-search-common.md) — 308.5K weekly downloads
- [@chain-registry/types](https://npm.io/package/@chain-registry/types.md) — 38.4K weekly downloads

## Recent versions

- 2.0.0 (latest) — 2019-10-05
- 1.0.7 — 2019-10-05
- 1.0.4 — 2016-07-04
- 1.0.3 — 2016-07-03
- 1.0.2 — 2016-04-26
- 1.0.1 — 2015-10-05
- 1.0.0 — 2015-09-27
- 0.1.5 — 2015-03-19
- 0.1.4 — 2015-03-19
- 0.1.3 — 2014-05-21
- 0.1.2 — 2014-05-21
- 0.1.0 — 2014-05-21

## README

# fast-crc32c [![NPM version](https://badge.fury.io/js/fast-crc32c.svg)](http://badge.fury.io/js/fast-crc32c) [![Build Status](https://travis-ci.org/ashi009/node-fast-crc32c.svg?branch=master)](https://travis-ci.org/ashi009/node-fast-crc32c) [![Dependency Status](https://david-dm.org/ashi009/node-fast-crc32c.svg)](https://david-dm.org/ashi009/node-fast-crc32c) [![Coverage Status](https://coveralls.io/repos/github/ashi009/node-fast-crc32c/badge.svg?branch=master)](https://coveralls.io/github/ashi009/node-fast-crc32c?branch=master)

fast-crc32c is a CRC-32C algorithm implementation for node.js, which uses
hardware acceleration (via [voxer/sse4_crc32][sse4_crc32] by Anand Suresh), and
fallback to software implementation when hardware acceleration fails.

## Performance

CRC-32C is faster then CRC-32, which could take advantage of full CPU operand
register width (64bit) instead of CRC-32's 8bit.

When using hardware acceleration, CRC-32C is about 7x ~ 9x faster than software
implemented CRC-32C.

### Benchmark

The 3 tested implementations are:

- **sse4\_crc32c** Hardware accelerated CRC-32C from [sse4_crc32][sse4_crc32]
- **js_crc32c** Javascript implemented CRC-32C
- **js_crc32** Javascript implemented CRC-32 from [buffer-crc32][buffer-crc32]

```shell
$ yarn run benchmark
yarn run v1.17.3
$ node benchmark
sse4_crc32c_hw for inputs 1024B x 3,210,508 ops/sec ±2.09% (87 runs sampled)
sse4_crc32c_hw for inputs 16836819B, avg 2055B x 252 ops/sec ±2.90% (79 runs sampled)
sse4_crc32c_sw for inputs 1024B x 1,358,720 ops/sec ±1.31% (89 runs sampled)
sse4_crc32c_sw for inputs 16836819B, avg 2055B x 96.41 ops/sec ±1.42% (71 runs sampled)
js_crc32c for inputs 1024B x 409,615 ops/sec ±1.46% (89 runs sampled)
js_crc32c for inputs 16836819B, avg 2055B x 26.00 ops/sec ±0.72% (47 runs sampled)
js_crc32 for inputs 1024B x 403,262 ops/sec ±1.55% (90 runs sampled)
js_crc32 for inputs 16836819B, avg 2055B x 24.82 ops/sec ±1.70% (45 runs sampled)
```

|                | 1024B             | 16836819B, avg 2055B |
|:---------------|------------------:|---------------------:|
| sse4_crc32c_hw | 3,210,508 ops/sec | 252 ops/sec          |
| sse4_crc32c_sw | 1,358,720 ops/sec | 96.41 ops/sec        |
| js_crc32c      | 409,615 ops/sec   | 26.00 ops/sec        |
| js_crc32       | 403,262 ops/sec   | 24.82 ops/sec        |

## Install

```shell
npm install fast-crc32c@^2.0.0 --save
# For node version before 6
# npm install fast-crc32c@^1.0.0 --save
```

### Usage

```javascript
var crc32 = require('fast-crc32c');
var result = crc32.calculate(data, initial);
```

- **data** required, String|Buffer, data to digest
- **initial** optional, Number, initial CRC-32C digest

[sse4_crc32]: https://github.com/Voxer/sse4_crc32
[buffer-crc32]: https://github.com/brianloveswords/buffer-crc32

---
_Source: https://npm.io/package/fast-crc32c · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._