demangle.cc

/*
 * Copyright (c) 2008-2014, Pedigree Developers
 *
 * Please see the CONTRIB file in the root of the source tree for a full
 * list of contributors.
 *
 * Permission to use, copy, modify, and distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
#include "pedigree/kernel/utilities/StaticString.h"
#include "pedigree/kernel/utilities/demangle.h"
#include "pedigree/kernel/utilities/utility.h"
 
// Uncomment these if running standalone.
// include <stdio.h>
// include <stdlib.h>
// define uintptr_t unsigned int
// include "StaticString.h"
 
// typedef StaticString<128> LargeStaticString;
typedef struct demangle {
  demangle() : nSubstitutions(0), nTemplateParams(0), nParams(0), nLevel(0), nNameParseLevel(0) {}
  LargeStaticString substitutions[16];
  size_t nSubstitutions;
  LargeStaticString templateParams[8];
  size_t nTemplateParams;
  LargeStaticString params[16];
  size_t nParams;
  size_t nLevel;
  size_t nNameParseLevel;
} demangle_t;
 
#define FAIL 1
#define SUCCESS 0
 
#define DECLARE(id) static int parse##id(LargeStaticString&, LargeStaticString&, demangle_t&)
#define DECLARE_LVAL(id) \
  static int parse##id(LargeStaticString&, LargeStaticString&, demangle_t&, int&)
#define DECLARE_SVAL(id) \
  static int parse##id(LargeStaticString&, LargeStaticString&, demangle_t&, LargeStaticString&)
DECLARE(MangledName);
DECLARE(Name);
DECLARE(UnscopedName);
DECLARE(UnscopedTemplateName);
DECLARE(NestedName);
// DECLARE(TemplatePrefix);
DECLARE(UnqualifiedName);
DECLARE(SourceName);
DECLARE(CvQualifiers);
DECLARE(Type);
DECLARE(BuiltinType);
DECLARE(FunctionType);
// DECLARE(BareFunctionType);
DECLARE(ArrayType);
DECLARE(PointerToMemberType);
DECLARE(TemplateParam);
DECLARE(TemplateTemplateParam);
DECLARE(TemplateArgs);
DECLARE(TemplateArg);
DECLARE(Expression);
DECLARE(ExprPrimary);
DECLARE(Substitution);
DECLARE_LVAL(SeqId);
DECLARE(OperatorName);
DECLARE(CtorDtorName);
DECLARE_SVAL(Prefix);
DECLARE_LVAL(Number);
DECLARE_LVAL(Identifier);
 
#undef MANGLE_DEBUG
#ifdef MANGLE_DEBUG
#define END_SUCCESS(id)                                                             \
  do {                                                                              \
    printf("[%d] Success:\t %s, \t%s -> %s\n", data.nLevel--, id, (const char*)src, \
           (const char*)dest);                                                      \
    return SUCCESS;                                                                 \
  } while (0)
#define END_FAIL(id)                                                             \
  do {                                                                           \
    printf("[%d] Fail:\t %s, \t%s -> %s\n", data.nLevel--, id, (const char*)src, \
           (const char*)dest);                                                   \
    return FAIL;                                                                 \
  } while (0)
#define START(id)                                                                 \
  do {                                                                            \
    printf("[%d] Start:\t %s, \t%s -> %s\n", ++data.nLevel, id, (const char*)src, \
           (const char*)dest);                                                    \
  } while (0)
#else  // DEBUG
#define END_SUCCESS(id) return SUCCESS
#define END_FAIL(id) return FAIL
#define START(id)
#endif
 
// Adds a string to the substitution index.
static void addSubstitution(LargeStaticString str, demangle_t& data) {
  for (size_t i = 0; i < data.nSubstitutions; i++)
    if (!StringCompare(data.substitutions[i], str))
      return;
 
  // HACK:: Bit of a hack here - we prepend "::" to every identifier. It looks
  // a bit ugly.
  if (str[0] == ':' && str[1] == ':')
    str.stripFirst(2);
 
  data.substitutions[data.nSubstitutions++] = str;
}
 
/*
<mangled_name> ::= _Z <name> [<type> (if template params > 0)] <type>+
*/
static int parseMangledName(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("MangledName");
  // Does the string begin with _Z?
  if (src[0] != '_' || src[1] != 'Z')
    END_FAIL("MangledName");
  src.stripFirst(2);
  if (parseName(src, dest, data) == FAIL)
    END_FAIL("MangledName");
 
  // HACK:: Bit of a hack here - we add the entire function name (foo::bar) to
  // the substitution index, when it shouldn't be. Here we decrement the
  // number of substitutions so it is wiped.
  if (data.nSubstitutions)
    data.nSubstitutions--;
 
  // HACK:: OK here we go, hack again. We manually increase the
  // data.nNameParseLevel member so that our template parameters don't get
  // accidentally overwritten.
  data.nNameParseLevel = 5;
 
  // If we have some template params we should expect a type next (for return
  // type).
  LargeStaticString tmp;  // Just completely ignore the return type.
  if (data.nTemplateParams > 0)
    if (parseType(src, tmp, data) == FAIL)
      END_FAIL("MangledName");
 
  data.nParams = 0;
  do {
    if (parseType(src, data.params[data.nParams], data) == FAIL)
      END_FAIL("MangledName");
    data.nParams++;
  } while (src.length() > 0);
  END_SUCCESS("MangledName");
}
 
