Products
and Services Support
and Docs Training Partner Programs About Red
Hat
  download storecart
red hat logo
redhat.comredhat network

Red Hat Documentation

c++filt Contents|Index|Previous|Next
c++filt


c++filt  [ -_ | --strip-underscores ]
         [ -n | --no-strip-underscores ]
         [ -sformat | --format=format ]
         [ --help ] [ --version ] [ symbol...]

The C++ language provides function overloading, which means that you can write many functions with the same name (providing each takes parameters of different types). All C++ function names are encoded into a low-level assembly label (this process is known as mangling). The c++filt 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.
    -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.
    --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 future to decode a name passed as an argument on the command line; for example, c++filt symbol may in a future release become c++filt option symbol.

Top|Contents|Index|Previous|Next

 

 


 
© 2001 Red Hat, Inc. All rights reserved.
About Red Hat  :  Legal statement  :  Privacy statement  :  Y2K statement  :  Contact Red Hat