Lua 的 tostring 函数

原创于 2025-12-07 23:26:49 发布 · 372 阅读 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

IMPYLH

关注

标签

#lua #junit #开发语言 #笔记 #单元测试

分类游戏开发

代码可运行

Lua 专栏收录该内容

34 篇文章

订阅专栏

Lua 的 tostring 函数是一个内置的基础函数，用于将给定的值转换为字符串表示形式。这个函数在 Lua 5.1 到 Lua 5.4 的所有版本中都可用，是处理数据类型转换时最常用的函数之一。

基本语法：

tostring(value)

功能特点：

对于数字类型，会直接转换为对应的字符串形式：

print(tostring(123))    -- 输出 "123"
print(tostring(3.14))   -- 输出 "3.14"

对于字符串类型，会返回字符串本身：

print(tostring("hello")) -- 输出 "hello"

对于布尔值，会返回 "true" 或 "false"：

print(tostring(true))   -- 输出 "true"
print(tostring(false))  -- 输出 "false"

对于 nil，会返回 "nil"：

print(tostring(nil))    -- 输出 "nil"

对于 table 等复杂类型，默认返回其内存地址的字符串表示：

local tbl = {}
print(tostring(tbl))    -- 输出类似 "table: 0x7f8e5bc04230"

高级用法：

可以通过为 table 定义 __tostring 元方法来自定义输出：

local person = {name = "Alice", age = 25}
setmetatable(person, {
    __tostring = function(t)
        return "Person: "..t.name..", "..t.age.." years old"
    end
})
print(tostring(person)) -- 输出 "Person: Alice, 25 years old"

在字符串拼接时会自动调用 tostring：

local num = 42
print("The answer is "..num) -- 自动转换为 "The answer is 42"

应用场景：

调试输出时查看变量内容
日志记录时需要将各种数据类型转为字符串
字符串拼接前的类型转换
序列化数据前的预处理

注意事项：

对 userdata 类型的转换结果取决于其元表定义
大数字转换时可能会损失精度
自定义 __tostring 时要注意避免递归调用