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 以下の場合は、空の文字列になります。