Add tryGet to object function article

Author: mumian

articles/azure-resource-manager/templates/template-functions-array.md

@@ -748,16 +748,16 @@ The output from the preceding example with the default values is:
 
 `tryGet(sourceArray, keyOrIndex)`
 
-`tryGet` helps you avoid deployment failures when trying to access a non-existent property or index in an object or array. If the specified key or index does not exist, `tryGet` returns null instead of throwing an error. You might need to use the function in conjunction with [nullable types](./data-types.md#nullable-types).
+`tryGet` helps you avoid deployment failures when trying to access a non-existent property or index in an object or array. If the specified key or index does not exist, `tryGet` returns null instead of throwing an error. 
 
 In Bicep, use the [safe-dereference](../bicep/operator-safe-dereference.md#safe-dereference) operator.
 
 ### Parameters
 
 | Parameter | Required | Type | Description |
 |:--- |:--- |:--- |:--- |
-| sourceArray |Yes |array, object |The value to check if it's empty. |
-| keyOrIndex |Yes |string, int |The key or index to retrieve from the array or object. A property name for objects or index for arrays.|
+| sourceArray |Yes |array, object |An object or array to look into. |
+| keyOrIndex |Yes |string, int |A key or index to retrieve from the array or object. A property name for objects or index for arrays.|
 
 ### Return value
 

articles/azure-resource-manager/templates/template-functions-object.md

@@ -3,7 +3,7 @@ title: Template functions - objects
 description: Describes the functions to use in an Azure Resource Manager template (ARM template) for working with objects.
 ms.topic: reference
 ms.custom: devx-track-arm-template
-ms.date: 02/12/2025
+ms.date: 07/10/2025
 ---
 
 # Object functions for ARM templates
@@ -540,6 +540,73 @@ The output from the preceding example with the default values is:
 
 **secondOutput** shows the shallow merge doesn't recursively merge these nested objects. Instead, the entire nested object is replaced by the corresponding property from the merging object.
 
+## tryGet
+
+`tryGet(sourceArray, keyOrIndex)`
+
+`tryGet` helps you avoid deployment failures when trying to access a non-existent property or index in an object or array. If the specified key or index doesn't exist, `tryGet` returns null instead of throwing an error. 
+
+In Bicep, use the [safe-dereference](../bicep/operator-safe-dereference.md#safe-dereference) operator.
+
+### Parameters
+
+| Parameter | Required | Type | Description |
+|:--- |:--- |:--- |:--- |
+| sourceArray |Yes |array, object |An object or array to look into. |
+| keyOrIndex |Yes |string, int |A key or index to retrieve from the array or object. A property name for objects or index for arrays.|
+
+### Return value
+
+Returns the value at the key/index if it exists. Returns null if the key/index is missing or out of bounds.
+
+### Example
+
+The following example checks whether an array, object, and string are empty.
+
+```json
+{
+  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
+  "languageVersion": "2.0",
+  "contentVersion": "1.0.0.0",
+  "variables": {
+    "users": {
+      "name": "John Doe",
+      "age": 30
+    },
+    "colors": [
+      "red",
+      "green"
+    ]
+  },
+  "resources": [],
+  "outputs": {
+    "region": {
+      "type": "string",
+      "nullable": true,
+      "value": "[tryGet(variables('users'), 'region')]"
+    },
+    "name": {
+      "type": "string",
+      "nullable": true,
+      "value": "[tryGet(variables('users'), 'name')]"
+    },
+    "firstColor": {
+      "type": "string",
+      "nullable": true,
+      "value": "[tryGet(variables('colors'), 0)]"
+    }
+  }
+}
+```
+
+The output from the preceding example is:
+
+| Name | Type | Value |
+| ---- | ---- | ----- |
+| region | String | (NULL) |
+| name | String | John Doe |
+| firstColor | String | Red |
+
 ## union
 
 `union(arg1, arg2, arg3, ...)`

articles/azure-resource-manager/templates/template-functions.md

@@ -3,7 +3,7 @@ title: Template functions
 description: Describes the functions to use in an Azure Resource Manager template (ARM template) to retrieve values, work with strings and numerics, and retrieve deployment information.
 ms.topic: reference
 ms.custom: devx-track-arm-template
-ms.date: 07/07/2025
+ms.date: 07/10/2025
 ---
 
 # ARM template functions
@@ -64,6 +64,7 @@ Resource Manager provides several functions for working with arrays.
 * [range](template-functions-array.md#range)
 * [skip](template-functions-array.md#skip)
 * [take](template-functions-array.md#take)
+* [tryGet](template-functions-array.md#tryget)
 * [tryIndexFromEnd](template-functions-array.md#tryindexfromend)
 * [union](template-functions-array.md#union)
 
@@ -229,6 +230,7 @@ Resource Manager provides several functions for working with objects.
 * [null](template-functions-object.md#null)
 * [objectKeys](template-functions-object.md#objectkeys)
 * [shallowMerge](template-functions-object.md#shallowmerge)
+* [tryGet](template-functions-object.md#tryget)
 * [union](template-functions-object.md#union)
 
 For Bicep files, use the [object](../bicep/bicep-functions-object.md) functions.