在开发HarmonyOS应用时,开发者需根据字符编码生成字符串,或处理包含转义字符的模板字符串。若不了解String.fromCharCode()、String.fromCodePoint()和String.raw()三个静态方法的使用场景与差异,容易导致字符生成错误或模板字符串处理异常。
在JavaScript中,String是一个内置对象,提供一系列静态方法用于处理字符与字符串。在HarmonyOS应用开发中,基于JS语言的ArkTS(ArkUI TypeScript)同样支持这些方法。
当需要根据Unicode码点(0–65535)生成字符串时,使用String.fromCharCode()。
示例代码:
// 生成字母'A'和'Z'
const charA = String.fromCharCode(65);
const charZ = String.fromCharCode(90);
hilog.info(0x0000, 'testTag', charA);
hilog.info(0x0000, 'testTag', charZ);
// 生成数字'0'到'9'
const digits: string[] = [];
for (let i = 48; i <= 57; i++) {
digits.push(String.fromCharCode(i));
}
hilog.info(0x0000, 'testTag', digits.join(''));
适用场景:处理ASCII或基本拉丁字符,不涉及Emoji或特殊符号。
当需要处理超出16位范围的Unicode字符(如:、、)时,必须使用String.fromCodePoint()。
示例代码:
// 生成地球Emoji const earth = String.fromCodePoint(0x1F30D); hilog.info(0x0000, 'testTag', earth); // 生成程序员Emoji const programmer = String.fromCodePoint(0x1F469, 0x200D, 0x1F4BB); hilog.info(0x0000, 'testTag', programmer); // 生成家庭Emoji const family = String.fromCodePoint(0x1F468, 0x200D, 0x1F469, 0x200D, 0x1F467, 0x200D, 0x1F466); hilog.info(0x0000, 'testTag', family);
String.fromCharCode()对于代理对(如0xD83D和0xDCCD)会返回错误字符,而fromCodePoint()可正确处理。
当需要在模板字符串中保留原始的转义字符(如\n、\t、\\)时,应使用String.raw()。
示例代码:
// 普通模板字符串:转义字符会被解析 const normalStr = `第一行\n第二行`; hilog.info(0x0000, 'testTag', normalStr); // 使用String.raw():转义字符作为字面量保留 const rawStr = String.raw`第一行\n第二行`; hilog.info(0x0000, 'testTag', rawStr); // 处理路径字符串(避免反斜杠被转义) const filePath = String.raw`C:\Users\John\Documents`; hilog.info(0x0000, 'testTag', filePath);
适用场景:构建正则表达式、路径字符串、日志格式、多行文本模板等需要保留转义字符的场景。
完整示例代码如下:
import hilog from '@ohos.hilog';
@Entry
@Component
struct StringStaticMethod {
build() {
Column() {
Button('fromCharCode')
.onClick(() => {
// 生成字母'A'和'Z'
const charA = String.fromCharCode(65);
const charZ = String.fromCharCode(90);
hilog.info(0x0000, 'testTag', charA);
hilog.info(0x0000, 'testTag', charZ);
// 生成数字'0'到'9'
const digits: string[] = [];
for (let i = 48; i <= 57; i++) {
digits.push(String.fromCharCode(i));
}
hilog.info(0x0000, 'testTag', digits.join(''));
}).margin({ bottom: 10 });
Button('fromCodePoint')
.onClick(() => {
// 生成地球Emoji
const earth = String.fromCodePoint(0x1F30D);
hilog.info(0x0000, 'testTag', earth);
// 生成程序员Emoji
const programmer = String.fromCodePoint(0x1F469, 0x200D, 0x1F4BB);
hilog.info(0x0000, 'testTag', programmer);
// 生成家庭Emoji
const family = String.fromCodePoint(0x1F468, 0x200D, 0x1F469, 0x200D, 0x1F467, 0x200D, 0x1F466);
hilog.info(0x0000, 'testTag', family);
}).margin({ bottom: 10 });
Button('String.raw')
.onClick(() => {
// 普通模板字符串:转义字符会被解析
const normalStr = `第一行\n第二行`;
hilog.info(0x0000, 'testTag', normalStr);
// 使用String.raw():转义字符作为字面量保留
const rawStr = String.raw`第一行\n第二行`;
hilog.info(0x0000, 'testTag', rawStr);
// 处理路径字符串(避免反斜杠被转义)
const filePath = String.raw`C:\Users\John\Documents`;
hilog.info(0x0000, 'testTag', filePath);
});
}.width('100%')
.height('100%')
.alignItems(HorizontalAlign.Center)
.justifyContent(FlexAlign.Center);
}
} Q:String.fromCharCode()和String.fromCodePoint()有什么区别?
A:String.fromCharCode()仅支持16位码点(0–65535),不支持代理对;而String.fromCodePoint()支持完整的Unicode码点(包括Emoji和生僻字),能正确处理超出BMP的字符。
Q:为什么在处理Emoji时推荐使用String.fromCodePoint()?
A:Emoji通常由多个码点组成(如0x1F469+0x200D+0x1F4BB),这些码点可能包含代理对。String.fromCodePoint()能正确解析并组合这些码点,而fromCharCode()会失败或产生乱码。
Q:String.raw()与模板字符串中的raw属性有何关系?
A:String.raw()是一个静态方法,用于创建“原始模板字符串”。它实际上等价于调用模板字符串的raw属性,例如:String.raw等价于templateString.raw。