`slice`过滤器如何截取字符串或数组中指定范围内的元素？

📅 👁️ 78

AnQiCMS 模板引擎提供了丰富的过滤器，让您在展示内容时拥有极大的灵活性。其中，slice 过滤器是一个非常实用的工具，它能帮助您精确地截取字符串或数组中指定范围内的元素，无论您是想展示文章摘要、限制图片数量，还是处理其他数据片段，它都能派上用场。

slice 过滤器的语法简洁明了：{{ obj|slice:"from:to" }}。这里的 obj 可以是您需要操作的字符串或数组变量，而 "from:to" 则定义了您想要截取的范围。

理解 slice 过滤器的关键在于以下几点：

零基索引（0-based indexing）：和许多编程语言一样，slice 过滤器从 0 开始计算元素的索引。也就是说，第一个元素的索引是 0，第二个是 1，依此类推。
左闭右开区间：slice 截取的范围是“左闭右开”的。这意味着起始索引 from 处的元素会被包含在结果中，而结束索引 to 处的元素则不会被包含。
灵活的省略规则：
- 如果省略 from (例如 ":to")，将从开头（索引 0）开始截取。
- 如果省略 to (例如 "from:")，将从 from 索引开始一直截取到末尾。
- 如果 from 和 to 都省略 (例如 ":" 或直接不使用 slice 参数)，则表示截取整个字符串或数组（等同于复制一份）。
负数索引：您还可以使用负数索引，它表示从末尾开始计数。例如，-1 代表最后一个元素，-2 代表倒数第二个元素，依此类推。

接下来，我们通过具体的例子来看看 slice 过滤器如何在字符串和数组中发挥作用。

当您需要从一个较长的文本中提取一部分内容时，slice 过滤器非常高效。

假设您有一个字符串 "Hello AnQiCMS World!"：

从指定位置截取到末尾：如果您只想获取从索引 6 开始到末尾的内容（即 "AnQiCMS World!"），可以这样写： {{ "Hello AnQiCMS World!"|slice:"6:" }} 结果会是：AnQiCMS World!
从开头截取到指定位置：如果您只想获取从开头到索引 5 之前的内容（即 "Hello"），可以这样写： {{ "Hello AnQiCMS World!"|slice:":5" }} 结果会是：Hello
截取指定范围：如果您想获取从索引 6 到索引 13 之前的内容（即 "AnQiCMS"），可以这样写： {{ "Hello AnQiCMS World!"|slice:"6:13" }} 结果会是：AnQiCMS
使用负数索引：如果您想获取字符串的最后一个单词（即 "World!"），可以利用负数索引： {{ "Hello AnQiCMS World!"|slice:"-7:" }} （从倒数第七个字符开始）结果会是：World! 或者，如果您想获取除最后一个字符外的所有内容： {{ "Hello AnQiCMS World!"|slice:":-1" }} 结果会是：Hello AnQiCMS World

值得一提的是，AnQiCMS 底层基于 Go 语言开发，对 UTF-8 编码的字符有良好的支持。因此，在使用 slice 过滤器截取包含中文的字符串时，无需担心乱码或截取不完整的问题，每一个中文字符都会被作为一个独立的“字符”来计算索引。

slice 过滤器在处理数组（或列表）时，其原理与字符串截取类似，只是操作的对象变为了数组中的元素。

假设您有一个包含数字的数组 [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]，我们可以通过 split 过滤器模拟生成一个这样的数组： {% set numList = "1,2,3,4,5,6,7,8,9,10"|split:"," %}

现在，我们可以对 numList 这个数组进行截取操作：

从指定位置截取到末尾：如果您想获取从索引 3 开始到末尾的元素（即 [4, 5, 6, 7, 8, 9, 10]）： {{ numList|slice:"3:"|join:"," }} (注意：join:"," 只是为了将数组元素以逗号分隔的字符串形式展示，slice 操作本身返回的是一个新数组。) 结果会是：4,5,6,7,8,9,10
从开头截取到指定位置：如果您想获取从开头到索引 5 之前的内容（即 [1, 2, 3, 4, 5]）： {{ numList|slice:":5"|join:"," }} 结果会是：1,2,3,4,5
截取指定范围：如果您想获取从索引 3 到索引 7 之前的内容（即 [4, 5, 6, 7]）：