Refureku v2.2.0
C++17 runtime reflection library.
rfk::StaticField Class Referencefinal
Inheritance diagram for rfk::StaticField:
rfk::FieldBase rfk::VariableBase rfk::Entity

Public Member Functions

REFUREKU_INTERNAL StaticField (char const *name, std::size_t id, Type const &type, EFieldFlags flags, Struct const *owner, void *ptr, Entity const *outerEntity=nullptr) noexcept
 
REFUREKU_INTERNAL StaticField (char const *name, std::size_t id, Type const &type, EFieldFlags flags, Struct const *owner, void const *constPtr, Entity const *outerEntity=nullptr) noexcept
 
REFUREKU_INTERNAL StaticField (StaticField &&) noexcept
 
template<typename ValueType >
RFK_NODISCARD ValueType get () const
 Get the data corresponding to this static field. This method in not safe if you provide a wrong ValueType. More...
 
template<typename ValueType >
void set (ValueType &&value) const
 Set the data corresponding to this static field. This method is not safe if you provide a wrong ValueType. More...
 
REFUREKU_API void set (void const *valuePtr, std::size_t valueSize) const
 Copy dataSize bytes starting from data into the static field. This method is not safe if you provide a wrong ValueType. More...
 
RFK_NODISCARD REFUREKU_API void * getPtr () const
 Get a non-const pointer to this static field. Performing non-const operations on the pointer if the static field is const is undefined behaviour. More...
 
RFK_NODISCARD REFUREKU_API void const * getConstPtr () const noexcept
 Get a const pointer to this static field. More...
 
- Public Member Functions inherited from rfk::FieldBase
RFK_NODISCARD REFUREKU_API EAccessSpecifier getAccess () const noexcept
 Get the access specifier of this field in its owner struct/class. More...
 
RFK_NODISCARD REFUREKU_API bool isStatic () const noexcept
 Check whether this field is static or not. If the field is static, it can safely be cast to StaticField. More...
 
RFK_NODISCARD REFUREKU_API bool isMutable () const noexcept
 Check whether this field is mutable or not. More...
 
RFK_NODISCARD REFUREKU_API EFieldFlags getFlags () const noexcept
 Get the flags qualifying this field. More...
 
RFK_NODISCARD REFUREKU_API Struct const * getOwner () const noexcept
 Get the struct owning this field. More...
 
- Public Member Functions inherited from rfk::VariableBase
REFUREKU_API Type const & getType () const noexcept
 Get the type of this variable. More...
 
- Public Member Functions inherited from rfk::Entity
 Entity (Entity const &)=delete
 
RFK_NODISCARD REFUREKU_API Property const * getPropertyAt (std::size_t propertyIndex) const noexcept
 Retrieve the property at the given index. If propertyIndex is greater or equal to the properties count, the behaviour is undefined. More...
 
template<typename PropertyType , typename = std::enable_if_t<std::is_base_of_v<Property, PropertyType> && !std::is_same_v<PropertyType, Property>>>
RFK_NODISCARD PropertyType const * getProperty (bool isChildClassValid=true) const noexcept
 Retrieve a property of a given type from this entity. More...
 
RFK_NODISCARD REFUREKU_API Property const * getProperty (Struct const &archetype, bool isChildClassValid=true) const noexcept
 Retrieve the first property matching with the provided archetype. More...
 
RFK_NODISCARD REFUREKU_API Property const * getPropertyByName (char const *name) const noexcept
 Retrieve the first property named with the provided name. More...
 
RFK_NODISCARD REFUREKU_API Property const * getPropertyByPredicate (Predicate< Property > predicate, void *userData) const
 Retrieve a property matching with a predicate. More...
 
template<typename PropertyType , typename = std::enable_if_t<std::is_base_of_v<Property, PropertyType> && !std::is_same_v<PropertyType, Property>>>
RFK_NODISCARD Vector< PropertyType const * > getProperties (bool isChildClassValid=true) const noexcept
 Retrieve all properties matching with the provided archetype. If PropertyType uses multiple inheritance, its first inherited type must be rfk::Property or derived. More...
 
RFK_NODISCARD REFUREKU_API Vector< Property const * > getProperties (Struct const &archetype, bool isChildClassValid=true) const noexcept
 Retrieve all properties matching with the provided archetype. More...
 
RFK_NODISCARD REFUREKU_API Vector< Property const * > getPropertiesByName (char const *name) const noexcept
 Retrieve all properties named with the provided name. More...
 
RFK_NODISCARD REFUREKU_API Vector< Property const * > getPropertiesByPredicate (Predicate< Property > predicate, void *userData) const
 Retrieve all properties matching with a predicate in this entity. More...
 
RFK_NODISCARD REFUREKU_API std::size_t getPropertiesCount () const noexcept
 Get the number of properties attached to this entity. More...
 
REFUREKU_API bool foreachProperty (Visitor< Property > visitor, void *userData) const
 Execute the given visitor on all properties attached to this entity. More...
 
RFK_NODISCARD REFUREKU_API char const * getName () const noexcept
 Get the name of the entity. More...
 
RFK_NODISCARD REFUREKU_API bool hasSameName (char const *name) const noexcept
 Check that this entity has the same name as the provided string. More...
 
RFK_NODISCARD REFUREKU_API std::size_t getId () const noexcept
 Get the program-unique id of the entity. More...
 
