FAnsiString

FAnsiString

FAnsiString 是 Unreal Engine 的 ANSI 编码字符串类型，使用单字节字符编码。

继承关系

LocalObject

相关类型

方法

ToString()

  • 返回类型： string
  • 返回值： ANSI 编码的 Lua 字符串。

Empty()

  • 移除所有字符以清空字符串。

Clear()

  • 移除所有字符以清空字符串（与 Empty 相同）。

Len()

  • 返回类型： integer
  • 返回值： 字符串的字符长度（每个 ANSI 字符占 1 字节）。

IsEmpty()

  • 返回类型： boolean
  • 返回值： 字符串为空时为 true，否则为 false。

Append(string)

  • 参数： string - 要追加的 Lua 字符串或另一个 FAnsiString
  • 将给定字符串追加到当前字符串末尾。

Find(search)

  • 参数： search - 要搜索的 Lua 字符串
  • 返回类型： integer 或 nil
  • 返回值： 搜索字符串首次出现位置的 1 起始索引；未找到时为 nil。

StartsWith(prefix)

  • 参数： prefix - 要检查的 Lua 字符串
  • 返回类型： boolean
  • 返回值： 字符串以给定前缀开头时为 true，否则为 false。

EndsWith(suffix)

  • 参数： suffix - 要检查的 Lua 字符串
  • 返回类型： boolean
  • 返回值： 字符串以给定后缀结尾时为 true，否则为 false。

ToUpper()

  • 返回类型： FAnsiString
  • 返回值： 将所有字符转换为大写后的新 FAnsiString。

ToLower()

  • 返回类型： FAnsiString
  • 返回值： 将所有字符转换为小写后的新 FAnsiString。

使用示例

-- FAnsiString for ANSI-encoded data
local ansiString = FAnsiString("Hello ANSI")
print(ansiString:ToString()) -- Output: "Hello ANSI"

ansiString:Append(" World")
print(ansiString:ToString()) -- Output: "Hello ANSI World"

if ansiString:EndsWith("World") then
    print("String ends with World!")
end

local lowerString = ansiString:ToLower()
print(lowerString:ToString()) -- Output: "hello ansi world"

local index = ansiString:Find("ANSI")
if index then
    print("Found at index: " .. index)
end

注意事项

  • FAnsiString 使用单字节 ANSI 编码，适用于与 ASCII 兼容的文本。
  • 该类型适用于需要与预期 ANSI 字符串的旧式系统或 API 交互的场景。
  • 如需国际文本支持，请考虑改用 FUtf8String 或 FString。

原文：docs/lua-api/classes/fansistring.md · 固定提交 560411f18512 · 来源与 MIT 许可