StringBuilder.h

// Copyright (c) Stefano Cristiano
// SPDX-License-Identifier: MIT
#pragma once
#include "../Strings/StringFormat.h"
#include "StringsExport.h"
namespace SC
{
template <typename T>
struct StringBuilderFor;
 
struct SC_STRINGS_EXPORT StringBuilder
{
    // clang-format off
    template <typename T> static StringBuilderFor<T> create(T& stringOrBuffer) noexcept { return {stringOrBuffer, StringBuilder::Clear}; }
 
    template <typename T> static StringBuilderFor<T> createForAppendingTo(T& stringOrBuffer) noexcept { return {stringOrBuffer, StringBuilder::Append}; }
 
    template <typename T, typename... Types>
    [[nodiscard]] static bool format(T& buffer, StringView fmt, Types&&... args) { return StringBuilder::create(buffer).append(fmt, forward<Types>(args)...); }
    // clang-format on
 
    template <typename... Types>
    [[nodiscard]] bool append(StringView fmt, Types&&... args)
    {
        // It's ok parsing format string '{' and '}' both for utf8 and ascii with StringIteratorASCII
        // because on a valid UTF8 string, these chars are unambiguously recognizable
        StringFormatOutput sfo(encoding, *buffer);
        return StringFormat<StringIteratorASCII>::format(sfo, fmt, forward<Types>(args)...);
    }
 
    [[nodiscard]] bool append(StringView str);
 
    [[nodiscard]] bool appendReplaceAll(StringView source, StringView occurrencesOf, StringView with);
 
    enum class AppendHexCase
    {
        UpperCase,
        LowerCase,
    };
    [[nodiscard]] bool appendHex(Span<const uint8_t> data, AppendHexCase casing);
 
  protected:
    enum Flags
    {
        Clear, 
        Append 
    };
    friend struct Path;
 
    StringBuilder() = default;
    StringBuilder(IGrowableBuffer& ibuffer, StringEncoding encoding, Flags flags) noexcept;
    void initWithEncoding(IGrowableBuffer& bufferT, StringEncoding stringEncoding, Flags flags) noexcept;
 
    IGrowableBuffer* buffer = nullptr;
    StringEncoding   encoding;
};
 
template <typename T>
struct StringBuilderFor : public StringBuilder
{
    GrowableBuffer<T> growableBuffer;
    StringView        finalizedView;
    StringBuilderFor(T& stringOrBuffer, Flags flags) noexcept : growableBuffer(stringOrBuffer)
    {
        initWithEncoding(growableBuffer, GrowableBuffer<T>::getEncodingFor(stringOrBuffer), flags);
    }
 
    ~StringBuilderFor() noexcept { finalize(); }
 
    StringView finalize() noexcept
    {
        if (buffer)
        {
            growableBuffer.finalize();
            finalizedView = {{buffer->data(), buffer->size()}, true, encoding};
            buffer        = nullptr;
        }
        return view();
    }
 
    [[nodiscard]] StringView view() noexcept
    {
        SC_ASSERT_RELEASE(buffer == nullptr);
        return finalizedView;
    }
};
 
 
} // namespace SC