字符串函数

String functions

本节内函数除toString()外主要参数都应为String类型,否则会返回一个错误

left()

left(original, length)

返回值:String

返回original自左起共length个字符,字符顺序不变

  • left(null, length)或 left(null, null)会返回null;
  • left(original, null)会返回一个错误;
  • length不是整数时会返回一个错误;
  • length比original的总长度还长时,返回original本身;

ltrim()

ltrim(original)

返回值:String

去除original中最左侧连续的空格后返回剩余内容

ltrim(null) 会返回null

replace()

replace(original, search, replace)

返回值:String

将original中的search子串替换为replace

  • 任何一个参数为null都会返回null;
  • 如果original中没有search子串,则会返回original本身;

reverse()

reverse(original)

返回值:String

将一个String中的字符反转顺序后的String返回

reverse(null)会返回null

right()

right(original,length)

返回值:String

返回original自右起共length个字符,字符顺序不变

  • right(null, length)或 left(null, null)会返回null;
  • right(original, null)会返回一个错误;
  • length不是整数时会返回一个错误;
  • length比original的总长度还长时,返回original本身;

rtrim()

rtrim(original)

返回值:String

去除original中最右侧连续的空格后返回剩余内容

rtrim(null) 会返回null

split()

split(original, splitDelimiter)

返回值:List

将original在splitDelimiter的位置上分割为多个String并按顺序构成一个List返回

  • splitDelimiter不会出现在返回的String中;
  • original或splitDelimiter是null则会返回null;

substring()

substring(original, start [, length])

返回值:String

将original截为自start起共length长的子串

  • start自0开始计数;
  • length缺省时默认截至末尾;
  • original为null时会返回null;
  • 如果start或length是null或负数,则会返回一个错误;
  • 如果length是0,则会返回original本身;

toLower()

toLower(original)

返回值:String

将original中的大写字母转为小写后返回

toLower(null) 会返回null

toString()

toString(expression)

返回值:String

将一个Integer/Float/String/Boolean/Point/Duration/Date/Time/Locatime/Localdatetime/Datetime类型的数据转为String类型后返回

  • expression为String时则返回其本身;
  • toString(null) 会返回null;
  • 无法转换时会返回一个错误,如expression是一个List的情况

toStringOrNull()

toStringOrNull(expression)

返回值:String

将一个Integer/Float/String/Boolean/Point/Duration/Date/Time/Locatime/Localdatetime/Datetime类型的数据转为String类型后返回

toString()无法转换的情况会返回null

toUpper()

toUpper(original)

返回值:String

将original中的小写字母转为大写字母后返回

toUpper(null) 会返回null;

trim()

trim(original)

返回值:String

将original前后连续的空格去除后返回

trim(null)会返回null