#string #concat #push

concat-in-place

Efficient macros for concatenation of strings and vectors

2 stable releases

1.1.0 Feb 27, 2022
1.0.0 Jan 27, 2020

#756 in Rust patterns

Download history 924/week @ 2023-10-17 810/week @ 2023-10-24 623/week @ 2023-10-31 650/week @ 2023-11-07 566/week @ 2023-11-14 432/week @ 2023-11-21 415/week @ 2023-11-28 352/week @ 2023-12-05 359/week @ 2023-12-12 540/week @ 2023-12-19 404/week @ 2023-12-26 439/week @ 2024-01-02 574/week @ 2024-01-09 526/week @ 2024-01-16 518/week @ 2024-01-23 468/week @ 2024-01-30

2,181 downloads per month

MIT/Apache

8KB
68 lines

concat-in-place

Crates.io Docs.rs

Provides efficient concatenation of strings and vectors

The goal of these macros are to reduce the amount of allocations that are required when concatenating string buffers and vectors; with a macro that makes it simple to achieve in practice.

Implementation Notes

  • The caller must provide a buffer for appending the slices to
  • The buffer is resized to accomodate the total length of all slices given

String Concatenation

Appends any number of string slices onto a string buffer

use concat_in_place::strcat;

let domain = "domain.com";
let endpoint = "inventory/parts";
let id = "10512";

let mut url = String::new();
let slice = strcat!(&mut url, domain "/" endpoint "/" id);
assert_eq!(slice, "domain.com/inventory/parts/10512");

Implementation Notes

Technically works with any string type that has the following methods:

  • capacity
  • len
  • push_str

Vector Concatenation

Appends any number of slices onto a vector

use concat_in_place::veccat;

let domain = b"domain.com";
let endpoint = b"inventory/parts";
let id = b"10512";

let mut url = Vec::new();
let slice = veccat!(&mut url, domain b"/" endpoint b"/" id);
assert_eq!(slice, b"domain.com/inventory/parts/10512");

Implementation Notes

Technically works with any type that has the following methods:

  • capacity
  • len
  • reserve
  • extend_from_slice

No runtime deps