Samurai Native 学习笔记 samurai中的宏魔法

Samurai-Native 学习笔记--samurai中的宏魔法

文件 Samurai_Predefine.h Samurai里的一些预设宏

// 这3个宏是在定义属性 @prop_assign( NSInteger, page IN)的时候标记这个数据流的方向时用的.
#define IN
#define OUT
#define INOUT

// 函数属性限定符: __attribute__((unused)) 这个限定符属性禁止编译器在未引用该函数时生成警告
// 这里先用__unused_var__消除__x的未使用警告用的, 然后用__attribute__((unused))消除了__unused_var__的
#define	UNUSED( __x )		{ id __unused_var__ __attribute__((unused)) = (id)(__x); }

// 定义别名
#define	ALIAS( __a, __b )	__typeof__(__a) __b = __a;

// 标记过期
#define	DEPRECATED			__attribute__((deprecated))

// 这是一个可以在Issue Navigator中显示todo的宏
// macro_cstr 稍后介绍
#define TODO( X )			_Pragma(macro_cstr(message("✖✖✖✖✖✖✖✖✖✖✖✖✖✖✖✖✖✖ TODO: " X)))

// 强制内联
#define	INLINE				__inline__ __attribute__((always_inline))

// arc mrc 兼容处理
#if !defined(__clang__) || __clang_major__ < 3

	#ifndef __bridge
	#define __bridge
	#endif

	#ifndef __bridge_retain
	#define __bridge_retain
	#endif

	#ifndef __bridge_retained
	#define __bridge_retained
	#endif

	#ifndef __autoreleasing
	#define __autoreleasing
	#endif

	#ifndef __strong
	#define __strong
	#endif

	#ifndef __unsafe_unretained
	#define __unsafe_unretained
	#endif

	#ifndef __weak
	#define __weak
	#endif

#endif

#define weakify( x ) \
		_Pragma("clang diagnostic push") \
		_Pragma("clang diagnostic ignored \"-Wshadow\"") \
		autoreleasepool{} __weak __typeof__(x) __weak_##x##__ = x; \
		_Pragma("clang diagnostic pop")
		
#define strongify( x ) \
		_Pragma("clang diagnostic push") \
		_Pragma("clang diagnostic ignored \"-Wshadow\"") \
		try{} @finally{} __typeof__(x) x = __weak_##x##__; \
		_Pragma("clang diagnostic pop")
		
// 这段宏是用来消除block里的循环引用的,在block外@weakify( self ),在block内@strongify( self );
// _Pragma用来忽略编译警告
// try{} @finally{} 用来和前面的@生成完整的语句
// __typeof的作用是: 首先定义一个名为 __weak_self__ 类型为 self 同样的类型的 __weak 的变量指向 self, 
然后定义一个名为 self 类型为 self 同样的类型的 __strong的 变量指向 self .这样在block里面我们实际用的 self 其实是一个名字叫 self 的局部变量.