| // Formatting library for C++ - color support |
| // |
| // Copyright (c) 2018 - present, Victor Zverovich and fmt contributors |
| // All rights reserved. |
| // |
| // For the license information refer to format.h. |
| |
| #ifndef FMT_COLOR_H_ |
| #define FMT_COLOR_H_ |
| |
| #include "format.h" |
| |
| FMT_BEGIN_NAMESPACE |
| |
| enum class color : uint32_t { |
| alice_blue = 0xF0F8FF, // rgb(240,248,255) |
| antique_white = 0xFAEBD7, // rgb(250,235,215) |
| aqua = 0x00FFFF, // rgb(0,255,255) |
| aquamarine = 0x7FFFD4, // rgb(127,255,212) |
| azure = 0xF0FFFF, // rgb(240,255,255) |
| beige = 0xF5F5DC, // rgb(245,245,220) |
| bisque = 0xFFE4C4, // rgb(255,228,196) |
| black = 0x000000, // rgb(0,0,0) |
| blanched_almond = 0xFFEBCD, // rgb(255,235,205) |
| blue = 0x0000FF, // rgb(0,0,255) |
| blue_violet = 0x8A2BE2, // rgb(138,43,226) |
| brown = 0xA52A2A, // rgb(165,42,42) |
| burly_wood = 0xDEB887, // rgb(222,184,135) |
| cadet_blue = 0x5F9EA0, // rgb(95,158,160) |
| chartreuse = 0x7FFF00, // rgb(127,255,0) |
| chocolate = 0xD2691E, // rgb(210,105,30) |
| coral = 0xFF7F50, // rgb(255,127,80) |
| cornflower_blue = 0x6495ED, // rgb(100,149,237) |
| cornsilk = 0xFFF8DC, // rgb(255,248,220) |
| crimson = 0xDC143C, // rgb(220,20,60) |
| cyan = 0x00FFFF, // rgb(0,255,255) |
| dark_blue = 0x00008B, // rgb(0,0,139) |
| dark_cyan = 0x008B8B, // rgb(0,139,139) |
| dark_golden_rod = 0xB8860B, // rgb(184,134,11) |
| dark_gray = 0xA9A9A9, // rgb(169,169,169) |
| dark_green = 0x006400, // rgb(0,100,0) |
| dark_khaki = 0xBDB76B, // rgb(189,183,107) |
| dark_magenta = 0x8B008B, // rgb(139,0,139) |
| dark_olive_green = 0x556B2F, // rgb(85,107,47) |
| dark_orange = 0xFF8C00, // rgb(255,140,0) |
| dark_orchid = 0x9932CC, // rgb(153,50,204) |
| dark_red = 0x8B0000, // rgb(139,0,0) |
| dark_salmon = 0xE9967A, // rgb(233,150,122) |
| dark_sea_green = 0x8FBC8F, // rgb(143,188,143) |
| dark_slate_blue = 0x483D8B, // rgb(72,61,139) |
| dark_slate_gray = 0x2F4F4F, // rgb(47,79,79) |
| dark_turquoise = 0x00CED1, // rgb(0,206,209) |
| dark_violet = 0x9400D3, // rgb(148,0,211) |
| deep_pink = 0xFF1493, // rgb(255,20,147) |
| deep_sky_blue = 0x00BFFF, // rgb(0,191,255) |
| dim_gray = 0x696969, // rgb(105,105,105) |
| dodger_blue = 0x1E90FF, // rgb(30,144,255) |
| fire_brick = 0xB22222, // rgb(178,34,34) |
| floral_white = 0xFFFAF0, // rgb(255,250,240) |
| forest_green = 0x228B22, // rgb(34,139,34) |
| fuchsia = 0xFF00FF, // rgb(255,0,255) |
| gainsboro = 0xDCDCDC, // rgb(220,220,220) |
| ghost_white = 0xF8F8FF, // rgb(248,248,255) |
| gold = 0xFFD700, // rgb(255,215,0) |
| golden_rod = 0xDAA520, // rgb(218,165,32) |
| gray = 0x808080, // rgb(128,128,128) |
| green = 0x008000, // rgb(0,128,0) |
| green_yellow = 0xADFF2F, // rgb(173,255,47) |
| honey_dew = 0xF0FFF0, // rgb(240,255,240) |
| hot_pink = 0xFF69B4, // rgb(255,105,180) |
| indian_red = 0xCD5C5C, // rgb(205,92,92) |
| indigo = 0x4B0082, // rgb(75,0,130) |
| ivory = 0xFFFFF0, // rgb(255,255,240) |
| khaki = 0xF0E68C, // rgb(240,230,140) |
| lavender = 0xE6E6FA, // rgb(230,230,250) |
| lavender_blush = 0xFFF0F5, // rgb(255,240,245) |
| lawn_green = 0x7CFC00, // rgb(124,252,0) |
| lemon_chiffon = 0xFFFACD, // rgb(255,250,205) |
| light_blue = 0xADD8E6, // rgb(173,216,230) |
| light_coral = 0xF08080, // rgb(240,128,128) |
| light_cyan = 0xE0FFFF, // rgb(224,255,255) |
| light_golden_rod_yellow = 0xFAFAD2, // rgb(250,250,210) |
| light_gray = 0xD3D3D3, // rgb(211,211,211) |
| light_green = 0x90EE90, // rgb(144,238,144) |
| light_pink = 0xFFB6C1, // rgb(255,182,193) |
| light_salmon = 0xFFA07A, // rgb(255,160,122) |
| light_sea_green = 0x20B2AA, // rgb(32,178,170) |
| light_sky_blue = 0x87CEFA, // rgb(135,206,250) |
| light_slate_gray = 0x778899, // rgb(119,136,153) |
| light_steel_blue = 0xB0C4DE, // rgb(176,196,222) |
| light_yellow = 0xFFFFE0, // rgb(255,255,224) |
| lime = 0x00FF00, // rgb(0,255,0) |
| lime_green = 0x32CD32, // rgb(50,205,50) |
| linen = 0xFAF0E6, // rgb(250,240,230) |
| magenta = 0xFF00FF, // rgb(255,0,255) |
| maroon = 0x800000, // rgb(128,0,0) |
| medium_aquamarine = 0x66CDAA, // rgb(102,205,170) |
| medium_blue = 0x0000CD, // rgb(0,0,205) |
| medium_orchid = 0xBA55D3, // rgb(186,85,211) |
| medium_purple = 0x9370DB, // rgb(147,112,219) |
| medium_sea_green = 0x3CB371, // rgb(60,179,113) |
| medium_slate_blue = 0x7B68EE, // rgb(123,104,238) |
| medium_spring_green = 0x00FA9A, // rgb(0,250,154) |
| medium_turquoise = 0x48D1CC, // rgb(72,209,204) |
| medium_violet_red = 0xC71585, // rgb(199,21,133) |
| midnight_blue = 0x191970, // rgb(25,25,112) |
| mint_cream = 0xF5FFFA, // rgb(245,255,250) |
| misty_rose = 0xFFE4E1, // rgb(255,228,225) |
| moccasin = 0xFFE4B5, // rgb(255,228,181) |
| navajo_white = 0xFFDEAD, // rgb(255,222,173) |
| navy = 0x000080, // rgb(0,0,128) |
| old_lace = 0xFDF5E6, // rgb(253,245,230) |
| olive = 0x808000, // rgb(128,128,0) |
| olive_drab = 0x6B8E23, // rgb(107,142,35) |
| orange = 0xFFA500, // rgb(255,165,0) |
| orange_red = 0xFF4500, // rgb(255,69,0) |
| orchid = 0xDA70D6, // rgb(218,112,214) |
| pale_golden_rod = 0xEEE8AA, // rgb(238,232,170) |
| pale_green = 0x98FB98, // rgb(152,251,152) |
| pale_turquoise = 0xAFEEEE, // rgb(175,238,238) |
| pale_violet_red = 0xDB7093, // rgb(219,112,147) |
| papaya_whip = 0xFFEFD5, // rgb(255,239,213) |
| peach_puff = 0xFFDAB9, // rgb(255,218,185) |
| peru = 0xCD853F, // rgb(205,133,63) |
| pink = 0xFFC0CB, // rgb(255,192,203) |
| plum = 0xDDA0DD, // rgb(221,160,221) |
| powder_blue = 0xB0E0E6, // rgb(176,224,230) |
| purple = 0x800080, // rgb(128,0,128) |
| rebecca_purple = 0x663399, // rgb(102,51,153) |
| red = 0xFF0000, // rgb(255,0,0) |
| rosy_brown = 0xBC8F8F, // rgb(188,143,143) |
| royal_blue = 0x4169E1, // rgb(65,105,225) |
| saddle_brown = 0x8B4513, // rgb(139,69,19) |
| salmon = 0xFA8072, // rgb(250,128,114) |
| sandy_brown = 0xF4A460, // rgb(244,164,96) |
| sea_green = 0x2E8B57, // rgb(46,139,87) |
| sea_shell = 0xFFF5EE, // rgb(255,245,238) |
| sienna = 0xA0522D, // rgb(160,82,45) |
| silver = 0xC0C0C0, // rgb(192,192,192) |
| sky_blue = 0x87CEEB, // rgb(135,206,235) |
| slate_blue = 0x6A5ACD, // rgb(106,90,205) |
| slate_gray = 0x708090, // rgb(112,128,144) |
| snow = 0xFFFAFA, // rgb(255,250,250) |
| spring_green = 0x00FF7F, // rgb(0,255,127) |
| steel_blue = 0x4682B4, // rgb(70,130,180) |
| tan = 0xD2B48C, // rgb(210,180,140) |
| teal = 0x008080, // rgb(0,128,128) |
| thistle = 0xD8BFD8, // rgb(216,191,216) |
| tomato = 0xFF6347, // rgb(255,99,71) |
| turquoise = 0x40E0D0, // rgb(64,224,208) |
| violet = 0xEE82EE, // rgb(238,130,238) |
| wheat = 0xF5DEB3, // rgb(245,222,179) |
| white = 0xFFFFFF, // rgb(255,255,255) |
| white_smoke = 0xF5F5F5, // rgb(245,245,245) |
| yellow = 0xFFFF00, // rgb(255,255,0) |
| yellow_green = 0x9ACD32 // rgb(154,205,50) |
| }; // enum class color |
| |
| enum class terminal_color : uint8_t { |
| black = 30, |
| red, |
| green, |
| yellow, |
| blue, |
| magenta, |
| cyan, |
| white, |
| bright_black = 90, |
| bright_red, |
| bright_green, |
| bright_yellow, |
| bright_blue, |
| bright_magenta, |
| bright_cyan, |
| bright_white |
| }; |
| |
| enum class emphasis : uint8_t { |
| bold = 1, |
| italic = 1 << 1, |
| underline = 1 << 2, |
| strikethrough = 1 << 3 |
| }; |
| |
| // rgb is a struct for red, green and blue colors. |
| // Using the name "rgb" makes some editors show the color in a tooltip. |
| struct rgb { |
| FMT_CONSTEXPR rgb() : r(0), g(0), b(0) {} |
| FMT_CONSTEXPR rgb(uint8_t r_, uint8_t g_, uint8_t b_) : r(r_), g(g_), b(b_) {} |
| FMT_CONSTEXPR rgb(uint32_t hex) |
| : r((hex >> 16) & 0xFF), g((hex >> 8) & 0xFF), b(hex & 0xFF) {} |
| FMT_CONSTEXPR rgb(color hex) |
| : r((uint32_t(hex) >> 16) & 0xFF), |
| g((uint32_t(hex) >> 8) & 0xFF), |
| b(uint32_t(hex) & 0xFF) {} |
| uint8_t r; |
| uint8_t g; |
| uint8_t b; |
| }; |
| |
| namespace detail { |
| |
| // color is a struct of either a rgb color or a terminal color. |
| struct color_type { |
| FMT_CONSTEXPR color_type() FMT_NOEXCEPT : is_rgb(), value{} {} |
| FMT_CONSTEXPR color_type(color rgb_color) FMT_NOEXCEPT : is_rgb(true), |
| value{} { |
| value.rgb_color = static_cast<uint32_t>(rgb_color); |
| } |
| FMT_CONSTEXPR color_type(rgb rgb_color) FMT_NOEXCEPT : is_rgb(true), value{} { |
| value.rgb_color = (static_cast<uint32_t>(rgb_color.r) << 16) | |
| (static_cast<uint32_t>(rgb_color.g) << 8) | rgb_color.b; |
| } |
| FMT_CONSTEXPR color_type(terminal_color term_color) FMT_NOEXCEPT : is_rgb(), |
| value{} { |
| value.term_color = static_cast<uint8_t>(term_color); |
| } |
| bool is_rgb; |
| union color_union { |
| uint8_t term_color; |
| uint32_t rgb_color; |
| } value; |
| }; |
| } // namespace detail |
| |
| // Experimental text formatting support. |
| class text_style { |
| public: |
| FMT_CONSTEXPR text_style(emphasis em = emphasis()) FMT_NOEXCEPT |
| : set_foreground_color(), |
| set_background_color(), |
| ems(em) {} |
| |
| FMT_CONSTEXPR text_style& operator|=(const text_style& rhs) { |
| if (!set_foreground_color) { |
| set_foreground_color = rhs.set_foreground_color; |
| foreground_color = rhs.foreground_color; |
| } else if (rhs.set_foreground_color) { |
| if (!foreground_color.is_rgb || !rhs.foreground_color.is_rgb) |
| FMT_THROW(format_error("can't OR a terminal color")); |
| foreground_color.value.rgb_color |= rhs.foreground_color.value.rgb_color; |
| } |
| |
| if (!set_background_color) { |
| set_background_color = rhs.set_background_color; |
| background_color = rhs.background_color; |
| } else if (rhs.set_background_color) { |
| if (!background_color.is_rgb || !rhs.background_color.is_rgb) |
| FMT_THROW(format_error("can't OR a terminal color")); |
| background_color.value.rgb_color |= rhs.background_color.value.rgb_color; |
| } |
| |
| ems = static_cast<emphasis>(static_cast<uint8_t>(ems) | |
| static_cast<uint8_t>(rhs.ems)); |
| return *this; |
| } |
| |
| friend FMT_CONSTEXPR text_style operator|(text_style lhs, |
| const text_style& rhs) { |
| return lhs |= rhs; |
| } |
| |
| FMT_CONSTEXPR text_style& operator&=(const text_style& rhs) { |
| if (!set_foreground_color) { |
| set_foreground_color = rhs.set_foreground_color; |
| foreground_color = rhs.foreground_color; |
| } else if (rhs.set_foreground_color) { |
| if (!foreground_color.is_rgb || !rhs.foreground_color.is_rgb) |
| FMT_THROW(format_error("can't AND a terminal color")); |
| foreground_color.value.rgb_color &= rhs.foreground_color.value.rgb_color; |
| } |
| |
| if (!set_background_color) { |
| set_background_color = rhs.set_background_color; |
| background_color = rhs.background_color; |
| } else if (rhs.set_background_color) { |
| if (!background_color.is_rgb || !rhs.background_color.is_rgb) |
| FMT_THROW(format_error("can't AND a terminal color")); |
| background_color.value.rgb_color &= rhs.background_color.value.rgb_color; |
| } |
| |
| ems = static_cast<emphasis>(static_cast<uint8_t>(ems) & |
| static_cast<uint8_t>(rhs.ems)); |
| return *this; |
| } |
| |
| friend FMT_CONSTEXPR text_style operator&(text_style lhs, |
| const text_style& rhs) { |
| return lhs &= rhs; |
| } |
| |
| FMT_CONSTEXPR bool has_foreground() const FMT_NOEXCEPT { |
| return set_foreground_color; |
| } |
| FMT_CONSTEXPR bool has_background() const FMT_NOEXCEPT { |
| return set_background_color; |
| } |
| FMT_CONSTEXPR bool has_emphasis() const FMT_NOEXCEPT { |
| return static_cast<uint8_t>(ems) != 0; |
| } |
| FMT_CONSTEXPR detail::color_type get_foreground() const FMT_NOEXCEPT { |
| FMT_ASSERT(has_foreground(), "no foreground specified for this style"); |
| return foreground_color; |
| } |
| FMT_CONSTEXPR detail::color_type get_background() const FMT_NOEXCEPT { |
| FMT_ASSERT(has_background(), "no background specified for this style"); |
| return background_color; |
| } |
| FMT_CONSTEXPR emphasis get_emphasis() const FMT_NOEXCEPT { |
| FMT_ASSERT(has_emphasis(), "no emphasis specified for this style"); |
| return ems; |
| } |
| |
| private: |
| FMT_CONSTEXPR text_style(bool is_foreground, |
| detail::color_type text_color) FMT_NOEXCEPT |
| : set_foreground_color(), |
| set_background_color(), |
| ems() { |
| if (is_foreground) { |
| foreground_color = text_color; |
| set_foreground_color = true; |
| } else { |
| background_color = text_color; |
| set_background_color = true; |
| } |
| } |
| |
| friend FMT_CONSTEXPR_DECL text_style fg(detail::color_type foreground) |
| FMT_NOEXCEPT; |
| friend FMT_CONSTEXPR_DECL text_style bg(detail::color_type background) |
| FMT_NOEXCEPT; |
| |
| detail::color_type foreground_color; |
| detail::color_type background_color; |
| bool set_foreground_color; |
| bool set_background_color; |
| emphasis ems; |
| }; |
| |
| FMT_CONSTEXPR text_style fg(detail::color_type foreground) FMT_NOEXCEPT { |
| return text_style(/*is_foreground=*/true, foreground); |
| } |
| |
| FMT_CONSTEXPR text_style bg(detail::color_type background) FMT_NOEXCEPT { |
| return text_style(/*is_foreground=*/false, background); |
| } |
| |
| FMT_CONSTEXPR text_style operator|(emphasis lhs, emphasis rhs) FMT_NOEXCEPT { |
| return text_style(lhs) | rhs; |
| } |
| |
| namespace detail { |
| |
| template <typename Char> struct ansi_color_escape { |
| FMT_CONSTEXPR ansi_color_escape(detail::color_type text_color, |
| const char* esc) FMT_NOEXCEPT { |
| // If we have a terminal color, we need to output another escape code |
| // sequence. |
| if (!text_color.is_rgb) { |
| bool is_background = esc == detail::data::background_color; |
| uint32_t value = text_color.value.term_color; |
| // Background ASCII codes are the same as the foreground ones but with |
| // 10 more. |
| if (is_background) value += 10u; |
| |
| size_t index = 0; |
| buffer[index++] = static_cast<Char>('\x1b'); |
| buffer[index++] = static_cast<Char>('['); |
| |
| if (value >= 100u) { |
| buffer[index++] = static_cast<Char>('1'); |
| value %= 100u; |
| } |
| buffer[index++] = static_cast<Char>('0' + value / 10u); |
| buffer[index++] = static_cast<Char>('0' + value % 10u); |
| |
| buffer[index++] = static_cast<Char>('m'); |
| buffer[index++] = static_cast<Char>('\0'); |
| return; |
| } |
| |
| for (int i = 0; i < 7; i++) { |
| buffer[i] = static_cast<Char>(esc[i]); |
| } |
| rgb color(text_color.value.rgb_color); |
| to_esc(color.r, buffer + 7, ';'); |
| to_esc(color.g, buffer + 11, ';'); |
| to_esc(color.b, buffer + 15, 'm'); |
| buffer[19] = static_cast<Char>(0); |
| } |
| FMT_CONSTEXPR ansi_color_escape(emphasis em) FMT_NOEXCEPT { |
| uint8_t em_codes[4] = {}; |
| uint8_t em_bits = static_cast<uint8_t>(em); |
| if (em_bits & static_cast<uint8_t>(emphasis::bold)) em_codes[0] = 1; |
| if (em_bits & static_cast<uint8_t>(emphasis::italic)) em_codes[1] = 3; |
| if (em_bits & static_cast<uint8_t>(emphasis::underline)) em_codes[2] = 4; |
| if (em_bits & static_cast<uint8_t>(emphasis::strikethrough)) |
| em_codes[3] = 9; |
| |
| size_t index = 0; |
| for (int i = 0; i < 4; ++i) { |
| if (!em_codes[i]) continue; |
| buffer[index++] = static_cast<Char>('\x1b'); |
| buffer[index++] = static_cast<Char>('['); |
| buffer[index++] = static_cast<Char>('0' + em_codes[i]); |
| buffer[index++] = static_cast<Char>('m'); |
| } |
| buffer[index++] = static_cast<Char>(0); |
| } |
| FMT_CONSTEXPR operator const Char*() const FMT_NOEXCEPT { return buffer; } |
| |
| FMT_CONSTEXPR const Char* begin() const FMT_NOEXCEPT { return buffer; } |
| FMT_CONSTEXPR const Char* end() const FMT_NOEXCEPT { |
| return buffer + std::char_traits<Char>::length(buffer); |
| } |
| |
| private: |
| Char buffer[7u + 3u * 4u + 1u]; |
| |
| static FMT_CONSTEXPR void to_esc(uint8_t c, Char* out, |
| char delimiter) FMT_NOEXCEPT { |
| out[0] = static_cast<Char>('0' + c / 100); |
| out[1] = static_cast<Char>('0' + c / 10 % 10); |
| out[2] = static_cast<Char>('0' + c % 10); |
| out[3] = static_cast<Char>(delimiter); |
| } |
| }; |
| |
| template <typename Char> |
| FMT_CONSTEXPR ansi_color_escape<Char> make_foreground_color( |
| detail::color_type foreground) FMT_NOEXCEPT { |
| return ansi_color_escape<Char>(foreground, detail::data::foreground_color); |
| } |
| |
| template <typename Char> |
| FMT_CONSTEXPR ansi_color_escape<Char> make_background_color( |
| detail::color_type background) FMT_NOEXCEPT { |
| return ansi_color_escape<Char>(background, detail::data::background_color); |
| } |
| |
| template <typename Char> |
| FMT_CONSTEXPR ansi_color_escape<Char> make_emphasis(emphasis em) FMT_NOEXCEPT { |
| return ansi_color_escape<Char>(em); |
| } |
| |
| template <typename Char> |
| inline void fputs(const Char* chars, FILE* stream) FMT_NOEXCEPT { |
| std::fputs(chars, stream); |
| } |
| |
| template <> |
| inline void fputs<wchar_t>(const wchar_t* chars, FILE* stream) FMT_NOEXCEPT { |
| std::fputws(chars, stream); |
| } |
| |
| template <typename Char> inline void reset_color(FILE* stream) FMT_NOEXCEPT { |
| fputs(detail::data::reset_color, stream); |
| } |
| |
| template <> inline void reset_color<wchar_t>(FILE* stream) FMT_NOEXCEPT { |
| fputs(detail::data::wreset_color, stream); |
| } |
| |
| template <typename Char> |
| inline void reset_color(buffer<Char>& buffer) FMT_NOEXCEPT { |
| const char* begin = data::reset_color; |
| const char* end = begin + sizeof(data::reset_color) - 1; |
| buffer.append(begin, end); |
| } |
| |
| template <typename Char> |
| void vformat_to(buffer<Char>& buf, const text_style& ts, |
| basic_string_view<Char> format_str, |
| basic_format_args<buffer_context<type_identity_t<Char>>> args) { |
| bool has_style = false; |
| if (ts.has_emphasis()) { |
| has_style = true; |
| auto emphasis = detail::make_emphasis<Char>(ts.get_emphasis()); |
| buf.append(emphasis.begin(), emphasis.end()); |
| } |
| if (ts.has_foreground()) { |
| has_style = true; |
| auto foreground = detail::make_foreground_color<Char>(ts.get_foreground()); |
| buf.append(foreground.begin(), foreground.end()); |
| } |
| if (ts.has_background()) { |
| has_style = true; |
| auto background = detail::make_background_color<Char>(ts.get_background()); |
| buf.append(background.begin(), background.end()); |
| } |
| detail::vformat_to(buf, format_str, args); |
| if (has_style) detail::reset_color<Char>(buf); |
| } |
| } // namespace detail |
| |
| template <typename S, typename Char = char_t<S>> |
| void vprint(std::FILE* f, const text_style& ts, const S& format, |
| basic_format_args<buffer_context<type_identity_t<Char>>> args) { |
| basic_memory_buffer<Char> buf; |
| detail::vformat_to(buf, ts, to_string_view(format), args); |
| buf.push_back(Char(0)); |
| detail::fputs(buf.data(), f); |
| } |
| |
| /** |
| \rst |
| Formats a string and prints it to the specified file stream using ANSI |
| escape sequences to specify text formatting. |
| |
| **Example**:: |
| |
| fmt::print(fmt::emphasis::bold | fg(fmt::color::red), |
| "Elapsed time: {0:.2f} seconds", 1.23); |
| \endrst |
| */ |
| template <typename S, typename... Args, |
| FMT_ENABLE_IF(detail::is_string<S>::value)> |
| void print(std::FILE* f, const text_style& ts, const S& format_str, |
| const Args&... args) { |
| vprint(f, ts, format_str, |
| fmt::make_args_checked<Args...>(format_str, args...)); |
| } |
| |
| /** |
| Formats a string and prints it to stdout using ANSI escape sequences to |
| specify text formatting. |
| Example: |
| fmt::print(fmt::emphasis::bold | fg(fmt::color::red), |
| "Elapsed time: {0:.2f} seconds", 1.23); |
| */ |
| template <typename S, typename... Args, |
| FMT_ENABLE_IF(detail::is_string<S>::value)> |
| void print(const text_style& ts, const S& format_str, const Args&... args) { |
| return print(stdout, ts, format_str, args...); |
| } |
| |
| template <typename S, typename Char = char_t<S>> |
| inline std::basic_string<Char> vformat( |
| const text_style& ts, const S& format_str, |
| basic_format_args<buffer_context<type_identity_t<Char>>> args) { |
| basic_memory_buffer<Char> buf; |
| detail::vformat_to(buf, ts, to_string_view(format_str), args); |
| return fmt::to_string(buf); |
| } |
| |
| /** |
| \rst |
| Formats arguments and returns the result as a string using ANSI |
| escape sequences to specify text formatting. |
| |
| **Example**:: |
| |
| #include <fmt/color.h> |
| std::string message = fmt::format(fmt::emphasis::bold | fg(fmt::color::red), |
| "The answer is {}", 42); |
| \endrst |
| */ |
| template <typename S, typename... Args, typename Char = char_t<S>> |
| inline std::basic_string<Char> format(const text_style& ts, const S& format_str, |
| const Args&... args) { |
| return vformat(ts, to_string_view(format_str), |
| fmt::make_args_checked<Args...>(format_str, args...)); |
| } |
| |
| /** |
| Formats a string with the given text_style and writes the output to ``out``. |
| */ |
| template <typename OutputIt, typename Char, |
| FMT_ENABLE_IF(detail::is_output_iterator<OutputIt, Char>::value)> |
| OutputIt vformat_to( |
| OutputIt out, const text_style& ts, basic_string_view<Char> format_str, |
| basic_format_args<buffer_context<type_identity_t<Char>>> args) { |
| decltype(detail::get_buffer<Char>(out)) buf(detail::get_buffer_init(out)); |
| detail::vformat_to(buf, ts, format_str, args); |
| return detail::get_iterator(buf); |
| } |
| |
| /** |
| \rst |
| Formats arguments with the given text_style, writes the result to the output |
| iterator ``out`` and returns the iterator past the end of the output range. |
| |
| **Example**:: |
| |
| std::vector<char> out; |
| fmt::format_to(std::back_inserter(out), |
| fmt::emphasis::bold | fg(fmt::color::red), "{}", 42); |
| \endrst |
| */ |
| template <typename OutputIt, typename S, typename... Args, |
| bool enable = detail::is_output_iterator<OutputIt, char_t<S>>::value&& |
| detail::is_string<S>::value> |
| inline auto format_to(OutputIt out, const text_style& ts, const S& format_str, |
| Args&&... args) -> |
| typename std::enable_if<enable, OutputIt>::type { |
| return vformat_to(out, ts, to_string_view(format_str), |
| fmt::make_args_checked<Args...>(format_str, args...)); |
| } |
| |
| FMT_END_NAMESPACE |
| |
| #endif // FMT_COLOR_H_ |