Add TRIM

Author: seesharprun

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

@@ -1,70 +1,53 @@
 ---
-title: TRIM in Azure Cosmos DB query language
-description: Learn about SQL system function TRIM in Azure Cosmos DB.
-author: ginamr
+title: TRIM
+titleSuffix: Azure Cosmos DB for NoSQL
+description: An Azure Cosmos DB for NoSQL system function that returns a string with leading or trailing whitespace trimmed.
+author: jcodella
+ms.author: jacodel
+ms.reviewer: sidandrews
 ms.service: cosmos-db
 ms.subservice: nosql
-ms.topic: conceptual
-ms.date: 09/14/2021
-ms.author: girobins
-ms.custom: query-reference, ignite-2022
+ms.topic: reference
+ms.date: 07/24/2023
+ms.custom: query-reference
 ---
-# TRIM (Azure Cosmos DB)
+
+# TRIM (NoSQL query)
+
 [!INCLUDE[NoSQL](../../includes/appliesto-nosql.md)]
 
-Returns a string expression after it removes leading and trailing whitespace or specified characters.  
-  
+Returns a string expression after it removes leading and trailing whitespace or custom characters.  
+
 ## Syntax
-  
+
 ```sql
-TRIM(<str_expr1>[, <str_expr2>])  
-```  
-  
+TRIM(<string_expr_1> [, <string_expr_2>])
+```
+
 ## Arguments
-  
-*str_expr1*  
-   Is a string expression
 
-*str_expr2*  
-   Is an optional string expression to be trimmed from str_expr1. If not set, the default is whitespace.
+| | Description |
+| --- | --- |
+| **`string_expr_1`** | A string expression. |
+| **`string_expr_2` *(Optional)*** | An optional string expression with a string to trim from `string_expr_1`. If not specified, the default is to trim whitespace. |
 
 ## Return types
-  
-  Returns a string expression.  
-  
+
+Returns a string expression.
+
 ## Examples
-  
-  The following example shows how to use `TRIM` inside a query.  
-  
-```sql
-SELECT TRIM("   abc") AS t1, 
-TRIM("   abc   ") AS t2, 
-TRIM("abc   ") AS t3, 
-TRIM("abc") AS t4,
-TRIM("abc", "ab") AS t5,
-TRIM("abc", "abc") AS t6
-```  
-  
- Here is the result set.  
-  
-```json
-[
-    {
-        "t1": "abc",
-        "t2": "abc",
-        "t3": "abc",
-        "t4": "abc",
-        "t5": "c",
-        "t6": ""
-    }
-]
-``` 
+
+This example illustrates various ways to trim a string expression.
+
+:::code language="sql" source="~/cosmos-db-nosql-query-samples/scripts/trim/query.sql" highlight="2-9":::
+
+:::code language="json" source="~/cosmos-db-nosql-query-samples/scripts/trim/result.json":::
 
 ## Remarks
 
-This system function will not utilize the index.
+- This function doesn't use the index.
 
 ## Next steps
 
 - [System functions Azure Cosmos DB](system-functions.yml)
-- [Introduction to Azure Cosmos DB](../../introduction.md)
+- [`TRUNC`](trunc.md)