// // DCUniClassInfo.h // DCUniModel // // Created by ibireme on 15/5/9. // Copyright (c) 2015 ibireme. // // This source code is licensed under the MIT-style license found in the // LICENSE file in the root directory of this source tree. // #import #import NS_ASSUME_NONNULL_BEGIN /** Type encoding's type. */ typedef NS_OPTIONS(NSUInteger, DCUniEncodingType) { DCUniEncodingTypeMask = 0xFF, ///< mask of type value DCUniEncodingTypeUnknown = 0, ///< unknown DCUniEncodingTypeVoid = 1, ///< void DCUniEncodingTypeBool = 2, ///< bool DCUniEncodingTypeInt8 = 3, ///< char / BOOL DCUniEncodingTypeUInt8 = 4, ///< unsigned char DCUniEncodingTypeInt16 = 5, ///< short DCUniEncodingTypeUInt16 = 6, ///< unsigned short DCUniEncodingTypeInt32 = 7, ///< int DCUniEncodingTypeUInt32 = 8, ///< unsigned int DCUniEncodingTypeInt64 = 9, ///< long long DCUniEncodingTypeUInt64 = 10, ///< unsigned long long DCUniEncodingTypeFloat = 11, ///< float DCUniEncodingTypeDouble = 12, ///< double DCUniEncodingTypeLongDouble = 13, ///< long double DCUniEncodingTypeObject = 14, ///< id DCUniEncodingTypeClass = 15, ///< Class DCUniEncodingTypeSEL = 16, ///< SEL DCUniEncodingTypeBlock = 17, ///< block DCUniEncodingTypePointer = 18, ///< void* DCUniEncodingTypeStruct = 19, ///< struct DCUniEncodingTypeUnion = 20, ///< union DCUniEncodingTypeCString = 21, ///< char* DCUniEncodingTypeCArray = 22, ///< char[10] (for example) DCUniEncodingTypeQualifierMask = 0xFF00, ///< mask of qualifier DCUniEncodingTypeQualifierConst = 1 << 8, ///< const DCUniEncodingTypeQualifierIn = 1 << 9, ///< in DCUniEncodingTypeQualifierInout = 1 << 10, ///< inout DCUniEncodingTypeQualifierOut = 1 << 11, ///< out DCUniEncodingTypeQualifierBycopy = 1 << 12, ///< bycopy DCUniEncodingTypeQualifierByref = 1 << 13, ///< byref DCUniEncodingTypeQualifierOneway = 1 << 14, ///< oneway DCUniEncodingTypePropertyMask = 0xFF0000, ///< mask of property DCUniEncodingTypePropertyReadonly = 1 << 16, ///< readonly DCUniEncodingTypePropertyCopy = 1 << 17, ///< copy DCUniEncodingTypePropertyRetain = 1 << 18, ///< retain DCUniEncodingTypePropertyNonatomic = 1 << 19, ///< nonatomic DCUniEncodingTypePropertyWeak = 1 << 20, ///< weak DCUniEncodingTypePropertyCustomGetter = 1 << 21, ///< getter= DCUniEncodingTypePropertyCustomSetter = 1 << 22, ///< setter= DCUniEncodingTypePropertyDynamic = 1 << 23, ///< @dynamic }; /** Get the type from a Type-Encoding string. @discussion See also: https://developer.apple.com/library/mac/documentation/Cocoa/Conceptual/ObjCRuntimeGuide/Articles/ocrtTypeEncodings.html https://developer.apple.com/library/mac/documentation/Cocoa/Conceptual/ObjCRuntimeGuide/Articles/ocrtPropertyIntrospection.html @param typeEncoding A Type-Encoding string. @return The encoding type. */ DCUniEncodingType DCUniEncodingGetType(const char *typeEncoding); /** Instance variable information. */ @interface DCUniClassIvarInfo : NSObject @property (nonatomic, assign, readonly) Ivar ivar; ///< ivar opaque struct @property (nonatomic, strong, readonly) NSString *name; ///< Ivar's name @property (nonatomic, assign, readonly) ptrdiff_t offset; ///< Ivar's offset @property (nonatomic, strong, readonly) NSString *typeEncoding; ///< Ivar's type encoding @property (nonatomic, assign, readonly) DCUniEncodingType type; ///< Ivar's type /** Creates and returns an ivar info object. @param ivar ivar opaque struct @return A new object, or nil if an error occurs. */ - (instancetype)initWithIvar:(Ivar)ivar; @end /** Method information. */ @interface DCUniClassMethodInfo : NSObject @property (nonatomic, assign, readonly) Method method; ///< method opaque struct @property (nonatomic, strong, readonly) NSString *name; ///< method name @property (nonatomic, assign, readonly) SEL sel; ///< method's selector @property (nonatomic, assign, readonly) IMP imp; ///< method's implementation @property (nonatomic, strong, readonly) NSString *typeEncoding; ///< method's parameter and return types @property (nonatomic, strong, readonly) NSString *returnTypeEncoding; ///< return value's type @property (nullable, nonatomic, strong, readonly) NSArray *argumentTypeEncodings; ///< array of arguments' type /** Creates and returns a method info object. @param method method opaque struct @return A new object, or nil if an error occurs. */ - (instancetype)initWithMethod:(Method)method; @end /** Property information. */ @interface DCUniClassPropertyInfo : NSObject @property (nonatomic, assign, readonly) objc_property_t property; ///< property's opaque struct @property (nonatomic, strong, readonly) NSString *name; ///< property's name @property (nonatomic, assign, readonly) DCUniEncodingType type; ///< property's type @property (nonatomic, strong, readonly) NSString *typeEncoding; ///< property's encoding value @property (nonatomic, strong, readonly) NSString *ivarName; ///< property's ivar name @property (nullable, nonatomic, assign, readonly) Class cls; ///< may be nil @property (nullable, nonatomic, strong, readonly) NSArray *protocols; ///< may nil @property (nonatomic, assign, readonly) SEL getter; ///< getter (nonnull) @property (nonatomic, assign, readonly) SEL setter; ///< setter (nonnull) /** Creates and returns a property info object. @param property property opaque struct @return A new object, or nil if an error occurs. */ - (instancetype)initWithProperty:(objc_property_t)property; @end /** Class information for a class. */ @interface DCUniClassInfo : NSObject @property (nonatomic, assign, readonly) Class cls; ///< class object @property (nullable, nonatomic, assign, readonly) Class superCls; ///< super class object @property (nullable, nonatomic, assign, readonly) Class metaCls; ///< class's meta class object @property (nonatomic, readonly) BOOL isMeta; ///< whether this class is meta class @property (nonatomic, strong, readonly) NSString *name; ///< class name @property (nullable, nonatomic, strong, readonly) DCUniClassInfo *superClassInfo; ///< super class's class info @property (nullable, nonatomic, strong, readonly) NSDictionary *ivarInfos; ///< ivars @property (nullable, nonatomic, strong, readonly) NSDictionary *methodInfos; ///< methods @property (nullable, nonatomic, strong, readonly) NSDictionary *propertyInfos; ///< properties /** If the class is changed (for example: you add a method to this class with 'class_addMethod()'), you should call this method to refresh the class info cache. After called this method, `needUpdate` will returns `YES`, and you should call 'classInfoWithClass' or 'classInfoWithClassName' to get the updated class info. */ - (void)setNeedUpdate; /** If this method returns `YES`, you should stop using this instance and call `classInfoWithClass` or `classInfoWithClassName` to get the updated class info. @return Whether this class info need update. */ - (BOOL)needUpdate; /** Get the class info of a specified Class. @discussion This method will cache the class info and super-class info at the first access to the Class. This method is thread-safe. @param cls A class. @return A class info, or nil if an error occurs. */ + (nullable instancetype)classInfoWithClass:(Class)cls; /** Get the class info of a specified Class. @discussion This method will cache the class info and super-class info at the first access to the Class. This method is thread-safe. @param className A class name. @return A class info, or nil if an error occurs. */ + (nullable instancetype)classInfoWithClassName:(NSString *)className; @end NS_ASSUME_NONNULL_END