Introduction

Meziantou.Framework.FixedStringBuilder provides value types that hold a string of up to a fixed number of characters: FixedStringBuilder8, FixedStringBuilder16, FixedStringBuilder32 and FixedStringBuilder64. The characters are stored in the struct itself, so building, comparing and formatting the text allocates nothing on the heap until you call ToString():

FixedStringBuilder16 sb = $"Hello {"World"}";
sb.AppendLiteral("!");

string str = sb.ToString();
Assert.Equal("Hello World!", str);

Use them for short texts whose maximum length you know: identifiers, codes, keys, labels, log fields. A value that does not fit throws an ArgumentException: the types never truncate.

Packages

Next steps

• Getting started: create a fixed string with a literal or an interpolated string.
• Working with fixed strings: capacity, formatting, comparison, spans and generic code.
• Custom capacities: generate a type for another capacity.
• Diagnostics: the errors reported by the analyzer of the generator.