一、NS_SWIFT_UNAVAILABLE
在swift中不可见,不能使用。
二、NS_SWIFT_NAME
在混编时导入到Swift自定义名称
1、oc枚举定义在swift中名称
如:
typedef NS_ENUM(NSUInteger, OCEnumOption) {
OCEnumOptionA,
OCEnumOptionB,
OCEnumOptionC NS_SWIFT_NAME(SwiftC),
};
swift中使用:
let option: OCEnumOption = .A
let option1: OCEnumOption = .SwiftC
2、oc方法中定义在swift中的函数名
//.h中
#import <Foundation/Foundation.h>
@interface OCObject : NSObject
+ (instancetype)creatOCObjectWith:(NSString *)name NS_SWIFT_NAME(init(name:)); //为 Objective-C 接口重写 Swift 名称
@end
//.m中
#import "OCObject.h"
@interface OCObject ()
@property (nonatomic, copy) NSString *name;
@property (nonatomic, assign) int age;
@end
@implementation OCObject
+ (instancetype)creatOCObjectWith:(NSString *)name age:(int)age
{
OCObject *obj = [OCObject new];
obj.name = name;
obj.age = age;
return obj;
}
+ (instancetype)creatOCObjectWith:(NSString *)name
{
OCObject *obj = [OCObject new];
obj.name = name;
return obj;
}
@end
使用时:
let ocObj = OCObject.init(name: "张三")
//不再显示creatOCObjectWith:方法
print("\(String(describing: ocObj))")
ocObj?.reset(name: "新张三")
//使用ocObj?.resetName("新张三")会报错
⚠️注意:使用NS_SWIFT_NAME时,如果oc方法有多个参数会爆'swift_name' attribute has invalid identifier for parameter name警告。在swift文件中并不会转化为对应的函数。
三、NS_REFINED_FOR_SWIFT
重定义,通过 Objective-C 方法,可以使用相同的名称来提供一个对 Swift 更友好的 API。
注:用它所标记的方法和变量在Objective-C中可以正常使用,但bridge到Swift语言时,编译器会在名称前加上__(注意是双下划线)。可以使用相同的名称来提供一个对 Swift 更友好的 API.如果oc方法后有NS_REFINED_FOR_SWIFT,但在swift文件中并没有实现,swift使用时将找不到该方法,会直接爆错。
⚠️注意:标记的oc方法不能没有参数,否则在swift重定义时会报错。
如:
//在OCObject.h中;
- (NSUInteger)indexString:(NSString *)str NS_REFINED_FOR_SWIFT;
//在OCObject.m中
- (NSUInteger)indexString:(NSString *)str
{
return [self.name rangeOfString:str].location;
}
//在swift文件中
extension OCObject {
func indexString(str: String) -> Int? {
let index = Int(__indexString(str))
if (index == NSNotFound) {
return nil
}
return index
}
在swift中的使用:
let ocObj = OCObject.init(name: "张三")
//不再显示creatOCObjectWith:方法
print("\(String(describing: ocObj))")
//重写方法,⚠️index和index1类型不同,index为Int? ,index1为UInt
let index = ocObj?.indexString(str: "长")
print("\(String(describing: index))")
let index1 = ocObj?.__indexString("cs")
print("\(String(describing: index1))")
(如有错误欢迎指正)