libobjc/objc/encoding.h

   1 /* Encoding of types for Objective C.
   2    Copyright (C) 1993, 1997, 2002, 2004, 2009 Free Software Foundation, Inc.
   3
   4 Author: Kresten Krab Thorup
   5
   6 This file is part of GCC.
   7
   8 GCC is free software; you can redistribute it and/or modify
   9 it under the terms of the GNU General Public License as published by
  10 the Free Software Foundation; either version 3, or (at your option)
  11 any later version.
  12
  13 GCC is distributed in the hope that it will be useful,
  14 but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16 GNU General Public License for more details.
  17
  18 Under Section 7 of GPL version 3, you are granted additional
  19 permissions described in the GCC Runtime Library Exception, version
  20 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
  28 #ifndef __encoding_INCLUDE_GNU
  29 #define __encoding_INCLUDE_GNU
  30
  31 /* This file is to be used with the "traditional" GNU Objective-C
  32    Runtime API (the one declared in objc/objc-api.h).  If you are
  33    using the "modern" GNU Objective-C Runtime API, then the useful
  34    functions from this file are declared in objc/runtime.h.
  35 */
  36
  37 #include "objc-api.h"
  38 #include <ctype.h>
  39
  40 #ifdef __cplusplus
  41 extern "C" {
  42 #endif /* __cplusplus */
  43
  44 /* The following are used in encode strings to describe some
  45    qualifiers of method and ivar types.  */
  46 #define _C_CONST        'r'
  47 #define _C_IN           'n'
  48 #define _C_INOUT        'N'
  49 #define _C_OUT          'o'
  50 #define _C_BYCOPY       'O'
  51 #define _C_BYREF        'R'
  52 #define _C_ONEWAY       'V'
  53 #define _C_GCINVISIBLE  '|'
  54
  55 /* The same when used as flags.  */
  56 #define _F_CONST        0x01
  57 #define _F_IN           0x01
  58 #define _F_OUT          0x02
  59 #define _F_INOUT        0x03
  60 #define _F_BYCOPY       0x04
  61 #define _F_BYREF        0x08
  62 #define _F_ONEWAY       0x10
  63 #define _F_GCINVISIBLE  0x20
  64
  65 int objc_sizeof_type (const char *type);
  66 int objc_alignof_type (const char *type);
  67 int objc_aligned_size (const char *type);
  68 int objc_promoted_size (const char *type);
  69
  70 const char *objc_skip_type_qualifiers (const char *type);
  71 const char *objc_skip_typespec (const char *type);
  72 const char *objc_skip_offset (const char *type);
  73 const char *objc_skip_argspec (const char *type);
  74 int method_get_number_of_arguments (struct objc_method *);
  75 int method_get_sizeof_arguments (struct objc_method *);
  76
  77 char *method_get_first_argument (struct objc_method *,
  78                                  arglist_t argframe,
  79                                  const char **type);
  80 char *method_get_next_argument (arglist_t argframe,
  81                                 const char **type);
  82 char *method_get_nth_argument (struct objc_method *m,
  83                                arglist_t argframe,
  84                                int arg,
  85                                const char **type);
  86
  87 unsigned objc_get_type_qualifiers (const char *type);
  88
  89
  90 struct objc_struct_layout
  91 {
  92   const char *original_type;
  93   const char *type;
  94   const char *prev_type;
  95   unsigned int record_size;
  96   unsigned int record_align;
  97 };
  98
  99 void objc_layout_structure (const char *type,
 100                             struct objc_struct_layout *layout);
 101 BOOL  objc_layout_structure_next_member (struct objc_struct_layout *layout);
 102 void objc_layout_finish_structure (struct objc_struct_layout *layout,
 103                                    unsigned int *size,
 104                                    unsigned int *align);
 105 void objc_layout_structure_get_info (struct objc_struct_layout *layout,
 106                                      unsigned int *offset,
 107                                      unsigned int *align,
 108                                      const char **type);
 109
 110 #ifdef __cplusplus
 111 }
 112 #endif /* __cplusplus */
 113
 114 #endif /* __encoding_INCLUDE_GNU */