你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

StringToArray（NoSQL 查询）

  • 项目

适用范围： NoSQL

将字符串表达式转换为数组。

语法

StringToArray(<string_expr>)

参数

说明
string_expr 一个字符串表达式。

返回类型

返回数组。

示例

以下示例演示了此函数如何处理各种输入。

SELECT VALUE {
    parseEmptyArray: StringToArray("[]"),
    parseArray: StringToArray('[ "coats", "gloves", "hats" ]'),
    complexArray: StringToArray('[ { "types": [ "coats", "gloves" ] }, [ "hats" ], 76, false, null ]'),
    nestedArray: StringToArray('[ [ "coats", "gloves" ], [ "hats" ] ]'),
    invalidArray: StringToArray("[ 'coats', 'gloves', 'hats' ]"),
    parseUndefined: StringToArray(undefined),
    parseNull: StringToArray(null)
}

[
  {
    "parseEmptyArray": [],
    "parseArray": [ "coats", "gloves", "hats" ],
    "complexArray": [
      {
        "types": [ "coats", "gloves" ]
      },
      [ "hats" ],
      76,
      false,
      null
    ],
    "nestedArray": [
      [ "coats", "gloves" ],
      [ "hats" ]
    ]
  }
]

注解

  • 此函数不使用索引。
  • 如果表达式无法转换，则函数将返回 undefined。
  • 嵌套字符串值必须用双引号编写才能有效。
  • 在数组中使用单引号不是有效的 JSON。 即使单引号在查询中有效，它们也不能解析为有效数组。 必须将数组字符串中的字符串转义为 \"，否则其引号必须为单引号。

注意

有关 JSON 格式的详细信息，请参阅 https://json.org。

相关内容