Merge pull request #246066 from seesharprun/cosmos-populate-nosql-9

Cosmos DB | Add NoSQL query functions #11

Author: AnnaMHuff

articles/cosmos-db/nosql/query/stringtoarray.md

@@ -1,95 +1,58 @@
 ---
-title: StringToArray in Azure Cosmos DB query language
-description: Learn about SQL system function StringToArray in Azure Cosmos DB.
-author: ginamr
+title: StringToArray
+titleSuffix: Azure Cosmos DB for NoSQL
+description: An Azure Cosmos DB for NoSQL system function that returns a string expression converted to an array.
+author: jcodella
+ms.author: jacodel
+ms.reviewer: sidandrews
 ms.service: cosmos-db
 ms.subservice: nosql
-ms.topic: conceptual
-ms.date: 03/03/2020
-ms.author: girobins
-ms.custom: query-reference, ignite-2022
+ms.topic: reference
+ms.date: 07/24/2023
+ms.custom: query-reference
 ---
-# StringToArray (Azure Cosmos DB)
+
+# StringToArray (NoSQL query)
+
 [!INCLUDE[NoSQL](../../includes/appliesto-nosql.md)]
 
- Returns expression translated to an Array. If expression can't be translated, returns undefined.  
-  
+Converts a string expression to an array.
+
 ## Syntax
