ARM/Bicep mapValue function

Author: mumian

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

@@ -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.
 
+## mapValue
+
+`mapValue(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 `mapValue` function.
+
+```bicep
+var newObject = mapValues({ foo: 'foo', bar: 'bar' }, val => toUpper(val)) 
+
+output mapObject object = newObject
+```
+
+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,8 +92,10 @@ 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#mapvalue)
 * [reduce](bicep-functions-lambda.md#reduce)
 * [sort](bicep-functions-lambda.md#sort)
+* [toObject](bicep-functions-lambda.md#toobject)
 
 ## Logical functions
 

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

@@ -227,6 +227,54 @@ 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.
 
+## mapValue
+
+`mapValue(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 `mapValue` function.
+
+```bicep
+{
+  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
+  "contentVersion": "1.0.0.0",
+  "variables": {
+    "newObject": "[mapValues(createObject('foo', 'foo', 'bar', 'bar'), lambda('val', toUpper(lambdaVariables('val'))))]"
+  },
+  "resources": [],
+  "outputs": {
+    "mapObject": {
+      "type": "object",
+      "value": "[variables('newObject')]"
+    }
+  }
+}
+```
+
+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

@@ -121,6 +121,19 @@ For Bicep files, use the [deployment](../bicep/bicep-functions-deployment.md) fu
 <a id="not" aria-hidden="true"></a>
 <a id="or" aria-hidden="true"></a>
 
+## Lambda functions
+
+The following functions are available for working with lambda expressions: 
+
+* [filter](template-functions-lambda.md#filter)
+* [map](template-functions-lambda.md#map)
+* [mapValue](template-functions-lambda.md#mapvalue)
+* [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-lamda.md) functions.
+
 ## Logical functions
 
 Resource Manager provides the following functions for working with logical conditions: