termcolor

Begriff

TermColor ist eine C ++-C ++-Bibliothek nur für Header, um farbige Nachrichten an das Terminal zu drucken. Nur zum Spaß mit Hilfe der Kraft geschrieben. TermColor verwendet die ANSI -Farbformatierung, sodass Sie es für jedes System verwenden können, das solche Terminals verwendet (die meisten *Nix -Systeme, einschließlich Linux und Mac OS).

Notiz

Unter Windows wird Windows -API anstelle von Escape -Codes verwendet, aber einige Einschränkungen werden angewendet (nicht alles wird unterstützt). Aus diesem Grund wird empfohlen, den virtuellen Terminalverarbeitungsmodus einzugeben und TERMCOLOR_USE_ANSI_ESCAPE_SEQUENCES -Makro zu setzen, um TermColor zu wenden, um ANSI -Farbcodes zu verwenden.

Es ist unter der BSD-Lizenz (3-Klausel) lizenziert. Das bedeutet im Grunde: Mach alles, was du willst, solange das Urheberrecht herum bleibt.

Installation

• Fügen Sie termcolor.hpp hinzu (schnappen Sie sich es von include/termcolor/termcolor.hpp ) zum Projekt und verwenden Sie Stream -Manipulatoren aus dem termcolor -Namespace.

• Sie können auch VCPKG verwenden, um die Bibliothek zu installieren:

  $ vcpkg install termcolor

• Oder wenn Sie auf MacOS sind, können Sie für diesen Zweck Homebrew verwenden:

  $ brew install termcolor

• Weitere Informationen zu vorhandenen Paketen finden Sie im folgenden Bild:

Wie benutze ich?

Es ist sehr einfach zu bedienen. Die Idee basiert auf C ++ Stream -Manipulatoren. Typische «Hallo Welt» Die Anwendung sieht so aus:

# 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 ;
}

Die obige Anwendung druckt eine Zeichenfolge mit verschiedenen Farben. Es gibt jedoch eine Einschränkung. Sie dürfen nicht vergessen, Farben zurückzusetzen, sonst werden sie auch auf andere Drucke angewendet.

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

Die korrekte Version des obigen Codes sollte so aussehen:

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

Standardmäßig ignoriert TermColor alle Farben für nicht-ty-Streams (z. B. std::stringstream ), also das folgende Snippet

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

druckt «Unicorn» mit Standardfarbe, nicht rot. Um dieses Verhalten zu ändern, kann man termcolor::colorize Manipulator verwenden, die Farben durchsetzen, egal was passiert.

Welche Manipulatoren werden unterstützt?

Die Manipulatoren sind in vier Gruppen unterteilt:

• Vordergrund , der die Textfarbe verändert;
• Hintergrund , der Texthintergrund ändert;
• Attribute , die einen Textstil ändert (fett, unterstreicht usw.);
• Kontrolle , die das Verhalten von TermColor ändert.

Außerdem gibt es Farbmanipulatoren für 16 Farben, 256 Farben und wahre Farbenpaletten.

Notiz

Während termcolor echte Farbe unterstützt, ist es für den Terminal -Emulator erforderlich, mit dem Sie Ihre Software ausführen, um auch echte Farbe zu unterstützen. Stellen Sie also sicher, dass es unterstützt wird, bevor es ein Problem eingereicht hat.

Vordergrundmanipulatoren

16 Farben

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 Farben

1. termcolor::color<256_COLOR_CODE>

wahre Farben

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

Hintergrundmanipulatoren

16 Farben

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 Farben

1. termcolor::on_color<256_COLOR_CODE>

wahre Farben

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

Attributmanipulatoren

(Windows -API unterstützt diese Manipulatoren nicht, außer bei 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

Kontrollmanipulatoren

(Windows -API unterstützt diese Manipulatoren nicht)

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

Einschränkungen

1. Unter Windows könnte der globale Namespace aufgrund der internen Nutzung von <windows.h> mit Min/Max -Makros verschmutzt werden. Wenn ein solcher Effekt wünschenswert ist, sollten Sie #define NOMINMAX vor #include <termcolor.hpp> verwenden.