termcolor

TermColor

TermColorは、色付きのメッセージを端末に印刷するためのヘッダーのみのC ++ライブラリです。フォースの助けを借りて楽しみのためだけに書かれています。 TermColorはANSIカラーフォーマットを使用するため、そのような端子（LinuxやMac OSを含むほとんど *nixシステム）を使用するすべてのシステムで使用できます。

注記

Windowsでは、エスケープコードの代わりにWindows APIが使用されますが、いくつかの制限が適用されます（すべてがサポートされているわけではありません）。そのため、仮想端子処理モードに入り、 TERMCOLOR_USE_ANSI_ESCAPE_SEQUENCES Macroを設定して、ANSIカラーコードを使用してTrick TermColorを設定することをお勧めします。

BSD（3節）ライセンスの下でライセンスされています。それは基本的に、著作権が固執する限り、あなたが望むことを何でもすることを意味します。

インストール

• termcolor.hpp （ include/termcolor/termcolor.hppからglab It）をプロジェクトに追加し、 termcolor Namepaceからストリームマニピュレーターを使用します。

• VCPKGを使用してライブラリをインストールすることもできます。

  $ vcpkg install termcolor

• または、MacOSを使用している場合は、その目的のためにHomebrewを使用できます。

  $ brew install termcolor

• 既存のパッケージに関する最新情報については、次の写真を参照してください。

使い方は？

とても使いやすいです。このアイデアは、C ++ストリームマニピュレーターに基づいて構築されています。典型的な«Hello World»アプリケーションは次のようになります：

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

上記のアプリケーションは、異なる色を使用して文字列を印刷します。ただし、1つの注意事項があります。色をリセットすることを忘れてはなりません。そうしないと、他のプリントにも適用されます。

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

上記のコードの正しいバージョンは次のようになります。

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

デフォルトでは、TermColorは非TTYストリームの色を無視します（例std::stringstream ）、次のスニペット

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

赤ではなくデフォルトの色を使用して«Unicorn»を印刷します。この動作を変更するために、 termcolor::colorize Manipulatorを使用して、何があっても色を強制するマニピュレーターを色付けできます。

どのマニピュレーターがサポートされていますか？

マニピュレーターは4つのグループに分けられます。

• テキストの色を変更する前景。
• テキストの背景色を変更する背景。
• いくつかのテキストスタイル（太字、下線など）を変更する属性。
• Termcolorの動作を変更する制御。

また、16色、256色、真の色のパレットのカラーマニピュレーターがあります。

注記

termcolor真の色をサポートしていますが、ソフトウェアを実行するために使用するターミナルエミュレーターにも真の色をサポートするために必要です。そのため、問題を提出する前にサポートされていることを確認してください。

前景マニピュレーター

16色

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色

1. termcolor::color<256_COLOR_CODE>

本当の色

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

背景マニピュレーター

16色

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色

1. termcolor::on_color<256_COLOR_CODE>

本当の色

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

属性マニピュレーター

（WindowsAPIは、 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

制御マニピュレーター

（WindowsAPIはこれらのマニピュレーターをサポートしていません）

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

警告

1. Windowsでは、 <windows.h>の内部使用により、グローバルネームスペースはMIN/MAXマクロで汚染される可能性があります。そのような効果が望ましい場合は、 #include <termcolor.hpp>の前に#define NOMINMAXを使用することを検討してください。