NSObject 详解注释


#include <objc/NSObjCRuntime.h>

@class NSString, NSMethodSignature, NSInvocation;

#pragma mark - 协议部分

@protocol NSObject

/** 判断两个对象是否相等, 如相等返回YES, 否则返回NO */

- (BOOL)isEqual:(id)object;

/** 获取对象hash值, 两对象相等hash值也相等 */

@property (readonly) NSUInteger hash;

/** 获取对象的父类 */

@property (readonly) Class superclass;

/** 获取当前对象的类 */

- (Class)class OBJC_SWIFT_UNAVAILABLE("use 'type(of: anObject)' instead");

/** 获取当前对象 */

- (instancetype)self;

/** 发送指定的消息给对象, 返回消息执行结果(相当于方法调用) */

- (id)performSelector:(SEL)aSelector;

/** 发送带一个参数的消息给对象, 返回消息执行结果(相当于方法调用) */

- (id)performSelector:(SEL)aSelector withObject:(id)object;

/** 发送带两个参数的消息给对象, 返回消息执行结果(相当于方法调用) */

- (id)performSelector:(SEL)aSelector withObject:(id)object1 withObject:(id)object2;

/** 判断对象是否继承NSObject */

- (BOOL)isProxy;

/** 判断对象是否是给定类或给定类子类的实例 */

- (BOOL)isKindOfClass:(Class)aClass;

/** 判断对象是否是给定类的实例 */

- (BOOL)isMemberOfClass:(Class)aClass;

/** 判断对象是否遵从给定的协议 */

- (BOOL)conformsToProtocol:(Protocol *)aProtocol;

/** 判断对象是否能够调用给定的方法 */

- (BOOL)respondsToSelector:(SEL)aSelector;

/** 对象引用计数加1, 在MRC下使用 */

- (instancetype)retain OBJC_ARC_UNAVAILABLE;

/** 对象引用计数减1, 在MRC下使用 */

- (oneway void)release OBJC_ARC_UNAVAILABLE;

/** 对象引用计数以推迟方式自动减1, 在MRC下使用 */

- (instancetype)autorelease OBJC_ARC_UNAVAILABLE;

/** 获取对象引用计数, 在MRC下使用 */

- (NSUInteger)retainCount OBJC_ARC_UNAVAILABLE;

/** 获取对象存储空间, 在MRC下使用 */

- (struct _NSZone *)zone OBJC_ARC_UNAVAILABLE;

/** 获取对象描述信息 */

@property (readonly, copy) NSString *description;

@optional

/** 获取对象在调试器中的描述信息 */

@property (readonly, copy) NSString *debugDescription;

@end

#pragma mark - 类部分

OBJC_AVAILABLE(10.0, 2.0, 9.0, 1.0)

OBJC_ROOT_CLASS

OBJC_EXPORT

@interface NSObject <NSObject> {

Class isa OBJC_ISA_AVAILABILITY;

}

/** 运行时加载类或分类调用该方法, 每个类只会调用一次 */

+ (void)load;

/** 类实例化使用前需要先初始化, 一个类调用一次, 如果子类没有实现该方法则会调用父类方法 */

+ (void)initialize;

/** 初始化对象 */

- (instancetype)init

#if NS_ENFORCE_NSOBJECT_DESIGNATED_INITIALIZER

NS_DESIGNATED_INITIALIZER

#endif

;

/** 为新对象分配内存空间并初始化, 等于[[NSObject alloc] init] */

+ (instancetype)new OBJC_SWIFT_UNAVAILABLE("use object initializers instead");

/** 为新对象分配内存空间, 参数传nil */

+ (instancetype)allocWithZone:(struct _NSZone *)zone OBJC_SWIFT_UNAVAILABLE("use object initializers instead");

/** 为新对象分配内存空间 */

+ (instancetype)alloc OBJC_SWIFT_UNAVAILABLE("use object initializers instead");

/** 释放对象, 当对象的引用计数为0时会调用此方法 */

- (void)dealloc OBJC_SWIFT_UNAVAILABLE("use 'deinit' to define a de-initializer");

