annotate libobjc/nil_method.c @ 158:494b0b89df80 default tip

...
author Shinji KONO <kono@ie.u-ryukyu.ac.jp>
date Mon, 25 May 2020 18:13:55 +0900
parents 1830386684a0
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
111
kono
parents:
diff changeset
1 /* GNU Objective C Runtime nil receiver function
145
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
2 Copyright (C) 1993-2020 Free Software Foundation, Inc.
111
kono
parents:
diff changeset
3 Contributed by Kresten Krab Thorup
kono
parents:
diff changeset
4
kono
parents:
diff changeset
5 This file is part of GCC.
kono
parents:
diff changeset
6
kono
parents:
diff changeset
7 GCC is free software; you can redistribute it and/or modify it under the
kono
parents:
diff changeset
8 terms of the GNU General Public License as published by the Free Software
kono
parents:
diff changeset
9 Foundation; either version 3, or (at your option) any later version.
kono
parents:
diff changeset
10
kono
parents:
diff changeset
11 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
kono
parents:
diff changeset
12 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
kono
parents:
diff changeset
13 FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
kono
parents:
diff changeset
14 details.
kono
parents:
diff changeset
15
kono
parents:
diff changeset
16 Under Section 7 of GPL version 3, you are granted additional
kono
parents:
diff changeset
17 permissions described in the GCC Runtime Library Exception, version
kono
parents:
diff changeset
18 3.1, as published by the Free Software Foundation.
kono
parents:
diff changeset
19
kono
parents:
diff changeset
20 You should have received a copy of the GNU General Public License and
kono
parents:
diff changeset
21 a copy of the GCC Runtime Library Exception along with this program;
kono
parents:
diff changeset
22 see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
kono
parents:
diff changeset
23 <http://www.gnu.org/licenses/>. */
kono
parents:
diff changeset
24
kono
parents:
diff changeset
25
kono
parents:
diff changeset
26 /* This is the nil method, the function that is called when the receiver
kono
parents:
diff changeset
27 of a method is nil */
kono
parents:
diff changeset
28
kono
parents:
diff changeset
29 #include "objc-private/common.h"
kono
parents:
diff changeset
30 #include "objc/objc.h"
kono
parents:
diff changeset
31
kono
parents:
diff changeset
32 /* When the receiver of a method invocation is nil, the runtime
kono
parents:
diff changeset
33 returns nil_method() as the method implementation. This function
kono
parents:
diff changeset
34 will be casted to whatever function was supposed to be executed to
kono
parents:
diff changeset
35 execute that method (that function will take an id, followed by a
kono
parents:
diff changeset
36 SEL, followed by who knows what arguments, depends on the method),
kono
parents:
diff changeset
37 and executed.
kono
parents:
diff changeset
38
kono
parents:
diff changeset
39 For this reason, nil_method() should be a function which can be
kono
parents:
diff changeset
40 called in place of any function taking an 'id' argument followed by
kono
parents:
diff changeset
41 a 'SEL' argument, followed by zero, or one, or any number of
kono
parents:
diff changeset
42 arguments (both a fixed number, or a variable number !).
kono
parents:
diff changeset
43
kono
parents:
diff changeset
44 There is no "proper" implementation of such a nil_method function
kono
parents:
diff changeset
45 in C, however in all existing implementations it does not matter
kono
parents:
diff changeset
46 when extra arguments are present, so we can simply create a function
kono
parents:
diff changeset
47 taking a receiver and a selector, and all other arguments will be
kono
parents:
diff changeset
48 ignored. :-)
kono
parents:
diff changeset
49 */
kono
parents:
diff changeset
50
kono
parents:
diff changeset
51 id
kono
parents:
diff changeset
52 nil_method (id receiver, SEL op __attribute__ ((__unused__)))
kono
parents:
diff changeset
53 {
kono
parents:
diff changeset
54 return receiver;
kono
parents:
diff changeset
55 }