formatting.md

Text Formatting

• StringBuilder: - String builder type.
• String::Format: - Universal string formatter.

Usage

#include <Caitlyn/IO>

using namespace Caitlyn;

int main()
{
    const String first = "Hello";
    const String second = "world";
    
    const auto data = String::Format("{}, {}!", first, second);
    
    // Alignment
    OutputStream::WriteLine("l: '{:<25}'", data);
    OutputStream::WriteLine("c: '{:^25}'", data);
    OutputStream::WriteLine("r: '{:>25}'\n", data);
    // Precision
    OutputStream::WriteLine("floating: {:.4f}", 64.932698);
    OutputStream::WriteLine("decimal:  {:d}\n", 6427123266375693);
    // Filling
    OutputStream::WriteLine("line: {:-<24}", "");
    OutputStream::WriteLine("fill: {:*^24}\n", "TEXT");
    // Other
    OutputStream::WriteLine("escaped: {{text}}\n");
    
    return 0;
}

Output

l: 'Hello, world!            '
c: '      Hello, world!      '
r: '            Hello, world!'

floating: 64.9326
decimal:  6427123266375693

line: ------------------------
fill: **********TEXT**********

escaped: {text}