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-2023, 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  #ifdef __cplusplus
      55  }
      56  #endif