# klua

**Repository Path**: kibaamor/klua

## Basic Information

- **Project Name**: klua
- **Description**: A very simple C++11 wrapper for lua utility functions. 一个非常简单的用于C++11的lua实用函数封装。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://github.com/KibaAmor/klua
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-03-03
- **Last Updated**: 2024-06-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# klua

A very simple C++11 wrapper for lua utility functions.

一个非常简单的用于C++11的lua实用函数封装。

## 编译环境

自带lua 5.3.5源码

* CMake 3.1及以上
* [Clang 3.3](http://clang.llvm.org/cxx_status.html)及以上(如果你使用Clang编译)
* Visual Studio 2015及以上(Windows)
* [Gcc 4.9](https://gcc.gnu.org/gcc-5/changes.html#libstdcxx)及以上(Linux)
* [Xcode 8.0](https://stackoverflow.com/questions/28094794/why-does-apple-clang-disallow-c11-thread-local-when-official-clang-supports) 及以上(MacOS)

## 如何使用

Windows和Linux下都可以使用下面的命令

### 编译

```bash
# 进入源码根目录
cd knet

# 生成工程
cmake . -B build

# 编译Relase
cmake --build build --config Release
```

### 测试

```bash
# 进入源码根目录下的build目录
cd build

# 运行测试
ctest -C Release
```

## 示例程序

[查看源码](./test/call/main.cpp)

```cpp
struct kom
{
    std::string name;
    int32_t age;
    bool sex = true;
    double salary = 0.0;
    int64_t data = 0;
};

void to_lua(lua_State* L, const kom& v)
{
    lua_newtable(L);
    table_set(L, "name", v.name);
    table_set(L, "age", v.age);
    table_set(L, "sex", v.sex);
    table_set(L, "salary", v.salary);
    table_set(L, "data", v.data);
}

bool from_lua(lua_State* L, kom& v)
{
    if (LUA_TTABLE != lua_type(L, -1))
        return false;

    if (table_get(L, "name", v.name)
        && table_get(L, "age", v.age)
        && table_get(L, "sex", v.sex)
        && table_get(L, "salary", v.salary)
        && table_get(L, "data", v.data))
    {
        lua_pop(L, 1);
        return true;
    }
    return false;
}

const char* ls = R"(
function dump_kom(k)
    klua.dump(k, "k")
    print(k.name)
    print(k.age)
    print(k.sex)
    print(k.salary)
    print(k.data)
    return k
end

local submsg1 = {name="kiba", age=18}
local submsg2 = {name="amor", age=28}
assert(msg.dump_submsg(submsg1))
assert(msg.dump_submsg(submsg2))

local msg1 = {name="team1", submsgs={submsg1, submsg2}}
assert(msg.dump_msg(msg1))

local u = user.new()
u:set_account("kaccount")
print(u:get_account())
u:set_nickname("knickname")
print(u:get_nickname())
u:set_userid(8888)
print(u:get_userid())

print("user count:"..usermgr:get_user_count())
u = nil
collectgarbage()
print("user count:"..usermgr:get_user_count())
)";

TEST_SUITE_BEGIN("userdata");

TEST_CASE("call")
{
    lua l;
    CHECK(l.gettop() == 0);
    l.load_stdlibs();
    CHECK(l.gettop() == 0);
    reg_msg_to_lua(l);
    CHECK(l.gettop() == 0);
    reg_user_to_lua(l);
    CHECK(l.gettop() == 0);

    usermgr& um = usermgr::instance();
    reg_usermgr_to_lua(l, um);
    CHECK(l.gettop() == 0);

    kom k;
    k.name = "kom";
    k.age = 18;
    k.sex = true;
    k.salary = DBL_MAX;
    k.data = LLONG_MAX;
    kom m;

    CHECK(l.dostring(ls));
    CHECK(l.gettop() == 0);

    CHECK(l.call1p("dump_kom", k, m));
    CHECK(m.name == k.name);
    CHECK(m.age == k.age);
    CHECK(m.sex == k.sex);
    CHECK(m.salary == k.salary);
    CHECK(m.data == k.data);
    CHECK(l.gettop() == 0);

    CHECK(!l.call1p("error.test", k)); // false
    CHECK(l.gettop() == 0);

    CHECK(l.call1p("klua.dump", k));
    CHECK(l.gettop() == 0);

    CHECK(l.call2p("klua.dump", k, "k"));
    CHECK(l.gettop() == 0);
}

TEST_SUITE_END();
```