mirror of
https://github.com/ThePhD/sol2.git
synced 2024-03-22 13:10:44 +08:00
65 lines
1.5 KiB
ReStructuredText
65 lines
1.5 KiB
ReStructuredText
property
|
|
========
|
|
*wrapper to specify read and write variable functionality using functions*
|
|
|
|
.. 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:
|
|
|
|
sol::state lua;
|
|
lua.open_libraries(sol::lib::base);
|
|
|
|
lua.set("theplayer", Player());
|
|
|
|
// Yes, you can register after you set a value and it will
|
|
// connect up the usertype automatically
|
|
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
|
|
|
|
-- variable syntax, calls functions
|
|
theplayer.hp = 20
|
|
print(theplayer.hp) |