nanokit

About

A collection of tiny, reusable utility methods that reduce code size and improve performance. Readme for developers/contributors is available at README-DEV.MD.

String Construction

Fast way to concatenate strings:

use nanokit::string_concat::concat_2;
let base_msg = "Hello, ";
let text = "world!";
let result = concat_2(base_msg, text);
assert_eq!(result, "Hello, world!");

And with any type that implements AsRef<str>:

use nanokit::string_concat::concat_2;
let base_string = String::from("The quick brown fox ");
let text_string = String::from("jumps over the lazy dog.");
let result = concat_2(base_string, text_string);
assert_eq!(result, "The quick brown fox jumps over the lazy dog.");

This is similar to libraries like concat_strs and string_concat, except that instead of pushing strings onto a preallocated String instance, we instead unsafely create a new String instance and adjust the length.

This saves around 150 bytes of code in codebases that otherwise don't use string concatenation (push_str or add). Also saves some instructions.

Additional methods concat_3, concat_4, concat_5 exist.

Unsafe Concat

You can save on another 2 instructions per concatenation if you know the final string length is lesser than isize::MAX.

use nanokit::string_concat::concat_2;
let base_msg = "Hello, ";
let text = "world!";
let result = concat_2_no_overflow(base_msg, text);
assert_eq!(result, "Hello, world!");

Features

• no-inline-concat: Disables inlining of string concat functions (saves code size).

Contributing

See CONTRIBUTING for guidance on how to contribute to this project.

License

nanokit is part of the Reloaded suite of libraries. Licensed under MIT.

If you find this library useful, please contribute back!!