TextTable.hpp

Go to the documentation of this file.

/*
 * ======================================================================================
 *
 * ░▒▓███████▓▒░░▒▓████████▓▒░▒▓███████▓▒░       ░▒▓███████▓▒░ ░▒▓██████▓▒░▒▓████████▓▒░
 * ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░      ░▒▓█▓▒░░▒▓█▓▒░      ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░
 * ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░      ░▒▓█▓▒░░▒▓█▓▒░      ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░
 * ░▒▓███████▓▒░░▒▓██████▓▒░ ░▒▓█▓▒░░▒▓█▓▒░      ░▒▓███████▓▒░░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░
 * ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░      ░▒▓█▓▒░░▒▓█▓▒░      ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░
 * ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░      ░▒▓█▓▒░░▒▓█▓▒░      ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░
 * ░▒▓███████▓▒░░▒▓████████▓▒░▒▓█▓▒░░▒▓█▓▒░      ░▒▓███████▓▒░ ░▒▓██████▓▒░  ░▒▓█▓▒░
 *
 * ======================================================================================
 */

 
#pragma once
 
#include <cstddef> // IWYU pragma: keep - for size_t
#include <functional>
#include <span>
#include <string>
#include <string_view>
#include <vector>
 
namespace util::strings {
 
using std::size_t;
using std::string;
using std::string_view;

struct [[nodiscard]] TextTable final {
    auto append_column(string_view text) -> TextTable&;

    auto new_row() -> TextTable&;

    [[nodiscard]] auto to_string() const -> string;

    using PrintFunc = std::function<void(string_view)>;

    void print(
        PrintFunc&&           printHeading,
        PrintFunc&&           printCell,
        PrintFunc&&           printOutline,
        std::function<void()> printNewline) const;

    using Widths = std::span<const size_t>;
 
private:
    struct Row final {
        void add_column(string_view text) { columns.emplace_back(text); }
 
        [[nodiscard]] auto get_columns() const noexcept -> std::span<const string>
        {
            return columns;
        }
 
        [[nodiscard]] auto to_string(Widths widths) const -> string;
 
        void print(
            const PrintFunc&        printCell,
            const PrintFunc&        printOutline,
            std::span<const size_t> widths) const;
 
    private:
        std::vector<string> columns;
    };
 
    [[nodiscard]] auto num_columns() const -> size_t;
 
    [[nodiscard]] auto get_column_widths() const -> std::vector<size_t>;
 
    std::vector<Row> rows;
 
    bool startNewRow { true };
};
 
} // namespace util::strings