文字列関数

substr は、string から文字位置 position で開始する length 文字を返します。length を省略した場合、length = len(string) になるため、position から文字列の末尾までのすべての文字が返されます。いずれかのパラメータが null の場合、関数は null を返します。

string の最初の文字の位置は 1 です。position が負の場合、位置は文字列の末尾に対する相対位置になります。したがって、-1 のposition は最後の文字を示します。

length が負の場合、関数は null を返します。position > len (string)、position < -len(string)、または position = 0 の場合、空の文字列が返されます。

1substr("CRM", 1, 1) == "C"
2substr("CRM", 1, 2) == "CR"
3substr("CRM", -1, 1) == "M"
4substr("CRM", -2, 2) == "RM"
5substr("CRM", 4, 1) == ""

len は、string の長さを文字数で返します。string が null の場合、len(string) も null になります。

先頭および末尾の空白文字は、返される長さに含まれます。

1len("starfox") == 7
2len(" rocket ") == 8
3len("謝") == 1
4len("") == 0

ltrim は、chars に含まれない文字の最初の位置より左側を削除した string の値を返します。

chars には複数の文字を含めることができます。chars を省略した場合、先頭の空白文字が削除されます。string または chars が null の場合、結果は null になります。

1ltrim("__c__val__", "_") == "c__val__"
2ltrim(string, " \t\r") == ltrim(string)
3ltrim("aabcd", "ab") == "cd"

rtrim は、chars に含まれない文字の最後の位置より右側を削除した string の値を返します。

chars には複数の文字を含めることができます。chars を省略した場合、末尾の空白文字が削除されます。string または chars が null の場合、結果は null になります。

1rtrim("__c__val__", "_") == "__c__val"
2rtrim(ltrim(string, " \t\r"),  " \t\r") == trim(string,  " \t\r")

trim は、chars に含まれない文字の最初と最後の位置より外側を削除した string の値を返します。

chars には複数の文字を含めることができます。chars を省略した場合、先頭と末尾の空白文字が削除されます。string または chars が null の場合、結果は null になります。

1trim("__c__val__", "_") == "c__val"
2trim("__c__val__", "_c") == "val"
3trim("   c__val   ") == "c__val"
4trim("   c__val   ") == ltrim(rtrim("   c__val   "))
5trim("aaaaaa", "a") == ""

この関数は、string のすべての文字を大文字にして返します。string が null の場合、結果は null になります。

1upper("go") == "GO"
2upper ("große") == "GROßE"

この関数は、string のすべての文字を小文字にして返します。string が null の場合、結果は null になります。Unicode の大文字と小文字の対応関係に関する upper() のメモを参照してください。

1lower("JAVA") == "java"