GNU Binary Utilities: c++filt

[ < ] | [ > ] |  | [ << ] | [ Up ] | [ >> ] |  |  |  |  | [Top] | [Contents] | [Index] | [ ? ]

# 9. c++filt

    c++filt [`-_'|`--strip-underscores']
            [`-j'|`--java']
            [`-n'|`--no-strip-underscores']
            [`-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`
  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.

> 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 symbol

> may in a future release become

>     c++filt option symbol

[ < ] | [ > ] |  | [ << ] | [ Up ] | [ >> ] |  |  |  |  | [Top] | [Contents] | [Index] | [ ? ]

This document was generated on May 3, 2002 using texi2html