/*
* Copyright (c) 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017,
* 2018, 2019
* Jonathan Schleifer <js@heap.zone>
*
* All rights reserved.
*
* This file is part of ObjFW. It may be distributed under the terms of the
* Q Public License 1.0, which can be found in the file LICENSE.QPL included in
* the packaging of this file.
*
* Alternatively, it may be distributed under the terms of the GNU General
* Public License, either version 2 or 3, which can be found in the file
* LICENSE.GPLv2 or LICENSE.GPLv3 respectively included in the packaging of this
* file.
*/
#import "OFObject.h"
OF_ASSUME_NONNULL_BEGIN
@class OFArray OF_GENERIC(ObjectType);
@class OFMutableArray OF_GENERIC(ObjectType);
@class OFString;
enum {
OF_PROPERTY_READONLY = 0x01,
OF_PROPERTY_ASSIGN = 0x04,
OF_PROPERTY_READWRITE = 0x08,
OF_PROPERTY_RETAIN = 0x10,
OF_PROPERTY_COPY = 0x20,
OF_PROPERTY_NONATOMIC = 0x40,
OF_PROPERTY_SYNTHESIZED = 0x100,
OF_PROPERTY_DYNAMIC = 0x200,
OF_PROPERTY_ATOMIC = 0x400,
OF_PROPERTY_WEAK = 0x800
};
/*!
* @class OFMethod OFIntrospection.h ObjFW/OFIntrospection.h
*
* @brief A class for describing a method.
*/
@interface OFMethod: OFObject
{
SEL _selector;
OFString *_name;
const char *_typeEncoding;
}
/*!
* @brief The selector of the method.
*/
@property (readonly, nonatomic) SEL selector;
/*!
* @brief The name of the method.
*/
@property (readonly, nonatomic) OFString *name;
/*!
* @brief The type encoding for the method.
*/
@property OF_NULLABLE_PROPERTY (readonly, nonatomic) const char *typeEncoding;
- (instancetype)init OF_UNAVAILABLE;
@end
/*!
* @class OFProperty OFIntrospection.h ObjFW/OFIntrospection.h
*
* @brief A class for describing a property.
*/
@interface OFProperty: OFObject
{
OFString *_name;
unsigned int _attributes;
OFString *_Nullable _getter, *_Nullable _setter, *_Nullable _iVar;
}
/*!
* @brief The name of the property.
*/
@property (readonly, nonatomic) OFString *name;
/*!
* @brief The attributes of the property.
*
* The attributes are a bitmask with the following possible flags:@n
* Flag | Description
* ------------------------------|-------------------------------------
* OF_PROPERTY_READONLY | The property is declared `readonly`
* OF_PROPERTY_READWRITE | The property is declared `readwrite`
* OF_PROPERTY_ASSIGN | The property is declared `assign`
* OF_PROPERTY_RETAIN | The property is declared `retain`
* OF_PROPERTY_COPY | The property is declared `copy`
* OF_PROPERTY_NONATOMIC | The property is declared `nonatomic`
* OF_PROPERTY_ATOMIC | The property is declared `atomic`
* OF_PROPERTY_WEAK | The property is declared `weak`
* OF_PROPERTY_SYNTHESIZED | The property is synthesized
* OF_PROPERTY_DYNAMIC | The property is dynamic
*/
@property (readonly, nonatomic) unsigned int attributes;
/*!
* @brief The name of the getter.
*/
@property OF_NULLABLE_PROPERTY (readonly, nonatomic) OFString *getter;
/*!
* @brief The name of the setter.
*/
@property OF_NULLABLE_PROPERTY (readonly, nonatomic) OFString *setter;
/*!
* @brief The name of the backing iVar.
*/
@property OF_NULLABLE_PROPERTY (readonly, nonatomic) OFString *iVar;
- (instancetype)init OF_UNAVAILABLE;
@end
/*!
* @class OFInstanceVariable OFIntrospection.h ObjFW/OFIntrospection.h
*
* @brief A class for describing an instance variable.
*/
@interface OFInstanceVariable: OFObject
{
OFString *_name;
const char *_typeEncoding;
ptrdiff_t _offset;
}
/*!
* @brief The name of the instance variable.
*/
@property (readonly, nonatomic) OFString *name;
/*!
* @brief The offset of the instance variable.
*/
@property (readonly, nonatomic) ptrdiff_t offset;
/*!
* @brief The type encoding for the instance variable.
*/
@property OF_NULLABLE_PROPERTY (readonly, nonatomic) const char *typeEncoding;
- (instancetype)init OF_UNAVAILABLE;
@end
/*!
* @class OFIntrospection OFIntrospection.h ObjFW/OFIntrospection.h
*
* @brief A class for introspecting classes.
*/
@interface OFIntrospection: OFObject
{
OFMutableArray OF_GENERIC(OFMethod *) *_classMethods;
OFMutableArray OF_GENERIC(OFMethod *) *_instanceMethods;
OFMutableArray OF_GENERIC(OFProperty *) *_properties;
OFMutableArray OF_GENERIC(OFInstanceVariable *) *_instanceVariables;
}
/*!
* @brief The class methods of the class.
*/
@property (readonly, nonatomic) OFArray OF_GENERIC(OFMethod *) *classMethods;
/*!
* @brief The instance methods of the class.
*/
@property (readonly, nonatomic) OFArray OF_GENERIC(OFMethod *) *instanceMethods;
/*!
* @brief The properties of the class.
*
* @warning **Do not rely on this, as this behaves differently depending on the
* compiler and ABI used!**
*
* @warning For the ObjFW ABI, Clang only emits data for property introspection
* if `@``synthesize` or `@``dynamic` has been used on the property,
* not if the property has only been implemented by methods. Using
* `@``synthesize` and manually implementing the methods works,
* though.
*
* @warning For the Apple ABI, Clang and GCC both emit data for property
* introspection for every property that has been declared using
* `@``property`, even if no `@``synchronize` or `@``dynamic` has been
* used.
*
* @warning GCC does not emit any data for property introspection for the GNU
* ABI.
*/
@property (readonly, nonatomic) OFArray OF_GENERIC(OFProperty *) *properties;
/*!
* @brief The instance variables of the class.
*/
@property (readonly, nonatomic)
OFArray OF_GENERIC(OFInstanceVariable *) *instanceVariables;
/* TODO: protocols */
/*!
* @brief Creates a new introspection for the specified class.
*
* @return A new, autoreleased introspection for the specified class
*/
+ (instancetype)introspectionWithClass: (Class)class_;
- (instancetype)init OF_UNAVAILABLE;
/*!
* @brief Initializes an already allocated OFIntrospection with the specified
* class.
*
* @return An initialized OFIntrospection
*/
- (instancetype)initWithClass: (Class)class_ OF_DESIGNATED_INITIALIZER;
@end
OF_ASSUME_NONNULL_END