carta
m68k-palmos-c++filt(1)

m68k-palmos-c++filt1

Demangle c++ and java symbols.

Usage

c++filt [-_⎪--strip-underscores] [-j⎪--java] [-n⎪--no-strip-underscores] [-s format⎪--format=format] [--help] [--version] [symbol ...]

Overview

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.

Options

-_
--strip-underscores

On some systems, both the C and C++ compilers put an underscore in front of every name. For example, the C name "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

Prints demangled names using Java syntax. The default is to use C++ syntax.

-n
--no-strip-underscores

Do not remove the initial underscore.

-s format
--format=format

GNU nm can decode three different methods of mangling, used by different C++ compilers. The argument to this option selects which method it uses:

"gnu"

the one used by the GNU compiler (the default method)

"lucid"

the one used by the Lucid compiler

"arm"

the one specified by the C++ Annotated Reference Manual

"hp"

the one used by the HP compiler

"edg"

the one used by the EDG compiler

"gnu-new-abi"

the one used by the GNU compiler with the new ABI.

--help

Print a summary of the options to c++filt and exit.

--version

Print the version number of c++filt and exit.

Footnotes

1.

MS-DOS does not allow "+" characters in file names, so on MS-DOS this program is named c++filt.

History

  • Debian 3.1 (Sarge): the text shown here
  • Debian 3.0 (Woody)

--java since Debian 3.1 (Sarge); --no-strip-underscores since Debian 3.1 (Sarge); -j since Debian 3.1 (Sarge); -n since Debian 3.1 (Sarge).

From prc-tools-m68k 2.2.90.cvs20030306-6 in Debian 3.1 (Sarge). Parsed by carta from the page's man source.