الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

TermColor

TermColor في العمل

TermColor هي مكتبة C ++ رأس فقط لطباعة الرسائل الملونة إلى المحطة. مكتوبة فقط من أجل المتعة بمساعدة القوة. يستخدم TermColor تنسيق ألوان ANSI ، بحيث يمكنك استخدامه على كل نظام يستخدم مثل هذه المحطات (معظم أنظمة *nix ، بما في ذلك Linux و Mac OS).

ملحوظة

على Windows ، يتم استخدام Windows API بدلاً من رموز الهروب ولكن يتم تطبيق بعض القيود (لا يتم دعم كل شيء). لهذا السبب يوصى بإدخال وضع المعالجة الطرفية الظاهرية وتعيين MACRO TERMCOLOR_USE_ANSI_ESCAPE_SEQUENCES لخداع TermColor لاستخدام رموز ألوان ANSI.

إنه مرخص بموجب رخصة BSD (3 نقطة). هذا يعني في الأساس: افعل ما تريد طالما أن حقوق الطبع والنشر يتجول.

تثبيت

  • أضف termcolor.hpp (احصل عليه من 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 يدعم اللون الحقيقي ، إلا أنه مطلوب لمحاكي الطرفية الذي تستخدمه لتشغيل البرنامج لدعم اللون الحقيقي أيضًا. لذا يرجى التأكد من دعمها قبل تقديم مشكلة.

المتلاعبون المقسمون

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> .
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل