鸿蒙 ArkTS 常用的数组和字符串 操作方法
数组的常用方法
| 方法名 | 功能描述 |
|---|---|
concat(value0, ?value1, /* … ,*/ ?valueN) | 合并两个或多个数组。此方法不会更改现有数组，而是返回一个新数组 |
copyWithin(target, ?start, ?end) | 浅复制数组的一部分到同一数组中的另一个位置，并返回它，不会改变原数组的长度 |
entries() | 返回一个新的数组迭代器对象，该对象包含数组中每个索引的键/值对 |
every(callbackFn, ?thisArg) | 测试一个数组内的所有元素是否都能通过指定函数的测试。它返回一个布尔值 |
fill(value, ?start, ?end) | 用一个固定值填充一个数组中从起始索引（默认为 0）到终止索引（默认为 array.length）内的全部元素。它返回修改后的数组 |
filter(callbackFn, ?thisArg) | 创建给定数组一部分的浅拷贝，其包含通过所提供函数实现的测试的所有元素 |
find(callbackFn, ?thisArg) | 返回数组中满足提供的测试函数的第一个元素的值。否则返回 undefined |
findIndex(callbackFn, ?thisArg) | 返回数组中满足提供的测试函数的第一个元素的索引。若没有找到对应元素则返回 -1 |
flat(?depth) | 创建一个新的数组，并根据指定深度递归地将所有子数组元素拼接到新的数组中 |
flatMap(callbackFn, ?thisArg) | 对数组中的每个元素应用给定的回调函数，然后将结果展开一级，返回一个新数组 |
forEach(callbackFn, ?thisArg) | 对数组的每个元素执行一次给定的函数 |
includes(searchElement, ?fromIndex) | 用来判断一个数组是否包含一个指定的值，根据情况，如果包含则返回 true，否则返回 false |
indexOf(searchElement, ?fromIndex) | 返回数组中第一次出现给定元素的下标，如果不存在则返回 -1 |
join(?separator) | 将一个数组（或一个类数组对象）的所有元素连接成一个字符串并返回这个字符串，用逗号或指定的分隔符字符串分隔。如果数组只有一个元素，那么将返回该元素而不使用分隔符 |
keys() | 返回一个新的数组迭代器对象，其中包含数组中每个索引的键 |
lastIndexOf(searchElement, ?fromIndex) | 返回数组中给定元素最后一次出现的索引，如果不存在则返回 -1。该方法从 fromIndex 开始向前搜索数组 |
length | 返回该数组中元素的个数 |
map(callbackFn, ?thisArg) | 创建一个新数组，这个新数组由原数组中的每个元素都调用一次提供的函数后的返回值组成 |
pop() | 从数组中删除最后一个元素，并返回该元素的值。此方法会更改数组的长度 |
push() | 将指定的元素添加到数组的末尾，并返回新的数组长度 |
reduce(callbackFn, ?initialValue) | 对数组中的每个元素按序执行一个提供的 reducer 函数，每一次运行 reducer 会将先前元素的计算结果作为参数传入，最后将其结果汇总为单个返回值 |
reduceRight(callbackFn, ?initialValue) | 对累加器（accumulator）和数组的每个值（按从右到左的顺序）应用一个函数，并使其成为单个值 |
reverse() | 就地反转数组中的元素，并返回同一数组的引用 |
shift() | 从数组中删除第一个元素，并返回该元素的值。此方法更改数组的长度 |
slice(?start, ?end) | 返回一个新的数组对象，这一对象是一个由 start 和 end 决定的原数组的浅拷贝（包括 start，不包括 end），其中 start 和 end 代表了数组元素的索引。原始数组不会被改变 |
some(callbackFn, ?thisArg) | 测试数组中是否至少有一个元素通过了由提供的函数实现的测试 |
sort(?compareFn) | 就地对数组的元素进行排序，并返回对相同数组的引用 |
splice(start, ?deleteCount, ?item1, ?item2, /* …, */ ?itemN) | 就地移除或者替换已存在的元素和/或添加新的元素 |
toLocaleString(?locales, ?options) | 返回一个字符串，表示数组中的所有元素 |
toString() | 返回一个字符串，表示指定的数组及其元素 |
unshift(?element1, ?element2, /* …, */ ?elementN) | 将指定元素添加到数组的开头，并返回数组的新长度 |
values() | 返回一个新的数组迭代器对象，该对象迭代数组中每个元素的值 |
字符串常用方法
| 方法名 | 功能描述 |
|---|---|
charAt(index) | 返回一个由给定索引处的单个 UTF-16 码元构成的新字符串 |
charCodeAt(index) | 方法返回一个整数，表示给定索引处的 UTF-16 码元，其值介于 0 和 65535 之间 |
codePointAt(index) | 返回一个非负整数，该整数是从给定索引开始的字符的 Unicode 码位值 |
concat(str1, ?str2, /_ …, _/ ?strN) | 将字符串参数连接到调用的字符串上，并返回一个新的字符串 |
endsWith(searchString, ?endPosition) | 判断一个字符串是否以指定字符串结尾，如果是则返回 true，否则返回 false |
includes(searchString, ?position) | 区分大小写的搜索，以确定是否可以在一个字符串中找到另一个字符串，并根据情况返回 true 或 false |
indexOf(searchString, ?position) | 在字符串中搜索指定子字符串，并返回其第一次出现的位置索引 |
lastIndexOf(searchString, ?position) | 搜索该字符串并返回指定子字符串最后一次出现的索引 |
length | 表示字符串的 UTF-16 码元长度 |
localeCompare(compareString, ?locales, ?options) | 返回一个数字，表示参考字符串在排序顺序中是在给定字符串之前、之后还是与之相同 |
match(regexp) | 检索字符串与正则表达式进行匹配的结果 |
matchAll(regexp) | 返回一个迭代器，该迭代器包含了检索字符串与正则表达式进行匹配的所有结果包括捕获组） |
normalize(?form) | 返回该字符串的 Unicode 标准化形式 |
padEnd(targetLength, ?padString) | 将当前字符串从末尾开始填充给定的字符串（如果需要会重复填充），直到达到给定的长度。填充是从当前字符串的末尾开始的 |
padStart(targetLength, ?padString) | 用另一个字符串填充当前字符串（如果需要会重复填充），直到达到给定的长度 |
repeat(count) | 构造并返回一个新字符串，其中包含指定数量的所调用的字符串副本，这些副本连接在一起 |
replace(pattern, replacement) | 返回一个新字符串，其中一个、多个或所有匹配的 pattern 被替换为 replacement |
replaceAll(pattern, replacement) | 返回一个新字符串，其中所有匹配 pattern 的部分都被替换为 replacement |
search(regexp) | 用于在 String 对象中执行正则表达式的搜索，寻找匹配项 |
slice(indexStart, ?indexEnd) | 提取字符串的一部分，并将其作为新字符串返回，而不修改原始字符串 |
split(separator, ?limit) | 接受一个模式，通过搜索模式将字符串分割成一个有序的子串列表，将这些子串放入一个数组，并返回该数组 |
startsWith(searchString, ?position) | 用来判断当前字符串是否以另外一个给定的子字符串开头，并根据判断结果返回 true 或 false |
substring(indexStart, ?indexEnd) | 返回该字符串从起始索引到结束索引（不包括）的部分，如果未提供结束索引，则返回到字符串末尾的部分 |
toLocaleLowerCase(?locales) | 根据特定区域设置的大小写映射规则，将字符串转换为小写形式并返回 |
toLocaleUpperCase(?locales) | 根据特定区域设置的大小写映射规则，将字符串转换为大写形式并返回 |
toLowerCase() | 将该字符串转换为小写形式 |
toString() | 返回该字符串的值 |
toUpperCase() | 将该字符串转换为大写形式 |
trim() | 从字符串的两端移除空白字符，并返回一个新的字符串，而不会修改原始字符串 |
trimEnd() | 从字符串的结尾移除空白字符，并返回一个新的字符串，而不会修改原始字符串 |
trimStart() | 从字符串的开头移除空白字符，并返回一个新的字符串，而不会修改原始字符串 |
valueOf() | 返回 String 对象的字符串值 |