该 LEFT 函数返回字符串的左侧部分,最多返回指定的字符数。
一个 Azure Cosmos DB for NoSQL 系统函数,该函数从字符串左侧返回子字符串。
Syntax
LEFT(<string_expr>, <numeric_expr>)
Arguments
| Description | |
|---|---|
string_expr |
字符串表达式。 |
numeric_expr |
一个数值表达式,指定要从中提取 string_expr的字符数。 |
返回类型
返回字符串表达式。
例子
本部分包含有关如何使用此查询语言构造的示例。
获取字符串的左侧部分
在此示例中,函数 LEFT 用于返回字符串 AdventureWorks 的左侧部分以获取各种长度值。
SELECT VALUE {
firstZero: LEFT("AdventureWorks", 0),
firstOne: LEFT("AdventureWorks", 1),
firstFive: LEFT("AdventureWorks", 5),
fullLength: LEFT("AdventureWorks", LENGTH("AdventureWorks")),
beyondMaxLength: LEFT("AdventureWorks", 100)
}
[
{
"firstZero": "",
"firstOne": "A",
"firstFive": "Adven",
"fullLength": "AdventureWorks",
"beyondMaxLength": "AdventureWorks"
}
]
注解
- 此函数受益于范围索引的使用。 有关详细信息,请参阅 范围索引。