1 <html><head><meta http-equiv=
"Content-Type" content=
"text/html; charset=UTF-8"><title>Chapter
29. Demangling
</title><meta name=
"generator" content=
"DocBook XSL-NS Stylesheets V1.76.1"><meta name=
"keywords" content=
"
5 "><meta name=
"keywords" content=
"
11 "><link rel=
"home" href=
"../index.html" title=
"The GNU C++ Library"><link rel=
"up" href=
"extensions.html" title=
"Part III. Extensions"><link rel=
"prev" href=
"ext_io.html" title=
"Chapter 28. Input and Output"><link rel=
"next" href=
"ext_concurrency.html" title=
"Chapter 30. Concurrency"></head><body bgcolor=
"white" text=
"black" link=
"#0000FF" vlink=
"#840084" alink=
"#0000FF"><div class=
"navheader"><table width=
"100%" summary=
"Navigation header"><tr><th colspan=
"3" align=
"center">Chapter
29. Demangling
</th></tr><tr><td width=
"20%" align=
"left"><a accesskey=
"p" href=
"ext_io.html">Prev
</a> </td><th width=
"60%" align=
"center">Part III.
14 </th><td width=
"20%" align=
"right"> <a accesskey=
"n" href=
"ext_concurrency.html">Next
</a></td></tr></table><hr></div><div class=
"chapter" title=
"Chapter 29. Demangling"><div class=
"titlepage"><div><div><h2 class=
"title"><a name=
"manual.ext.demangle"></a>Chapter
29. Demangling
</h2></div></div></div><p>
15 Transforming C++ ABI identifiers (like RTTI symbols) into the
16 original C++ source identifiers is called
17 <span class=
"quote">“
<span class=
"quote">demangling.
</span>”
</span>
19 If you have read the
<a class=
"link" href=
"http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01115.html" target=
"_top">source
20 documentation for
<code class=
"code">namespace abi
</code></a> then you are
21 aware of the cross-vendor C++ ABI in use by GCC. One of the
22 exposed functions is used for demangling,
23 <code class=
"code">abi::__cxa_demangle
</code>.
25 In programs like
<span class=
"command"><strong>c++filt
</strong></span>, the linker, and other tools
26 have the ability to decode C++ ABI names, and now so can you.
28 (The function itself might use different demanglers, but that's the
29 whole point of abstract interfaces. If we change the implementation,
32 Probably the only times you'll be interested in demangling at runtime
33 are when you're seeing
<code class=
"code">typeid
</code> strings in RTTI, or when
34 you're handling the runtime-support exception classes. For example:
35 </p><pre class=
"programlisting">
36 #include
<exception
>
37 #include
<iostream
>
38 #include
<cxxabi.h
>
42 template
<typename T, int N
>
51 // exception classes not in
<stdexcept
>, thrown by the implementation
52 // instead of the user
54 realname = abi::__cxa_demangle(e.what(),
0,
0,
&status);
55 std::cout
<< e.what()
<< "\t=> " << realname
<< "\t: " << status
<< '\n';
60 bar
<empty,
17> u;
61 const std::type_info
&ti = typeid(u);
63 realname = abi::__cxa_demangle(ti.name(),
0,
0,
&status);
64 std::cout
<< ti.name()
<< "\t=> " << realname
<< "\t: " << status
<< '\n';
71 </p><pre class=
"screen">
72 <code class=
"computeroutput">
73 St13bad_exception =
> std::bad_exception :
0
74 3barI5emptyLi17EE =
> bar
<empty,
17> :
0
77 The demangler interface is described in the source documentation
78 linked to above. It is actually written in C, so you don't need to
79 be writing C++ in order to demangle C++. (That also means we have to
80 use crummy memory management facilities, so don't forget to free()
81 the returned char array.)
82 </p></div><div class=
"navfooter"><hr><table width=
"100%" summary=
"Navigation footer"><tr><td width=
"40%" align=
"left"><a accesskey=
"p" href=
"ext_io.html">Prev
</a> </td><td width=
"20%" align=
"center"><a accesskey=
"u" href=
"extensions.html">Up
</a></td><td width=
"40%" align=
"right"> <a accesskey=
"n" href=
"ext_concurrency.html">Next
</a></td></tr><tr><td width=
"40%" align=
"left" valign=
"top">Chapter
28. Input and Output
</td><td width=
"20%" align=
"center"><a accesskey=
"h" href=
"../index.html">Home
</a></td><td width=
"40%" align=
"right" valign=
"top"> Chapter
30. Concurrency
</td></tr></table></div></body></html>