使一个字符串拆分为两个子串。

可在特定字符或子字符串上拆分字符串。在字符串中搜索/拆分搜索字符串/字符中指定的字符串或字符。该函数拆分字符串，通过匹配之前的子字符串和匹配＋剩余字符串返回剩余的两个字符串。


icon

输入/输出

  • cstr.png 字符串 —

    字符串是函数搜索或分隔的输入字符串。

  • cstr.png 搜索字符串/字符(-) —

    搜索字符串/字符是要在字符串中搜索的字符串或字符。如未连线该输入端或该输入端包含空字符串，函数可在偏移量处拆分字符串。必须连线搜索字符或偏移量。

  • ci32.png 偏移量(0) —

    offset 指定函数在 string 中开始搜索匹配的位置的字节数。offset 必须为数值。string 中第一个字符的偏移量为 0。如果 offset 未连线或小于 0，函数将把 offset 视为 0。

  • istr.png 匹配之前的子字符串 —

    搜索字符串/字符如未连线，匹配之前的子字符串返回搜索字符串/字符前或偏移量前的字符串。如函数未找到搜索字符串，匹配之前的子字符串返回完整的原始字符串。

  • istr.png 匹配+剩余字符串 —

    匹配+剩余字符串包含搜索字符串/字符和字符串中的所有后续字符。如函数未找到搜索字符串，匹配字符串和剩余字符串返回空字符串。

  • ii32.png 匹配偏移量 —

    匹配偏移量是搜索字符串/字符在字符串中的位置。如函数未找到搜索字符串，则匹配偏移量返回-1。

    • 如启用了匹配单个字符选项，该函数只使用搜索字符串/字符中的第一个字符，在字符串中搜索该字符。在字符串中找到第一个匹配后，函数将字符串分为两段，返回两段字符串。右键单击函数，从菜单中选择匹配单个字符，可启用匹配单个字符选项。

    例如，当你为 string 指定 Test string，为 search string/char 指定 str 时，函数将根据是否启用 Match Single Character 选项返回不同的结果字符串。下表列出了不同的结果。

    匹配单个字符启用 匹配单个字符禁用
    匹配之前的子字符串 Test Te
    匹配+剩余字符串 string st string