Merge pull request #274984 from mumian/0509-function-mapvalue

ARM/Bicep mapValues function

Author: v-regandowner

articles/azure-resource-manager/bicep/bicep-functions-lambda.md

@@ -3,7 +3,7 @@ title: Bicep functions - lambda
 description: Describes the lambda functions to use in a Bicep file.
 ms.topic: conceptual
 ms.custom: devx-track-bicep
-ms.date: 01/25/2024
+ms.date: 05/13/2024
 ---
 # Lambda functions for Bicep
 
@@ -163,6 +163,43 @@ The output from the preceding example is:
 
 **dogNames** shows the dog names from the array of objects; **sayHi** concatenates "Hello" and each of the dog names; and **mapObject** creates another array of objects.
 
+## mapValues
+
+`mapValues(inputObject, lambda expression)`
+
+Creates an object from an input object, using a lambda expression to map values.
+
+Namespace: [sys](bicep-functions.md#namespaces-for-functions).
+
+### Parameters
+
+| Parameter | Required | Type | Description |
+|:--- |:--- |:--- |:--- |
+| inputObject |Yes |object |The object to map.|
+| lambda expression |Yes |expression |The lambda expression used to map the values.|
+
+### Return value
+
+An object.
+
+### Example
+
+The following example shows how to use the `mapValues` function.
+
+```bicep
+var inputObject = { foo: 'foo', bar: 'bar' }
+
+output mapObject object = mapValues(inputObject, val => toUpper(val)) 
+```
+
+The output from the preceding example is:
+
+| Name | Type | Value |
+| ---- | ---- | ----- |
+| mapObject | Object | {foo: 'FOO', bar: 'BAR'} |
+
+**mapObject** creates another object with the values in upper case.
+
 ## reduce
 
 `reduce(inputArray, initialValue, lambda expression)`

articles/azure-resource-manager/bicep/bicep-functions.md

@@ -92,6 +92,7 @@ The following functions are available for working with lambda expressions. All o
 
 * [filter](bicep-functions-lambda.md#filter)
 * [map](bicep-functions-lambda.md#map)
+* [mapValue](bicep-functions-lambda.md#mapvalues)
 * [reduce](bicep-functions-lambda.md#reduce)
 * [sort](bicep-functions-lambda.md#sort)
 * [toObject](bicep-functions-lambda.md#toobject)

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

@@ -3,7 +3,7 @@ title: Template functions - lambda
 description: Describes the lambda functions to use in an Azure Resource Manager template (ARM template)
 ms.topic: conceptual
 ms.custom: devx-track-arm-template
-ms.date: 01/25/2024
+ms.date: 05/13/2024
 ---
 
 # Lambda functions for ARM templates
@@ -227,6 +227,57 @@ The output from the preceding example is:
 
 **dogNames** shows the dog names from the array of objects; **sayHi** concatenates "Hello" and each of the dog names; and **mapObject** creates another array of objects.
 
+## mapValues
+
+`mapValues(inputObject, lambda expression)`
+
+Creates an object from an input object, using a lambda expression to map values.
+
+In Bicep, use the [mapValues](../bicep/bicep-functions-lambda.md#mapvalues) function.
+
+### Parameters
+
+| Parameter | Required | Type | Description |
+|:--- |:--- |:--- |:--- |
+| inputObject |Yes |object |The object to map.|
+| lambda expression |Yes |expression |The lambda expression used to map the values.|
+
+### Return value
+
+An object.
+
+### Example
+
+The following example shows how to use the `mapValues` function.
+
+```json
+{
+  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
+  "contentVersion": "1.0.0.0",
+  "variables": {
+    "inputObject": {
+      "foo": "foo",
+      "bar": "bar"
+    }
+  },
+  "resources": [],
+  "outputs": {
+    "mapObject": {
+      "type": "object",
+      "value": "[mapValues(variables('inputObject'), lambda('val', toUpper(lambdaVariables('val'))))]"
+    }
+  }
+}
+```
+
+The output from the preceding example is:
+
+| Name | Type | Value |
+| ---- | ---- | ----- |
+| mapObject | Object | {foo: 'FOO', bar: 'BAR'} |
+
+**mapObject** creates another object with the values in upper case.
+
 ## reduce
 
 `reduce(inputArray, initialValue, lambda function)`

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

@@ -131,6 +131,7 @@ For Bicep files, use the [deployment](../bicep/bicep-functions-deployment.md) fu
 
 <a id="filter" aria-hidden="true"></a>
 <a id="map" aria-hidden="true"></a>
+<a id="mapValues" aria-hidden="true"></a>
 <a id="reduce" aria-hidden="true"></a>
 <a id="sort" aria-hidden="true"></a>
 <a id="toObject" aria-hidden="true"></a>
@@ -141,10 +142,13 @@ Resource Manager provides the following functions for working with lambda expres
 
 * [filter](template-functions-lambda.md#filter)
 * [map](template-functions-lambda.md#map)
+* [mapValues](template-functions-lambda.md#mapvalues)
 * [reduce](template-functions-lambda.md#reduce)
 * [sort](template-functions-lambda.md#sort)
 * [toObject](template-functions-lambda.md#toobject)
 
+For Bicep files, use the [lambda](../bicep/bicep-functions-lambda.md) functions.
+
 <a id="and" aria-hidden="true"></a>
 <a id="bool" aria-hidden="true"></a>
 <a id="false" aria-hidden="true"></a>