/*
<name> ::= <nested-name>
  ::= <unscoped-name>
  ::= <unscoped-template-name> <template-args>
  ::= <local-name> <--- ignored.
*/
static int parseName(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("Name");
  data.nNameParseLevel++;
 
  LargeStaticString origsrc = src;
  LargeStaticString origdest = dest;
  // Nested names are the easiest, they start with a 'N'.
  if (src[0] == 'N') {
    size_t ret = parseNestedName(src, dest, data);
    data.nNameParseLevel--;
    return ret;
  }
 
  // The prefix 'L' means 'static linkage'. We should handle this.
  if (src[0] == 'L')
    src.stripFirst(1);
 
  // Here we try and parse a template name, with arguments following.
  if (parseUnscopedTemplateName(src, dest, data) == SUCCESS &&
      parseTemplateArgs(src, dest, data) == SUCCESS) {
    data.nNameParseLevel--;
    END_SUCCESS("Name");
  } else  // Template parseage failed, try normal unscoped name.
  {
    src = origsrc;    // Restore src.
    dest = origdest;  // Restore dest;
    if (parseUnscopedName(src, dest, data) == SUCCESS) {
      data.nNameParseLevel--;
      END_SUCCESS("Name");
    } else {
      data.nNameParseLevel--;
      END_FAIL("Name");
    }
  }
}
 
/*
<unscoped_name> ::= <unqualified_name>
  ::= St <unqualified_name> // ::std::
*/
static int parseUnscopedName(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("UnscopedName");
  if (parseUnqualifiedName(src, dest, data) == SUCCESS)
    END_SUCCESS("UnscopedName");
  else
    END_FAIL("UnscopedName");
}
 
/*
<unscoped_template_name> ::= <unscoped_name>
  ::= <substitution>
*/
static int parseUnscopedTemplateName(LargeStaticString& src, LargeStaticString& dest,
                                     demangle_t& data) {
  START("UnscopedTemplateName");
  LargeStaticString origsrc = src;
  LargeStaticString origdest = dest;
 
  // Try substitution first.
  if (parseSubstitution(src, dest, data) == SUCCESS)
    END_SUCCESS("UnscopedTemplateName");
 
  src = origsrc;
  dest = origdest;
 
  if (parseUnqualifiedName(src, dest, data) == SUCCESS)
    END_SUCCESS("UnscopedTemplateName");
  else
    END_FAIL("UnscopedTemplateName");
}
 
/*
<nested_name> ::= N [<CV-qualifiers>] <prefix> <unqualified_name> E
  ::= N [<CV-qualifiers>] <template-prefix> <template_args> E
=============== CHANGED TO
<nested_name> ::= N [<CV-qualifiers>] <prefix> E
*/
static int parseNestedName(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("NestedName");
 
  if (src[0] != 'N')
    END_FAIL("NestedName");
  src.stripFirst(1);
 
  // Check CV qualifiers.
  if (src[0] == 'r' || src[0] == 'K' || src[0] == 'V') {
    if (parseCvQualifiers(src, dest, data) == FAIL)
      END_FAIL("NestedName");
  }
 
  LargeStaticString thePrefix;
  if (parsePrefix(src, dest, data, thePrefix) == FAIL)
    END_FAIL("NestedName");
 
  if (src[0] != 'E')
    END_FAIL("NestedName");
  src.stripFirst(1);
 
  END_SUCCESS("NestedName");
}
 
/*
<prefix> ::= <prefix> <unqualified_name>
  ::= <template_prefix> <template_args>
  ::= <template_param>
  ::= # empty
  ::= <substitution>
=============== CHANGED TO
<prefix> ::= <unqualified_name> <prefix>
  ::= <unqualified_name> <template_args> <prefix>
  ::= <template_param>
  ::= # empty
  ::= <substitution>
*/
static int parsePrefix(LargeStaticString& src, LargeStaticString& dest, demangle_t& data,
                       LargeStaticString& thisPrefix) {
  START("Prefix");
 
  LargeStaticString origsrc = src;
  LargeStaticString origdest = dest;
 
  // Check for a template_param.
  //   if (parseTemplateParam(src, dest, data) == SUCCESS)
  //     END_SUCCESS("Prefix");
 
  src = origsrc;
  dest = origdest;
 
  // Check for a substitution.
  if (parseSubstitution(src, dest, data) == SUCCESS)
    END_SUCCESS("Prefix");
 
  src = origsrc;
  dest = origdest;
 
  // Check for an unqualified name
  LargeStaticString unqualName;
  if (parseUnqualifiedName(src, unqualName, data) == SUCCESS) {
    dest += "::";
    dest += unqualName;
    origsrc = src;
    origdest = dest;  // Checkpoint!
 
    thisPrefix += "::";
    thisPrefix += unqualName;
 
    addSubstitution(thisPrefix, data);
 
    // Do we have a template_args?
    unqualName = "";
    if (parseTemplateArgs(src, unqualName, data) == FAIL) {
      src = origsrc;
      dest = origdest;
    } else {
      dest += unqualName;
      thisPrefix += unqualName;
      addSubstitution(thisPrefix, data);
    }
 
    // Recurse.
    if (parsePrefix(src, dest, data, thisPrefix) == SUCCESS)
      END_SUCCESS("Prefix");
    else
      END_FAIL("Prefix");
  }
 
  src = origsrc;
  dest = origdest;
 
  // Empty rule.
  END_SUCCESS("Prefix");
}
 
