v_concat - a tiny library for blazing fast concatenation and prints

v_concat is a Rust library for blazing fast concatenation and prints.

After doing thousands of benchmarks we decided to create this crate to provide the fastest way possible to concatenate and print at the same time since macros like format! takes 10ms 🐢 while this crate concats and prints in only 280 microseconds YES! it is blazing fast, even with multithread tasks.

Examples

First of all include the crate as macro in your main.rs

#[macro_use]
extern crate v_concat;

Concat and print at the same time:

v_concat_println!( "\n ❌ Error getting path metadata: \"{}\"\n", meta.unwrap_err() );

Concat first, store it and print:

let str_one = "is immutable";
let str_two = "proven guilty";
let result  = v_concat!( "🚀 Everything {} until {}. {}", str_one, str_two, "123 ".repeat(4) );

v_concat_println!( "\n\r{}\n\r", result );

Overwrite previous print each second:

let total = 100;
let dur   = std::time::Duration::from_millis( 1000 );

for i in 0..total {
    std::thread::sleep( dur );
    v_concat_print!( "Loaded {} of {:?} records", i, total );
}

Supported OS

Platform
Linux
Windows
macOS
Android
iOS, tvOS, watchOS

Minimum Supported Rust Version

This crate requires Rust 1.94.1 or later.

Error handling

Generally, on supported platforms, failure is highly unlikely, though not impossible. If an error does occur, it is likely that it will occur on every call to v_concat. Therefore, after the first successful call, one can be reasonably confident that no errors will occur.

Panic handling

We strive to eliminate all potential panics from our backend implementations. In other words, when compiled with optimizations enabled, the generated binary code for v_concat functions should not contain any panic branches. Even if the platform misbehaves and returns an unexpected result, our code should correctly handle it and return an error.

Credits

License

The v_concat library is distributed under either of

at your convenience.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

v_concat 0.1.2