1 /****************************************************************************
2  *                                                                          *
3  *                         GNAT COMPILER COMPONENTS                         *
4  *                                                                          *
5  *                            A D A D E C O D E                             *
6  *                                                                          *
7  *                              C Header File                               *
8  *                                                                          *
9  *           Copyright (C) 2001-2011, Free Software Foundation, Inc.        *
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 3,  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.                                     *
17  *                                                                          *
18  * As a special exception under Section 7 of GPL version 3, you are granted *
19  * additional permissions described in the GCC Runtime Library Exception,   *
20  * version 3.1, as published by the Free Software Foundation.               *
21  *                                                                          *
22  * You should have received a copy of the GNU General Public License and    *
23  * a copy of the GCC Runtime Library Exception along with this program;     *
24  * see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see    *
25  * <http://www.gnu.org/licenses/>.                                          *
26  *                                                                          *
27  * GNAT was originally developed  by the GNAT team at  New York University. *
28  * Extensive contributions were provided by Ada Core Technologies Inc.      *
29  *                                                                          *
30  ****************************************************************************/
31 
32 #ifdef __cplusplus
33 extern "C" {
34 #endif
35 
36 /* This function will return the Ada name from the encoded form.
37    The Ada coding is done in exp_dbug.ads and this is the inverse function.
38    see exp_dbug.ads for full encoding rules, a short description is added
39    below. Objects and routines are fully handled; types are stripped of their
40    encodings.
41 
42    CODED_NAME is the encoded entity name.
43    ADA_NAME is a pointer to a buffer, it will receive the Ada name. A safe
44    size for this buffer is: strlen (coded_name) * 2 + 60. (60 is for the
45    verbose information).
46    VERBOSE is nonzero if more information about the entity is to be
47    added at the end of the Ada name and surrounded by ( and ).  */
48 extern void __gnat_decode (const char *, char *, int);
49 
50 /* This function will return the GNAT encodings, in a colon-separated list,
51    from the encoded form. The Ada encodings are described in exp_dbug.ads.  */
52 extern void get_encoding (const char *, char *);
53 
54 /* ada_demangle is added for COMPATIBILITY ONLY. It has the name of the
55    function used in the binutils and GDB. Always consider using __gnat_decode
56    instead of ada_demangle. Caller must free the pointer returned.  */
57 extern char *ada_demangle (const char *);
58 
59 #ifdef __cplusplus
60 }
61 #endif
62