termcolor

TermColor

O TermColor é uma biblioteca C ++ somente para a impressão de mensagens coloridas no terminal. Escrito apenas para se divertir com a ajuda da força. O TermColor usa a formatação de cores ANSI, para que você possa usá -lo em todos os sistemas que sejam usados ​​esses terminais (a maioria dos sistemas *nix, incluindo Linux e Mac OS).

Observação

No Windows, a API do Windows é usada em vez de códigos de fuga, mas algumas limitações são aplicadas (nem tudo é suportado). É por isso que é recomendável entrar no modo de processamento do terminal virtual e definir TERMCOLOR_USE_ANSI_ESCAPE_SEQUENCES macro para enganar o TermColor para usar os códigos de cores ANSI.

É licenciado sob a licença BSD (3-cláusulas). Isso basicamente significa: faça o que quiser, desde que os direitos autorais permaneçam por aí.

Instalação

• Adicione termcolor.hpp (pegue -o de include/termcolor/termcolor.hpp ) ao projeto e use manipuladores de fluxo do espaço para nome termcolor .

• Você também pode usar o VCPKG para instalar a biblioteca:

  $ vcpkg install termcolor

• Ou se você estiver no macOS, pode usar o homebrew para esse fim:

  $ brew install termcolor

• Para obter informações atualizadas sobre os pacotes existentes, consulte a figura a seguir:

Como usar?

É muito fácil de usar. A idéia é construída sobre manipuladores de fluxo C ++. Típico «Hello World Application se parece com o seguinte:

# include < iostream >
# include < termcolor/termcolor.hpp >

int main ( int /* argc */ , char ** /* argv */ )
{
    std::cout << termcolor::red << " Hello, " ;                   // 16 colors
    std::cout << termcolor::color< 100 > << " Colorful " ;          // 256 colors
    std::cout << termcolor::color< 211 , 54 , 130 > << " World! " ;    // true colors
    std::cout << std::endl;
    return 0 ;
}

O aplicativo acima imprime uma string usando cores diferentes. Há uma ressalva. Você não deve esquecer de redefinir as cores, caso contrário elas serão aplicadas a outras impressões também.

std::cout << termcolor::red << " Hello, Colorful World! " << std::endl;
std::cout << " I'm RED too! " << std::endl;

A versão correta do código acima deve ficar assim:

std::cout << termcolor::red << " Hello, Colorful World! " << termcolor::reset << std::endl;
std::cout << termcolor::reset << " Here I'm! " << std::endl;

std::stringstream padrão, o TermColor ignora qualquer cor para fluxos que não

std::stringstream ss;
ss << termcolor::red << " unicorn " ;
std::cout << ss.str();

Imprimirá «unicórnio» usando a cor padrão, não vermelha. Para alterar esse comportamento, pode -se usar o Manipulador termcolor::colorize que aplique cores, não importa o quê.

Quais manipuladores são suportados?

Os manipuladores são divididos em quatro grupos:

• primeiro plano , que muda de cor do texto;
• fundo , que altera a cor de fundo do texto;
• atributos , que mudam algum estilo de texto (em negrito, sublinhado, etc);
• Controle , que altera o comportamento do TermColor.

Além disso, existem manipuladores de cores para 16 cores, 256 cores e paletas de cores verdadeiras.

Observação

Enquanto termcolor suporta a verdadeira cor, é necessário para o emulador de terminal que você usa para executar seu software para oferecer suporte à verdadeira cor. Portanto, verifique se ele é suportado antes de apresentar um problema.

Manipuladores de primeiro plano

16 cores

1. termcolor::grey
2. termcolor::red
3. termcolor::green
4. termcolor::yellow
5. termcolor::blue
6. termcolor::magenta
7. termcolor::cyan
8. termcolor::white
9. termcolor::bright_grey
10. termcolor::bright_red
11. termcolor::bright_green
12. termcolor::bright_yellow
13. termcolor::bright_blue
14. termcolor::bright_magenta
15. termcolor::bright_cyan
16. termcolor::bright_white

256 cores

1. termcolor::color<256_COLOR_CODE>

cores verdadeiras

1. termcolor::color<RED, GREEN, BLUE>

Manipuladores de fundo

16 cores

1. termcolor::on_grey
2. termcolor::on_red
3. termcolor::on_green
4. termcolor::on_yellow
5. termcolor::on_blue
6. termcolor::on_magenta
7. termcolor::on_cyan
8. termcolor::on_white
9. termcolor::on_bright_grey
10. termcolor::on_bright_red
11. termcolor::on_bright_green
12. termcolor::on_bright_yellow
13. termcolor::on_bright_blue
14. termcolor::on_bright_magenta
15. termcolor::on_bright_cyan
16. termcolor::on_bright_white

256 cores

1. termcolor::on_color<256_COLOR_CODE>

cores verdadeiras

1. termcolor::on_color<RED, GREEN, BLUE>

Atributo manipuladores

(A API do Windows não suporta esses manipuladores, exceto para underline )

1. termcolor::bold
2. termcolor::dark
3. termcolor::italic
4. termcolor::underline
5. termcolor::blink
6. termcolor::reverse
7. termcolor::concealed
8. termcolor::crossed

Manipuladores de controle

(API do Windows não suporta esses manipuladores)

1. termcolor::colorize
2. termcolor::nocolorize

Advertências

1. No Windows, devido ao uso interno de <windows.h> , o espaço para nome global pode ser poluído com macros min/max. Se esse efeito for desejável, considere usar #define NOMINMAX antes #include <termcolor.hpp> .