SUBSTRING (NoSQL クエリ)
適用対象: NoSQL
指定された位置で始まり、指定された長さまたは文字列の末尾までの文字列式の一部を返します。
構文
SUBSTRING(<string_expr>, <numeric_expr_1>, <numeric_expr_2>)
引数
説明 | |
---|---|
string_expr |
文字列式。 |
numeric_expr_1 |
開始文字を示す数値式です。 |
numeric_expr_2 |
返される string_expr の最大文字数を示す数値式です。 |
戻り値の型
文字列式を返します。
例
次の例では、さまざまな長さと開始位置を持つ部分文字列を返します。
SELECT VALUE {
substringPrefix: SUBSTRING("AdventureWorks", 0, 9),
substringSuffix: SUBSTRING("AdventureWorks", 9, 5),
substringTotalLength: SUBSTRING("AdventureWorks", 0, LENGTH("AdventureWorks")),
substringEmptyString: SUBSTRING("AdventureWorks", 0, -1)
}
[
{
"substringPrefix": "Adventure",
"substringSuffix": "Works",
"substringTotalLength": "AdventureWorks",
"substringEmptyString": ""
}
]
注釈
- 開始位置が
0
の場合、この関数は、範囲インデックスの恩恵を受けます。 numeric_expr_1
位置は 0 ベースであるため、0
の値はstring_expr
の最初の文字から始まります。0
の値、または値がnumeric_expr_2
以下の場合は、空の文字列になります。