/*
<template_prefix> ::= <prefix> <unqualified_name>
  ::= <template_param>
  ::= <substitution>
*/
// static int parseTemplatePrefix(LargeStaticString &src, LargeStaticString
// &dest, demangle_t &data)
// {
// Unused.
// }
 
/*
<unqualified_name> ::= <operator_name>
  ::= <ctor_dtor_name>
  ::= <source_name>
*/
static int parseUnqualifiedName(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("UnqualifiedName");
  LargeStaticString origsrc = src;
  LargeStaticString origdest = dest;
 
  if (parseOperatorName(src, dest, data) == SUCCESS)
    END_SUCCESS("UnqualifiedName");
 
  src = origsrc;
  dest = origdest;
 
  if (parseCtorDtorName(src, dest, data) == SUCCESS)
    END_SUCCESS("UnqualifiedName");
 
  src = origsrc;
  dest = origdest;
 
  if (parseSourceName(src, dest, data) == SUCCESS)
    END_SUCCESS("UnqualifiedName");
 
  END_FAIL("UnqualifiedName");
}
 
/*
<ctor_dtor_name> ::= C {0,1,2}
  ::= D {0,1,2}
*/
static int parseCtorDtorName(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("CtorDtorName");
  if (src[0] == 'C' && (src[1] == '0' || src[1] == '1' || src[1] == '2')) {
    src.stripFirst(2);
    dest += "`ctor'";
  } else if (src[0] == 'D' && (src[1] == '0' || src[1] == '1' || src[1] == '2')) {
    src.stripFirst(2);
    dest += "`dtor'";
  } else
    END_FAIL("CtorDtorName");
  END_SUCCESS("CtorDtorName");
}
 
/*
<operator-name> ::= nw        # new
  ::= na        # new[]
  ::= dl        # delete
  ::= da        # delete[]
  ::= ps        # + (unary)
  ::= ng        # - (unary)
  ::= ad        # & (unary)
  ::= de        # * (unary)
  ::= co        # ~
  ::= pl        # +
  ::= mi        # -
  ::= ml        # *
  ::= dv        # /
  ::= rm        # %
  ::= an        # &
  ::= or        # |
  ::= eo        # ^
  ::= aS        # =
  ::= pL        # +=
  ::= mI        # -=
  ::= mL        # *=
  ::= dV        # /=
  ::= rM        # %=
  ::= aN        # &=
  ::= oR        # |=
  ::= eO        # ^=
  ::= ls        # <<
  ::= rs        # >>
  ::= lS        # <<=
  ::= rS        # >>=
  ::= eq        # ==
  ::= ne        # !=
  ::= lt        # <
  ::= gt        # >
  ::= le        # <=
  ::= ge        # >=
  ::= nt        # !
  ::= aa        # &&
  ::= oo        # ||
  ::= pp        # ++
  ::= mm        # --
  ::= cm        # ,
  ::= pm        # ->*
  ::= pt        # ->
  ::= cl        # ()
  ::= ix        # []
  ::= qu        # ?
  ::= st        # sizeof (a type)
  ::= sz        # sizeof (an expression)
  ::= cv <type> # (cast)
*/
static int parseOperatorName(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("OperatorName");
 
  LargeStaticString op = src.left(2);
  src.stripFirst(2);
 
  if (op == "nw")
    dest += "operator new";
  else if (op == "na")
    dest += "operator new[]";
  else if (op == "dl")
    dest += "operator delete";
  else if (op == "da")
    dest += "operator delete[]";
  else if (op == "ps")
    dest += "operator+(unary)";
  else if (op == "ng")
    dest += "operator-(unary)";
  else if (op == "ad")
    dest += "operator&(unary)";
  else if (op == "de")
    dest += "operator*(unary)";
  else if (op == "co")
    dest += "operator~";
  else if (op == "pl")
    dest += "operator+";
  else if (op == "mi")
    dest += "operator-";
  else if (op == "ml")
    dest += "operator*";
  else if (op == "dv")
    dest += "operator/";
  else if (op == "rm")
    dest += "operator%";
  else if (op == "an")
    dest += "operator&";
  else if (op == "or")
    dest += "operator|";
  else if (op == "eo")
    dest += "operator^";
  else if (op == "aS")
    dest += "operator=";
  else if (op == "pL")
    dest += "operator+=";
  else if (op == "mI")
    dest += "operator-=";
  else if (op == "mL")
    dest += "operator*=";
  else if (op == "dV")
    dest += "operator/=";
  else if (op == "rM")
    dest += "operator%=";
  else if (op == "aN")
    dest += "operator&=";
  else if (op == "oR")
    dest += "operator|=";
  else if (op == "eO")
    dest += "operator^=";
  else if (op == "ls")
    dest += "operator<<";
  else if (op == "rs")
    dest += "operator>>";
  else if (op == "lS")
    dest += "operator<<=";
  else if (op == "rS")
    dest += "operator>>=";
  else if (op == "eq")
    dest += "operator==";
  else if (op == "ne")
    dest += "operator!=";
  else if (op == "lt")
    dest += "operator<";
  else if (op == "gt")
    dest += "operator>";
  else if (op == "le")
    dest += "operator<=";
  else if (op == "ge")
    dest += "operator>=";
  else if (op == "nt")
    dest += "operator!";
  else if (op == "aa")
    dest += "operator&&";
  else if (op == "oo")
    dest += "operator||";
  else if (op == "pp")
    dest += "operator++";
  else if (op == "mm")
    dest += "operator--";
  else if (op == "cm")
    dest += "operator,";
  else if (op == "pm")
    dest += "operator->*";
  else if (op == "pt")
    dest += "operator->";
  else if (op == "cl")
    dest += "operator()";
  else if (op == "ix")
    dest += "operator[]";
  else if (op == "qu")
    dest += "operator?";
  else if (op == "st")
    dest += "operator sizeof";
  else if (op == "sz")
    dest += "operator sizeof";
  else if (op == "cv") {
    dest += "operator ";
    if (parseType(src, dest, data) == FAIL)
      END_FAIL("OperatorName");
  } else
    END_FAIL("OperatorName");
 
  END_SUCCESS("OperatorName");
}
 
