aloe-char

Aloe-char is a Rust crate designed for developers requiring advanced manipulation of character encodings within strings. It provides robust utilities for handling UTF-8, UTF-16, UTF-32, and ASCII encodings. With a focus on flexibility, the crate allows you to switch internal storage formats, enabling optimized memory usage or rapid indexing.

Features

• Character Pointer Implementations: Abstract data structures (CharPointer_UTF32, CharPointer_UTF16, CharPointer_UTF8, CharPointer_ASCII) help manipulate null-terminated strings.
• Flexible Encoding Types: Change the internal encoding type via ALOE_STRING_UTF_TYPE to suit specific memory and performance needs.
• Support for ASCII and UTF Character Sets: Efficient operations across various encoding types such as length calculation, pointer arithmetic, and character comparison.
• Conversion Functions: Seamlessly convert between UTF-8, UTF-16, and UTF-32 through toUTF8(), toUTF16(), toUTF32() methods.
• Atomic Operations: Safe manipulation of character pointers through atomic swaps.

Getting Started

Add the following to your Cargo.toml:

[dependencies]
aloe-char = "0.1.0"

Utilize the character pointer structures to navigate strings effectively within your application logic. Tailor the Unicode encoding by setting the desired ALOE_STRING_UTF_TYPE configuration at compile time.

Usage

// Example of creating and manipulating a UTF-32 character pointer
use aloe_char::CharPointer_UTF32;

fn main() {
    let mut pointer = CharPointer_UTF32::new(raw_utf32_pointer);
    pointer.write('A');
    println!("Character: {}", *pointer);
}

License

aloe-char is licensed under the GPL-3.0 license.

Contributing

Issues and contributions are welcome. Please submit your changes to the GitHub repository: Github Repo

This README.md file was generated by an AI model. Despite efforts for accuracy, please verify details manually.

This crate is a translation of the JUCE module.

JUCE is a c++ software framework for developing high performance audio applications.

Usage falls under the GPLv3 as well as the JUCE commercial license.

See github.com/juce-framework/JUCE and the JUCE license page for details.

This crate is in the process of being translated from c++ to rust. For progress updates, please see the workspacer rust project. designed specifically for rust projects.