Cocoa中常用的宏定义

NS_AVAILABLE

+ (void)animateWithDuration:(NSTimeInterval)duration
                 animations:(void (^)(void))animations
                 completion:(void (^ __nullable)(BOOL finished))completion NS_AVAILABLE_IOS(4_0);

- (void)enumerateObjectsUsingBlock:(void (^)(ObjectType obj, NSUInteger idx, BOOL *stop))block NS_AVAILABLE(10_6, 4_0);

- (CGSize)sizeWithFont:(UIFont *)font NS_DEPRECATED_IOS(2_0, 7_0, "Use -sizeWithAttributes:") __TVOS_PROHIBITED;

- (void)removeObjectsFromIndices:(NSUInteger *)indices
                      numIndices:(NSUInteger)cnt NS_DEPRECATED(10_0, 10_6, 2_0, 4_0);

NS_ASSUME_NONNULL

NS_ASSUME_NONNULL_BEGIN
@interface Father : NSObject
@property (nonatomic, copy) NSString *name;
+ (instancetype)fatherWithName:(NSString *)name age:(NSInteger)age;
@end
NS_ASSUME_NONNULL_END

// 这里会给出警告，因为这句代码显示地给 NS_ASSUME_NONNULL_BEGIN 范围内的指针变量赋值为 nil
Father *father = [Father fatherWithName:nil age:10];
// 但是如果这么写，xCode 不会给出警告：
NSString *name = nil;
Father *father = [Father fatherWithName:name age:10];

// 同理，对 NS_ASSUME_NONNULL_BEGIN 范围内的属性显示赋值为 nil，也会有警告：
father.name = nil;
// 这么写就没有警告：
NSString *name = nil;
father.name = name;

NS_ASSUME_NONNULL_BEGIN
@interface AFHTTPSessionManager : AFURLSessionManager <NSSecureCoding, NSCopying>
@property (readonly, nonatomic, strong, nullable) NSURL *baseURL;

...

- (nullable NSURLSessionDataTask *)GET:(NSString *)URLString
                            parameters:(nullable id)parameters
                              progress:(nullable void (^)(NSProgress *downloadProgress)) downloadProgress
                               success:(nullable void (^)(NSURLSessionDataTask *task, id _Nullable responseObject))success
                               failure:(nullable void (^)(NSURLSessionDataTask * _Nullable task, NSError *error))failure;

...

@end
NS_ASSUME_NONNULL_END

深入挖掘

#define NS_AVAILABLE(_mac, _ios) CF_AVAILABLE(_mac, _ios)#define NS_AVAILABLE_MAC(_mac) CF_AVAILABLE_MAC(_mac)#define NS_AVAILABLE_IOS(_ios) CF_AVAILABLE_IOS(_ios)

#define CF_AVAILABLE(_mac, _ios) __attribute__((availability(ios,introduced=_ios)))#define CF_AVAILABLE_MAC(_mac) __attribute__((availability(ios,unavailable)))#define CF_AVAILABLE_IOS(_ios) __attribute__((availability(ios,introduced=_ios)))#define CF_DEPRECATED(_macIntro, _macDep, _iosIntro, _iosDep, ...) __attribute__((availability(ios,introduced=_iosIntro,deprecated=_iosDep,message="" __VA_ARGS__)))#define CF_DEPRECATED_MAC(_macIntro, _macDep, ...) __attribute__((availability(ios,unavailable)))#define CF_DEPRECATED_IOS(_iosIntro, _iosDep, ...) __attribute__((availability(ios,introduced=_iosIntro,deprecated=_iosDep,message="" __VA_ARGS__)))

+ (void)animateWithDuration:(NSTimeInterval)duration
                 animations:(void (^)(void))animations
                 completion:(void (^ __nullable)(BOOL finished))completion NS_AVAILABLE_IOS(4_0);

+ (void)animateWithDuration:(NSTimeInterval)duration
                 animations:(void (^)(void))animations
                 completion:(void (^ __nullable)(BOOL finished))completion __attribute__((availability(ios,introduced=4_0)));

__attribute__

函数属性

availability

objc_requires_super （OC 方法）

- (void)fatherMethod __attribute__((objc_requires_super));

枚举中的 attribute

typedef NS_ENUM(NSInteger, MyEnum) {
    MyEnumA,
    MyEnumB,
    MyEnumC __attribute__((deprecated)),  // 标明 MyEnumC 不建议使用
};

sentinel （OC 方法、C 函数）

- (void)endWithNil:(nonnull id)first, ... __attribute__((sentinel));

warn_unused_result （OC 方法、C 函数）

- (int)mustCheckReturnValue __attribute__((warn_unused_result)) {
    return 0;
}

[self mustCheckReturnValue]; // Xode 给出警告：Ignoring return value of function declared with warn_unused_result attribute

NSLog(@"%d", [self mustCheckReturnValue]); // 这里简单打印下，也算是「使用」了返回值:)，警告消失

nonnull （OC 方法、C 函数）

变量属性

cleanup

// 注意这里的参数必须为「变量的地址」的类型
void cleanupInt(int *ip) {
    // 通过指针依然可以访问变量
    NSLog(@"%d,", *ip);
}

- (void)viewDidLoad {
    [super viewDidLoad];
    // Do any additional setup after loading the view, typically from a nib.

    int i __attribute__((cleanup(cleanupInt))) = 10;
    // 这里定义一个整型值，加上cleanup属性，并且填入上面的函数 cleanupInt。
    // 在 i 的作用域——也就是 viewDidLoad 函数——即将结束时，自动执行 cleanupInt 函数。
}

void stringCleanUp(NSString **pString) {
    NSLog(@"%@", *pString);
}

- (void)viewDidLoad {
    [super viewDidLoad];

    __autoreleasing NSString *string __attribute__((cleanup(stringCleanUp))) = @"end";
    // 对于指向objc对象的指针，默认加上 __autoreleasing 修饰，造成类型不匹配，这里强转一下
    // 在 string 的作用域——也就是 viewDidLoad 函数——即将结束时，自动执行 stringCleanUp 函数。
}

void blockCleanUp(void (^*block)()) {
    (*block)();
}

__autoreleasing void (^block)() __attribute__((cleanup(blockCleanUp))) = ^{
        NSLog(@"end");
};

UIGraphicsBeginImageContext(size);
// some code
UIGraphicsEndImageContext(); // 中间有许多代码，导致这句忘了写怎么办？

UIGraphicsBeginImageContext(size);
__autoreleasing void (^block)() __attribute__((cleanup(blockCleanUp)))= ^{
    UIGraphicsEndImageContext();
};
// some code

objc_runtime_name

__attribute__((objc_runtime_name("NewFather")))
@interface Father : NSObject
@end

unused

NSInteger i = 10;

NSInteger i __attribute__((unused)) = 10;

deprecated

@property (nonatomic, copy) NSString *str __attribute__ ((deprecated));

__attribute__ 到底对谁有用

参考