/** 垃圾回收器调用此方法前处理它所使用的内存。 */

- (void)finalize OBJC_DEPRECATED("Objective-C garbage collection is no longer supported");

/** 复制为不可变对象 */

- (id)copy;

/** 复制为可变对象 */

- (id)mutableCopy;

/** 在指定的内存空间上复制为不可变对象, 在MRC下使用 */

+ (id)copyWithZone:(struct _NSZone *)zone OBJC_ARC_UNAVAILABLE;

/** 在指定的内存空间上复制为可变对象, 在MRC下使用 */

+ (id)mutableCopyWithZone:(struct _NSZone *)zone OBJC_ARC_UNAVAILABLE;

/** 判断实例是否能够调用给定的方法 */

+ (BOOL)instancesRespondToSelector:(SEL)aSelector;

/** 判断类是否遵从给定的协议 */

+ (BOOL)conformsToProtocol:(Protocol *)protocol;

/** 获取指向方法实现IMP的指针 */

- (IMP)methodForSelector:(SEL)aSelector;

/** 获取指向实例方法实现IMP的指针 */

+ (IMP)instanceMethodForSelector:(SEL)aSelector;

/** 找不到函数实现的将调用此方法抛出异常 */

- (void)doesNotRecognizeSelector:(SEL)aSelector;

/** 返回消息被第一个转发的对象, 对象没有找到SEL的IML时就会执行调用该方法 */

- (id)forwardingTargetForSelector:(SEL)aSelector OBJC_AVAILABLE(10.5, 2.0, 9.0, 1.0);

/** methodSignatureForSelector:返回不为nil则调用该方法, 可以重写该方法将SEL转发给另一个对象 */

- (void)forwardInvocation:(NSInvocation *)anInvocation OBJC_SWIFT_UNAVAILABLE("");

/** 获取方法签名, 对象没有找到SEL的IML时就会执行调用该方法, 可以重写该方法抛出一个函数的签名,再由forwardInvocation:去执行 */

- (NSMethodSignature *)methodSignatureForSelector:(SEL)aSelector OBJC_SWIFT_UNAVAILABLE("");

/** 获取实例方法签名 */

+ (NSMethodSignature *)instanceMethodSignatureForSelector:(SEL)aSelector OBJC_SWIFT_UNAVAILABLE("");

/** 允许弱引用标量, 对于所有allowsWeakReference方法返回NO的类都绝对不能使用__weak修饰符 */

- (BOOL)allowsWeakReference UNAVAILABLE_ATTRIBUTE;

/** 保留弱引用变量, 在使用__weak修饰符的变量时, 当被赋值对象的retainWeakReference方法返回NO的情况下, 该变量将使用“nil” */

- (BOOL)retainWeakReference UNAVAILABLE_ATTRIBUTE;

/** 判断是否是另一个类的子类 */

+ (BOOL)isSubclassOfClass:(Class)aClass;

/** 动态解析一个类方法 */

+ (BOOL)resolveClassMethod:(SEL)sel OBJC_AVAILABLE(10.5, 2.0, 9.0, 1.0);

/** 动态解析一个实例方法, 对象没有找到SEL的IML时就会执行调用该方法, 可以重写该方法给对象添加所需的SEL */

+ (BOOL)resolveInstanceMethod:(SEL)sel OBJC_AVAILABLE(10.5, 2.0, 9.0, 1.0);

/** 获取对象hash值, 两对象相等hash值也相等*/

+ (NSUInteger)hash;

/** 获取对象的父类 */

+ (Class)superclass;

/** 获取类 */

+ (Class)class OBJC_SWIFT_UNAVAILABLE("use 'aClass.self' instead");

/** 获取对象描述信息 */

+ (NSString *)description;

/** 获取对象在调试器中的描述信息 */

+ (NSString *)debugDescription;

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,001评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,210评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,874评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,001评论 1 291
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,022评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,005评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,929评论 3 416
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,742评论 0 271
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,193评论 1 309
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,427评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,583评论 1 346
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,305评论 5 342
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,911评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,564评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,731评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,581评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,478评论 2 352

推荐阅读更多精彩内容