Funções lambda para Bicep

Artigo
05/29/2024

Este artigo descreve as funções lambda a serem usadas no Bicep. Expressões lambda (ou funções lambda) são essencialmente blocos de código que podem ser passados como um argumento. Eles podem usar vários parâmetros, mas são restritos a uma única linha de código. No Bicep, a expressão lambda está neste formato:

<lambda variable> => <expression>

Observação

As funções lambda só têm suporte na CLI do Bicep versão 0.10.X ou superior.

Limitações

A função lambda do Bicep tem estas limitações:

A expressão lambda só pode ser especificada diretamente como argumentos de função nestas funções: filter(), groupBy(), map(), mapValues(), reduce(), sort()e toObject().
No momento, não há suporte para o uso de variáveis lambda (as variáveis temporárias usadas nas expressões lambda) no acesso à matriz de recursos ou módulos.
No momento, não há suporte para o uso de variáveis lambda dentro da função listKeys.
Não há suporte para o uso de variáveis lambda dentro da função de referência no momento.

filter

filter(inputArray, lambda expression)

Filtra uma matriz com uma função de filtragem personalizada.

Namespace: sys.

Parâmetros

Parâmetro	Obrigatório	Type	Descrição
inputArray	Sim	matriz	A matriz a filtrar.
expressão lambda	Sim	expressão	A expressão lambda é aplicada a cada elemento de matriz de entrada. Se o resultado for true, o item será incluído na matriz de saída; caso contrário, o item será descartado.

Valor retornado

Uma matriz .

Exemplos

Os exemplos a seguir mostram como usar a função filter.

var dogs = [
  {
    name: 'Evie'
    age: 5
    interests: ['Ball', 'Frisbee']
  }
  {
    name: 'Casper'
    age: 3
    interests: ['Other dogs']
  }
  {
    name: 'Indy'
    age: 2
    interests: ['Butter']
  }
  {
    name: 'Cira'
    age: 8
    interests: ['Rubs']
  }
]

output oldDogs array = filter(dogs, dog => dog.age >=5)
output dogNameIndex array = filter(dogs, (val, i) => i < 2 && substring(val.name, 0, 1) == 'C')

As saídas do exemplo anterior:

Nome	Tipo	Valor
oldDogs	Array	[{"name":"Evie","age":5,"interests":["Ball","Frisbee"]},{"name":"Kira","age":8,"interests":["Rubs"]}]
dogNameIndex	Array	[{"nome":"Casper","idade":3,"interesses":["Outros cães"]}]

oldDogs lista os cães que têm cinco anos ou mais; dogNameIndex identifica os cães cujo número de índice é menor que dois e cujo nome começa com a letra "C".

var itemForLoop = [for item in range(0, 10): item]

output filteredLoop array = filter(itemForLoop, i => i > 5)
output isEven array = filter(range(0, 10), i => 0 == i % 2)

As saídas do exemplo anterior:

Nome	Tipo	Valor
filteredLoop	Array	[6, 7, 8, 9]
isEven	Array	[0, 2, 4, 6, 8]

filterdLoop mostra os números em uma matriz que são maiores que 5 e isEven mostra os números pares na matriz.

groupBy

groupBy(inputArray, lambda expression)

Criar um objeto com valores de matriz a partir de uma matriz, usando uma condição de agrupamento.

Namespace: sys.

Parâmetros

Parâmetro	Obrigatório	Type	Descrição
inputArray	Sim	matriz	A matriz para agrupamento.
expressão lambda	Sim	expressão	A expressão lambda é aplicada a cada elemento de matriz de entrada e agrupa os elementos usando a condição de agrupamento.

Valor retornado

Um objeto .

Exemplos

O exemplo a seguir mostra como usar a função groupBy.

var inputArray = ['foo', 'bar', 'baz']

output outObject object = groupBy(inputArray, x => substring(x, 0, 1))

A saída do exemplo anterior é:

Nome	Tipo	Valor
outObject	Objeto	{"f":["foo"],"b":["bar","baz"]}

outObject mostra um objeto que agrupa os elementos da matriz por suas primeiras letras.

map

map(inputArray, lambda expression)

Aplica uma função de mapeamento personalizada a cada elemento de uma matriz.

Namespace: sys.

Parâmetros

Parâmetro	Obrigatório	Type	Descrição
inputArray	Sim	matriz	A matriz a ser mapeada.
expressão lambda	Sim	expressão	A expressão lambda aplicada a cada elemento de matriz de entrada, a fim de gerar a matriz de saída.

Retornar valor

Uma matriz .

Exemplo

O exemplo a seguir mostra como usar a função map.

