pub type OwnedSymbol = Symbol<Vec<u8>>;
Expand description
A Symbol
which owns the underlying storage for the mangled name.
Aliased Type§
struct OwnedSymbol { /* private fields */ }
Implementations
Source§impl<T> Symbol<T>
impl<T> Symbol<T>
Sourcepub fn new(raw: T) -> Result<Symbol<T>>
pub fn new(raw: T) -> Result<Symbol<T>>
Given some raw storage, parse the mangled symbol from it with the default options.
use cpp_demangle::Symbol;
use std::string::ToString;
// First, something easy :)
let mangled = b"_ZN5space3fooEibc";
let sym = Symbol::new(&mangled[..])
.expect("Could not parse mangled symbol!");
let demangled = sym.to_string();
assert_eq!(demangled, "space::foo(int, bool, char)");
// Now let's try something a little more complicated!
let mangled =
b"__Z28JS_GetPropertyDescriptorByIdP9JSContextN2JS6HandleIP8JSObjectEENS2_I4jsidEENS1_13MutableHandleINS1_18PropertyDescriptorEEE";
let sym = Symbol::new(&mangled[..])
.expect("Could not parse mangled symbol!");
let demangled = sym.to_string();
assert_eq!(
demangled,
"JS_GetPropertyDescriptorById(JSContext*, JS::Handle<JSObject*>, JS::Handle<jsid>, JS::MutableHandle<JS::PropertyDescriptor>)"
);
Sourcepub fn new_with_options(raw: T, options: &ParseOptions) -> Result<Symbol<T>>
pub fn new_with_options(raw: T, options: &ParseOptions) -> Result<Symbol<T>>
Given some raw storage, parse the mangled symbol from it.
use cpp_demangle::{ParseOptions, Symbol};
use std::string::ToString;
// First, something easy :)
let mangled = b"_ZN5space3fooEibc";
let parse_options = ParseOptions::default()
.recursion_limit(1024);
let sym = Symbol::new_with_options(&mangled[..], &parse_options)
.expect("Could not parse mangled symbol!");
let demangled = sym.to_string();
assert_eq!(demangled, "space::foo(int, bool, char)");
// Now let's try something a little more complicated!
let mangled =
b"__Z28JS_GetPropertyDescriptorByIdP9JSContextN2JS6HandleIP8JSObjectEENS2_I4jsidEENS1_13MutableHandleINS1_18PropertyDescriptorEEE";
let sym = Symbol::new(&mangled[..])
.expect("Could not parse mangled symbol!");
let demangled = sym.to_string();
assert_eq!(
demangled,
"JS_GetPropertyDescriptorById(JSContext*, JS::Handle<JSObject*>, JS::Handle<jsid>, JS::MutableHandle<JS::PropertyDescriptor>)"
);
Sourcepub fn demangle(&self, options: &DemangleOptions) -> Result<String, Error>
pub fn demangle(&self, options: &DemangleOptions) -> Result<String, Error>
Demangle the symbol and return it as a String.
Unlike the ToString
implementation, this function allows options to
be specified.
use cpp_demangle::{DemangleOptions, Symbol};
use std::string::ToString;
let mangled = b"_ZN5space3fooEibc";
let sym = Symbol::new(&mangled[..])
.expect("Could not parse mangled symbol!");
let demangled = sym.to_string();
let options = DemangleOptions::default();
let demangled_again = sym.demangle(&options).unwrap();
assert_eq!(demangled_again, demangled);
Sourcepub fn structured_demangle<W: DemangleWrite>(
&self,
out: &mut W,
options: &DemangleOptions,
) -> Result
pub fn structured_demangle<W: DemangleWrite>( &self, out: &mut W, options: &DemangleOptions, ) -> Result
Demangle the symbol to a DemangleWrite, which lets the consumer be informed about syntactic structure.