gcc/ada/adadecode.h

   1 /****************************************************************************
   2  *                                                                          *
   3  *                         GNAT COMPILER COMPONENTS                         *
   4  *                                                                          *
   5  *                             G N A T D E C O                              *
   6  *                                                                          *
   7  *                            $Revision$
   8  *                                                                          *
   9  *                              C Header File                               *
  10  *                                                                          *
  11  *           Copyright (C) 2001-2002, Free Software Foundation, Inc.        *
  12  *                                                                          *
  13  * GNAT is free software;  you can  redistribute it  and/or modify it under *
  14  * terms of the  GNU General Public License as published  by the Free Soft- *
  15  * ware  Foundation;  either version 2,  or (at your option) any later ver- *
  16  * sion.  GNAT is distributed in the hope that it will be useful, but WITH- *
  17  * OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY *
  18  * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License *
  19  * for  more details.  You should have  received  a copy of the GNU General *
  20  * Public License  distributed with GNAT;  see file COPYING.  If not, write *
  21  * to  the Free Software Foundation,  59 Temple Place - Suite 330,  Boston, *
  22  * MA 02111-1307, USA.                                                      *
  23  *                                                                          *
  24  * As a  special  exception,  if you  link  this file  with other  files to *
  25  * produce an executable,  this file does not by itself cause the resulting *
  26  * executable to be covered by the GNU General Public License. This except- *
  27  * ion does not  however invalidate  any other reasons  why the  executable *
  28  * file might be covered by the  GNU Public License.                        *
  29  *                                                                          *
  30  * GNAT was originally developed  by the GNAT team at  New York University. *
  31  * It is now maintained by Ada Core Technologies Inc (http://www.gnat.com). *
  32  *                                                                          *
  33  ****************************************************************************/
  34
  35 /* This function will return the Ada name from the encoded form.
  36    The Ada coding is done in exp_dbug.ads and this is the inverse function.
  37    see exp_dbug.ads for full encoding rules, a short description is added
  38    below. Right now only objects and routines are handled. There is no support
  39    for Ada types.
  40
  41    CODED_NAME is the encoded entity name.
  42    ADA_NAME is a pointer to a buffer, it will receive the Ada name. A safe
  43    size for this buffer is: strlen (coded_name) * 2 + 60. (60 is for the
  44    verbose information).
  45    VERBOSE is nonzero if more information about the entity is to be
  46    added at the end of the Ada name and surrounded by ( and ).  */
  47 extern void __gnat_decode PARAMS ((const char *, char *, int));
  48
  49 /* ada_demangle is added for COMPATIBILITY ONLY. It has the name of the
  50    function used in the binutils and GDB. Always consider using __gnat_decode
  51    instead of ada_demangle. Caller must free the pointer returned.  */
  52 extern char *ada_demangle PARAMS ((const char *));