termcolor

Термин

Termcolor-это библиотека C ++ только для заголовка для печати цветных сообщений на терминал. Написано просто для развлечения с помощью силы. Termcolor использует форматирование цвета ANSI, поэтому вы можете использовать его в каждой системе, которая используется такие терминалы (большинство систем NIX, включая Linux и Mac OS).

Примечание

В Windows используется API Windows вместо кодов побега, но применяются некоторые ограничения (не все поддерживается). Вот почему рекомендуется войти в режим обработки виртуальных терминалов и установить макрос TERMCOLOR_USE_ANSI_ESCAPE_SEQUENCES , чтобы обмануть Termcolor для использования цветных кодов ANSI.

Он лицензирован по лицензии BSD (3-rack). Это в основном означает: делайте все, что вы хотите, пока обходится авторским правом.

Установка

• Добавьте termcolor.hpp (Grap It From include/termcolor/termcolor.hpp ) в проект и используйте манипуляторы потока из пространства имен termcolor .

• Вы также можете использовать 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 ;
}

Приложение выше печатает строку, используя разные цвета. Хотя есть одно предостережение. Вы не должны забывать сбросить цвета, иначе они будут применены и к другим отпечаткам.

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();

печатать «Единорог», используя цвет по умолчанию, а не красный. Чтобы изменить это поведение, можно использовать termcolor::colorize Manipulator, который обеспечивает соблюдение цвета, несмотря ни на что.

Какие манипуляторы поддерживаются?

Манипуляторы разделены на четыре группы:

• передний план , который меняет цвет текста;
• фон , который меняет цвет фона текста;
• атрибуты , которые изменяют некоторый стиль текста (жирный жирный, подчеркивание и т. Д.);
• контроль , который меняет поведение Termcolor.

Кроме того, есть цветные манипуляторы для 16 цветов, 256 цветов и палитр настоящих цветов.

Примечание

В то время как termcolor поддерживает True Color, это необходимо для эмулятора терминала, который вы используете для запуска своего программного обеспечения для поддержки истинного цвета. Поэтому, пожалуйста, убедитесь, что он поддерживается перед подачей проблемы.

Манипуляторы переднего плана

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>

Манипуляторы атрибута

(Windows API не поддерживает эти манипуляторы, за исключением 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

Контрольные манипуляторы

(Windows API не поддерживает эти манипуляторы)

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

Предостережения

1. В Windows, из -за внутреннего использования <windows.h> , глобальное пространство имен может быть загрязнено макросами Min/Max. Если такой эффект желателен, пожалуйста, рассмотрите возможность использования #define NOMINMAX до #include <termcolor.hpp> .