objc4_Read/runtime/Module/ObjectiveC.apinotes at master · sclcoder/objc4_Read · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
---
Name: ObjectiveC
Classes:
- Name: NSArray
  SwiftBridge: 'Swift.Array'
- Name: NSDictionary
  SwiftBridge: 'Swift.Dictionary'
- Name: NSSet
  SwiftBridge: 'Swift.Set'
- Name: NSString
  SwiftBridge: 'Swift.String'
- Name: List
  Methods:
  - Selector: init
    MethodKind: Instance
    NullabilityOfRet: N
  - Selector: 'isEqual:'
    MethodKind: Instance
    Nullability:
    - O
    NullabilityOfRet: S
- Name: NSObject
  SwiftName: NSObject
  Methods:
  - Selector: alloc
    MethodKind: Class
    NullabilityOfRet: N
  - Selector: 'allocWithZone:'
    MethodKind: Class
    Nullability:
    - S
    NullabilityOfRet: N
  - Selector: class
    MethodKind: Class
    Availability: nonswift
    AvailabilityMsg: use 'self' instead
  - Selector: 'conformsToProtocol:'
    MethodKind: Class
    Nullability:
    - N
    NullabilityOfRet: S
  - Selector: copy
    MethodKind: Instance
    NullabilityOfRet: N
  - Selector: dealloc
    MethodKind: Instance
    Availability: nonswift
    AvailabilityMsg: use 'deinit' to define a de-initializer
  - Selector: debugDescription
    MethodKind: Class
    NullabilityOfRet: N
  - Selector: description
    MethodKind: Class
    NullabilityOfRet: N
  - Selector: 'forwardingTargetForSelector:'
    MethodKind: Instance
    Nullability:
    - S
    NullabilityOfRet: O
  - Selector: 'forwardInvocation:'
    MethodKind: Instance
    Availability: nonswift
  - Selector: init
    MethodKind: Instance
    NullabilityOfRet: N
    DesignatedInit: true
  - Selector: 'instanceMethodSignatureForSelector:'
    MethodKind: Class
    Availability: nonswift
  - Selector: 'isSubclassOfClass:'
    MethodKind: Class
    Nullability:
    - N
    NullabilityOfRet: S
  - Selector: 'methodSignatureForSelector:'
    MethodKind: Instance
    Availability: nonswift
  - Selector: mutableCopy
    MethodKind: Instance
    NullabilityOfRet: N
  - Selector: new
    MethodKind: Class
    NullabilityOfRet: N
  - Selector: superclass
    MethodKind: Class
    NullabilityOfRet: O
- Name: Object
  Methods:
  - Selector: init
    MethodKind: Instance
    NullabilityOfRet: N
  - Selector: 'isEqual:'
    MethodKind: Instance
    Nullability:
    - O
    NullabilityOfRet: S
Protocols:
- Name: NSObject
  SwiftName: NSObjectProtocol
  Methods:
  - Selector: class
    MethodKind: Instance
    Availability: nonswift
    AvailabilityMsg: use 'type(of:)' instead
  - Selector: 'conformsToProtocol:'
    MethodKind: Instance
    Nullability:
    - N
    NullabilityOfRet: S
  - Selector: 'isEqual:'
    MethodKind: Instance
    Nullability:
    - O
    NullabilityOfRet: S
  - Selector: 'isKindOfClass:'
    MethodKind: Instance
    Nullability:
    - N
    NullabilityOfRet: S
  - Selector: 'isMemberOfClass:'
    MethodKind: Instance
    Nullability:
    - N
    NullabilityOfRet: S
  - Selector: self
    MethodKind: Instance
    NullabilityOfRet: N
  Properties:
  - Name: debugDescription
    Nullability: N
  - Name: description
    Nullability: N
  - Name: superclass
    Nullability: O
Tags:
- Name: _NSZone
  SwiftName: _NSZone


# Runtime functions did not yet have nullability in Swift 3.

