[thirdparty/gcc.git] / gcc / ada / adadecode.h

/****************************************************************************
 *                                                                          *
 *                         GNAT COMPILER COMPONENTS                         *
 *                                                                          *
 *                            A D A D E C O D E                             *
 *                                                                          *
 *                              C Header File                               *
 *                                                                          *
 *           Copyright (C) 2001-2003, Free Software Foundation, Inc.        *
 *                                                                          *
 * GNAT is free software;  you can  redistribute it  and/or modify it under *
 * terms of the  GNU General Public License as published  by the Free Soft- *
 * ware  Foundation;  either version 2,  or (at your option) any later ver- *
 * sion.  GNAT is distributed in the hope that it will be useful, but WITH- *
 * OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY *
 * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License *
 * for  more details.  You should have  received  a copy of the GNU General *
 * Public License  distributed with GNAT;  see file COPYING.  If not, write *
 * to  the Free Software Foundation,  59 Temple Place - Suite 330,  Boston, *
 * MA 02111-1307, USA.                                                      *
 *                                                                          *
 * As a  special  exception,  if you  link  this file  with other  files to *
 * produce an executable,  this file does not by itself cause the resulting *
 * executable to be covered by the GNU General Public License. This except- *
 * ion does not  however invalidate  any other reasons  why the  executable *
 * file might be covered by the  GNU Public License.                        *
 *                                                                          *
 * GNAT was originally developed  by the GNAT team at  New York University. *
 * Extensive contributions were provided by Ada Core Technologies Inc.      *
 *                                                                          *
 ****************************************************************************/

/* This function will return the Ada name from the encoded form.
   The Ada coding is done in exp_dbug.ads and this is the inverse function.
   see exp_dbug.ads for full encoding rules, a short description is added
   below. Right now only objects and routines are handled. There is no support
   for Ada types.

   CODED_NAME is the encoded entity name.
   ADA_NAME is a pointer to a buffer, it will receive the Ada name. A safe
   size for this buffer is: strlen (coded_name) * 2 + 60. (60 is for the
   verbose information).
   VERBOSE is nonzero if more information about the entity is to be
   added at the end of the Ada name and surrounded by ( and ).  */
extern void __gnat_decode (const char *, char *, int);

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