-  
+
 ```sql  
-StringToArray(<str_expr>)  
-```  
-  
-## Arguments
-  
-*str_expr*  
-   Is a string expression to be parsed as a JSON Array expression. 
-  
-## Return types
-  
-  Returns an array expression or undefined. 
-  
-## Remarks
-  Nested string values must be written with double quotes to be valid JSON. For details on the JSON format, see [json.org](https://json.org/). This system function won't utilize the index.
-  
-## Examples
-  
-  The following example shows how `StringToArray` behaves across different types. 
-  
- The following are examples with valid input.
-
-```sql
-SELECT 
-    StringToArray('[]') AS a1, 
-    StringToArray("[1,2,3]") AS a2,
-    StringToArray("[\"str\",2,3]") AS a3,
-    StringToArray('[["5","6","7"],["8"],["9"]]') AS a4,
-    StringToArray('[1,2,3, "[4,5,6]",[7,8]]') AS a5
+StringToArray(<string_expr>)  
 ```
 
-Here's the result set.
+## Arguments
 
-```json
-[{"a1": [], "a2": [1,2,3], "a3": ["str",2,3], "a4": [["5","6","7"],["8"],["9"]], "a5": [1,2,3,"[4,5,6]",[7,8]]}]
-```
+| | Description |
+| --- | --- |
+| **`string_expr`** | A string expression. |
 
-The following examples illustrate invalid input:
-   
-- Single quotes within the array aren't valid JSON.
-- Even though they're valid within a query, they won't parse to valid arrays. 
-- Strings within the array string must either be escaped "[\\"\\"]" or the surrounding quote must be single '[""]'.
+## Return types
 
-```sql
-SELECT
-    StringToArray("['5','6','7']")
-```
+Returns an array.
 
-Here's the result set.
+## Examples
+  
+The following example illustrates how this function works with various inputs.
 
-```json
-[{}]
-```
+:::code language="sql" source="~/cosmos-db-nosql-query-samples/scripts/stringtoarray/query.sql" highlight="2-8":::
 
-The following are examples of invalid input.
-   
- The expression passed will be parsed as a JSON array; the following don't evaluate to type array and thus return undefined.
-   
-```sql
-SELECT
-    StringToArray("["),
-    StringToArray("1"),
-    StringToArray(NaN),
-    StringToArray(false),
-    StringToArray(undefined)
-```
+:::code language="json" source="~/cosmos-db-nosql-query-samples/scripts/stringtoarray/result.json":::
 
-Here's the result set.
+## Remarks
 
-```json
-[{}]
-```
+- This function doesn't use the index.
+- If the expression can't be converted, the function returns `undefined`.
+- Nested string values must be written with double quotes to be valid.
+- Single quotes within the array aren't valid JSON. Even though single quotes are valid within a query, they don't parse to valid arrays. Strings within the array string must either be escaped `\"` or the surrounding quote must be a single quote.
+
+> [!NOTE]
+> For more information on the JSON format, see [https://json.org](https://json.org/).
 
 ## Next steps
 
 - [System functions Azure Cosmos DB](system-functions.yml)
-- [Introduction to Azure Cosmos DB](../../introduction.md)
+- [`StringToObject`](stringtoobject.md)

articles/cosmos-db/nosql/query/stringtoboolean.md

@@ -1,93 +1,56 @@
 ---
-title: StringToBoolean in Azure Cosmos DB query language
-description: Learn about SQL system function StringToBoolean in Azure Cosmos DB.
-author: ginamr
+title: StringToBoolean
+titleSuffix: Azure Cosmos DB for NoSQL
+description: An Azure Cosmos DB for NoSQL system function that returns a string expression converted to a boolean.
+author: jcodella
+ms.author: jacodel
+ms.reviewer: sidandrews
 ms.service: cosmos-db
 ms.subservice: nosql
-ms.topic: conceptual
-ms.date: 03/03/2020
-ms.author: girobins
-ms.custom: query-reference, ignite-2022
+ms.topic: reference
+ms.date: 07/24/2023
+ms.custom: query-reference
 ---
-# StringToBoolean (Azure Cosmos DB)
+
+# StringToBoolean (NoSQL query)
+
 [!INCLUDE[NoSQL](../../includes/appliesto-nosql.md)]
 
- Returns expression translated to a Boolean. If expression can't be translated, returns undefined.  
+Converts a string expression to a boolean.
 
 ## Syntax
 
 ```sql
-StringToBoolean(<str_expr>)  
-```  
-  
-## Arguments
-  
-*str_expr*  
-   Is a string expression to be parsed as a Boolean expression.  
-  
-## Return types
-  
-  Returns a Boolean expression or undefined.  
-  
-## Examples
-  
-  The following example shows how `StringToBoolean` behaves across different types. 
- 
- The following are examples with valid input.
-
-Whitespace is allowed only before or after `true`/`false`.
-
-```sql
-SELECT 
-    StringToBoolean("true") AS b1, 
-    StringToBoolean("    false") AS b2,
-    StringToBoolean("false    ") AS b3
-```  
-  
- Here's the result set.  
-  
-```json
-[{"b1": true, "b2": false, "b3": false}]
+StringToBoolean(<string_expr>)  
 ```  
 
-The following are examples with invalid input.
+## Arguments
 
- Booleans are case sensitive and must be written with all lowercase characters such as `true` and `false`.
+| | Description |
+| --- | --- |
+| **`string_expr`** | A string expression. |
 
-```sql
-SELECT 
-    StringToBoolean("TRUE"),
-    StringToBoolean("False")
-```  
+## Return types
 
-Here's the result set.  
+Returns a boolean value.
 
-```json
-[{}]
-``` 
-
-The expression passed will be parsed as a Boolean expression; these inputs don't evaluate to type Boolean and thus return undefined.
+## Examples
+  
+The following example illustrates how this function works with various data types.
 
-```sql
-SELECT 
-    StringToBoolean("null"),
-    StringToBoolean(undefined),
-    StringToBoolean(NaN), 
-    StringToBoolean(false), 
-    StringToBoolean(true)
-```  
+:::code language="sql" source="~/cosmos-db-nosql-query-samples/scripts/stringtoboolean/query.sql" highlight="2-8":::
 
-Here's the result set.  
-  
-```json
-[{}]
-```  
+:::code language="json" source="~/cosmos-db-nosql-query-samples/scripts/stringtoboolean/result.json":::
 
 ## Remarks
 
-This system function won't utilize the index.
+- This function doesn't use the index.
+- If the expression can't be converted, the function returns `undefined`.
+
+> [!NOTE]
+> For more information on the JSON format, see [https://json.org](https://json.org/).
 
 ## Next steps
 
 - [System functions Azure Cosmos DB](system-functions.yml)
-- [Introduction to Azure Cosmos DB](../../introduction.md)
+- [`StringToNumber`](stringtonumber.md)

articles/cosmos-db/nosql/query/stringtonull.md

@@ -1,92 +1,56 @@
 ---
-title: StringToNull in Azure Cosmos DB query language
-description: Learn about SQL system function StringToNull in Azure Cosmos DB.
-author: ginamr
+title: StringToNull
+titleSuffix: Azure Cosmos DB for NoSQL
+description: An Azure Cosmos DB for NoSQL system function that returns a string expression converted to null.
+author: jcodella
+ms.author: jacodel
+ms.reviewer: sidandrews
 ms.service: cosmos-db
 ms.subservice: nosql
-ms.topic: conceptual
-ms.date: 03/03/2020
-ms.author: girobins
-ms.custom: query-reference, ignite-2022
+ms.topic: reference
+ms.date: 07/24/2023
+ms.custom: query-reference
 ---
-# StringToNull (Azure Cosmos DB)
+
+# StringToNull (NoSQL query)
+
 [!INCLUDE[NoSQL](../../includes/appliesto-nosql.md)]
 
- Returns expression translated to null. If expression can't be translated, returns undefined.  
+Converts a string expression to `null`.
 
 ## Syntax
-  
-```sql
-StringToNull(<str_expr>)  
-```  
-  
-## Arguments
-  
-*str_expr*  
-   Is a string expression to be parsed as a null expression.
-  
-## Return types
-  
-  Returns a null expression or undefined.  
-  
-## Examples
-  
-  The following example shows how `StringToNull` behaves across different types. 
 
-The following are examples with valid input.
+```sql
+StringToNull(<string_expr>)  
+```
 
- Whitespace is allowed only before or after "null".
+## Arguments
 
-```sql
-SELECT 
-    StringToNull("null") AS n1, 
-    StringToNull("  null ") AS n2,
-    IS_NULL(StringToNull("null   ")) AS n3
-```  
-  
- Here's the result set.  
-  
-```json
-[{"n1": null, "n2": null, "n3": true}]
-```  
+| | Description |
+| --- | --- |
+| **`string_expr`** | A string expression. |
 
-The following are examples with invalid input.
+## Return types
 
-Null is case sensitive and must be written with all lowercase characters such as `null`.
+Returns a `null`.
 
-```sql
-SELECT    
-    StringToNull("NULL"),
-    StringToNull("Null")
-```  
-  
- Here's the result set.  
+## Examples
 
-```json
-[{}]
-```  
+The following example illustrates how this function works with various data types.
 
-The expression passed will be parsed as a null expression; these inputs don't evaluate to type null and thus return undefined.
+:::code language="sql" source="~/cosmos-db-nosql-query-samples/scripts/stringtonull/query.sql" highlight="2-9":::
 
-```sql
-SELECT    
-    StringToNull("true"), 
-    StringToNull(false), 
-    StringToNull(undefined),
-    StringToNull(NaN) 
-```  
-  
- Here's the result set.  
-  
-```json
-[{}]
-```  
+:::code language="json" source="~/cosmos-db-nosql-query-samples/scripts/stringtonull/result.json":::
 
 ## Remarks
 
-This system function won't utilize the index.
+- This function doesn't use the index.
+- If the expression can't be converted, the function returns `undefined`.
+
+> [!NOTE]
+> For more information on the JSON format, see [https://json.org](https://json.org/).
 
 ## Next steps
 
 - [System functions Azure Cosmos DB](system-functions.yml)
-- [Introduction to Azure Cosmos DB](../../introduction.md)
+- [`StringToBoolean`](stringtoboolean.md)