1 /* Encoding of types for Objective C.
2 Copyright (C) 1993, 1995, 1996, 1997, 1998, 2000, 2002, 2004, 2009
3 Free Software Foundation, Inc.
4 Contributed by Kresten Krab Thorup
5 Bitfield support by Ovidiu Predescu
7 This file is part of GCC.
9 GCC is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3, or (at your option)
14 GCC is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 Under Section 7 of GPL version 3, you are granted additional
20 permissions described in the GCC Runtime Library Exception, version
21 3.1, as published by the Free Software Foundation.
23 You should have received a copy of the GNU General Public License and
24 a copy of the GCC Runtime Library Exception along with this program;
25 see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
26 <http://www.gnu.org/licenses/>. */
28 /* FIXME: This file has no business including tm.h. */
31 #include "coretypes.h"
33 #include "objc/objc-api.h"
34 #include "objc/encoding.h"
39 ({ typeof (X) __x = (X), __y = (Y); \
40 (__x > __y ? __x : __y); })
44 ({ typeof (X) __x = (X), __y = (Y); \
45 (__x < __y ? __x : __y); })
49 ({ typeof (V) __v = (V); typeof (A) __a = (A); \
50 __a * ((__v+__a - 1)/__a); })
53 /* Various hacks for objc_layout_record. These are used by the target
56 #define TREE_CODE(TYPE) *(TYPE)
57 #define TREE_TYPE(TREE) (TREE)
59 #define RECORD_TYPE _C_STRUCT_B
60 #define UNION_TYPE _C_UNION_B
61 #define QUAL_UNION_TYPE _C_UNION_B
62 #define ARRAY_TYPE _C_ARY_B
64 #define REAL_TYPE _C_DBL
66 #define VECTOR_TYPE _C_VECTOR
68 #define TYPE_FIELDS(TYPE) ({const char *_field = (TYPE)+1; \
69 while (*_field != _C_STRUCT_E && *_field != _C_STRUCT_B \
70 && *_field != _C_UNION_B && *_field++ != '=') \
74 #define DECL_MODE(TYPE) *(TYPE)
75 #define TYPE_MODE(TYPE) *(TYPE)
79 #define strip_array_types(TYPE) ({const char *_field = (TYPE); \
80 while (*_field == _C_ARY_B)\
82 while (isdigit ((unsigned char)*++_field))\
87 /* Some ports (eg ARM) allow the structure size boundary to be
88 selected at compile-time. We override the normal definition with
89 one that has a constant value for this compilation. */
91 #define BITS_PER_UNIT 8
93 #undef STRUCTURE_SIZE_BOUNDARY
94 #define STRUCTURE_SIZE_BOUNDARY (BITS_PER_UNIT * sizeof (struct{char a;}))
96 /* Some ROUND_TYPE_ALIGN macros use TARGET_foo, and consequently
97 target_flags. Define a dummy entry here to so we don't die.
98 We have to rename it because target_flags may already have been
100 #define target_flags not_target_flags
101 static int __attribute__ ((__unused__
)) not_target_flags
= 0;
103 /* Some ROUND_TYPE_ALIGN use ALTIVEC_VECTOR_MODE (rs6000 darwin).
104 Define a dummy ALTIVEC_VECTOR_MODE so it will not die. */
105 #undef ALTIVEC_VECTOR_MODE
106 #define ALTIVEC_VECTOR_MODE(MODE) (0)
108 /* Furthermore, some (powerpc) targets also use TARGET_ALIGN_NATURAL
109 in their alignment macros. Currently[4.5/6], rs6000.h points this
110 to a static variable, initialized by target overrides. This is reset
111 in linux64.h but not in darwin64.h. The macro is not used by *86*. */
113 #if __MACH__ && __LP64__
114 # undef TARGET_ALIGN_NATURAL
115 # define TARGET_ALIGN_NATURAL 1
118 /* FIXME: while this file has no business including tm.h, this
119 definitely has no business defining this macro but it
120 is only way around without really rewritting this file,
121 should look after the branch of 3.4 to fix this.
122 FIXME1: It's also out of date, darwin no longer has the same alignment
123 'special' as aix - this is probably the origin of the m32 breakage. */
124 #define rs6000_special_round_type_align(STRUCT, COMPUTED, SPECIFIED) \
125 ({ const char *_fields = TYPE_FIELDS (STRUCT); \
127 && TYPE_MODE (strip_array_types (TREE_TYPE (_fields))) == DFmode) \
128 ? MAX (MAX (COMPUTED, SPECIFIED), 64) \
129 : MAX (COMPUTED, SPECIFIED));})
130 /* FIXME: The word 'fixme' is insufficient to explain the wrong-ness
131 of this next macro definition. */
132 #define darwin_rs6000_special_round_type_align(S,C,S2) \
133 rs6000_special_round_type_align(S,C,S2)
136 return the size of an object specified by type
140 objc_sizeof_type (const char *type
)
142 /* Skip the variable name if any */
145 for (type
++; *type
++ != '"';)
151 return sizeof (_Bool
);
159 return sizeof (Class
);
167 return sizeof (char);
171 return sizeof (unsigned char);
175 return sizeof (short);
179 return sizeof (unsigned short);
187 return sizeof (unsigned int);
191 return sizeof (long);
195 return sizeof (unsigned long);
199 return sizeof (long long);
203 return sizeof (unsigned long long);
207 return sizeof (float);
211 return sizeof (double);
215 return sizeof (void);
221 return sizeof (char *);
226 int len
= atoi (type
+ 1);
227 while (isdigit ((unsigned char)*++type
))
229 return len
* objc_aligned_size (type
);
235 /* The new encoding of bitfields is: b 'position' 'type' 'size' */
237 int startByte
, endByte
;
239 position
= atoi (type
+ 1);
240 while (isdigit ((unsigned char)*++type
))
242 size
= atoi (type
+ 1);
244 startByte
= position
/ BITS_PER_UNIT
;
245 endByte
= (position
+ size
) / BITS_PER_UNIT
;
246 return endByte
- startByte
;
252 struct objc_struct_layout layout
;
255 objc_layout_structure (type
, &layout
);
256 while (objc_layout_structure_next_member (&layout
))
258 objc_layout_finish_structure (&layout
, &size
, NULL
);
265 type
++; /* Skip after the 'j'. */
269 return sizeof (_Complex
char);
273 return sizeof (_Complex
unsigned char);
277 return sizeof (_Complex
short);
281 return sizeof (_Complex
unsigned short);
285 return sizeof (_Complex
int);
289 return sizeof (_Complex
unsigned int);
293 return sizeof (_Complex
long);
297 return sizeof (_Complex
unsigned long);
301 return sizeof (_Complex
long long);
305 return sizeof (_Complex
unsigned long long);
309 return sizeof (_Complex
float);
313 return sizeof (_Complex
double);
318 objc_error (nil
, OBJC_ERR_BAD_TYPE
, "unknown complex type %s\n",
327 objc_error (nil
, OBJC_ERR_BAD_TYPE
, "unknown type %s\n", type
);
335 Return the alignment of an object specified by type
339 objc_alignof_type (const char *type
)
341 /* Skip the variable name if any */
344 for (type
++; *type
++ != '"';)
349 return __alignof__ (_Bool
);
353 return __alignof__ (id
);
357 return __alignof__ (Class
);
361 return __alignof__ (SEL
);
365 return __alignof__ (char);
369 return __alignof__ (unsigned char);
373 return __alignof__ (short);
377 return __alignof__ (unsigned short);
381 return __alignof__ (int);
385 return __alignof__ (unsigned int);
389 return __alignof__ (long);
393 return __alignof__ (unsigned long);
397 return __alignof__ (long long);
401 return __alignof__ (unsigned long long);
405 return __alignof__ (float);
409 return __alignof__ (double);
415 return __alignof__ (char *);
419 while (isdigit ((unsigned char)*++type
))
421 return objc_alignof_type (type
);
426 struct objc_struct_layout layout
;
429 objc_layout_structure (type
, &layout
);
430 while (objc_layout_structure_next_member (&layout
))
432 objc_layout_finish_structure (&layout
, NULL
, &align
);
440 type
++; /* Skip after the 'j'. */
444 return __alignof__ (_Complex
char);
448 return __alignof__ (_Complex
unsigned char);
452 return __alignof__ (_Complex
short);
456 return __alignof__ (_Complex
unsigned short);
460 return __alignof__ (_Complex
int);
464 return __alignof__ (_Complex
unsigned int);
468 return __alignof__ (_Complex
long);
472 return __alignof__ (_Complex
unsigned long);
476 return __alignof__ (_Complex
long long);
480 return __alignof__ (_Complex
unsigned long long);
484 return __alignof__ (_Complex
float);
488 return __alignof__ (_Complex
double);
493 objc_error (nil
, OBJC_ERR_BAD_TYPE
, "unknown complex type %s\n",
502 objc_error (nil
, OBJC_ERR_BAD_TYPE
, "unknown type %s\n", type
);
509 The aligned size if the size rounded up to the nearest alignment.
513 objc_aligned_size (const char *type
)
517 /* Skip the variable name */
520 for (type
++; *type
++ != '"';)
524 size
= objc_sizeof_type (type
);
525 align
= objc_alignof_type (type
);
527 return ROUND (size
, align
);
531 The size rounded up to the nearest integral of the wordsize, taken
532 to be the size of a void *.
536 objc_promoted_size (const char *type
)
540 /* Skip the variable name */
543 for (type
++; *type
++ != '"';)
547 size
= objc_sizeof_type (type
);
548 wordsize
= sizeof (void *);
550 return ROUND (size
, wordsize
);
554 Skip type qualifiers. These may eventually precede typespecs
555 occurring in method prototype encodings.
559 objc_skip_type_qualifiers (const char *type
)
561 while (*type
== _C_CONST
565 || *type
== _C_BYCOPY
567 || *type
== _C_ONEWAY
568 || *type
== _C_GCINVISIBLE
)
577 Skip one typespec element. If the typespec is prepended by type
578 qualifiers, these are skipped as well.
582 objc_skip_typespec (const char *type
)
584 /* Skip the variable name if any */
587 for (type
++; *type
++ != '"';)
591 type
= objc_skip_type_qualifiers (type
);
596 /* An id may be annotated by the actual type if it is known
597 with the @"ClassName" syntax */
603 while (*++type
!= '"')
608 /* The following are one character type codes */
636 /* skip digits, typespec and closing ']' */
638 while (isdigit ((unsigned char)*++type
))
640 type
= objc_skip_typespec (type
);
641 if (*type
== _C_ARY_E
)
645 objc_error (nil
, OBJC_ERR_BAD_TYPE
, "bad array type %s\n", type
);
650 /* The new encoding of bitfields is: b 'position' 'type' 'size' */
651 while (isdigit ((unsigned char)*++type
))
652 ; /* skip position */
653 while (isdigit ((unsigned char)*++type
))
654 ; /* skip type and size */
658 /* skip name, and elements until closing '}' */
660 while (*type
!= _C_STRUCT_E
&& *type
++ != '=')
662 while (*type
!= _C_STRUCT_E
)
664 type
= objc_skip_typespec (type
);
669 /* skip name, and elements until closing ')' */
671 while (*type
!= _C_UNION_E
&& *type
++ != '=')
673 while (*type
!= _C_UNION_E
)
675 type
= objc_skip_typespec (type
);
680 /* Just skip the following typespec */
682 return objc_skip_typespec (++type
);
686 objc_error (nil
, OBJC_ERR_BAD_TYPE
, "unknown type %s\n", type
);
693 Skip an offset as part of a method encoding. This is prepended by a
694 '+' if the argument is passed in registers.
697 objc_skip_offset (const char *type
)
701 while (isdigit ((unsigned char) *++type
))
707 Skip an argument specification of a method encoding.
710 objc_skip_argspec (const char *type
)
712 type
= objc_skip_typespec (type
);
713 type
= objc_skip_offset (type
);
718 Return the number of arguments that the method MTH expects.
719 Note that all methods need two implicit arguments `self' and
723 method_get_number_of_arguments (struct objc_method
*mth
)
726 const char *type
= mth
->method_types
;
729 type
= objc_skip_argspec (type
);
736 Return the size of the argument block needed on the stack to invoke
737 the method MTH. This may be zero, if all arguments are passed in
742 method_get_sizeof_arguments (struct objc_method
*mth
)
744 const char *type
= objc_skip_typespec (mth
->method_types
);
749 Return a pointer to the next argument of ARGFRAME. type points to
750 the last argument. Typical use of this look like:
754 for (datum = method_get_first_argument (method, argframe, &type);
755 datum; datum = method_get_next_argument (argframe, &type))
757 unsigned flags = objc_get_type_qualifiers (type);
758 type = objc_skip_type_qualifiers (type);
760 [portal encodeData: datum ofType: type];
763 if ((flags & _F_IN) == _F_IN)
764 [portal encodeData: *(char **) datum ofType: ++type];
771 method_get_next_argument (arglist_t argframe
, const char **type
)
773 const char *t
= objc_skip_argspec (*type
);
779 t
= objc_skip_typespec (t
);
782 return argframe
->arg_regs
+ atoi (++t
);
784 return argframe
->arg_ptr
+ atoi (t
);
788 Return a pointer to the value of the first argument of the method
789 described in M with the given argumentframe ARGFRAME. The type
790 is returned in TYPE. type must be passed to successive calls of
791 method_get_next_argument.
794 method_get_first_argument (struct objc_method
*m
,
798 *type
= m
->method_types
;
799 return method_get_next_argument (argframe
, type
);
803 Return a pointer to the ARGth argument of the method
804 M from the frame ARGFRAME. The type of the argument
805 is returned in the value-result argument TYPE
809 method_get_nth_argument (struct objc_method
*m
,
810 arglist_t argframe
, int arg
,
813 const char *t
= objc_skip_argspec (m
->method_types
);
815 if (arg
> method_get_number_of_arguments (m
))
819 t
= objc_skip_argspec (t
);
822 t
= objc_skip_typespec (t
);
825 return argframe
->arg_regs
+ atoi (++t
);
827 return argframe
->arg_ptr
+ atoi (t
);
831 objc_get_type_qualifiers (const char *type
)
839 case _C_CONST
: res
|= _F_CONST
; break;
840 case _C_IN
: res
|= _F_IN
; break;
841 case _C_INOUT
: res
|= _F_INOUT
; break;
842 case _C_OUT
: res
|= _F_OUT
; break;
843 case _C_BYCOPY
: res
|= _F_BYCOPY
; break;
844 case _C_BYREF
: res
|= _F_BYREF
; break;
845 case _C_ONEWAY
: res
|= _F_ONEWAY
; break;
846 case _C_GCINVISIBLE
: res
|= _F_GCINVISIBLE
; break;
854 /* The following three functions can be used to determine how a
855 structure is laid out by the compiler. For example:
857 struct objc_struct_layout layout;
860 objc_layout_structure (type, &layout);
861 while (objc_layout_structure_next_member (&layout))
866 objc_layout_structure_get_info (&layout, &position, &align, &type);
867 printf ("element %d has offset %d, alignment %d\n",
868 i++, position, align);
871 These functions are used by objc_sizeof_type and objc_alignof_type
872 functions to compute the size and alignment of structures. The
873 previous method of computing the size and alignment of a structure
874 was not working on some architectures, particulary on AIX, and in
875 the presence of bitfields inside the structure. */
877 objc_layout_structure (const char *type
,
878 struct objc_struct_layout
*layout
)
882 if (*type
!= _C_UNION_B
&& *type
!= _C_STRUCT_B
)
884 objc_error (nil
, OBJC_ERR_BAD_TYPE
,
885 "record (or union) type expected in objc_layout_structure, got %s\n",
890 layout
->original_type
= type
;
892 /* Skip "<name>=" if any. Avoid embedded structures and unions. */
894 while (*ntype
!= _C_STRUCT_E
&& *ntype
!= _C_STRUCT_B
&& *ntype
!= _C_UNION_B
898 /* If there's a "<name>=", ntype - 1 points to '='; skip the the name */
899 if (*(ntype
- 1) == '=')
903 layout
->prev_type
= NULL
;
904 layout
->record_size
= 0;
905 layout
->record_align
= BITS_PER_UNIT
;
907 layout
->record_align
= MAX (layout
->record_align
, STRUCTURE_SIZE_BOUNDARY
);
912 objc_layout_structure_next_member (struct objc_struct_layout
*layout
)
914 register int desired_align
= 0;
916 /* The following are used only if the field is a bitfield */
917 register const char *bfld_type
= 0;
918 register int bfld_type_align
= 0, bfld_field_size
= 0;
920 /* The current type without the type qualifiers */
922 BOOL unionp
= layout
->original_type
[-1] == _C_UNION_B
;
924 /* Add the size of the previous field to the size of the record. */
925 if (layout
->prev_type
)
927 type
= objc_skip_type_qualifiers (layout
->prev_type
);
929 layout
->record_size
= MAX (layout
->record_size
,
930 objc_sizeof_type (type
) * BITS_PER_UNIT
);
932 else if (*type
!= _C_BFLD
)
933 layout
->record_size
+= objc_sizeof_type (type
) * BITS_PER_UNIT
;
935 /* Get the bitfield's type */
936 for (bfld_type
= type
+ 1;
937 isdigit ((unsigned char)*bfld_type
);
941 bfld_type_align
= objc_alignof_type (bfld_type
) * BITS_PER_UNIT
;
942 bfld_field_size
= atoi (objc_skip_typespec (bfld_type
));
943 layout
->record_size
+= bfld_field_size
;
947 if ((unionp
&& *layout
->type
== _C_UNION_E
)
948 || (!unionp
&& *layout
->type
== _C_STRUCT_E
))
951 /* Skip the variable name if any */
952 if (*layout
->type
== '"')
954 for (layout
->type
++; *layout
->type
++ != '"';)
958 type
= objc_skip_type_qualifiers (layout
->type
);
960 if (*type
!= _C_BFLD
)
961 desired_align
= objc_alignof_type (type
) * BITS_PER_UNIT
;
965 /* Skip the bitfield's offset */
966 for (bfld_type
= type
+ 1;
967 isdigit ((unsigned char) *bfld_type
);
971 bfld_type_align
= objc_alignof_type (bfld_type
) * BITS_PER_UNIT
;
972 bfld_field_size
= atoi (objc_skip_typespec (bfld_type
));
975 #ifdef BIGGEST_FIELD_ALIGNMENT
976 desired_align
= MIN (desired_align
, BIGGEST_FIELD_ALIGNMENT
);
978 #ifdef ADJUST_FIELD_ALIGN
979 desired_align
= ADJUST_FIELD_ALIGN (type
, desired_align
);
982 /* Record must have at least as much alignment as any field.
983 Otherwise, the alignment of the field within the record
985 #ifndef PCC_BITFIELD_TYPE_MATTERS
986 layout
->record_align
= MAX (layout
->record_align
, desired_align
);
987 #else /* PCC_BITFIELD_TYPE_MATTERS */
988 if (*type
== _C_BFLD
)
990 /* For these machines, a zero-length field does not
991 affect the alignment of the structure as a whole.
992 It does, however, affect the alignment of the next field
993 within the structure. */
995 layout
->record_align
= MAX (layout
->record_align
, desired_align
);
997 desired_align
= objc_alignof_type (bfld_type
) * BITS_PER_UNIT
;
999 /* A named bit field of declared type `int'
1000 forces the entire structure to have `int' alignment.
1001 Q1: How is encoded this thing and how to check for it?
1002 Q2: How to determine maximum_field_alignment at runtime? */
1004 /* if (DECL_NAME (field) != 0) */
1006 int type_align
= bfld_type_align
;
1008 if (maximum_field_alignment
!= 0)
1009 type_align
= MIN (type_align
, maximum_field_alignment
);
1010 else if (DECL_PACKED (field
))
1011 type_align
= MIN (type_align
, BITS_PER_UNIT
);
1014 layout
->record_align
= MAX (layout
->record_align
, type_align
);
1018 layout
->record_align
= MAX (layout
->record_align
, desired_align
);
1019 #endif /* PCC_BITFIELD_TYPE_MATTERS */
1021 /* Does this field automatically have alignment it needs
1022 by virtue of the fields that precede it and the record's
1025 if (*type
== _C_BFLD
)
1026 layout
->record_size
= atoi (type
+ 1);
1027 else if (layout
->record_size
% desired_align
!= 0)
1029 /* No, we need to skip space before this field.
1030 Bump the cumulative size to multiple of field alignment. */
1031 layout
->record_size
= ROUND (layout
->record_size
, desired_align
);
1034 /* Jump to the next field in record. */
1036 layout
->prev_type
= layout
->type
;
1037 layout
->type
= objc_skip_typespec (layout
->type
); /* skip component */
1043 void objc_layout_finish_structure (struct objc_struct_layout
*layout
,
1045 unsigned int *align
)
1047 BOOL unionp
= layout
->original_type
[-1] == _C_UNION_B
;
1049 && ((!unionp
&& *layout
->type
== _C_STRUCT_E
)
1050 || (unionp
&& *layout
->type
== _C_UNION_E
)))
1052 /* Work out the alignment of the record as one expression and store
1053 in the record type. Round it up to a multiple of the record's
1055 #if defined (ROUND_TYPE_ALIGN) && ! defined (__sparc__)
1056 layout
->record_align
= ROUND_TYPE_ALIGN (layout
->original_type
-1,
1058 layout
->record_align
);
1060 layout
->record_align
= MAX (1, layout
->record_align
);
1063 #ifdef ROUND_TYPE_SIZE
1064 layout
->record_size
= ROUND_TYPE_SIZE (layout
->original_type
,
1065 layout
->record_size
,
1066 layout
->record_align
);
1068 /* Round the size up to be a multiple of the required alignment */
1069 layout
->record_size
= ROUND (layout
->record_size
, layout
->record_align
);
1072 layout
->type
= NULL
;
1075 *size
= layout
->record_size
/ BITS_PER_UNIT
;
1077 *align
= layout
->record_align
/ BITS_PER_UNIT
;
1081 void objc_layout_structure_get_info (struct objc_struct_layout
*layout
,
1082 unsigned int *offset
,
1083 unsigned int *align
,
1087 *offset
= layout
->record_size
/ BITS_PER_UNIT
;
1089 *align
= layout
->record_align
/ BITS_PER_UNIT
;
1091 *type
= layout
->prev_type
;