utf8.*

utf8.*

类型库

版本版本 2024.3703

关键词 utf8, UTF-8, Unicode, 字符串

平台 Android, iOS, macOS, tvOS, Windows

概述

UTF-8 插件，基于 luautf8 模块，提供在 Corona 中操作UTF-8字符串的函数。

UTF-8 字符串由单字节和多字节Unicode 字符混合组成，这意味着简单的字节计数不能用于确定字符串长度或子字符串位置等内容。Lua 字符串对象可以存储UTF-8字符串，因为它只是将它们视为字节序列，但是任何需要理解“字符”概念的操作都将无法工作，因为 Lua 假定所有字符都是一个字节。

本质上，如果您需要处理诸如大写转换或带有重音符号或非 ASCII字符的字符串替换等操作，此插件将特别有用。

概念

UTF-8 插件使用了一些在尝试使用它之前应该理解的概念。

字符位置 或 charpos — 字符串中字符相对于字符串开头的位置。任何字符的位置取决于它前面所有字符的宽度UTF-8（字节数）。
偏移量 或 offset — 一个字符与另一个字符之间的字符数。这可能取决于两点之间存在的字符。
代码点 或 codepoint — 表示特定 charpos 处字符的数字。它是该字符的 Unicode 标准代码。

语法

local utf8 = require( "plugin.utf8" )

函数

utf8.charpos()

utf8.codepoint()

utf8.codes()

utf8.escape()

utf8.fold()

utf8.insert()

utf8.ncasecmp()

utf8.next()

utf8.remove()

utf8.title()

utf8.width()

此外，以下函数模仿相应的字符串库函数，但在该UTF-8插件中，它们处理的是多字节字符

UTF-8 插件	等效函数
`utf8.byte`	string.byte()
`utf8.char`	string.char()
`utf8.find`	string.find()
`utf8.gmatch`	string.gmatch()
`utf8.gsub`	string.gsub()
`utf8.len`	string.len()
`utf8.lower`	string.lower()
`utf8.match`	string.match()
`utf8.reverse`	string.reverse()
`utf8.sub`	string.sub()
`utf8.upper`	string.upper()

项目设置

要使用此插件，请在 build.settings 的 plugins 表中添加一个条目。添加后，构建服务器将在构建阶段集成该插件。

settings =
{
    plugins =
    {
        ["plugin.utf8"] =
        {
            publisherId = "com.coronalabs"
        },
    },      
}