#display #string-representation #helper #formatting #buffer #fmt #stack

no-std display_buffer

A helper library to make implementing core::fmt::Display easier

2 releases

0.1.0 Jan 20, 2024
0.1.0-rc.1 Jan 2, 2024

#260 in Value formatting

MIT license

8KB
78 lines

display_buffer

display_buffer is a no_std helper library to make implementing core::fmt::Display easier.

While implementing core::fmt::Display for a new type seems quite easy, it is actually quite complex to support formatting parameters correctly. Fortunately most of this complexity can be avoided by deferring to the implementation for str in the core library. However the naive way of doing this is to create a String using format! which allocates space on the heap. For a lot of types the string representation is not that long and so it could easily be formatted into a buffer on the stack.

For types which can be formatted using a single core::write!, the fmt! helper macro is provided.

No runtime deps