/*
<source_name> ::= <number> <identifier>
*/
static int parseSourceName(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("SourceName");
 
  int lval;
  if (parseNumber(src, dest, data, lval) == SUCCESS && lval >= 0 &&
      parseIdentifier(src, dest, data, lval) == SUCCESS)
    END_SUCCESS("SourceName");
 
  END_FAIL("SourceName");
}
 
/*
<number> ::= [n] <non negative decimal integer>
*/
static int parseNumber(LargeStaticString& src, LargeStaticString& dest, demangle_t& data,
                       int& lval) {
  START("Number");
 
  // Negative?
  bool bNegative = false;
  if (src[0] == 'n') {
    bNegative = true;
    src.stripFirst(1);
  }
 
  // Non numeric?
  if (src[0] < '0' || src[0] > '9')
    END_FAIL("Number");
 
  size_t nLength = 0;
  char str[32];
  while (src[nLength] >= '0' && src[nLength] <= '9') {
    str[nLength] = src[nLength];
    nLength++;
  }
  str[nLength] = '\0';
  lval = StringToUnsignedLong(str, 0, 10);
  if (bNegative)
    lval = -lval;
 
  src.stripFirst(nLength);
 
  END_SUCCESS("Number");
}
 
/*
<identifier> ::= <unqualified source code identifier>
*/
static int parseIdentifier(LargeStaticString& src, LargeStaticString& dest, demangle_t& data,
                           int& lval) {
  START("Identifier");
  if (static_cast<int>(src.length()) < lval)
    END_FAIL("Identifier");
  for (int i = 0; i < lval; i++)
    dest += src[i];
  src.stripFirst(lval);
  END_SUCCESS("Identifier");
}
 
/*
<CV-qualifiers> ::= [r] [V] [K]
*/
static int parseCvQualifiers(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("CvQualifiers");
  bool bParsedOne = false;
  if (src[0] == 'r') {
    bParsedOne = true;
    dest += "restrict ";
    src.stripFirst(1);
  }
  if (src[0] == 'V') {
    bParsedOne = true;
    dest += "volatile ";
    src.stripFirst(1);
  }
  if (src[0] == 'K') {
    bParsedOne = true;
    dest += "const ";
    src.stripFirst(1);
  }
  if (!bParsedOne)
    END_FAIL("CvQualifiers");
  else
    END_SUCCESS("CvQualifiers");
}
 
