截取一段文本

指令说明

按指定起始位置和截取方式，从文本中截取一段内容，并将截取结果保存为新的文本变量。

指令输入参数

输入参数	输入参数类型	说明
文本内容	any	待截取的内容；列表会用换行拼接，其他类型会先转成字符串
起始位置	枚举项	从第一个字符开始截取、从指定位置开始截取、从指定文本开始截取
起始字符位置	int 或 str	仅当 起始位置 是 从指定位置开始截取 时需要该参数，位置从 0 开始
起始文本内容	any	仅当 起始位置 是 从指定文本开始截取 时需要该参数，截取结果会从该文本首次出现的位置开始
截取方式	枚举项	截取到最后一个字符、截取指定长度
截取长度	int 或 str	仅当 截取方式 是 截取指定长度 时需要该参数，必须大于或等于 0

指令输出参数

输出参数	输出参数类型	说明
截取结果	str	截取到的文本内容

注意

文本内容如果是列表，会先用换行符拼接为文本；其他类型会通过 str() 转为文本，因此 None 会变成字符串 "None"。

起始字符位置和截取长度应使用整数或可转换为整数的字符串；如果不能转换为数字会报错。

从指定位置开始截取时，起始字符位置不能为空，不能小于 0。位置从 0 开始；如果起始位置等于或大于文本长度，不会报错，结果为空文本。

从指定文本开始截取时，起始文本内容不能为空；如果有多个匹配项，从第一次出现的位置开始截取，截取结果包含这个起始文本；如果找不到会报错。

截取指定长度时，长度不能为空，不能小于 0；长度为 0 时返回空文本；长度超过剩余文本长度时，不会报错，会截取到文本末尾。

生成注意

• 位置和长度按字符计算；生成流程时应使用非负整数，避免生成小数或无法转换为数字的文本。
• 只生成当前枚举项需要的参数：按指定位置开始才需要“起始字符位置”，按指定文本开始才需要“起始文本内容”，截取指定长度才需要“截取长度”。