oc与swift混编中可能用到的宏

一、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))")

（如有错误欢迎指正）