Lua Int64库使用文档

1. 安装指南

Lua Int64 是一个为 Lua 语言提供64位整数支持的库。在64位架构中，我们可以使用 lightuserdata 类型进行64位数字的操作。以下是安装此库的步骤：

• 确保您的 Lua 环境为64位架构。
• 将 Lua Int64 库的源代码下载到您的项目中。
• 如果您使用的是 LuaRocks，可以使用以下命令安装：

  luarocks install lua-int64
  

2. 项目的使用说明

Lua Int64 库提供了一个非常简单的 API，用于在 Lua 中创建和管理64位整数。以下是基本的使用方法：

• 通过 Lua 的 number 类型或小端序的8字节字符串创建一个 int64 数字。
• 可以将 lightuserdata 类型作为 int64 数字从 C 库中推送到 Lua。

示例代码

local int64 = require("int64")

-- 创建一个 int64 数字
local num = int64.new(1234567890123456789)

-- 打印数字
print(num)

-- 从字符串创建 int64 数字
local str_num = int64.new("c09a6b7b8a7c7b8c")

-- 打印数字
print(str_num)

-- 从 C 库中推入 lightuserdata 作为 int64 数字（示例）
-- local c_num = C_function_that_returns_lightuserdata()
-- print(int64.new(c_num))

3. 项目API使用文档

Lua Int64 库仅提供了一个 API：int64.new，用于创建一个 int64 类型的数字。

int64.new

• 参数：
  • number 或 string：Lua number 类型或表示64位整数的小端序8字节字符串。
• 返回：返回一个 int64 类型的对象。

示例代码

local int64 = require("int64")

-- 使用 number 创建 int64 对象
local num1 = int64.new(9223372036854775807)
print(num1)

-- 使用字符串创建 int64 对象
local num2 = int64.new("0000000100000001")
print(num2)

4. 项目安装方式

如果您不使用 LuaRocks，可以通过以下步骤手动安装 Lua Int64 库：

• 下载 Lua Int64 库的源代码。
• 将源代码文件放置到您的 Lua 项目中。
• 在您的 Lua 代码中，使用 require("int64") 来引入库。

确保在64位架构上运行 Lua 解释器，Lua Int64 库才能正常工作。