/*
<type> ::= <CV-qualifiers> <type>
  ::= P <type>
  ::= R <type>
  ::= <builtin-type>
  ::= <function-type>
  ::= <name> # class-enum-type
  ::= <array-type>
  ::= <pointer-to-member-type>
  ::= <template-param>
  ::= <template-template-param> <template-args>
  ::= <substitution>
*/
static int parseType(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("Type");
 
  // CV-qualifiers?
  if (src[0] == 'r' || src[0] == 'V' || src[0] == 'K') {
    LargeStaticString tmp;
    if (parseCvQualifiers(src, tmp, data) == FAIL)
      END_FAIL("Type");
    if (parseType(src, tmp, data) == FAIL)
      END_FAIL("Type");
    dest += tmp;
    addSubstitution(tmp, data);
    END_SUCCESS("Type");
  }
  // Pointer?
  else if (src[0] == 'P') {
    src.stripFirst(1);
    LargeStaticString tmp;
    if (parseType(src, tmp, data) == FAIL)
      END_FAIL("Type");
    dest += tmp;
    tmp += "*";
    dest += "*";
    addSubstitution(tmp, data);
    END_SUCCESS("Type");
  }
  // Reference?
  else if (src[0] == 'R') {
    src.stripFirst(1);
    LargeStaticString tmp;
    if (parseType(src, tmp, data) == FAIL)
      END_FAIL("Type");
    dest += tmp;
    tmp += "&";
    dest += "&";
    addSubstitution(tmp, data);
    END_SUCCESS("Type");
  }
  // Function-type?
  else if (src[0] == 'F') {
    if (parseFunctionType(src, dest, data) == FAIL)
      END_FAIL("Type");
    END_SUCCESS("Type");
  }
  // Array type?
  else if (src[0] == 'A') {
    if (parseArrayType(src, dest, data) == FAIL)
      END_FAIL("Type");
    END_SUCCESS("Type");
  }
  // Pointer-to-member type?
  else if (src[0] == 'M') {
    if (parsePointerToMemberType(src, dest, data) == FAIL)
      END_FAIL("Type");
    END_SUCCESS("Type");
  }
  // Template parameter type?
  else if (src[0] == 'T') {
    // Try the template-template-type first, if it fails fall back.
    LargeStaticString origsrc = src;
    LargeStaticString origdest = dest;
    if (parseTemplateTemplateParam(src, dest, data) == SUCCESS &&
        parseTemplateArgs(src, dest, data) == SUCCESS)
      END_SUCCESS("Type");
 
    src = origsrc;
    dest = origdest;
 
    if (parseTemplateParam(src, dest, data) == FAIL)
      END_FAIL("Type");
 
    END_SUCCESS("Type");
  } else {
    // OK then, try a builtin-type.
    LargeStaticString origsrc = src;
    LargeStaticString origdest = dest;
    if (parseBuiltinType(src, dest, data) == SUCCESS)
      END_SUCCESS("Type");
 
    src = origsrc;
    dest = origdest;
 
    LargeStaticString tmp;
    if (parseName(src, tmp, data) == SUCCESS) {
      dest += tmp;
      addSubstitution(tmp, data);
      END_SUCCESS("Type");
    }
 
    if (src[0] == 'S') {
      src = origsrc;
      dest = origdest;
      if (parseSubstitution(src, dest, data) == FAIL)
        END_FAIL("Type");
      END_SUCCESS("Type");
    }
 
    END_FAIL("Type");
  }
}
 
/*
<builtin-type> ::= v    # void
  ::= w  # wchar_t
  ::= b  # bool
  ::= c  # char
  ::= a  # signed char
  ::= h  # unsigned char
  ::= s  # short
  ::= t  # unsigned short
  ::= i  # int
  ::= j  # unsigned int
  ::= l  # long
  ::= m  # unsigned long
  ::= x  # long long, __int64
  ::= y  # unsigned long long, __int64
  ::= n  # __int128
  ::= o  # unsigned __int128
  ::= f  # float
  ::= d  # double
  ::= e  # long double, __float80
  ::= g  # __float128
  ::= z  # ellipsis
*/
static int parseBuiltinType(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("BuiltinType");
  switch (src[0]) {
    case 'v':
      dest += "void";
      break;
    case 'w':
      dest += "wchar_t";
      break;
    case 'b':
      dest += "bool";
      break;
    case 'c':
      dest += "char";
      break;
    case 'a':
      dest += "char";
      break;
    case 'h':
      dest += "unsigned char";
      break;
    case 's':
      dest += "short";
      break;
    case 't':
      dest += "unsigned short";
      break;
    case 'i':
      dest += "int";
      break;
    case 'j':
      dest += "unsigned int";
      break;
    case 'l':
      dest += "long";
      break;
    case 'm':
      dest += "unsigned long";
      break;
    case 'x':
      dest += "__int64";
      break;
    case 'y':
      dest += "unsigned __int64";
      break;
    case 'n':
      dest += "__int128";
      break;
    case 'o':
      dest += "unsigned __int128";
      break;
    case 'f':
      dest += "float";
      break;
    case 'd':
      dest += "double";
      break;
    case 'z':
      dest += "...";
      break;
    default:
      END_FAIL("BuiltinType");
  }
  src.stripFirst(1);
  END_SUCCESS("BuiltinType");
}
 
/*
<function_type> ::= F [Y] <type> <type>+ E
*/
static int parseFunctionType(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("FunctionType");
 
  // Should start with an 'F'.
  if (src[0] != 'F')
    END_FAIL("FunctionType");
 
  src.stripFirst(1);
  // Do we have a 'Y'?
  if (src[0] == 'Y')
    src.stripFirst(1);  // Ignore it.
 
  // Return type.
  if (parseType(src, dest, data) == FAIL)
    END_FAIL("FunctionType");
 
  dest += " ()(";
  bool bIsFirst = true;
  do {
    if (bIsFirst)
      bIsFirst = false;
    else
      dest += ", ";
    if (parseType(src, dest, data) == FAIL)
      END_FAIL("FunctionType");
  } while (src[0] != 'E');
 
  dest += ")";
  src.stripFirst(1);
  END_SUCCESS("FunctionType");
}
 