var dogs = [
  {
    name: 'Evie'
    age: 5
    interests: ['Ball', 'Frisbee']
  }
  {
    name: 'Casper'
    age: 3
    interests: ['Other dogs']
  }
  {
    name: 'Indy'
    age: 2
    interests: ['Butter']
  }
  {
    name: 'Kira'
    age: 8
    interests: ['Rubs']
  }
]

output dogNames array = map(dogs, dog => dog.name)
output sayHi array = map(dogs, dog => 'Hello ${dog.name}!')
output mapArray array = map(range(0, length(dogs)), i => {
  i: i
  dog: dogs[i].name
  greeting: 'Ahoy, ${dogs[i].name}!'
})
output mapArrayIndex array = map(dogs, (x, i) => { index: i, val: x.name})

As saídas do exemplo anterior são:

Nome	Tipo	Valor
dogNames	Array	["Evie","Casper","Indy","Kira"]
sayHi	Array	["Hello Evie!","Hello Casper!","Hello Indy!","Hello Kira!"]
mapArray	Array	[{"i":0,"dog":"Evie","greeting":"Ahoy, Evie!"},{"i":1,"dog":"Casper","greeting":"Ahoy, Casper!"},{"i":2,"dog":"Indy","greeting":"Ahoy, Indy!"},{"i":3,"dog":"Kira","greeting":"Ahoy, Kira!"}]
mapArrayIndex	Array	[{"index":0,"val":"Evie"},{"index":1,"val":"Casper"},{"index":2,"val":"Indy"},{"index":3,"val":"Kira"}]

dogNames mostra os nomes dos cães da matriz de objetos; sayHi concatena "Olá" e cada um dos nomes dos cães; mapArray e mapArrayIndex criam outras duas matrizes de objetos.

mapValues

mapValues(inputObject, lambda expression)

Cria um objeto a partir de um objeto de entrada usando uma expressão lambda para mapear valores.

Namespace: sys.

Parâmetros

Parâmetro	Obrigatório	Type	Descrição
inputObject	Yes	objeto	O objeto a ser mapeado.
expressão lambda	Sim	expressão	A expressão lambda usada para mapear os valores.

Valor retornado

Um objeto.

Exemplo

O exemplo a seguir mostra como usar a função mapValues.

var inputObject = { foo: 'foo', bar: 'bar' }

output mapObject object = mapValues(inputObject, val => toUpper(val))

O resultado do exemplo anterior é:

Nome	Tipo	Valor
mapObject	Objeto	{foo: 'FOO', bar: 'BAR'}

mapObject cria outro objeto com os valores em letras maiúsculas.

reduce

reduce(inputArray, initialValue, lambda expression)

Reduz uma matriz com uma função de redução personalizada.

Namespace: sys.

Parâmetros

Parâmetro	Obrigatório	Type	Descrição
inputArray	Sim	matriz	A matriz a ser reduzida.
initialValue	Sim	any	Valor inicial.
expressão lambda	Sim	expressão	A expressão lambda usada para agregar o valor atual e o próximo valor.

Retornar valor

Qualquer um.

Exemplo

Os exemplos a seguir mostram como usar a função reduce.

var dogs = [
  {
    name: 'Evie'
    age: 5
    interests: ['Ball', 'Frisbee']
  }
  {
    name: 'Casper'
    age: 3
    interests: ['Other dogs']
  }
  {
    name: 'Indy'
    age: 2
    interests: ['Butter']
  }
  {
    name: 'Kira'
    age: 8
    interests: ['Rubs']
  }
]
var ages = map(dogs, dog => dog.age)
output totalAge int = reduce(ages, 0, (cur, next) => cur + next)
output totalAgeAdd1 int = reduce(ages, 1, (cur, next) => cur + next)
output oddAge int = reduce(ages, 0, (cur, next, i) => (i % 2 == 0) ? cur + next : cur)

As saídas do exemplo anterior são:

Nome	Tipo	Valor
totalAge	INT	18
totalAgeAdd1	INT	19
Idade ímpar	int	7

totalAge soma as idades dos cães; totalAgeAdd1 tem um valor inicial de 1 e adiciona todas as idades dos cães aos valores iniciais. oddAge soma as idades dos cães que estão localizados em índices pares, especificamente 5 (Evie) e 2 (Indy).

output reduceObjectUnion object = reduce([
  { foo: 123 }
  { bar: 456 }
  { baz: 789 }
], {}, (cur, next) => union(cur, next))

O resultado do exemplo anterior é:

Nome	Tipo	Valor
reduceObjectUnion	objeto	{"foo":123,"bar":456,"baz":789}

A função união retorna um único objeto com todos os elementos dos parâmetros. A chamada de função sindicaliza os pares de valor de chave dos objetos em um novo objeto.

sort

sort(inputArray, lambda expression)

Classifica uma matriz com uma função de classificação personalizada.

Namespace: sys.

Parâmetros

