annotate gcc/objc/objc-tree.def @ 131:84e7813d76e9

gcc-8.2
author mir3636
date Thu, 25 Oct 2018 07:37:49 +0900
parents 04ced10e8804
children 1830386684a0
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
111
kono
parents:
diff changeset
1 /* This file contains the definitions and documentation for the
kono
parents:
diff changeset
2 additional tree codes used in the Objective C front end (see tree.def
kono
parents:
diff changeset
3 for the standard codes).
131
84e7813d76e9 gcc-8.2
mir3636
parents: 111
diff changeset
4 Copyright (C) 1990-2018 Free Software Foundation, Inc.
111
kono
parents:
diff changeset
5
kono
parents:
diff changeset
6 This file is part of GCC.
kono
parents:
diff changeset
7
kono
parents:
diff changeset
8 GCC is free software; you can redistribute it and/or modify
kono
parents:
diff changeset
9 it under the terms of the GNU General Public License as published by
kono
parents:
diff changeset
10 the Free Software Foundation; either version 3, or (at your option)
kono
parents:
diff changeset
11 any later version.
kono
parents:
diff changeset
12
kono
parents:
diff changeset
13 GCC is distributed in the hope that it will be useful,
kono
parents:
diff changeset
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
kono
parents:
diff changeset
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
kono
parents:
diff changeset
16 GNU General Public License for more details.
kono
parents:
diff changeset
17
kono
parents:
diff changeset
18 You should have received a copy of the GNU General Public License
kono
parents:
diff changeset
19 along with GCC; see the file COPYING3. If not see
kono
parents:
diff changeset
20 <http://www.gnu.org/licenses/>. */
kono
parents:
diff changeset
21
kono
parents:
diff changeset
22
kono
parents:
diff changeset
23 /* Objective-C types. */
kono
parents:
diff changeset
24 DEFTREECODE (CLASS_INTERFACE_TYPE, "class_interface_type", tcc_type, 0)
kono
parents:
diff changeset
25 DEFTREECODE (CLASS_IMPLEMENTATION_TYPE, "class_implementation_type",
kono
parents:
diff changeset
26 tcc_type, 0)
kono
parents:
diff changeset
27 DEFTREECODE (CATEGORY_INTERFACE_TYPE, "category_interface_type", tcc_type, 0)
kono
parents:
diff changeset
28 DEFTREECODE (CATEGORY_IMPLEMENTATION_TYPE,"category_implementation_type",
kono
parents:
diff changeset
29 tcc_type, 0)
kono
parents:
diff changeset
30 DEFTREECODE (PROTOCOL_INTERFACE_TYPE, "protocol_interface_type", tcc_type, 0)
kono
parents:
diff changeset
31
kono
parents:
diff changeset
32 /* Objective-C decls. */
kono
parents:
diff changeset
33 DEFTREECODE (KEYWORD_DECL, "keyword_decl", tcc_declaration, 0)
kono
parents:
diff changeset
34 DEFTREECODE (INSTANCE_METHOD_DECL, "instance_method_decl", tcc_declaration, 0)
kono
parents:
diff changeset
35 DEFTREECODE (CLASS_METHOD_DECL, "class_method_decl", tcc_declaration, 0)
kono
parents:
diff changeset
36 DEFTREECODE (PROPERTY_DECL, "property_decl", tcc_declaration, 0)
kono
parents:
diff changeset
37
kono
parents:
diff changeset
38 /* Objective-C expressions. */
kono
parents:
diff changeset
39 DEFTREECODE (MESSAGE_SEND_EXPR, "message_send_expr", tcc_expression, 3)
kono
parents:
diff changeset
40 DEFTREECODE (CLASS_REFERENCE_EXPR, "class_reference_expr", tcc_expression, 1)
kono
parents:
diff changeset
41
kono
parents:
diff changeset
42 /* This tree is used to represent the expression 'object.property',
kono
parents:
diff changeset
43 where 'object' is an Objective-C object and 'property' is an
kono
parents:
diff changeset
44 Objective-C property. Operand 0 is the object (the tree
kono
parents:
diff changeset
45 representing the expression), and Operand 1 is the property (the
kono
parents:
diff changeset
46 PROPERTY_DECL). Operand 2 is the 'getter' call, ready to be used;
kono
parents:
diff changeset
47 we pregenerate it because it is hard to generate it properly later
kono
parents:
diff changeset
48 on. Operand 3 records whether using the 'getter' call should
kono
parents:
diff changeset
49 generate a deprecation warning or not.
kono
parents:
diff changeset
50
kono
parents:
diff changeset
51 A PROPERTY_REF tree needs to be transformed into 'setter' and
kono
parents:
diff changeset
52 'getter' calls at some point; at the moment this happens in two
kono
parents:
diff changeset
53 places:
kono
parents:
diff changeset
54
kono
parents:
diff changeset
55 * if we detect that a modify expression is being applied to a
kono
parents:
diff changeset
56 PROPERTY_REF, then we transform that into a 'getter' call (this
kono
parents:
diff changeset
57 happens in build_modify_expr() or cp_build_modify_expr()).
kono
parents:
diff changeset
58
kono
parents:
diff changeset
59 * else, it will remain as a PROPERTY_REF until we get to
kono
parents:
diff changeset
60 gimplification; at that point, we convert each PROPERTY_REF into
kono
parents:
diff changeset
61 a 'getter' call during ObjC/ObjC++ gimplify. At that point, it
kono
parents:
diff changeset
62 is quite hard to build a 'getter' call, but we have already built
kono
parents:
diff changeset
63 it and we just need to swap Operand 2 in, and emit the deprecation
kono
parents:
diff changeset
64 warnings from Operand 3 if needed.
kono
parents:
diff changeset
65
kono
parents:
diff changeset
66 Please note that when the Objective-C 2.0 "dot-syntax" 'object.component'
kono
parents:
diff changeset
67 is encountered, where 'component' is not a property but there are valid
kono
parents:
diff changeset
68 setter/getter methods for it, an artificial PROPERTY_DECL is generated
kono
parents:
diff changeset
69 and used in the PROPERTY_REF. */
kono
parents:
diff changeset
70 DEFTREECODE (PROPERTY_REF, "property_ref", tcc_expression, 4)
kono
parents:
diff changeset
71
kono
parents:
diff changeset
72 /*
kono
parents:
diff changeset
73 Local variables:
kono
parents:
diff changeset
74 mode:c
kono
parents:
diff changeset
75 End:
kono
parents:
diff changeset
76 */