filter は次の値のいずれかである必要があります。
表 A–9 -filt の値
値 |
意味 |
---|---|
[no%]errors |
C++ のリンカーエラーメッセージの説明を表示します [しません]。説明の抑止は、リンカーの診断を別のツールに直接提供している場合に便利です。 |
[no%]names |
C++ で符号化されたリンカー名を復号化します [しません]。 |
[no%]returns |
関数の戻り型を復号化します [しません]。この種の復号化を抑止すると、より迅速に関数名が識別しやすくなりますが、共有の不変式の戻り値の場合、一部の関数は戻り型でのみ異なることに注意してください。 |
[no%]stdlib |
リンカーとコンパイラの両方のエラーメッセージに出力される標準ライブラリからの名前を簡略化します。この結果、標準ライブラリテンプレート型の名前を容易に認識できるようになります。 |
%all |
-filt=errors,names,returns,stdlib に相当します。これはデフォルトの動作です。 |
%none |
-filt=no%errors,no%names,no%returns,no%stdlib に相当します。 |
-filt オプションを指定しないで、または値を入れないで -filt を指定すると、コンパイラでは -filt=%all が使用されます。
次の例では、このコードを -filt オプションでコンパイルしたときの影響を示します。
// filt_demo.cc class type { public: virtual ~type(); // no definition provided }; int main() { type t; } |
-filt オプションを指定しないでコードをコンパイルすると、コンパイラでは -filt=errors,names,returns,stdlib が使用され、標準出力が表示されます。
example% CC filt_demo.cc Undefined first referenced symbol in file type::~type() filt_demo.o type::__vtbl filt_demo.o [Hint: try checking whether the first non-inlined, / non-pure virtual function of class type is defined] ld: fatal: Symbol referencing errors. No output written to a.out |
次のコマンドでは、C++ で符号化されたリンカー名の復号化が抑止され、C++ のリンカーエラーの説明が抑止されます。
example% CC -filt=no%names,no%errors filt_demo.cc Undefined first referenced symbol in file __1cEtype2T6M_v_ filt_demo.o __1cEtypeG__vtbl_ filt_demo.o ld: fatal: Symbol referencing errors. No output written to a.out |
次のコードについて考えてみましょう。
#include <string> #include <list> int main() { std::list<int> l; std::string s(l); // error here } |
次は、-filt=no%stdlib を指定したときの出力です。
Error: Cannot use std::list<int, std::allocator<int>> to initialize std::basic_string<char, std::char_traits<char>, std::allocator<char>>. |
次は、-filt=stdlib を指定したときの出力です。
Error: Cannot use std::list<int> to initialize std::string . |
no%names を使用しても returns や no%returns に影響はありません。つまり、次のオプションは同じ効果を持ちます。
-filt=no%names
-filt=no%names,no%returns
-filt=no%names,returns