Crate mangling

This module provides for converting arbitrary byte streams into valid C-language identifiers and back again.

The resulting symbol begins with an underscore character _, and is followed by zero or more groups of two types: printables and non-printables. The content of the input byte stream determines which type of group comes first, after which the two types alternate strictly.

• A printable group corresponds to the longest substring of the input that can be consumed while matching the (case-insensitive) regular expression [a-z][a-z0-9_]*. The mangled form is Naaa where N is the unbounded decimal length of the substring in the original input, and aaa is the literal substring.
• A non-printable group represents the shortest substring in the input that can be consumed before a printable substring begins to match. The mangled form is 0N_xxxxxx where 0 and _ are literal, N is the unbounded decimal length of the substring in the original input, and xxxxxx is the lowercase hexadecimal expansion of the original bytes (two hexadecimal digits per input byte, most significant nybble first).

Note that despite the description above, the current implementation does not actually use regular expressions for matching.

For example:

let input = "abc/123x".as_bytes();
let expect = "_3abc04_2f3132331x";

let output = mangling::mangle(input.to_vec());
assert_eq!(output, expect);

let reverse = mangling::demangle(expect).unwrap();
assert_eq!(reverse, input);

Functions

demangle	Takes a string slice corresponding to a symbol as converted by the mangle function, and returns a vector of bytes corresponding to the original input to the mangle function.
mangle	Takes an IntoIterator over u8 and produces a String that is safe to use as an identifier in the C language.

Type Definitions

ManglingResult

A generic Result type for functions in this module