Lambda-funktioner för Bicep

  • Artikel

Den här artikeln beskriver lambda-funktionerna som ska användas i Bicep. Lambda-uttryck (eller lambda-funktioner) är i huvudsak kodblock som kan skickas som ett argument. De kan ta flera parametrar, men är begränsade till en enda kodrad. I Bicep är lambda-uttrycket i det här formatet:

<lambda variable> => <expression>

Kommentar

Lambda-funktionerna stöds endast i Bicep CLI version 0.10.X eller senare.

Begränsningar

Funktionen Bicep lambda har följande begränsningar:

  • Lambda-uttryck kan bara anges direkt som funktionsargument i dessa funktioner: filter(), map(), reduce(), sort()och toObject().
  • Användning av lambda-variabler (de tillfälliga variabler som används i lambda-uttrycken) i resurs- eller modulmatrisåtkomst stöds inte för närvarande.
  • Det finns för närvarande inte stöd för att använda lambda-variabler i listKeys funktionen.
  • Det finns för närvarande inte stöd för att använda lambda-variabler i referensfunktionen .

filter

filter(inputArray, lambda expression)

Filtrerar en matris med en anpassad filtreringsfunktion.

Namnområde: sys.

Parametrar

Parameter Obligatoriskt Type Beskrivning
inputArray Ja matris Matrisen som ska filtreras.
lambda-uttryck Ja Uttryck Lambda-uttrycket tillämpas på varje indatamatriselement. Om resultatet är sant inkluderas objektet i utdatamatrisen. annars tas objektet bort.

Returvärde

En matris.

Exempel

I följande exempel visas hur du filter använder funktionen.

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 oldDogs array = filter(dogs, dog => dog.age >=5)

Utdata från föregående exempel visar de hundar som är fem eller äldre:

Namn Typ Värde
oldDogs Matris [{"name":"Evie","age":5,"interests":["Ball","Frisbee"]},{"name":"Kira","age":8,"interests":["Rubs"]}] 
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)

Utdata från föregående exempel:

Namn Typ Värde
filteredLoop Matris [6, 7, 8, 9]
isEven Matris [0, 2, 4, 6, 8]

filterdLoop visar talen i en matris som är större än 5, och isEven visar jämna tal i matrisen.

map

map(inputArray, lambda expression)

Tillämpar en anpassad mappningsfunktion på varje element i en matris.

Namnområde: sys.

Parametrar

Parameter Obligatoriskt Type Beskrivning
inputArray Ja matris Matrisen som ska mappas.
lambda-uttryck Ja Uttryck Lambda-uttrycket som tillämpas på varje indatamatriselement för att generera utdatamatrisen.

Returvärde

En matris.

Exempel

I följande exempel visas hur du map använder funktionen.

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 mapObject array = map(range(0, length(dogs)), i => {
  i: i
  dog: dogs[i].name
  greeting: 'Ahoy, ${dogs[i].name}!'
})

Utdata från föregående exempel är:

Namn Typ Värde
dogNames Matris ["Evie","Casper","Indy","Kira"]
sayHi Matris ["Hello Evie!","Hello Casper!","Hello Indy!","Hello Kira!"]
mapObject Matris [{"i":0,"hund":"Evie","hälsning":"Ahoy, Evie!"},{"i":1,"hund":"Casper","hälsning":"Ahoy, Casper!"},{"i":2,"hund":"Indy","hälsning":"Ahoy, Indy!"},{"i":3,"hund":"Kira","hälsning":"Ahoy, Kira!}]

dogNames visar hundnamnen från matrisen med objekt; sayHi sammanfogar "Hello" och vart och ett av hundnamnen, och mapObject skapar en annan matris med objekt.

Minska

reduce(inputArray, initialValue, lambda expression)

Minskar en matris med en anpassad reduce-funktion.

Namnområde: sys.

Parametrar

Parameter Obligatoriskt Type Beskrivning
inputArray Ja matris Matrisen som ska minskas.
initialValue Ja någon Ursprungligt värde.
lambda-uttryck Ja Uttryck Lambda-uttrycket som används för att aggregera det aktuella värdet och nästa värde.

Returvärde

Någon.

Exempel

I följande exempel visas hur du reduce använder funktionen.

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)

Utdata från föregående exempel är:

Namn Typ Värde
totalAge heltal 18
totalAgeAdd1 heltal 19

totalAge summerar hundarnas ålder; totalAgeAdd1 har ett initialt värde på 1 och lägger till alla hundåldrarna till de inledande värdena.

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

Utdata från föregående exempel är:

Namn Typ Värde
reduceObjectUnion objekt {"foo":123,"bar":456,"baz":789}

Union-funktionen returnerar ett enskilt objekt med alla element från parametrarna. Funktionsanropet unioniserar nyckelvärdeparen för objekten till ett nytt objekt.

sortera

sort(inputArray, lambda expression)

Sorterar en matris med en anpassad sorteringsfunktion.

Namnområde: sys.

Parametrar

Parameter Obligatoriskt Type Beskrivning
inputArray Ja matris Matrisen som ska sorteras.
lambda-uttryck Ja Uttryck Lambda-uttrycket som används för att jämföra två matriselement för beställning. Om det är sant sorteras det andra elementet efter det första i utdatamatrisen.

Returvärde

En matris.

Exempel

I följande exempel visas hur du sort använder funktionen.

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)

Utdata från föregående exempel sorterar hundobjekten från den yngsta till den äldsta:

Namn Typ Värde
dogsByAge Matris [{"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])

Konverterar en matris till ett objekt med en anpassad nyckelfunktion och valfri funktion för anpassat värde. Se objekt om att konvertera ett objekt till en matris.

Namnområde: sys.

Parametrar

Parameter Obligatoriskt Type Beskrivning
inputArray Ja matris Matrisen som används för att skapa ett objekt.
lambda-uttryck Ja Uttryck Lambda-uttrycket som används för att ange nyckelpredikatet.
lambda-uttryck Nej Uttryck Lambda-uttrycket som används för att ange värdepredikatet.

Returvärde

Ett objekt.

Exempel

I följande exempel visas hur du toObject använder funktionen med de två obligatoriska parametrarna:

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)

Föregående exempel genererar ett objekt baserat på en matris.

Namn Typ Värde
dogsObject Objekt {"Evie":{"name":"Evie","age":5,"interests":["Ball","Frisbee"]},"Casper":{"name":"Casper","age":3,"interests":["Other dogs"]},"Indy":{"name":"Indy","age":2,"interests":["Butter"]},"Kira":{"name":"Kira","age":8,"interests":["Rubs"]}}

Följande toObject funktion med den tredje parametern ger samma utdata.

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

I följande exempel visas hur du toObject använder funktionen med tre parametrar.

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)

Föregående exempel genererar ett objekt baserat på en matris.

Namn Typ Värde
dogsObject Objekt {"Evie":{"age":5,"interests":["Ball","Frisbee"]},"Casper":{"age":3,"interests":["Other dogs"]},"Indy":{"age":2,"interests":["Butter"]},"Kira":{"age":8,"interests":["Rubs"]}}

Nästa steg