posix-space

Crates.ioposix-space
lib.rsposix-space
version1.0.4
sourcesrc
created_at2022-08-13 05:15:45.997844
updated_at2023-06-02 17:40:57.610955
descriptionPure Rust implementation of `isspace` for the POSIX locale
homepagehttps://github.com/artichoke/posix-space
repositoryhttps://github.com/artichoke/posix-space
max_upload_size
id644474
size17,510
crates.io publishers (github:artichoke:crates-io-publishers)

documentation

https://docs.rs/posix-space

README

posix-space

GitHub Actions Code Coverage Discord Twitter
Crate API API trunk

A small crate which determines if a byte is classified as a space in the POSIX locale per POSIX.1-2017, chapter 7, Locale.

space

Define characters to be classified as white-space characters.

In the POSIX locale, exactly <space>, <form-feed>, <newline>, <carriage-return>, <tab>, and <vertical-tab> shall be included.

The function defined in this crate should have equivalent behavior to the C function isspace as defined in ctype.h.

Usage

Add this to your Cargo.toml:

[dependencies]
posix-space = "1.0.4"

Then classify bytes like:

assert!(posix_space::is_space(b' '));
assert!(posix_space::is_space(b'\t'));
assert!(posix_space::is_space(b'\r'));

assert!(!posix_space::is_space(b'\0'));
assert!(!posix_space::is_space(b'C'));
assert!(!posix_space::is_space(b'&'));

This crate's behavior differs from u8::is_ascii_whitespace in the Rust standard library in that <vertical-tab>, \x0B, is considered a space.

assert!(posix_space::is_space(b'\x0B'));

Crate features

posix-space is no_std with no dependencies outside of Rust core.

Minimum Supported Rust Version

This crate requires at least Rust 1.31.0. This version can be bumped in minor releases.

License

posix-space is licensed under the MIT License (c) Ryan Lopopolo.

Commit count: 119

cargo fmt