liba 0.1.15

An algorithm library based on C/C++
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360

/***
 algorithm library version
 @module liba.version
*/

#include "version.h"
#include "a/version.h"

static int liba_version_tostring(lua_State *L)
{
    a_version const *const ctx = (a_version const *)lua_touserdata(L, 1);
    if (ctx)
    {
        char str[48];
        a_version_tostr(ctx, str, sizeof(str));
        lua_pushstring(L, str);
        return 1;
    }
    return 0;
}

static int liba_version_init_(lua_State *L, a_version *ctx, int arg, int top)
{
    ctx->alpha_[0] = '.';
    ctx->alpha_[1] = 0;
    ctx->alpha_[2] = 0;
    ctx->alpha_[3] = 0;
    switch (top)
    {
    default:
    case 4:
        ctx->extra = (unsigned int)luaL_checkinteger(L, arg + 4);
        A_FALLTHROUGH;
    case 3:
        ctx->third = (unsigned int)luaL_checkinteger(L, arg + 3);
        A_FALLTHROUGH;
    case 2:
        ctx->minor = (unsigned int)luaL_checkinteger(L, arg + 2);
        A_FALLTHROUGH;
    case 1:
        if (lua_type(L, arg + 1) == LUA_TSTRING)
        {
            a_version_parse(ctx, lua_tostring(L, arg + 1));
            break;
        }
        ctx->major = (unsigned int)luaL_checkinteger(L, arg + 1);
        A_FALLTHROUGH;
    case 0:;
    }
    return 1;
}

/***
 constructor for algorithm library version
 @tparam[opt] integer major version major number
 @tparam[opt] integer minor version minor number
 @tparam[opt] integer third version third number
 @tparam[opt] integer extra version extra number
 @treturn a.version algorithm library version userdata
 @function new
*/
int liba_version_new(lua_State *L)
{
    int const top = lua_gettop(L);
    a_version *const ctx = lua_newclass(L, a_version);
    a_zero(ctx, sizeof(a_version));
    lua_registry_get(L, liba_version_new);
    lua_setmetatable(L, -2);
    return liba_version_init_(L, ctx, 0, top);
}

/***
 initialize for algorithm library version
 @tparam a.version ctx algorithm library version userdata
 @tparam[opt] integer major version major number
 @tparam[opt] integer minor version minor number
 @tparam[opt] integer third version third number
 @tparam[opt] integer extra version extra number
 @treturn a.version algorithm library version userdata
 @function init
*/
int liba_version_init(lua_State *L)
{
    int const top = lua_gettop(L);
    luaL_checktype(L, 1, LUA_TUSERDATA);
    a_version *const ctx = (a_version *)lua_touserdata(L, 1);
    lua_pushvalue(L, 1);
    return liba_version_init_(L, ctx, 1, top - 1);
}

/***
 parse version string to version
 @tparam a.version ctx algorithm library version userdata
 @tparam string version string to be parsed
 @treturn a.version algorithm library version userdata
 @function parse
*/
int liba_version_parse(lua_State *L)
{
    a_version *const ctx = (a_version *)lua_touserdata(L, 1);
    if (ctx)
    {
        a_version_parse(ctx, lua_tostring(L, 2));
        lua_pushvalue(L, 1);
        return 1;
    }
    return 0;
}

/***
 algorithm library version check
 @tparam integer major required major number
 @tparam integer minor required minor number
 @tparam integer patch required patch number
 @treturn integer <0 library version is higher than required version
 @treturn integer >0 library version is lower than required version
 @treturn integer 0 library version is equal to required version
 @function check
*/
static int liba_version_check(lua_State *L)
{
    a_version v = A_VERSION_0();
    switch (lua_gettop(L) & 0x3)
    {
    case 3:
        v.third = (unsigned int)luaL_checkinteger(L, 3);
        A_FALLTHROUGH;
    case 2:
        v.minor = (unsigned int)luaL_checkinteger(L, 2);
        A_FALLTHROUGH;
    case 1:
        v.major = (unsigned int)luaL_checkinteger(L, 1);
        A_FALLTHROUGH;
    default:
        break;
    }
    lua_pushinteger(L, a_version_check(v.major, v.minor, v.third));
    return 1;
}