SwiftVersions:
- Version: 3
  Functions:
  # objc.h swift3
  - Name: object_getClassName
    NullabilityOfRet: U
    Nullability: [U]
  - Name: sel_isMapped
    Nullability: [U]
  - Name: sel_getUid
    NullabilityOfRet: U
    Nullability: [U]

  # objc-exception.h swift3
  - Name: objc_exception_throw
    Nullability: [U]
  - Name: objc_begin_catch
    NullabilityOfRet: U
    Nullability: [U]
  - Name: objc_setExceptionPreprocessor
    NullabilityOfRet: U
    Nullability: [U]
  - Name: objc_setExceptionMatcher
    NullabilityOfRet: U
    Nullability: [U]
  - Name: objc_setUncaughtExceptionHandler
    NullabilityOfRet: U
    Nullability: [U]
  - Name: objc_addExceptionHandler
    Nullability: [U, U]

  # objc-sync.h swift3
  - Name: objc_sync_enter
    Nullability: [U]
  - Name: objc_sync_exit
    Nullability: [U]

  # runtime.h swift3
  - Name: object_getClass
    NullabilityOfRet: U
    Nullability: [U]
  - Name: object_setClass
    NullabilityOfRet: U
    Nullability: [U, U]
  - Name: object_isClass
    Nullability: [U]
  - Name: object_getIvar
    NullabilityOfRet: U
    Nullability: [U, U]
  - Name: object_setIvar
    Nullability: [U, U, U]
  - Name: object_setIvarWithStrongDefault
    Nullability: [U, U, U]
  - Name: objc_getClass
    NullabilityOfRet: U
    Nullability: [U]
  - Name: objc_getMetaClass
    NullabilityOfRet: U
    Nullability: [U]
  - Name: objc_lookUpClass
    NullabilityOfRet: U
    Nullability: [U]
  - Name: objc_getRequiredClass
    NullabilityOfRet: U
    Nullability: [U]
  - Name: objc_getClassList
    Parameters:
    - Position: 0
      Type: "Class _Nullable * _Null_unspecified"
  - Name: objc_copyClassList
    ResultType: "Class _Nullable * _Null_unspecified"
    Nullability: [U]
  - Name: class_getName
    NullabilityOfRet: U
    Nullability: [U]
  - Name: class_isMetaClass
    Nullability: [U]
  - Name: class_getSuperclass
    NullabilityOfRet: U
    Nullability: [U]
  - Name: class_getVersion
    Nullability: [U]
  - Name: class_setVersion
    Nullability: [U]
  - Name: class_getInstanceSize
    Nullability: [U]
  - Name: class_getInstanceVariable
    NullabilityOfRet: U
    Nullability: [U, U]
  - Name: class_getClassVariable
    NullabilityOfRet: U
    Nullability: [U, U]
  - Name: class_copyIvarList
    ResultType: "Ivar _Nullable * _Null_unspecified"
    Nullability: [U, U]
  - Name: class_getInstanceMethod
    NullabilityOfRet: U
    Nullability: [U, U]
  - Name: class_getClassMethod
    NullabilityOfRet: U
    Nullability: [U, U]
  - Name: class_getMethodImplementation
    NullabilityOfRet: U
    Nullability: [U, U]
  - Name: class_getMethodImplementation_stret
    NullabilityOfRet: U
    Nullability: [U, U]
  - Name: class_respondsToSelector
    Nullability: [U, U]
  - Name: class_copyMethodList
    Nullability: [U, U]
    ResultType: "Method _Nullable * _Null_unspecified"
  - Name: class_conformsToProtocol
    Nullability: [U, U]
  - Name: class_copyProtocolList
# fixme ResultType:
    NullabilityOfRet: U
    Nullability: [U, U]
  - Name: class_getProperty
    NullabilityOfRet: U
    Nullability: [U, U]
  - Name: class_copyPropertyList
    ResultType: "objc_property_t _Nullable * _Null_unspecified"
    Nullability: [U, U]
  - Name: class_getIvarLayout
    NullabilityOfRet: U
    Nullability: [U]
  - Name: class_getWeakIvarLayout
    NullabilityOfRet: U
    Nullability: [U]
  - Name: class_addMethod
    Nullability: [U, U, U, U]
  - Name: class_replaceMethod
    NullabilityOfRet: U
    Nullability: [U, U, U, U]
  - Name: class_addIvar
    Nullability: [U, U, U, U, U]
  - Name: class_addProtocol
    Nullability: [U, U]
  - Name: class_addProperty
    Nullability: [U, U, U, U]
  - Name: class_replaceProperty
    Nullability: [U, U, U, U]
  - Name: class_setIvarLayout
    Nullability: [U, U]
  - Name: class_setWeakIvarLayout
    Nullability: [U, U]
  - Name: class_createInstance
    NullabilityOfRet: U
    Nullability: [U, U]
  - Name: objc_allocateClassPair
    NullabilityOfRet: U
    Nullability: [U, U, U]
  - Name: objc_registerClassPair
    Nullability: [U]
  - Name: objc_duplicateClass
    NullabilityOfRet: U
    Nullability: [U, U, U]
  - Name: objc_disposeClassPair
    Nullability: [U]
  - Name: method_getName
    NullabilityOfRet: U
    Nullability: [U]
  - Name: method_getImplementation
    NullabilityOfRet: U
    Nullability: [U]
  - Name: method_getTypeEncoding
    NullabilityOfRet: U
    Nullability: [U]
  - Name: method_getNumberOfArguments
    Nullability: [U]
  - Name: method_copyReturnType
    NullabilityOfRet: U
    Nullability: [U]
  - Name: method_copyArgumentType
    NullabilityOfRet: U
    Nullability: [U, U]
  - Name: method_getReturnType
    Nullability: [U, U, U]
  - Name: method_getArgumentType
    Nullability: [U, U, U, U]
  - Name: method_getDescription
    NullabilityOfRet: U
    Nullability: [U]
  - Name: method_setImplementation
    NullabilityOfRet: U
    Nullability: [U, U]
  - Name: method_exchangeImplementations
    Nullability: [U, U]
  - Name: ivar_getName
    NullabilityOfRet: U
    Nullability: [U]
  - Name: ivar_getTypeEncoding
    NullabilityOfRet: U
    Nullability: [U]
  - Name: ivar_getOffset
    Nullability: [U]
  - Name: property_getName
    NullabilityOfRet: U
    Nullability: [U]
  - Name: property_getAttributes
    NullabilityOfRet: U
    Nullability: [U]
  - Name: property_copyAttributeList
    NullabilityOfRet: U
    Nullability: [U, U]
  - Name: property_copyAttributeValue
    NullabilityOfRet: U
    Nullability: [U, U]
  - Name: objc_getProtocol
    NullabilityOfRet: U
    Nullability: [U]
  - Name: objc_copyProtocolList
