美文网首页
NSObject 详解注释

NSObject 详解注释

作者: 一盘菜十斤米 | 来源:发表于2018-12-28 18:18 被阅读0次
    
    #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;
    
    

    相关文章

      网友评论

          本文标题:NSObject 详解注释

          本文链接:https://www.haomeiwen.com/subject/jduelqtx.html