CXXFilt
This is a Ruby gem for demangling C++ symbols. It works the same way as the c++filt program from GNU binutils does. It even links with libiberty and uses the same demangling routines as c++filt.
Installation
Add this line to your application's Gemfile:
gem 'cxxfilt'And then execute:
$ bundle
Or install it yourself as:
$ gem install cxxfilt
Usage
Get a list of the available demanglers:
2.4.1 :001 > require "cxxfilt"
=> true
2.4.1 :002 > CXXFilt::demanglers
=> [
#<CXXFilt::Demangler:0x00000000e3e720 @name="none", @doc="Demangling disabled">,
#<CXXFilt::Demangler:0x00000000e3e658 @name="auto", @doc="Automatic selection based on executable">,
#<CXXFilt::Demangler:0x00000000e3e5e0 @name="gnu", @doc="GNU (g++) style demangling">,
#<CXXFilt::Demangler:0x00000000e3e568 @name="lucid", @doc="Lucid (lcc) style demangling">,
#<CXXFilt::Demangler:0x00000000e3e4c8 @name="arm", @doc="ARM style demangling">,
#<CXXFilt::Demangler:0x00000000e3e450 @name="hp", @doc="HP (aCC) style demangling">,
#<CXXFilt::Demangler:0x00000000e3e3d8 @name="edg", @doc="EDG style demangling">,
#<CXXFilt::Demangler:0x00000000e3e360 @name="gnu-v3", @doc="GNU (g++) V3 ABI-style demangling">,
#<CXXFilt::Demangler:0x00000000e3e270 @name="java", @doc="Java style demangling">,
#<CXXFilt::Demangler:0x00000000e3e180 @name="gnat", @doc="GNAT style demangling">,
#<CXXFilt::Demangler:0x00000000e3e0e0 @name="dlang", @doc="DLANG style demangling">]
Demangle a symbol with the auto demangler:
2.4.1 :003 > CXXFilt::demangle("_Z1hic")
=> "h(int, char)"
2.4.1 :004 > CXXFilt::auto.demangle("_Z1hic")
=> "h(int, char)"
2.4.1 :005 > CXXFilt::demanglers[1].demangle("_Z1hic")
=> "h(int, char)"
Development
After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.
Contributing
Bug reports and pull requests are welcome on GitHub at [https://github.com/misson20000/cxxfilt-rb].