# fixme ResultType:
    NullabilityOfRet: U
    Nullability: [U]
  - Name: protocol_conformsToProtocol
    Nullability: [U, U]
  - Name: protocol_isEqual
    Nullability: [U, U]
  - Name: protocol_getName
    NullabilityOfRet: U
    Nullability: [U]
  - Name: protocol_getMethodDescription
    Nullability: [U, U, U, U]
  - Name: protocol_copyMethodDescriptionList
    NullabilityOfRet: U
    Nullability: [U, U, U, U]
  - Name: protocol_getProperty
    NullabilityOfRet: U
    Nullability: [U, U, U, U]
  - Name: protocol_copyPropertyList
    ResultType: "objc_property_t _Nullable * _Null_unspecified"
    Nullability: [U, U]
  - Name: protocol_copyPropertyList2
    ResultType: "objc_property_t _Nullable * _Null_unspecified"
    Nullability: [U, U, U, U]
  - Name: protocol_copyProtocolList
# fixme ResultType:
    NullabilityOfRet: U
    Nullability: [U, U]
  - Name: objc_allocateProtocol
    NullabilityOfRet: U
    Nullability: [U]
  - Name: objc_registerProtocol
    Nullability: [U]
  - Name: protocol_addMethodDescription
    Nullability: [U, U, U, U, U]
  - Name: protocol_addProtocol
    Nullability: [U, U]
  - Name: protocol_addProperty
    Nullability: [U, U, U, U, U, U]
  - Name: objc_copyImageNames
    ResultType: "const char * _Nullable * _Null_unspecified"
    Nullability: [U]
  - Name: class_getImageName
    NullabilityOfRet: U
    Nullability: [U]
  - Name: objc_copyClassNamesForImage
    ResultType: "const char * _Nullable * _Null_unspecified"
    Nullability: [U, U]
  - Name: sel_getName
    NullabilityOfRet: U
    Nullability: [U]
  - Name: sel_registerName
    NullabilityOfRet: U
    Nullability: [U]
  - Name: sel_isEqual
    Nullability: [U, U]
  - Name: objc_enumerationMutation
    Nullability: [U]
  - Name: objc_setEnumerationMutationHandler
    Nullability: [U]
  - Name: objc_setForwardHandler
    Nullability: [U, U]
  - Name: imp_implementationWithBlock
    NullabilityOfRet: U
    Nullability: [U]
  - Name: imp_getBlock
    NullabilityOfRet: U
    Nullability: [U]
  - Name: imp_removeBlock
    Nullability: [U]
  - Name: objc_loadWeak
    NullabilityOfRet: U
    Nullability: [U]
  - Name: objc_storeWeak
    NullabilityOfRet: U
    Nullability: [U, U]
  - Name: objc_setAssociatedObject
    Nullability: [U, U, U, U]
  - Name: objc_getAssociatedObject
    NullabilityOfRet: U
    Nullability: [U, U]
  - Name: objc_removeAssociatedObjects
    Nullability: [U]