color.hpp

color.hpp #

color.hppでは、エラーメッセージの色付けに関する関数が定義されます。

色はANSIエスケープシーケンスによって指定されます。 ANSIエスケープシーケンスをサポートしていないターミナルやその他の出力先では、読みにくくなる可能性があります。

マクロ #

TOML11_COLORIZE_ERROR_MESSAGE #

コンパイル時にこのマクロが定義されていた場合（-DTOML11_COLORIZE_ERROR_MESASGE）、 デフォルトでエラーメッセージに色が付きます。

定義されていなかった場合、デフォルトでは色は付きません。以下の toml::color::enable() を 使用して指定する必要があります。

TOML11_USE_THREAD_LOCAL_COLORIZATION #

コンパイル時にこのマクロが定義されていた場合（-DTOML11_COLORIZE_ERROR_MESASGE）、 toml::color::enableの設定がthread_localになります。 この場合、toml::color::enable()やtoml::color::disable()は、それを呼び出したスレッドでの設定しか変更しません。 つまり、新しいスレッドを起動した際にデフォルトと異なる設定にしたい場合は、再度設定が必要になります。 その代わり、toml::color::enable()やtoml::color::disable()はスレッドセーフになります。

デフォルトでは設定はグローバルです。 グローバルの場合、一つのスレッドがtoml::color::enable()を実行した場合、すべてのスレッドで色が付きます。 ただし、あるスレッドがenable()またはdisable()を実行している間に別のスレッドがenable()、disable()、should_color()を実行した場合、その結果は未定義です。

関数 #

enable() #

namespace toml {
namespace color {
void enable();
} // color
} // toml

ANSIエスケープシーケンスによる色付けを行うよう設定します。

例 #

#include <toml.hpp>

int main()
{
    toml::color::enable(); // この後の全てのエラーがカラーになります。
    const auto input = toml::parse("input.toml");
    return 0;
}

disable() #

namespace toml {
namespace color {
void disable();
} // color
} // toml

ANSIエスケープシーケンスによる色付けを行わないよう設定します。

例 #

#include <toml.hpp>

int main()
{
    toml::color::enable(); // この後の全てのエラーがカラーになります。
    const auto input = toml::parse("input.toml");
    return 0;
}

should_color() #

namespace toml {
namespace color {
bool should_color();
} // color
} // toml

色付けを行う設定になっている場合trueが、そうでない場合falseが返されます。

例 #

#include <toml.hpp>
#include <iomanip>
#include <iostream>

int main()
{
    std::cout << "colorized? : " << std::boolalpha << toml::color::should_color() << std::endl;
    return 0;
}

マニピュレータ #

namespace toml {
namespace color {
std::ostream& reset  (std::ostream&);
std::ostream& bold   (std::ostream&);
std::ostream& grey   (std::ostream&);
std::ostream& gray   (std::ostream&);
std::ostream& red    (std::ostream&);
std::ostream& green  (std::ostream&);
std::ostream& yellow (std::ostream&);
std::ostream& blue   (std::ostream&);
std::ostream& magenta(std::ostream&);
std::ostream& cyan   (std::ostream&);
std::ostream& white  (std::ostream&);
} // color
} // toml

ANSIエスケープシーケンスによって、fgを色付けします。

例 #

#include <toml.hpp>
#include <iostream>

int main()
{
    std::cout << toml::color::red << "red!" << std::endl;
    return 0;
}

関連項目 #