Parâmetro	Obrigatório	Type	Descrição
inputArray	Sim	matriz	A matriz a ser classificada.
expressão lambda	Sim	expressão	A expressão lambda usada para comparar dois elementos de matriz para ordenação. Se for true, o segundo elemento será ordenado após o primeiro na matriz de saída.

Retornar valor

Uma matriz .

Exemplo

O exemplo a seguir mostra como usar a função sort.

var dogs = [
  {
    name: 'Evie'
    age: 5
    interests: ['Ball', 'Frisbee']
  }
  {
    name: 'Casper'
    age: 3
    interests: ['Other dogs']
  }
  {
    name: 'Indy'
    age: 2
    interests: ['Butter']
  }
  {
    name: 'Kira'
    age: 8
    interests: ['Rubs']
  }
]

output dogsByAge array = sort(dogs, (a, b) => a.age < b.age)

A saída do exemplo anterior classifica os objetos de cachorro dos mais jovens para os mais antigos:

Nome	Tipo	Valor
dogsByAge	Array	[{"name":"Indy","age":2,"interests":["Butter"]},{"name":"Casper","age":3,"interests":["Other dogs"]},{"name":"Evie","age":5,"interests":["Ball","Frisbee"]},{"name":"Kira","age":8,"interests":["Rubs"]}]

toObject

toObject(inputArray, lambda expression, [lambda expression])

Converte uma matriz em um objeto com uma função de chave personalizada e uma função de valor personalizado opcional. Confira os itens sobre a conversão de um objeto em uma matriz.

Namespace: sys.

Parâmetros

Parâmetro	Obrigatório	Type	Descrição
inputArray	Sim	matriz	A matriz usada para criar um objeto.
expressão lambda	Sim	expressão	A expressão lambda utilizada para fornecer o predicado da chave.
expressão lambda	Não	expressão	A expressão lambda utilizada para fornecer o predicado do valor.

Retornar valor

Um objeto.

Exemplo

O exemplo a seguir mostra como usar a função toObject com os dois parâmetros obrigatórios:

var dogs = [
  {
    name: 'Evie'
    age: 5
    interests: [ 'Ball', 'Frisbee' ]
  }
  {
    name: 'Casper'
    age: 3
    interests: [ 'Other dogs' ]
  }
  {
    name: 'Indy'
    age: 2
    interests: [ 'Butter' ]
  }
  {
    name: 'Kira'
    age: 8
    interests: [ 'Rubs' ]
  }
]

output dogsObject object = toObject(dogs, entry => entry.name)

O exemplo anterior gera um objeto com base numa matriz.

Nome	Tipo	Valor
dogsObject	Objeto	{"Evie":{"nome":"Evie","idade":5,"interesses":["Bola","Frisbee"]},"Casper":{"nome":"Casper","idade":3,"interesses":["Outros cães"]},"Indy":{"nome":"Indy","idade":2,"interesses":["Borboleta"]},"Kira":{"nome":"Kira","idade":8,"interesses":["Borrachas"]}}

A seguinte função toObject com o terceiro parâmetro fornece a mesma saída.

output dogsObject object = toObject(dogs, entry => entry.name, entry => entry)

O exemplo a seguir mostra como usar a função toObject com três parâmetros.

var dogs = [
  {
    name: 'Evie'
    properties: {
      age: 5
      interests: [ 'Ball', 'Frisbee' ]
    }
  }
  {
    name: 'Casper'
    properties: {
      age: 3
      interests: [ 'Other dogs' ]
    }
  }
  {
    name: 'Indy'
    properties: {
      age: 2
      interests: [ 'Butter' ]
    }
  }
  {
    name: 'Kira'
    properties: {
      age: 8
      interests: [ 'Rubs' ]
    }
  }
]
output dogsObject object = toObject(dogs, entry => entry.name, entry => entry.properties)

O exemplo anterior gera um objeto com base numa matriz.

Nome	Tipo	Valor
dogsObject	Objeto	{"Evie":{"idade":5,"interesses":["Bola","Frisbee"]},"Casper":{"idade":3,"interesses":["Outros cães"]},"Indy":{"idade":2,"interesses":["Borboleta"]},"Kira":{"idade":8,"interesses":["Borrachas"]}}

Próximas etapas

Consulte Funções Bicep - matrizes para obter mais funções Bicep relacionadas a array.

Compartilhar via

Funções lambda para Bicep

Limitações

filter

Parâmetros

Valor retornado

Exemplos

groupBy

Parâmetros

Valor retornado

Exemplos

map

Parâmetros

Retornar valor

Exemplo

mapValues

Parâmetros

Valor retornado

Exemplo

reduce

Parâmetros

Retornar valor

Exemplo

sort

Parâmetros

Retornar valor

Exemplo

toObject

Parâmetros

Retornar valor

Exemplo

Próximas etapas

Comentários

Recursos adicionais