sol2/docs/source/api/property.rst

58 lines
1.3 KiB
ReStructuredText

property
========
.. code-block:: cpp
template <typename Read, typename Write>
decltype(auto) property ( Read&& read_function, Write&& write_function );
template <typename Read>
decltype(auto) property ( Read&& read_function );
template <typename Write>
decltype(auto) property ( Write&& write_function );
These set of functions create a type which allows a setter and getter pair (or a single getter, or a single setter) to be used to create a variable that is either read-write, read-only, or write-only. When used during :doc:`usertype<usertype>` construction, it will create a variable that uses the setter/getter member function specified.
.. code-block:: cpp
:caption: player.hpp
:linenos:
class Player {
public:
int get_hp() const {
return hp;
}
void set_hp( int value ) {
hp = value;
}
int get_max_hp() const {
return hp;
}
void set_max_hp( int value ) {
maxhp = value;
}
private:
int hp = 50;
int maxHp = 50;
}
.. code-block:: cpp
:caption: game.cpp
:linenos:
lua.set("theplayer", Player());
lua.new_usertype<Player>( "Player",
"hp", sol::property(&Player::get_hp, &Player::set_hp),
"maxHp", sol::property(&Player::get_max_hp, &Player::set_max_hp)
);
.. code-block:: lua
:caption: game-snippet.lua
theplayer.hp = 20
print(theplayer.hp)