/*
<bare_function_type> ::= <type>+
*/
// static int parseBareFunctionType(LargeStaticString &src, LargeStaticString
// &dest, demangle_t &data)
// {
// Unused.
// }
 
/*
<array_type> ::= A <number> _ <type>
  ::= A <expression> _ <type>
*/
static int parseArrayType(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("Array");
 
  // We should start with an 'A'.
  if (src[0] != 'A')
    END_FAIL("Array");
 
  src.stripFirst(1);
  LargeStaticString bound;
  // Number?
  if (src[0] >= '0' && src[0] <= '9') {
    size_t nLength = 0;
    while (src[nLength] >= '0' && src[nLength] <= '9')
      bound += src[nLength++];
    src.stripFirst(nLength);
  } else if (parseExpression(src, bound, data) == FAIL)
    END_FAIL("Array");
 
  // We should be looking at a '_'.
  if (src[0] != '_')
    END_FAIL("Array");
 
  src.stripFirst(1);
 
  // Get the type.
  if (parseType(src, dest, data) == FAIL)
    END_FAIL("Array");
 
  // Append the bound.
  dest += " [";
  dest += bound;
  dest += "]";
 
  END_SUCCESS("Array");
}
 
/*
<pointer_to_member_type> ::= M <class type> <member type>
*/
static int parsePointerToMemberType(LargeStaticString& src, LargeStaticString& dest,
                                    demangle_t& data) {
  START("PointerToMemberType");
 
  // We should start with an 'M'.
  if (src[0] != 'M')
    END_FAIL("PointerToMemberType");
 
  src.stripFirst(1);
 
  LargeStaticString classType;
  if (parseType(src, classType, data) == FAIL)
    END_FAIL("PointerToMemberType");
 
  // If the next thing is a function, we cheat a little to get a decent
  // looking member member function.
  if (src[0] == 'F') {
    LargeStaticString function;
    if (parseFunctionType(src, function, data) == FAIL)
      END_FAIL("PointerToMemberType");
    // find the bit before the parameter list "()".
    size_t nLength = 0;
    while (function[nLength] != '(' || function[nLength + 1] != ')')
      nLength++;  // NOTE unsafe!
 
    dest += function.left(nLength + 1);
    dest += classType;
    dest += "::*";
    dest += function.right(function.length() - nLength - 1);
  } else {
    if (parseType(src, dest, data) == FAIL)
      END_FAIL("PointerToMemberType");
    dest += " ";
    dest += classType;
    dest += "::*";
  }
  END_SUCCESS("PointerToMemberType");
}
 
/*
<template_param> ::= T_ # first parameter
  ::= T <parameter-2 non negative number> _
*/
static int parseTemplateParam(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("TemplateParam");
 
  // Must start with a T.
  if (src[0] != 'T')
    END_FAIL("TemplateParam");
 
  src.stripFirst(1);
  // If we don't start with _, there's a number first.
  int nId = 0;
  if (src[0] != '_') {
    parseNumber(src, dest, data, nId);
    nId++;  // T_ is 0, T0_ is 1, etc etc.
  }
 
  // Now we should DEFINATELY be looking at a '_'.
  if (src[0] != '_')
    END_FAIL("TemplateParam");
 
  src.stripFirst(1);
 
  // Now, look up the substitution.
  if (nId >= static_cast<int>(data.nTemplateParams))
    END_FAIL("TemplateParam");
 
  // Else, stick it in!
  dest += data.templateParams[nId];
  END_SUCCESS("TemplateParam");
}
 
/*
<template_template_param> ::= <template-param> # first parameter
  ::= <substitution>
*/
static int parseTemplateTemplateParam(LargeStaticString& src, LargeStaticString& dest,
                                      demangle_t& data) {
  START("TemplateTemplateParam");
  if (parseTemplateParam(src, dest, data) == SUCCESS)
    END_SUCCESS("TemplateTemplateParam");
  else
    END_FAIL("TemplateTemplateParam");
}
 
/*
<template_args> ::= I <template_arg>+ E
*/
static int parseTemplateArgs(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("TemplateArgs");
 
  LargeStaticString tmp;
  if (data.nNameParseLevel == 1)
    data.nTemplateParams = 0;
 
  if (src[0] != 'I')
    END_FAIL("TemplateArgs");
 
  src.stripFirst(1);
  bool bIsFirst = true;
  dest += "<";
  do {
    tmp = "";
    if (!bIsFirst)
      dest += ", ";
    bIsFirst = false;
    if (parseTemplateArg(src, tmp, data) == FAIL)
      END_FAIL("TemplateArgs");
    dest += tmp;
    if (data.nNameParseLevel == 1) {
      data.templateParams[data.nTemplateParams] = tmp;
      data.nTemplateParams++;
    }
  } while (src[0] != 'E');
  dest += ">";
  src.stripFirst(1);
 
  END_SUCCESS("TemplateArgs");
}
 
/*
<template_arg> ::= <type>
  ::= X <expression> E
  ::= <expr-primary>
*/
static int parseTemplateArg(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("TemplateArg");
  LargeStaticString origsrc = src;
  LargeStaticString origdest = dest;
 
  if (parseType(src, dest, data) == SUCCESS)
    END_SUCCESS("TemplateArg");
 
  src = origsrc;
  dest = origdest;
 
  if (src[0] == 'X') {
    src.stripFirst(1);
    if (parseExpression(src, dest, data) == FAIL)
      END_FAIL("TemplateArg");
    if (src[0] != 'E')
      END_FAIL("TemplateArg");
    src.stripFirst(1);
    END_SUCCESS("TemplateArg");
  }
 
  src = origsrc;
  dest = origdest;
 
  if (parseExprPrimary(src, dest, data) == SUCCESS)
    END_SUCCESS("TemplateArg");
 
  END_FAIL("TemplateArg");
}
 
/*
<expression> ::= <unary operator-name> <expression>
  ::= <binary operator-name> <expression> <expression>
  ::= <trinary operator-name> <expression> <expression> <expression>
  ::= st <type>
  ::= <template-param>
  ::= sr <type> <unqualified-name>                   # dependent name
  ::= sr <type> <unqualified-name> <template-args>   # dependent template-id
  ::= <expr-primary>
*/
static int parseExpression(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("Expression");
 
  if (src[0] == 'T') {
    if (parseTemplateParam(src, dest, data) == FAIL)
      END_FAIL("Expression");
    else
      END_SUCCESS("Expression");
  } else if (src[0] == 'L') {
    if (parseExprPrimary(src, dest, data) == FAIL)
      END_FAIL("Expression");
    else
      END_SUCCESS("Expression");
  }
 
  LargeStaticString op = src.left(2);
  src.stripFirst(2);
 
#define UNARY_OP(prefix)                          \
  {                                               \
    dest += prefix;                               \
    if (parseExpression(src, dest, data) == FAIL) \
      END_FAIL("Expression");                     \
    else                                          \
      END_SUCCESS("Expression");                  \
  }
#define BINARY_OP(infix)                          \
  {                                               \
    dest += "(";                                  \
    if (parseExpression(src, dest, data) == FAIL) \
      END_FAIL("Expression");                     \
    dest += infix;                                \
    if (parseExpression(src, dest, data) == FAIL) \
      END_FAIL("Expression");                     \
    else {                                        \
      dest += ")";                                \
      END_SUCCESS("Expression");                  \
    }                                             \
  }
  if (op == "ps")
    UNARY_OP("+")
  else if (op == "ng")
    UNARY_OP("-")
  else if (op == "ad")
    UNARY_OP("&")
  else if (op == "de")
    UNARY_OP("*")
  else if (op == "co")
    UNARY_OP("~")
  else if (op == "nt")
    UNARY_OP("!")
  else if (op == "pl")
    BINARY_OP("+")
  else if (op == "mi")
    BINARY_OP("-")
  else if (op == "ml")
    BINARY_OP("*")
  else if (op == "dv")
    BINARY_OP("/")
  else if (op == "rm")
    BINARY_OP("%")
  else if (op == "an")
    BINARY_OP("&")
  else if (op == "or")
    BINARY_OP("|")
  else if (op == "eo")
    BINARY_OP("^")
  else if (op == "ls")
    BINARY_OP("<<")
  else if (op == "rs")
    BINARY_OP(">>")
  else if (op == "st") {
    dest += "sizeof (";
    if (parseType(src, dest, data) == FAIL)
      END_FAIL("Expression");
    dest += ")";
    END_SUCCESS("Expression");
  }
 
  END_FAIL("Expression");
}
 
/*
<expr-primary> ::= L <type> <value number> E                   # integer literal
  ::= L <type> <value float> E                     # floating literal (ignored)
  ::= L <mangled-name> E                           # external name
*/
static int parseExprPrimary(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("ExprPrimary");
 
  // We should be looking at an 'L'.
  if (src[0] != 'L')
    END_FAIL("ExprPrimary");
 
  src.stripFirst(1);
 
  // HACK:: We don't want the full "unsigned int" nonsense, if it's a builtin
  // type we use our own handlers. Else we fall back on parseType.
  const char* cookie = 0;
  switch (src[0]) {
    case 'i':
      src.stripFirst(1);
      break;
    case 'j':
      cookie = "u";
      src.stripFirst(1);
      break;
    case 'l':
      cookie = "l";
      src.stripFirst(1);
      break;
    case 'm':
      cookie = "ul";
      src.stripFirst(1);
      break;
    default: {
      dest += '(';
      if (parseType(src, dest, data) == FAIL)
        END_FAIL("ExprPrimary");
      dest += ')';
    }
  }
 
  int n;
  if (parseNumber(src, dest, data, n) == FAIL)
    END_FAIL("ExprPrimary");
  dest += static_cast<ssize_t>(n);
  dest += cookie;
  if (src[0] != 'E')
    END_FAIL("ExprPrimary");
  src.stripFirst(1);
 
  END_SUCCESS("ExprPrimary");
}
 