/***
 compare the version lhs with the version rhs
 @tparam a.version lhs version userdata on the left
 @tparam a.version rhs version userdata on the right
 @treturn integer <0 version lhs < version rhs
 @treturn integer >0 version lhs > version rhs
 @treturn integer 0 version lhs == version rhs
 @function cmp
*/
int liba_version_cmp(lua_State *L)
{
    luaL_checktype(L, 1, LUA_TUSERDATA);
    luaL_checktype(L, 2, LUA_TUSERDATA);
    a_version const *const lhs = (a_version const *)lua_touserdata(L, 1);
    a_version const *const rhs = (a_version const *)lua_touserdata(L, 2);
    lua_pushinteger(L, a_version_cmp(lhs, rhs));
    return 1;
}

#undef F2
#define F2(func)                                            \
    int liba_version_##func(lua_State *L)                   \
    {                                                       \
        luaL_checktype(L, 1, LUA_TUSERDATA);                \
        luaL_checktype(L, 2, LUA_TUSERDATA);                \
        a_version *lhs = (a_version *)lua_touserdata(L, 1); \
        a_version *rhs = (a_version *)lua_touserdata(L, 2); \
        lua_pushboolean(L, a_version_##func(lhs, rhs));     \
        return 1;                                           \
    }
/***
 version lhs is less than version rhs
 @tparam a.version lhs version userdata on the left
 @tparam a.version rhs version userdata on the right
 @treturn bool result of comparison
 @function lt
*/
F2(lt)
/***
 version lhs is greater than version rhs
 @tparam a.version lhs version userdata on the left
 @tparam a.version rhs version userdata on the right
 @treturn bool result of comparison
 @function gt
*/
F2(gt)
/***
 version lhs is less than or equal to version rhs
 @tparam a.version lhs version userdata on the left
 @tparam a.version rhs version userdata on the right
 @treturn bool result of comparison
 @function le
*/
F2(le)
/***
 version lhs is greater than or equal to version rhs
 @tparam a.version lhs version userdata on the left
 @tparam a.version rhs version userdata on the right
 @treturn bool result of comparison
 @function ge
*/
F2(ge)
/***
 version lhs is equal to version rhs
 @tparam a.version lhs version userdata on the left
 @tparam a.version rhs version userdata on the right
 @treturn bool result of comparison
 @function eq
*/
F2(eq)
/***
 version lhs is not equal to version rhs
 @tparam a.version lhs version userdata on the left
 @tparam a.version rhs version userdata on the right
 @treturn bool result of comparison
 @function ne
*/
F2(ne)

static int liba_version_set(lua_State *L)
{
    a_version *const ctx = (a_version *)lua_touserdata(L, 1);
    switch (a_hash_bkdr(lua_tostring(L, 2), 0))
    {
    case 0x86720331: // major
        ctx->major = (unsigned int)luaL_checkinteger(L, 3);
        break;
    case 0x87857C2D: // minor
        ctx->minor = (unsigned int)luaL_checkinteger(L, 3);
        break;
    case 0x0241DD17: // third
        ctx->third = (unsigned int)luaL_checkinteger(L, 3);
        break;
    case 0xFD1BE968: // extra
        ctx->extra = (unsigned int)luaL_checkinteger(L, 3);
        break;
    case 0xB5485B9E: // alpha
    {
        char const *alpha = luaL_checklstring(L, 3, 0);
        a_version_set_alpha(ctx, alpha);
        break;
    }
    case 0x0CD3E494: // __lt
    case 0x0CD3E485: // __le
    case 0x0CD3E0FC: // __eq
    case 0xE8859EEB: // __name
    case 0xE70C48C6: // __call
    case 0xA65758B2: // __index
    case 0xAEB551C6: // __newindex
    case 0x5DA21A54: // __tostring
        break;
    default:
        lua_getmetatable(L, 1);
        lua_replace(L, 1);
        lua_rawset(L, 1);
    }
    return 0;
}

static int liba_version_get(lua_State *L)
{
    a_version const *const ctx = (a_version const *)lua_touserdata(L, 1);
    switch (a_hash_bkdr(lua_tostring(L, 2), 0))
    {
    case 0x86720331: // major
        lua_pushinteger(L, (lua_Integer)ctx->major);
        break;
    case 0x87857C2D: // minor
        lua_pushinteger(L, (lua_Integer)ctx->minor);
        break;
    case 0x0241DD17: // third
        lua_pushinteger(L, (lua_Integer)ctx->third);
        break;
    case 0xFD1BE968: // extra
        lua_pushinteger(L, (lua_Integer)ctx->extra);
        break;
    case 0xB5485B9E: // alpha
    {
        char alpha[sizeof(ctx->alpha_) + 1];
        a_version_alpha(ctx, alpha);
        lua_pushstring(L, alpha);
        break;
    }
    case 0xA65758B2: // __index
        lua_registry_get(L, liba_version_new);
        lua_int_set(L, -1, "major", (lua_Integer)ctx->major);
        lua_int_set(L, -1, "minor", (lua_Integer)ctx->minor);
        lua_int_set(L, -1, "third", (lua_Integer)ctx->third);
        lua_int_set(L, -1, "extra", (lua_Integer)ctx->extra);
        lua_str_set(L, -1, "alpha", ".");
        break;
    default:
        lua_getmetatable(L, 1);
        lua_replace(L, 1);
        lua_rawget(L, 1);
    }
    return 1;
}

static int liba_version_(lua_State *L)
{
    lua_pushcfunction(L, liba_version_new);
    lua_replace(L, 1);
    lua_call(L, lua_gettop(L) - 1, 1);
    return 1;
}

int luaopen_liba_version(lua_State *L)
{
    /***
     algorithm library version number
     @field MAJOR algorithm library version major
     @field MINOR algorithm library version minor
     @field PATCH algorithm library version patch
     @field TWEAK algorithm library version tweak
     @table liba.version
    */
    static lua_int const enums[] = {
        {"MAJOR", A_VERSION_MAJOR},
        {"MINOR", A_VERSION_MINOR},
        {"PATCH", A_VERSION_PATCH},
        {"TWEAK", A_VERSION_TWEAK},
    };
    static lua_fun const funcs[] = {
        {"check", liba_version_check},
        {"parse", liba_version_parse},
        {"init", liba_version_init},
        {"new", liba_version_new},
        {"cmp", liba_version_cmp},
        {"lt", liba_version_lt},
        {"gt", liba_version_gt},
        {"le", liba_version_le},
        {"ge", liba_version_ge},
        {"eq", liba_version_eq},
        {"ne", liba_version_ne},
    };
    lua_createtable(L, 0, A_LEN(enums) + A_LEN(funcs));
    lua_int_reg(L, -1, enums, A_LEN(enums));
    lua_fun_reg(L, -1, funcs, A_LEN(funcs));
    lua_createtable(L, 0, 1);
    lua_fun_set(L, -1, "__call", liba_version_);
    lua_setmetatable(L, -2);

    static lua_fun const metas[] = {
        {"__tostring", liba_version_tostring},
        {"__newindex", liba_version_set},
        {"__index", liba_version_get},
        {"__call", liba_version_init},
        {"__eq", liba_version_eq},
        {"__lt", liba_version_lt},
        {"__le", liba_version_le},
    };
    lua_createtable(L, 0, A_LEN(metas) + A_LEN(funcs));
    lua_fun_reg(L, -1, metas, A_LEN(metas));
    lua_fun_reg(L, -1, funcs + 1, A_LEN(funcs) - 1);
    lua_str_set(L, -1, "__name", "a.version");
    lua_registry_set(L, liba_version_new);

    return 1;
}