c++filt [-_
|--strip-underscores
] [-j
|--java
] [-n
|--no-strip-underscores
] [-p
|--no-params
] [-s
format|--format=
format] [--help
] [--version
] [symbol...]
The C++ and Java languages provides function overloading, which means that you can write many functions with the same name (providing each takes parameters of different types). All C++ and Java function names are encoded into a low-level assembly label (this process is known as mangling). The c++filt
1 program does the inverse mapping: it decodes (demangles) low-level names into user-level names so that the linker can keep these overloaded functions from clashing.
Every alphanumeric word (consisting of letters, digits, underscores, dollars, or periods) seen in the input is a potential label. If the label decodes into a C++ name, the C++ name replaces the low-level name in the output.
You can use c++filt
to decipher individual symbols:
c++filt symbol
If no symbol arguments are given, c++filt
reads symbol names from the standard input and writes the demangled names to the standard output. All results are printed on the standard output.
-_
--strip-underscores
foo
gets the low-level name _foo
. This option removes the initial underscore. Whether c++filt
removes the underscore by default is target dependent.-j
--java
-n
--no-strip-underscores
-p
--no-params
-s
format--format=
formatc++filt
can decode various methods of mangling, used by different compilers. The argument to this option selects which method it uses:
auto
gnu
lucid
arm
hp
edg
gnu-v3
java
gnat
--help
c++filt
and exit.--version
c++filt
and exit.Warning:c++filt
is a new utility, and the details of its user interface are subject to change in future releases. In particular, a command-line option may be required in the the future to decode a name passed as an argument on the command line; in other words,c++filt symbolmay in a future release become
c++filt option symbol