Markup.hpp

#pragma once

#include <cstdint>
#include <cstdbool>
#include <cstddef> //size_t

/*

used by Sprintf class

//allow multiple markup codes by using { } to enclose codes

{{ = {
{!} = reset ansi color/attributes
{+} = markup on (state perists between use)
{-} = markup off (markup ignored, not printed, initial state is off)
{/} = italic
{|} = normal
{_} = underline
{K} = blacK foreground, uppercase character = foreground color
{k} = blacK background, lowercase character = background color
    colors= K R G Y B M C W (foreground) k rk g y b m c w (background)
    blacK Red Green Yellow Blue Magenta Cyan White

examples (assuming a Uart object named uart which has printf function)-
    uart.printf("{+!}Test");    //turn on markup, reset ansi, print "Test"
    uart.printf("{Kw/}hello{kW|}");//foreground blacK, background white
                                //print "hello" in italics
                                //foreground White, background black, normal
    uart.printf("{-}");         //markup off
    uart.printf("{Rg}hello{kW}");//print "hello" (markup ignored, is off)
    uart.printf("{+G}hello{W}"); /markup back on, foreground Green
                                //print "hello"
                                //foreground White

    if result of markup exceeds size of temporary markup buffer,
    all markup will be stripped from incoming buffer and result
    will still be printed

*/

struct Markup {

    protected:

Markup      () //prevent direct use
            {
            }

            auto
markup      (char*, size_t) -> bool;


            //strip markup from string (modify string in place)
            auto
strip       (char*) -> bool;

    private:

            bool m_ison{false};

            static const char m_trigger{'{'};
            static const char m_trigger_end{'}'};
            static const char m_turnon{'+'};
            static const char m_turnoff{'-'};

            //ansi forecolor
            static constexpr const char* m_blacK   = "K\033[38;5;0m";
            static constexpr const char* m_Red     = "R\033[38;5;196m";
            static constexpr const char* m_Green   = "G\033[38;5;48m";
            static constexpr const char* m_Yellow  = "Y\033[38;5;226m";
            static constexpr const char* m_Blue    = "B\033[38;5;26m";
            static constexpr const char* m_Magenta = "M\033[38;5;163m";
            static constexpr const char* m_Cyan    = "C\033[38;5;6m";
            static constexpr const char* m_White   = "W\033[38;5;15m";
            //ansi backcolor
            static constexpr const char* m_black   = "k\033[48;5;0m";
            static constexpr const char* m_red     = "r\033[48;5;196m";
            static constexpr const char* m_green   = "g\033[48;5;48m";
            static constexpr const char* m_yellow  = "y\033[48;5;226m";
            static constexpr const char* m_blue    = "b\033[48;5;26m";
            static constexpr const char* m_magenta = "m\033[48;5;163m";
            static constexpr const char* m_cyan    = "c\033[48;5;6m";
            static constexpr const char* m_white   = "w\033[48;5;15m";
            //reset colors/attributes/cls/home
            static constexpr const char* m_reset   = "!\033[0;38;5;15m"
                                                     "\033[48;5;0m"
                                                     "\033[2J"
                                                     "\033[1;1H";
            //italic
            static constexpr const char* m_italic  = "/\033[3m";
            //normal
            static constexpr const char* m_normal  = "|\033[0m";
            //underline
            static constexpr const char* m_underline= "_\033[4m";

            using
codes_t     = struct
            {
            const char* ansistr;    //includes markup character to match
            const uint8_t siz;      //not including match character
            };

            //store all markup char+ansi codes and size of string-1
            static const codes_t m_codes[];

};