Exposes a safe interface to libc's memchr in Rust.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bench memchr: rewrite everything Sep 17, 2018
ci ci: test on big endian Jan 8, 2019
src ci: test on big endian Jan 8, 2019
.gitignore bench: add criterion benchmarks Sep 17, 2018
.travis.yml ci: test on big endian Jan 8, 2019
COPYING Initial commit. Jun 11, 2015
Cargo.toml 2.1.3 Jan 19, 2019
LICENSE-MIT Initial commit. Jun 11, 2015
Makefile Initial commit. Jun 11, 2015
README.md readme: typo Sep 17, 2018
UNLICENSE Initial commit. Jun 11, 2015
appveyor.yml memchr: rewrite everything Sep 17, 2018
build.rs deps: remove version_check Jan 19, 2019
ctags.rust Initial commit. Jun 11, 2015
session.vim Initial commit. Jun 11, 2015

README.md

memchr

The memchr crate provides heavily optimized routines for searching bytes.

Build status Build status

Dual-licensed under MIT or the UNLICENSE.

Documentation

https://docs.rs/memchr

Overview

The memchr function is traditionally provided by libc, however, the performance of memchr can vary significantly depending on the specific implementation of libc that is used. They can range from manually tuned Assembly implementations (like that found in GNU's libc) all the way to non-vectorized C implementations (like that found in MUSL).

To smooth out the differences between implementations of libc, at least on x86_64 for Rust 1.27+, this crate provides its own implementation of memchr that should perform competitively with the one found in GNU's libc. The implementation is in pure Rust and has no dependency on a C compiler or an Assembler.

Additionally, GNU libc also provides an extension, memrchr. This crate provides its own implementation of memrchr as well, on top of memchr2, memchr3, memrchr2 and memrchr3. The difference between memchr and memchr2 is that that memchr2 permits finding all occurrences of two bytes instead of one. Similarly for memchr3.

Compiling without the standard library

memchr links to the standard library by default, but you can disable the use_std feature if you want to use it in a #![no_std] crate:

[dependencies]
memchr = { version = "2", default-features = false }