/*
<substitution> ::= S <seq_id> _
  ::= S_
*/
static int parseSubstitution(LargeStaticString& src, LargeStaticString& dest, demangle_t& data) {
  START("Substitution");
 
  // Must start with an S.
  if (src[0] != 'S')
    END_FAIL("Substitution");
 
  src.stripFirst(1);
  // If we don't start with _, there's a number first.
  int nId = 0;
  if (src[0] != '_') {
    parseSeqId(src, dest, data, nId);
    nId++;  // S_ is 0, S0_ is 1, etc etc.
  }
 
  // Now we should DEFINATELY be looking at a '_'.
  if (src[0] != '_')
    END_FAIL("Substitution");
 
  src.stripFirst(1);
 
  // Now, look up the substitution.
  if (nId >= static_cast<int>(data.nSubstitutions))
    END_FAIL("Substitution");
 
  // Else, stick it in!
  dest += data.substitutions[nId];
 
  END_SUCCESS("Substitution");
}
 
/*
<seq_id> ::= <base 36 number>
*/
static int parseSeqId(LargeStaticString& src, LargeStaticString& dest, demangle_t& data,
                      int& lval) {
  START("SeqId");
  size_t nLength = 0;
  char str[32];
  while ((src[nLength] >= '0' && src[nLength] <= '9') ||
         ((src[nLength] >= 'A') && src[nLength] <= 'Z')) {
    str[nLength] = src[nLength];
    nLength++;
  }
  str[nLength] = '\0';
  lval = StringToUnsignedLong(str, 0, 36);
 
  src.stripFirst(nLength);
  END_SUCCESS("SeqId");
}
 
// If you want to run this standalone, uncomment this function.
// int main(char argc, char **argv)
// {
//   LargeStaticString src = LargeStaticString(argv[1]);
//   LargeStaticString dest;
//   demangle_t data;
//   data.nLevel = 0;
//   data.nSubstitutions = 0;
//   data.nNameParseLevel = 0;
//   int code = parseMangledName(src, dest, data);
//
//   // HACK:: Bit of a hack here - we prepend "::" to every identifier. It
//   looks a bit ugly. if (dest[0] == ':' && dest[1] == ':')
//     dest.stripFirst(2);
//
//   // Parse parameter list.
//   LargeStaticString params;
//   params += "(";
//   for (int i = 0; i < data.nParams; i++)
//   {
//     if (i > 0)
//       params += ", ";
//
//     params += data.params[i];
//   };
//   params += ")";
//
//   if (code == FAIL)
//     printf("Failed.\n");
//   else
//     printf("%s -> %s%s\n", (const char*)argv[1], (const char*)dest, (const
//     char*)params);
//
//   printf("Substitutions:\n");
//   for (int i = 0; i < data.nSubstitutions; i++)
//   {
//     if (i == 0)
//       printf("\t S_:  %s\n", (const char*)data.substitutions[0]);
//     else
//       printf("\t S%d_: %s\n", i-1, (const char*)data.substitutions[i]);
//   }
//
//   printf("Template params:\n");
//   for (int i = 0; i < data.nTemplateParams; i++)
//   {
//     if (i == 0)
//       printf("\t T_:  %s\n", (const char*)data.templateParams[0]);
//     else
//       printf("\t T%d_: %s\n", i-1, (const char*)data.templateParams[i]);
//   }
//   return 0;
// }
 
void demangle(LargeStaticString src, symbol_t* sym) {
  static demangle_t data;
  data.nLevel = 0;
  data.nSubstitutions = 0;
  data.nNameParseLevel = 0;
  int code = parseMangledName(src, sym->name, data);
  // HACK:: Bit of a hack here - we prepend "::" to every identifier. It looks
  // a bit ugly.
  if (sym->name[0] == ':' && sym->name[1] == ':')
    sym->name.stripFirst(2);
 
  if (code == FAIL) {
    sym->name = src;
    sym->nParams = 0;
    return;
  }
 
  sym->nParams = data.nParams;
  for (size_t i = 0; i < data.nParams; i++)
    sym->params[i] = data.params[i];
}
 
void demangle_full(LargeStaticString src, LargeStaticString& dest) {
  static demangle_t data;
  data.nLevel = 0;
  data.nSubstitutions = 0;
  data.nNameParseLevel = 0;
  data.nParams = 0;
 
  int code = parseMangledName(src, dest, data);
  // HACK:: Bit of a hack here - we prepend "::" to every identifier. It looks
  // a bit ugly.
  if (dest[0] == ':' && dest[1] == ':')
    dest.stripFirst(2);
 
  if (code == FAIL) {
    dest = src;
    return;
  }
 
  dest += "(";
  for (size_t i = 0; i < data.nParams; i++) {
    if (i > 0)
      dest += ", ";
 
    dest += data.params[i];
  };
  dest += ")";
}