RFK_NODISCARD REFUREKU_API EEntityKind getKind () const noexcept
 Get the kind of the entity. Knowing the kind allows to safely cast to child classes. Check the EEntityKind documentation for more information. More...
 
RFK_NODISCARD REFUREKU_API Entity const * getOuterEntity () const noexcept
 Get the outer entity of the entity. It basically corresponds to the entity this entity was declared in from a source-code point of view. A nullptr outer entity means the entity was declared at file level. More...
 
REFUREKU_API bool addProperty (Property const &property) noexcept
 Add a property to this entity. More...
 
REFUREKU_API void setOuterEntity (Entity const *outerEntity) noexcept
 Setter for the field _outerEntity. More...
 
REFUREKU_API void setPropertiesCapacity (std::size_t capacity) noexcept
 Set the number of properties for this entity. Useful to avoid reallocations when adding a lot of properties. If the number of properties is already >= to the provided capacity, this method has no effect. More...
 
Entityoperator= (Entity const &)=delete
 
Entityoperator= (Entity &&)=delete
 
RFK_NODISCARD REFUREKU_API bool operator== (Entity const &other) const noexcept
 
RFK_NODISCARD REFUREKU_API bool operator!= (Entity const &other) const noexcept
 

Additional Inherited Members

- Protected Member Functions inherited from rfk::FieldBase
REFUREKU_INTERNAL FieldBase (FieldBaseImpl *implementation) noexcept
 
REFUREKU_INTERNAL FieldBase (FieldBase &&) noexcept
 
- Protected Member Functions inherited from rfk::VariableBase
REFUREKU_INTERNAL VariableBase (VariableBaseImpl *implementation) noexcept
 
REFUREKU_INTERNAL VariableBase (VariableBase &&) noexcept
 
template<typename ValueType >
RFK_NODISCARD ValueType get (void *ptr) const
 Get the data stored in the provided ptr. This method in not safe if you provide a wrong DataType. More...
 
template<typename ValueType >
RFK_NODISCARD ValueType get (void const *ptr) const
 Get the data stored in the provided ptr. This method in not safe if you provide a wrong DataType. Overload of the same method for const pointers. More...
 
template<typename ValueType >
void set (void *ptr, ValueType &&value) const
 Set the provided pointer content. This method is not safe if you provide a wrong ValueType. More...
 
REFUREKU_INTERNAL void set (void *target, void const *source, std::size_t bytesCount) const
 Copy dataSize bytes starting from data into the variable. More...
 
- Protected Member Functions inherited from rfk::Entity
REFUREKU_INTERNAL Entity (Entity &&) noexcept
 
REFUREKU_INTERNAL Entity (EntityImpl *implementation) noexcept
 
- Static Protected Member Functions inherited from rfk::VariableBase
RFK_NORETURN static REFUREKU_API void throwConstViolationException (char const *message)
 Throw a ConstViolation exception with the specified message. /!\ This method is called from template methods so it must be exported. More...
 
- Static Protected Attributes inherited from rfk::VariableBase
template<typename T >
static constexpr bool is_value_v = !std::is_lvalue_reference_v<T> && !std::is_rvalue_reference_v<T>
 

Member Function Documentation

◆ get()

template<typename ValueType >
RFK_NODISCARD ValueType rfk::StaticField::get ( ) const

Get the data corresponding to this static field. This method in not safe if you provide a wrong ValueType.

Template Parameters
ValueTypeType to retrieve from the field. If ValueType is an rvalue reference, the data is moved into the return value (so the class data is no longer safe to use). If ValueType is an lvalue reference, return a reference to the field. If ValueType is a value type, the data is copied. If it is a class, ValueType must be copy-constructible.
Returns
The queried data.
Exceptions
ConstViolationif:
  • the static field is const and ValueType is an RValue type (can't move a const field content);
  • the static field is const and ValueType is a non-const reference;

◆ getConstPtr()

RFK_NODISCARD REFUREKU_API void const * rfk::StaticField::getConstPtr ( ) const
noexcept

Get a const pointer to this static field.

Returns
A const pointer to this static field.

◆ getPtr()

RFK_NODISCARD REFUREKU_API void * rfk::StaticField::getPtr ( ) const

Get a non-const pointer to this static field. Performing non-const operations on the pointer if the static field is const is undefined behaviour.

Returns
A pointer to this static field.

◆ set() [1/2]

template<typename ValueType >
void rfk::StaticField::set ( ValueType &&  value) const

Set the data corresponding to this static field. This method is not safe if you provide a wrong ValueType.

Template Parameters
ValueTypeType to retrieve from the field. If ValueType is an rvalue reference, the data is forwarded into the static field. If ValueType is an lvalue reference, the data is copied into the static field.
Parameters
valueValue to set in the static field.
Exceptions
ConstViolationif the variable is actually const and therefore readonly.

◆ set() [2/2]

REFUREKU_API void rfk::StaticField::set ( void const *  valuePtr,
std::size_t  valueSize 
) const

Copy dataSize bytes starting from data into the static field. This method is not safe if you provide a wrong ValueType.

Parameters
valuePtrPointer to the value to copy.
valueSizeNumber of bytes to copy into the static field.
Exceptions
ConstViolationif the variable is actually const and therefore readonly.

The documentation for this class was generated from the following file: