201 lines
8.1 KiB
Objective-C
201 lines
8.1 KiB
Objective-C
//
|
|
// DCUniClassInfo.h
|
|
// DCUniModel <https://github.com/ibireme/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 <Foundation/Foundation.h>
|
|
#import <objc/runtime.h>
|
|
|
|
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<NSString *> *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<NSString *> *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<NSString *, DCUniClassIvarInfo *> *ivarInfos; ///< ivars
|
|
@property (nullable, nonatomic, strong, readonly) NSDictionary<NSString *, DCUniClassMethodInfo *> *methodInfos; ///< methods
|
|
@property (nullable, nonatomic, strong, readonly) NSDictionary<NSString *, DCUniClassPropertyInfo *> *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
|