termcolor

Termcolor

TermColor adalah perpustakaan C ++ hanya header untuk mencetak pesan berwarna ke terminal. Ditulis hanya untuk bersenang -senang dengan bantuan pasukan. TermColor menggunakan pemformatan warna ANSI, sehingga Anda dapat menggunakannya pada setiap sistem yang digunakan terminal tersebut (sebagian besar sistem *nix, termasuk Linux dan Mac OS).

Catatan

Pada Windows, Windows API digunakan sebagai pengganti kode pelarian tetapi beberapa batasan diterapkan (tidak semuanya didukung). Itu sebabnya disarankan untuk memasukkan mode pemrosesan terminal virtual dan mengatur makro TERMCOLOR_USE_ANSI_ESCAPE_SEQUENCES untuk menipu termcolor untuk menggunakan kode warna ANSI.

Ini dilisensikan di bawah lisensi BSD (3-klausa). Itu pada dasarnya berarti: Lakukan apa pun yang Anda inginkan selama hak cipta menempel.

Instalasi

• Tambahkan termcolor.hpp (ambil dari include/termcolor/termcolor.hpp ) ke proyek dan gunakan manipulator aliran dari termcolor namespace.

• Anda juga dapat menggunakan VCPKG untuk menginstal perpustakaan:

  $ vcpkg install termcolor

• Atau jika Anda menggunakan macOS, Anda dapat menggunakan homebrew untuk tujuan itu:

  $ brew install termcolor

• Untuk informasi terkini tentang paket yang ada, lihat gambar berikut:

Bagaimana cara menggunakannya?

Sangat mudah digunakan. Idenya dibangun di atas manipulator aliran C ++. Aplikasi khas «Hello World» terlihat seperti ini:

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

Aplikasi di atas mencetak string menggunakan warna yang berbeda. Ada satu peringatan. Anda tidak boleh lupa untuk mengatur ulang warna, jika tidak mereka akan diterapkan pada cetakan lain juga.

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

Versi yang benar dari kode di atas akan terlihat seperti ini:

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

Secara default, Termcolor mengabaikan warna apa pun untuk aliran non-dua (misalnya std::stringstream ), jadi cuplikan berikut

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

Akan mencetak «unicorn» menggunakan warna default, bukan merah. Untuk mengubah perilaku ini, seseorang dapat menggunakan termcolor::colorize yang menegakkan warna apa pun yang terjadi.

Manipulator apa yang didukung?

Manipulator dibagi menjadi empat kelompok:

• latar depan , yang mengubah warna teks;
• latar belakang , yang mengubah warna latar belakang teks;
• atribut , yang mengubah beberapa gaya teks (tebal, garis bawah, dll);
• kontrol , yang mengubah perilaku Termcolor.

Juga, ada manipulator warna untuk 16 warna, 256 warna dan palet warna yang sebenarnya.

Catatan

Sementara termcolor mendukung warna sejati, itu diperlukan untuk emulator terminal yang Anda gunakan untuk menjalankan perangkat lunak Anda untuk mendukung warna yang sebenarnya juga. Jadi harap pastikan itu didukung sebelum mengajukan masalah.

Manipulator latar depan

16 warna

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 warna

1. termcolor::color<256_COLOR_CODE>

warna sejati

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

Manipulator latar belakang

16 warna

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 warna

1. termcolor::on_color<256_COLOR_CODE>

warna sejati

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

Atribut manipulator

(Windows API tidak mendukung manipulator ini kecuali untuk 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

Manipulator kontrol

(Windows API tidak mendukung manipulator ini)

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

Peringatan

1. Di Windows, karena penggunaan internal <windows.h> , namespace global dapat tercemar dengan makro min/max. Jika efek tersebut diinginkan, silakan pertimbangkan untuk menggunakan #define NOMINMAX sebelum #include <termcolor.hpp> .