Tekenreeksfuncties voor ARM-sjablonen

Resource Manager biedt de volgende functies voor het werken met tekenreeksen in uw Azure Resource Manager-sjabloon (ARM-sjabloon):

• base64
• base64ToJson
• base64ToString
• Concat
• Bevat
• dataUri
• dataUriToString
• empty
• endsWith
• Eerste
• format
• Guid
• indexOf
• join
• json
• Laatste
• lastIndexOf
• length
• newGuid
• padLeft
• replace
• skip
• split
• startsWith
• Tekenreeks
• Subtekenreeks
• Nemen
• toLower
• Toupper
• trim
• uniqueString
• Uri
• uriComponent
• uriComponentToString

Tip

We raden Bicep aan omdat het dezelfde mogelijkheden biedt als ARM-sjablonen en de syntaxis gemakkelijker te gebruiken is. Zie tekenreeksfuncties voor meer informatie.

base64

base64(inputString)

Retourneert de base64-weergave van de invoertekenreeks.

Gebruik in Bicep de base64-functie .

Parameters

Parameter	Vereist	Type	Description
inputString	Ja	tekenreeks	De waarde die moet worden geretourneerd als een base64-weergave.

Retourwaarde

Een tekenreeks met de base64-weergave.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de base64 functie gebruikt.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stringData": {
      "type": "string",
      "defaultValue": "one, two, three"
    },
    "jsonFormattedData": {
      "type": "string",
      "defaultValue": "{'one': 'a', 'two': 'b'}"
    }
  },
  "variables": {
    "base64String": "[base64(parameters('stringData'))]",
    "base64Object": "[base64(parameters('jsonFormattedData'))]"
  },
  "resources": [
  ],
  "outputs": {
    "base64Output": {
      "type": "string",
      "value": "[variables('base64String')]"
    },
    "toStringOutput": {
      "type": "string",
      "value": "[base64ToString(variables('base64String'))]"
    },
    "toJsonOutput": {
      "type": "object",
      "value": "[base64ToJson(variables('base64Object'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
base64Output	String	b25lLCB0d28sIHRocmVl
toStringOutput	String	Een twee drie
toJsonOutput	Object	{"one": "a", "two": "b"}

base64ToJson

base64ToJson(base64Value)

Converteert een base64-weergave naar een JSON-object.

Gebruik in Bicep de functie base64ToJson .

Parameters

Parameter	Vereist	Type	Description
base64Value	Ja	tekenreeks	De base64-weergave die moet worden geconverteerd naar een JSON-object.

Retourwaarde

Een JSON-object.

Voorbeelden

In het volgende voorbeeld wordt de base64ToJson functie gebruikt om een base64-waarde te converteren:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stringData": {
      "type": "string",
      "defaultValue": "one, two, three"
    },
    "jsonFormattedData": {
      "type": "string",
      "defaultValue": "{'one': 'a', 'two': 'b'}"
    }
  },
  "variables": {
    "base64String": "[base64(parameters('stringData'))]",
    "base64Object": "[base64(parameters('jsonFormattedData'))]"
  },
  "resources": [
  ],
  "outputs": {
    "base64Output": {
      "type": "string",
      "value": "[variables('base64String')]"
    },
    "toStringOutput": {
      "type": "string",
      "value": "[base64ToString(variables('base64String'))]"
    },
    "toJsonOutput": {
      "type": "object",
      "value": "[base64ToJson(variables('base64Object'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
base64Output	String	b25lLCB0d28sIHRocmVl
toStringOutput	String	Een twee drie
toJsonOutput	Object	{"one": "a", "two": "b"}

base64ToString

base64ToString(base64Value)

Converteert een base64-weergave naar een tekenreeks.

Gebruik in Bicep de functie base64ToString .

Parameters

Parameter	Vereist	Type	Description
base64Value	Ja	tekenreeks	De base64-weergave die moet worden geconverteerd naar een tekenreeks.

Retourwaarde

Een tekenreeks van de geconverteerde base64-waarde.

Voorbeelden

In het volgende voorbeeld wordt de base64ToString functie gebruikt om een base64-waarde te converteren:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stringData": {
      "type": "string",
      "defaultValue": "one, two, three"
    },
    "jsonFormattedData": {
      "type": "string",
      "defaultValue": "{'one': 'a', 'two': 'b'}"
    }
  },
  "variables": {
    "base64String": "[base64(parameters('stringData'))]",
    "base64Object": "[base64(parameters('jsonFormattedData'))]"
  },
  "resources": [
  ],
  "outputs": {
    "base64Output": {
      "type": "string",
      "value": "[variables('base64String')]"
    },
    "toStringOutput": {
      "type": "string",
      "value": "[base64ToString(variables('base64String'))]"
    },
    "toJsonOutput": {
      "type": "object",
      "value": "[base64ToJson(variables('base64Object'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
base64Output	String	b25lLCB0d28sIHRocmVl
toStringOutput	String	Een twee drie
toJsonOutput	Object	{"one": "a", "two": "b"}

concat

concat(arg1, arg2, arg3, ...)

Combineert meerdere tekenreekswaarden en retourneert de samengevoegde tekenreeks, of combineert meerdere matrices en retourneert de samengevoegde matrix.

Gebruik in Bicep tekenreeksinterpolatie in plaats van de functie om de concat() leesbaarheid te verbeteren. In sommige gevallen, zoals het vervangen van tekenreeksen in tekenreeksen met meerdere regels, moet u mogelijk terugvallen op het gebruik van de concat() functie of de replace() functie.

Parameters

Parameter	Vereist	Type	Description
arg1	Ja	tekenreeks of matrix	De eerste tekenreeks of matrix voor samenvoeging.
meer argumenten	Nee	tekenreeks of matrix	Meer tekenreeksen of matrices in opeenvolgende volgorde voor samenvoeging.

Deze functie kan een willekeurig aantal argumenten aannemen en kan tekenreeksen of matrices voor de parameters accepteren. U kunt echter niet zowel matrices als tekenreeksen opgeven voor parameters. Tekenreeksen worden alleen samengevoegd met andere tekenreeksen.

Retourwaarde

Een tekenreeks of matrix met samengevoegde waarden.

Voorbeelden

In het volgende voorbeeld ziet u hoe u twee tekenreekswaarden combineert en een samengevoegde tekenreeks retourneert.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "prefix": {
      "type": "string",
      "defaultValue": "prefix"
    }
  },
  "resources": [],
  "outputs": {
    "concatOutput": {
      "type": "string",
      "value": "[concat(parameters('prefix'), '-', uniqueString(resourceGroup().id))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
concatOutput	String	prefix-5yj4yjf5mbg72

In het volgende voorbeeld ziet u hoe u twee matrices combineert.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "firstArray": {
      "type": "array",
      "defaultValue": [
        "1-1",
        "1-2",
        "1-3"
      ]
    },
    "secondArray": {
      "type": "array",
      "defaultValue": [
        "2-1",
        "2-2",
        "2-3"
      ]
    }
  },
  "resources": [
  ],
  "outputs": {
    "return": {
      "type": "array",
      "value": "[concat(parameters('firstArray'), parameters('secondArray'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
enter	Matrix	["1-1", "1-2", "1-3", "2-1", "2-2", "2-3"]

bevat

contains(container, itemToFind)

Hiermee wordt gecontroleerd of een matrix een waarde bevat, een object een sleutel bevat of een tekenreeks een subtekenreeks bevat. De tekenreeksvergelijking is hoofdlettergevoelig. Wanneer u echter test of een object een sleutel bevat, is de vergelijking niet hoofdlettergevoelig.

Gebruik in Bicep de functie contains .

Parameters

Parameter	Vereist	Type	Description
container	Ja	matrix, object of tekenreeks	De waarde die de te zoeken waarde bevat.
itemToFind	Ja	tekenreeks of int	De te vinden waarde.

Retourwaarde

Waar als het item wordt gevonden; anders onwaar.

Voorbeelden

In het volgende voorbeeld ziet u hoe u deze kunt gebruiken met verschillende typen:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stringToTest": {
      "type": "string",
      "defaultValue": "OneTwoThree"
    },
    "objectToTest": {
      "type": "object",
      "defaultValue": {
        "one": "a",
        "two": "b",
        "three": "c"
      }
    },
    "arrayToTest": {
      "type": "array",
      "defaultValue": [ "one", "two", "three" ]
    }
  },
  "resources": [
  ],
  "outputs": {
    "stringTrue": {
      "type": "bool",
      "value": "[contains(parameters('stringToTest'), 'e')]"
    },
    "stringFalse": {
      "type": "bool",
      "value": "[contains(parameters('stringToTest'), 'z')]"
    },
    "objectTrue": {
      "type": "bool",
      "value": "[contains(parameters('objectToTest'), 'one')]"
    },
    "objectFalse": {
      "type": "bool",
      "value": "[contains(parameters('objectToTest'), 'a')]"
    },
    "arrayTrue": {
      "type": "bool",
      "value": "[contains(parameters('arrayToTest'), 'three')]"
    },
    "arrayFalse": {
      "type": "bool",
      "value": "[contains(parameters('arrayToTest'), 'four')]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
stringTrue	Bool	Waar
stringFalse	Bool	Onwaar
objectTrue	Bool	Waar
objectFalse	Bool	Onwaar
arrayTrue	Bool	Waar
arrayFalse	Bool	Onwaar

dataUri

dataUri(stringToConvert)

Converteert een waarde naar een gegevens-URI.

Gebruik in Bicep de functie dataUri .

Parameters

Parameter	Vereist	Type	Description
stringToConvert	Ja	tekenreeks	De waarde die moet worden geconverteerd naar een gegevens-URI.

Retourwaarde

Een tekenreeks die is opgemaakt als een gegevens-URI.

Voorbeelden

In het volgende voorbeeld wordt een waarde geconverteerd naar een gegevens-URI en wordt een gegevens-URI geconverteerd naar een tekenreeks.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stringToTest": {
      "type": "string",
      "defaultValue": "Hello"
    },
    "dataFormattedString": {
      "type": "string",
      "defaultValue": "data:;base64,SGVsbG8sIFdvcmxkIQ=="
    }
  },
  "resources": [],
  "outputs": {
    "dataUriOutput": {
      "value": "[dataUri(parameters('stringToTest'))]",
      "type": "string"
    },
    "toStringOutput": {
      "type": "string",
      "value": "[dataUriToString(parameters('dataFormattedString'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
dataUriOutput	String	data:text/plain; charset=utf8; base64,SGVsbG8=
toStringOutput	String	Hallo wereld!

dataUriToString

dataUriToString(dataUriToConvert)

Converteert een gegevens-URI-opgemaakte waarde naar een tekenreeks.

Gebruik in Bicep de functie dataUriToString .

Parameters

Parameter	Vereist	Type	Description
dataUriToConvert	Ja	tekenreeks	De gegevens-URI-waarde die moet worden geconverteerd.

Retourwaarde

Een tekenreeks met de geconverteerde waarde.

Voorbeelden

Met de volgende voorbeeldsjabloon wordt een waarde geconverteerd naar een gegevens-URI en wordt een gegevens-URI geconverteerd naar een tekenreeks.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stringToTest": {
      "type": "string",
      "defaultValue": "Hello"
    },
    "dataFormattedString": {
      "type": "string",
      "defaultValue": "data:;base64,SGVsbG8sIFdvcmxkIQ=="
    }
  },
  "resources": [],
  "outputs": {
    "dataUriOutput": {
      "value": "[dataUri(parameters('stringToTest'))]",
      "type": "string"
    },
    "toStringOutput": {
      "type": "string",
      "value": "[dataUriToString(parameters('dataFormattedString'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
dataUriOutput	String	data:text/plain; charset=utf8; base64,SGVsbG8=
toStringOutput	String	Hallo wereld!

empty

empty(itemToTest)

Bepaalt of een matrix, object of tekenreeks leeg is.

Gebruik in Bicep de lege functie.

Parameters

Parameter	Vereist	Type	Description
itemToTest	Ja	matrix, object of tekenreeks	De waarde om te controleren of deze leeg is.

Retourwaarde

Retourneert Waar als de waarde leeg is; anders Onwaar.

Voorbeelden

In het volgende voorbeeld wordt gecontroleerd of een matrix, object en tekenreeks leeg zijn.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testArray": {
      "type": "array",
      "defaultValue": []
    },
    "testObject": {
      "type": "object",
      "defaultValue": {}
    },
    "testString": {
      "type": "string",
      "defaultValue": ""
    }
  },
  "resources": [
  ],
  "outputs": {
    "arrayEmpty": {
      "type": "bool",
      "value": "[empty(parameters('testArray'))]"
    },
    "objectEmpty": {
      "type": "bool",
      "value": "[empty(parameters('testObject'))]"
    },
    "stringEmpty": {
      "type": "bool",
      "value": "[empty(parameters('testString'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
arrayEmpty	Bool	Waar
objectEmpty	Bool	Waar
stringEmpty	Bool	Waar

endsWith

endsWith(stringToSearch, stringToFind)

Bepaalt of een tekenreeks eindigt op een waarde. De vergelijking is niet hoofdlettergevoelig.

Gebruik in Bicep de functie endsWith .

Parameters

Parameter	Vereist	Type	Description
stringToSearch	Ja	tekenreeks	De waarde die het item bevat dat moet worden gevonden.
stringToFind	Ja	tekenreeks	De te vinden waarde.

Retourwaarde

Waar als het laatste teken of de laatste tekens van de tekenreeks overeenkomen met de waarde; anders onwaar.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de startsWith functies en endsWith functies gebruikt:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [],
  "outputs": {
    "startsTrue": {
      "type": "bool",
      "value": "[startsWith('abcdef', 'ab')]"
    },
    "startsCapTrue": {
      "type": "bool",
      "value": "[startsWith('abcdef', 'A')]"
    },
    "startsFalse": {
      "type": "bool",
      "value": "[startsWith('abcdef', 'e')]"
    },
    "endsTrue": {
      "type": "bool",
      "value": "[endsWith('abcdef', 'ef')]"
    },
    "endsCapTrue": {
      "type": "bool",
      "value": "[endsWith('abcdef', 'F')]"
    },
    "endsFalse": {
      "type": "bool",
      "value": "[endsWith('abcdef', 'e')]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
startsTrue	Bool	Waar
startsCapTrue	Bool	Waar
startsFalse	Bool	Onwaar
endsTrue	Bool	Waar
endsCapTrue	Bool	Waar
endsFalse	Bool	Onwaar

Eerste

first(arg1)

Retourneert het eerste teken van de tekenreeks of het eerste element van de matrix. Als er een lege tekenreeks wordt gegeven, resulteert de functie in een lege tekenreeks. In het geval van een lege matrix retourneert nullde functie .

Gebruik in Bicep de eerste functie.

Parameters

Parameter	Vereist	Type	Description
arg1	Ja	matrix of tekenreeks	De waarde voor het ophalen van het eerste element of teken.

Retourwaarde

Een tekenreeks van het eerste teken of het type (tekenreeks, int, matrix of object) van het eerste element in een matrix.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de eerste functie gebruikt met een matrix en tekenreeks.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "arrayToTest": {
      "type": "array",
      "defaultValue": [ "one", "two", "three" ]
    }
  },
  "resources": [
  ],
  "outputs": {
    "arrayOutput": {
      "type": "string",
      "value": "[first(parameters('arrayToTest'))]"
    },
    "stringOutput": {
      "type": "string",
      "value": "[first('One Two Three')]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
arrayOutput	String	één
stringOutput	String	O

indeling

format(formatString, arg1, arg2, ...)

Hiermee maakt u een opgemaakte tekenreeks op basis van invoerwaarden.

Gebruik in Bicep de notatiefunctie .

Parameters

Parameter	Vereist	Type	Description
formatString	Ja	tekenreeks	De tekenreeks voor samengestelde notatie.
arg1	Ja	tekenreeks, geheel getal of Booleaanse waarde	De waarde die moet worden opgenomen in de opgemaakte tekenreeks.
meer argumenten	Nee	tekenreeks, geheel getal of Booleaanse waarde	Meer waarden die moeten worden opgenomen in de opgemaakte tekenreeks.

Opmerkingen

Gebruik deze functie om een tekenreeks in uw sjabloon op te maken. Er worden dezelfde opmaakopties gebruikt als de methode System.String.Format in .NET.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de indelingsfunctie gebruikt.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "greeting": {
      "type": "string",
      "defaultValue": "Hello"
    },
    "name": {
      "type": "string",
      "defaultValue": "User"
    },
    "numberToFormat": {
      "type": "int",
      "defaultValue": 8175133
    }
  },
  "resources": [
  ],
  "outputs": {
    "formatTest": {
      "type": "string",
      "value": "[format('{0}, {1}. Formatted number: {2:N0}', parameters('greeting'), parameters('name'), parameters('numberToFormat'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
formatTest	String	Hallo, gebruiker. Opgemaakt getal: 8.175.133

guid

guid(baseString, ...)

Hiermee maakt u een waarde in de notatie van een globaal unieke id op basis van de waarden die als parameters zijn opgegeven.

Gebruik in Bicep de guid-functie .

Parameters

Parameter	Vereist	Type	Description
baseString	Ja	tekenreeks	De waarde die wordt gebruikt in de hash-functie om de GUID te maken.
meer parameters indien nodig	Nee	tekenreeks	U kunt zoveel tekenreeksen toevoegen als nodig is om de waarde te maken die het uniekheidsniveau aangeeft.

Opmerkingen

Deze functie is handig wanneer u een waarde moet maken in de indeling van een globally unique identifier. U geeft parameterwaarden op waarmee het bereik van uniekheid voor het resultaat wordt beperkt. U kunt opgeven of de naam uniek is voor abonnement, resourcegroep of implementatie.

De geretourneerde waarde is geen willekeurige tekenreeks, maar eerder het resultaat van een hash-functie op de parameters. De geretourneerde waarde is 36 tekens lang. Het is niet wereldwijd uniek. Als u een nieuwe GUID wilt maken die niet is gebaseerd op die hashwaarde van de parameters, gebruikt u de functie newGuid .

In de volgende voorbeelden ziet u hoe u guid gebruikt om een unieke waarde te maken voor veelgebruikte niveaus.

Uniek bereik voor abonnement

"[guid(subscription().subscriptionId)]"

Uniek bereik voor resourcegroep

"[guid(resourceGroup().id)]"

Uniek bereik voor implementatie voor een resourcegroep

"[guid(resourceGroup().id, deployment().name)]"

De guid functie implementeert het algoritme van RFC 4122 §4.3. De oorspronkelijke bron is te vinden in GuidUtility met enkele wijzigingen.

Retourwaarde

Een tekenreeks met 36 tekens in de notatie van een globally unique identifier.

Voorbeelden

Het volgende voorbeeld retourneert resultaten van guid:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {},
  "variables": {},
  "resources": [],
  "outputs": {
    "guidPerSubscription": {
      "type": "string",
      "value": "[guid(subscription().subscriptionId)]"
    },
    "guidPerResourceGroup": {
      "type": "string",
      "value": "[guid(resourceGroup().id)]"
    },
    "guidPerDeployment": {
      "type": "string",
      "value": "[guid(resourceGroup().id, deployment().name)]"
    }
  }
}

indexOf

indexOf(stringToSearch, stringToFind)

Retourneert de eerste positie van een waarde binnen een tekenreeks. De vergelijking is niet hoofdlettergevoelig.

Gebruik in Bicep de functie IndexOf .

Parameters

Parameter	Vereist	Type	Description
stringToSearch	Ja	tekenreeks	De waarde die het item bevat dat moet worden gevonden.
stringToFind	Ja	tekenreeks	De te vinden waarde.

Retourwaarde

Een geheel getal dat de positie van het item aangeeft dat moet worden gevonden. De waarde is gebaseerd op nul. Als het item niet wordt gevonden, wordt -1 geretourneerd.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de indexOf functies en lastIndexOf functies gebruikt:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [],
  "outputs": {
    "firstT": {
      "type": "int",
      "value": "[indexOf('test', 't')]"
    },
    "lastT": {
      "type": "int",
      "value": "[lastIndexOf('test', 't')]"
    },
    "firstString": {
      "type": "int",
      "value": "[indexOf('abcdef', 'CD')]"
    },
    "lastString": {
      "type": "int",
      "value": "[lastIndexOf('abcdef', 'AB')]"
    },
    "notFound": {
      "type": "int",
      "value": "[indexOf('abcdef', 'z')]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
firstT	Int	0
lastT	Int	3
firstString	Int	2
lastString	Int	0
notFound	Int	-1

join

join(inputArray, delimiter)

Hiermee wordt een tekenreeksmatrix samengevoegd tot één tekenreeks, gescheiden met behulp van een scheidingsteken.

Gebruik in Bicep de join-functie .

Parameters

Parameter	Vereist	Type	Description
inputArray	Ja	tekenreeksmatrix	Een matrix met tekenreeks die moet worden samengevoegd.
scheidingsteken	Ja	Het scheidingsteken dat moet worden gebruikt voor het splitsen van de tekenreeks.

Retourwaarde

Een tekenreeks.

Voorbeelden

In het volgende voorbeeld wordt de invoertekenreeksmatrix samengevoegd tot tekenreeksen die zijn gescheiden met behulp van verschillende scheidingstekens.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "variables": {
    "arrayString": [
      "one",
      "two",
      "three"
    ]
  },
  "resources": [],
  "outputs": {
    "firstOutput": {
      "type": "string",
      "value": "[join(variables('arrayString'), ',')]"
    },
    "secondOutput": {
      "type": "string",
      "value": "[join(variables('arrayString'), ';')]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld is:

Name	Type	Weergegeven als
firstOutput	String	"één,twee,drie"
secondOutput	String	"één; Twee; drie"

json

json(arg1)

Converteert een geldige JSON-tekenreeks naar een JSON-gegevenstype. Zie de json-functie voor meer informatie.

Gebruik in Bicep de json-functie .

Laatste

last(arg1)

Retourneert het laatste teken van de tekenreeks of het laatste element van de matrix.

Gebruik in Bicep de laatste functie.

Parameters

Parameter	Vereist	Type	Description
arg1	Ja	matrix of tekenreeks	De waarde voor het ophalen van het laatste element of teken.

Retourwaarde

Een tekenreeks van het laatste teken of het type (tekenreeks, int, matrix of object) van het laatste element in een matrix.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de last functie gebruikt met een matrix en tekenreeks.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "arrayToTest": {
      "type": "array",
      "defaultValue": [ "one", "two", "three" ]
    }
  },
  "resources": [
  ],
  "outputs": {
    "arrayOutput": {
      "type": "string",
      "value": "[last(parameters('arrayToTest'))]"
    },
    "stringOutput": {
      "type": "string",
      "value": "[last('One Two Three')]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
arrayOutput	String	drie
stringOutput	String	e

lastIndexOf

lastIndexOf(stringToSearch, stringToFind)

Retourneert de laatste positie van een waarde binnen een tekenreeks. De vergelijking is niet hoofdlettergevoelig.

Gebruik in Bicep de functie lastIndexOf .

Parameters

Parameter	Vereist	Type	Description
stringToSearch	Ja	tekenreeks	De waarde die het item bevat dat moet worden gevonden.
stringToFind	Ja	tekenreeks	De te vinden waarde.

Retourwaarde

Een geheel getal dat de laatste positie van het item aangeeft dat moet worden gevonden. De waarde is gebaseerd op nul. Als het item niet wordt gevonden, wordt -1 geretourneerd.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de indexOf functies en lastIndexOf functies gebruikt:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [],
  "outputs": {
    "firstT": {
      "type": "int",
      "value": "[indexOf('test', 't')]"
    },
    "lastT": {
      "type": "int",
      "value": "[lastIndexOf('test', 't')]"
    },
    "firstString": {
      "type": "int",
      "value": "[indexOf('abcdef', 'CD')]"
    },
    "lastString": {
      "type": "int",
      "value": "[lastIndexOf('abcdef', 'AB')]"
    },
    "notFound": {
      "type": "int",
      "value": "[indexOf('abcdef', 'z')]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
firstT	Int	0
lastT	Int	3
firstString	Int	2
lastString	Int	0
notFound	Int	-1

length

length(string)

Retourneert het aantal tekens in een tekenreeks, elementen in een matrix of eigenschappen op hoofdniveau in een object.

Gebruik in Bicep de lengtefunctie .

Parameters

Parameter	Vereist	Type	Description
arg1	Ja	matrix, tekenreeks of object	De matrix die moet worden gebruikt voor het ophalen van het aantal elementen, de tekenreeks die moet worden gebruikt voor het ophalen van het aantal tekens of het object dat moet worden gebruikt voor het ophalen van het aantal eigenschappen op hoofdniveau.

Retourwaarde

Een int.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de length functie gebruikt met een matrix en tekenreeks:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "arrayToTest": {
      "type": "array",
      "defaultValue": [
        "one",
        "two",
        "three"
      ]
    },
    "stringToTest": {
      "type": "string",
      "defaultValue": "One Two Three"
    },
    "objectToTest": {
      "type": "object",
      "defaultValue": {
        "propA": "one",
        "propB": "two",
        "propC": "three",
        "propD": {
          "propD-1": "sub",
          "propD-2": "sub"
        }
      }
    }
  },
  "resources": [],
  "outputs": {
    "arrayLength": {
      "type": "int",
      "value": "[length(parameters('arrayToTest'))]"
    },
    "stringLength": {
      "type": "int",
      "value": "[length(parameters('stringToTest'))]"
    },
    "objectLength": {
      "type": "int",
      "value": "[length(parameters('objectToTest'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
arrayLength	Int	3
stringLength	Int	13
objectLength	Int	4

newGuid

newGuid()

Retourneert een waarde in de notatie van een globaal unieke id. Deze functie kan alleen worden gebruikt in de standaardwaarde voor een parameter.

Gebruik in Bicep de functie newGuid .

Opmerkingen

U kunt deze functie alleen gebruiken in een expressie voor de standaardwaarde van een parameter. Als u deze functie ergens anders in een sjabloon gebruikt, wordt een fout geretourneerd. De functie is niet toegestaan in andere delen van de sjabloon, omdat deze elke keer dat deze wordt aangeroepen een andere waarde retourneert. Het implementeren van dezelfde sjabloon met dezelfde parameters zou niet betrouwbaar dezelfde resultaten opleveren.

De functie newGuid verschilt van de guid-functie omdat deze geen parameters accepteert. Wanneer u guid aanroept met dezelfde parameter, wordt elke keer dezelfde id geretourneerd. Gebruik guid wanneer u op betrouwbare wijze dezelfde GUID voor een specifieke omgeving moet genereren. Gebruik newGuid wanneer u elke keer een andere id nodig hebt, zoals het implementeren van resources in een testomgeving.

De functie newGuid maakt gebruik van de GUID-structuur in .NET Framework om de globally unique identifier te genereren.

Als u de optie gebruikt om een eerdere geslaagde implementatie opnieuw te implementeren en de eerdere implementatie een parameter bevat die gebruikmaakt van newGuid, wordt de parameter niet opnieuw geëvalueerd. In plaats daarvan wordt de parameterwaarde van de eerdere implementatie automatisch opnieuw gebruikt in de rollback-implementatie.

In een testomgeving moet u resources die slechts korte tijd actief zijn, herhaaldelijk implementeren. In plaats van unieke namen te maken, kunt u newGuid met uniqueString gebruiken om unieke namen te maken.

Wees voorzichtig met het opnieuw implementeren van een sjabloon die afhankelijk is van de functie newGuid voor een standaardwaarde. Wanneer u de parameter opnieuw implementeert en geen waarde opgeeft, wordt de functie opnieuw geëvalueerd. Als u een bestaande resource wilt bijwerken in plaats van een nieuwe resource te maken, geeft u de parameterwaarde van de eerdere implementatie door.

Retourwaarde

Een tekenreeks met 36 tekens in de notatie van een globally unique identifier.

Voorbeelden

In het volgende voorbeeld ziet u een parameter met een nieuwe id.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "guidValue": {
      "type": "string",
      "defaultValue": "[newGuid()]"
    }
  },
  "resources": [
  ],
  "outputs": {
    "guidOutput": {
      "type": "string",
      "value": "[parameters('guidValue')]"
    }
  }
}

De uitvoer van het vorige voorbeeld varieert voor elke implementatie, maar is vergelijkbaar met:

Name	Type	Weergegeven als
guidOutput	tekenreeks	b76a51fc-bd72-4a77-b9a2-3c29e7d2e551

In het volgende voorbeeld wordt de newGuid functie gebruikt om een unieke naam voor een opslagaccount te maken. Deze sjabloon werkt mogelijk voor een testomgeving waarin het opslagaccount gedurende korte tijd bestaat en niet opnieuw wordt geïmplementeerd.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "guidValue": {
      "type": "string",
      "defaultValue": "[newGuid()]"
    }
  },
  "variables": {
    "storageName": "[concat('storage', uniqueString(parameters('guidValue')))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-04-01",
      "name": "[variables('storageName')]",
      "location": "West US",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {}
    }
  ],
  "outputs": {
    "nameOutput": {
      "type": "string",
      "value": "[variables('storageName')]"
    }
  }
}

De uitvoer van het vorige voorbeeld varieert voor elke implementatie, maar is vergelijkbaar met:

Name	Type	Weergegeven als
nameOutput	tekenreeks	storagenziwvyru7uxie

padLeft

padLeft(valueToPad, totalLength, paddingCharacter)

Retourneert een rechts uitgelijnde tekenreeks door tekens aan de linkerkant toe te voegen totdat de totale opgegeven lengte is bereikt.

Gebruik in Bicep de padLeft-functie .

Parameters

Parameter	Vereist	Type	Description
valueToPad	Ja	tekenreeks of int	De waarde om rechts uit te lijnen.
totalLength	Ja	int	Het totale aantal tekens in de geretourneerde tekenreeks.
paddingCharacter	Nee	enkel teken	Het teken dat moet worden gebruikt voor linkeropvulling totdat de totale lengte is bereikt. De standaardwaarde is een spatie.

Als de oorspronkelijke tekenreeks langer is dan het aantal tekens dat moet worden opgevuld, worden er geen tekens toegevoegd.

Retourwaarde

Een tekenreeks met ten minste het aantal opgegeven tekens.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de door de gebruiker verstrekte parameterwaarde kunt optellen door het nulteken toe te voegen totdat het totale aantal tekens is bereikt.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testString": {
      "type": "string",
      "defaultValue": "123"
    }
  },
  "resources": [],
  "outputs": {
    "stringOutput": {
      "type": "string",
      "value": "[padLeft(parameters('testString'),10,'0')]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
stringOutput	String	0000000123

replace

replace(originalString, oldString, newString)

Retourneert een nieuwe tekenreeks met alle exemplaren van een tekenreeks die wordt vervangen door een andere tekenreeks.

Gebruik in Bicep de vervangfunctie .

Parameters

Parameter	Vereist	Type	Description
originalString	Ja	tekenreeks	De waarde met alle exemplaren van één tekenreeks vervangen door een andere tekenreeks.
oldString	Ja	tekenreeks	De tekenreeks die moet worden verwijderd uit de oorspronkelijke tekenreeks.
newString	Ja	tekenreeks	De tekenreeks die moet worden toegevoegd in plaats van de verwijderde tekenreeks.

Retourwaarde

Een tekenreeks met de vervangen tekens.

Voorbeelden

In het volgende voorbeeld ziet u hoe u alle streepjes verwijdert uit de door de gebruiker opgegeven tekenreeks en hoe u een deel van de tekenreeks vervangt door een andere tekenreeks.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testString": {
      "type": "string",
      "defaultValue": "123-123-1234"
    }
  },
  "resources": [],
  "outputs": {
    "firstOutput": {
      "type": "string",
      "value": "[replace(parameters('testString'),'-', '')]"
    },
    "secondOutput": {
      "type": "string",
      "value": "[replace(parameters('testString'),'1234', 'xxxx')]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
firstOutput	String	1231231234
secondOutput	String	123-123-xxxx

skip

skip(originalValue, numberToSkip)

Retourneert een tekenreeks met alle tekens na het opgegeven aantal tekens of een matrix met alle elementen na het opgegeven aantal elementen.

Gebruik in Bicep de functie skip .

Parameters

Parameter	Vereist	Type	Description
Originalvalue	Ja	matrix of tekenreeks	De matrix of tekenreeks die moet worden gebruikt voor het overslaan.
numberToSkip	Ja	int	Het aantal elementen of tekens dat moet worden overgeslagen. Als deze waarde 0 of minder is, worden alle elementen of tekens in de waarde geretourneerd. Als deze groter is dan de lengte van de matrix of tekenreeks, wordt een lege matrix of tekenreeks geretourneerd.

Retourwaarde

Een matrix of tekenreeks.

Voorbeelden

In het volgende voorbeeld wordt het opgegeven aantal elementen in de matrix en het opgegeven aantal tekens in een tekenreeks overgeslagen.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testArray": {
      "type": "array",
      "defaultValue": [
        "one",
        "two",
        "three"
      ]
    },
    "elementsToSkip": {
      "type": "int",
      "defaultValue": 2
    },
    "testString": {
      "type": "string",
      "defaultValue": "one two three"
    },
    "charactersToSkip": {
      "type": "int",
      "defaultValue": 4
    }
  },
  "resources": [],
  "outputs": {
    "arrayOutput": {
      "type": "array",
      "value": "[skip(parameters('testArray'),parameters('elementsToSkip'))]"
    },
    "stringOutput": {
      "type": "string",
      "value": "[skip(parameters('testString'),parameters('charactersToSkip'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
arrayOutput	Matrix	["drie"]
stringOutput	String	twee drie

split

split(inputString, delimiter)

Retourneert een matrix met tekenreeksen die de subtekenreeksen van de invoertekenreeks bevat die worden gescheiden door de opgegeven scheidingstekens.

Gebruik in Bicep de splitsfunctie .

Parameters

Parameter	Vereist	Type	Description
inputString	Ja	tekenreeks	De tekenreeks die moet worden gesplitst.
scheidingsteken	Ja	tekenreeks of matrix met tekenreeksen	Het scheidingsteken dat moet worden gebruikt voor het splitsen van de tekenreeks.

Retourwaarde

Een matrix met tekenreeksen.

Voorbeelden

In het volgende voorbeeld wordt de invoertekenreeks gesplitst met een komma en met een komma of een puntkomma.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "firstString": {
      "type": "string",
      "defaultValue": "one,two,three"
    },
    "secondString": {
      "type": "string",
      "defaultValue": "one;two,three"
    }
  },
  "variables": {
    "delimiters": [ ",", ";" ]
  },
  "resources": [],
  "outputs": {
    "firstOutput": {
      "type": "array",
      "value": "[split(parameters('firstString'),',')]"
    },
    "secondOutput": {
      "type": "array",
      "value": "[split(parameters('secondString'),variables('delimiters'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
firstOutput	Matrix	["één", "twee", "drie"]
secondOutput	Matrix	["één", "twee", "drie"]

startsWith

startsWith(stringToSearch, stringToFind)

Bepaalt of een tekenreeks begint met een waarde. De vergelijking is niet hoofdlettergevoelig.

Gebruik in Bicep de functie startsWith .

Parameters

Parameter	Vereist	Type	Description
stringToSearch	Ja	tekenreeks	De waarde die het item bevat dat moet worden gevonden.
stringToFind	Ja	tekenreeks	De te vinden waarde.

Retourwaarde

Waar als het eerste teken of de eerste tekens van de tekenreeks overeenkomen met de waarde; anders onwaar.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de startsWith functies en endsWith functies gebruikt:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [],
  "outputs": {
    "startsTrue": {
      "type": "bool",
      "value": "[startsWith('abcdef', 'ab')]"
    },
    "startsCapTrue": {
      "type": "bool",
      "value": "[startsWith('abcdef', 'A')]"
    },
    "startsFalse": {
      "type": "bool",
      "value": "[startsWith('abcdef', 'e')]"
    },
    "endsTrue": {
      "type": "bool",
      "value": "[endsWith('abcdef', 'ef')]"
    },
    "endsCapTrue": {
      "type": "bool",
      "value": "[endsWith('abcdef', 'F')]"
    },
    "endsFalse": {
      "type": "bool",
      "value": "[endsWith('abcdef', 'e')]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
startsTrue	Bool	Waar
startsCapTrue	Bool	Waar
startsFalse	Bool	Onwaar
endsTrue	Bool	Waar
endsCapTrue	Bool	Waar
endsFalse	Bool	Onwaar

tekenreeks

string(valueToConvert)

Converteert de opgegeven waarde naar een tekenreeks.

Gebruik in Bicep de tekenreeksfunctie .

Parameters

Parameter	Vereist	Type	Description
valueToConvert	Ja	Alle	De waarde die moet worden geconverteerd naar een tekenreeks. Elk type waarde kan worden geconverteerd, inclusief objecten en matrices.

Retourwaarde

Een tekenreeks van de geconverteerde waarde.

Voorbeelden

In het volgende voorbeeld ziet u hoe u verschillende typen waarden converteert naar tekenreeksen.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testObject": {
      "type": "object",
      "defaultValue": {
        "valueA": 10,
        "valueB": "Example Text"
      }
    },
    "testArray": {
      "type": "array",
      "defaultValue": [
        "a",
        "b",
        "c"
      ]
    },
    "testInt": {
      "type": "int",
      "defaultValue": 5
    }
  },
  "resources": [],
  "outputs": {
    "objectOutput": {
      "type": "string",
      "value": "[string(parameters('testObject'))]"
    },
    "arrayOutput": {
      "type": "string",
      "value": "[string(parameters('testArray'))]"
    },
    "intOutput": {
      "type": "string",
      "value": "[string(parameters('testInt'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
objectOutput	String	{"valueA":10,"valueB":"Example Text"}
arrayOutput	String	["a","b","c"]
intOutput	String	5

Subtekenreeks

substring(stringToParse, startIndex, length)

Retourneert een subtekenreeks die begint bij de opgegeven tekenpositie en het opgegeven aantal tekens bevat.

Gebruik in Bicep de subtekenreeksfunctie .

Parameters

Parameter	Vereist	Type	Description
stringToParse	Ja	tekenreeks	De oorspronkelijke tekenreeks waaruit de subtekenreeks wordt geëxtraheerd.
startIndex	Nee	int	De op nul gebaseerde begintekenpositie voor de subtekenreeks.
length	Nee	int	Het aantal tekens voor de subtekenreeks. Moet verwijzen naar een locatie in de tekenreeks. Moet nul of groter zijn. Als u dit weglaat, wordt de rest van de tekenreeks vanaf de beginpositie geretourneerd.

Retourwaarde

De subtekenreeks. Of een lege tekenreeks als de lengte nul is.

Opmerkingen

De functie mislukt wanneer de subtekenreeks zich buiten het einde van de tekenreeks bevindt of wanneer de lengte kleiner is dan nul. Het volgende voorbeeld mislukt met de fout 'De index- en lengteparameters moeten verwijzen naar een locatie in de tekenreeks. De indexparameter: '0', de lengteparameter: '11', de lengte van de tekenreeksparameter: '10'.

"parameters": {
  "inputString": {
    "type": "string",
    "value": "1234567890"
  }
}, "variables": {
  "prefix": "[substring(parameters('inputString'), 0, 11)]"
}

Voorbeelden

In het volgende voorbeeld wordt een subtekenreeks uit een parameter geëxtraheerd.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testString": {
      "type": "string",
      "defaultValue": "one two three"
    }
  },
  "resources": [],
  "outputs": {
    "substringOutput": {
      "type": "string",
      "value": "[substring(parameters('testString'), 4, 3)]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
subtekenreeksOutput	String	twee

take

take(originalValue, numberToTake)

Hiermee wordt een matrix of tekenreeks geretourneerd. Een matrix heeft het opgegeven aantal elementen vanaf het begin van de matrix. Een tekenreeks heeft het opgegeven aantal tekens vanaf het begin van de tekenreeks.

Gebruik in Bicep de take-functie .

Parameters

Parameter	Vereist	Type	Description
Originalvalue	Ja	matrix of tekenreeks	De matrix of tekenreeks waaruit de elementen moeten worden opgehaald.
numberToTake	Ja	int	Het aantal elementen of tekens dat moet worden gebruikt. Als deze waarde 0 of minder is, wordt een lege matrix of tekenreeks geretourneerd. Als deze groter is dan de lengte van de opgegeven matrix of tekenreeks, worden alle elementen in de matrix of tekenreeks geretourneerd.

Retourwaarde

Een matrix of tekenreeks.

Voorbeelden

In het volgende voorbeeld wordt het opgegeven aantal elementen uit de matrix en tekens uit een tekenreeks gebruikt.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testArray": {
      "type": "array",
      "defaultValue": [
        "one",
        "two",
        "three"
      ]
    },
    "elementsToTake": {
      "type": "int",
      "defaultValue": 2
    },
    "testString": {
      "type": "string",
      "defaultValue": "one two three"
    },
    "charactersToTake": {
      "type": "int",
      "defaultValue": 2
    }
  },
  "resources": [],
  "outputs": {
    "arrayOutput": {
      "type": "array",
      "value": "[take(parameters('testArray'),parameters('elementsToTake'))]"
    },
    "stringOutput": {
      "type": "string",
      "value": "[take(parameters('testString'),parameters('charactersToTake'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
arrayOutput	Matrix	["één", "twee"]
stringOutput	String	op

toLower

toLower(stringToChange)

Converteert de opgegeven tekenreeks naar kleine letters.

Gebruik in Bicep de functie toLower .

Parameters

Parameter	Vereist	Type	Description
stringToChange	Ja	tekenreeks	De waarde die moet worden geconverteerd naar kleine letters.

Retourwaarde

De tekenreeks is geconverteerd naar kleine letters.

Voorbeelden

In het volgende voorbeeld wordt een parameterwaarde geconverteerd naar kleine letters en hoofdletters.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testString": {
      "type": "string",
      "defaultValue": "One Two Three"
    }
  },
  "resources": [],
  "outputs": {
    "toLowerOutput": {
      "type": "string",
      "value": "[toLower(parameters('testString'))]"
    },
    "toUpperOutput": {
      "type": "string",
      "value": "[toUpper(parameters('testString'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
toLowerOutput	String	Een twee drie
toUpperOutput	String	EEN TWEE DRIE

Toupper

toUpper(stringToChange)

Converteert de opgegeven tekenreeks naar hoofdletters.

Gebruik in Bicep de functie toUpper .

Parameters

Parameter	Vereist	Type	Description
stringToChange	Ja	tekenreeks	De waarde die moet worden geconverteerd naar hoofdletters.

Retourwaarde

De tekenreeks is geconverteerd naar hoofdletters.

Voorbeelden

In het volgende voorbeeld wordt een parameterwaarde geconverteerd naar kleine letters en hoofdletters.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testString": {
      "type": "string",
      "defaultValue": "One Two Three"
    }
  },
  "resources": [],
  "outputs": {
    "toLowerOutput": {
      "type": "string",
      "value": "[toLower(parameters('testString'))]"
    },
    "toUpperOutput": {
      "type": "string",
      "value": "[toUpper(parameters('testString'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
toLowerOutput	String	Een twee drie
toUpperOutput	String	EEN TWEE DRIE

trim

trim(stringToTrim)

Hiermee verwijdert u alle voorloop- en volgspaties uit de opgegeven tekenreeks.

Gebruik in Bicep de trimfunctie .

Parameters

Parameter	Vereist	Type	Description
stringToTrim	Ja	tekenreeks	De waarde die u wilt bijsnijden.

Retourwaarde

De tekenreeks zonder voorloop- en volgspaties.

Voorbeelden

In het volgende voorbeeld worden de spatietekens uit de parameter bijgeknipt.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testString": {
      "type": "string",
      "defaultValue": "    one two three   "
    }
  },
  "resources": [],
  "outputs": {
    "return": {
      "type": "string",
      "value": "[trim(parameters('testString'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
enter	String	Een twee drie

uniqueString

uniqueString(baseString, ...)

Hiermee maakt u een deterministische hashtekenreeks op basis van de waarden die zijn opgegeven als parameters.

Gebruik in Bicep de uniqueString-functie .

Parameters

Parameter	Vereist	Type	Description
baseString	Ja	tekenreeks	De waarde die wordt gebruikt in de hash-functie om een unieke tekenreeks te maken.
meer parameters indien nodig	Nee	tekenreeks	U kunt zoveel tekenreeksen toevoegen als nodig is om de waarde te maken die het uniekheidsniveau aangeeft.

Opmerkingen

Deze functie is handig wanneer u een unieke naam voor een resource moet maken. U geeft parameterwaarden op waarmee het bereik van uniekheid voor het resultaat wordt beperkt. U kunt opgeven of de naam uniek is voor abonnement, resourcegroep of implementatie.

De geretourneerde waarde is geen willekeurige tekenreeks, maar eerder het resultaat van een hash-functie. De geretourneerde waarde is 13 tekens lang. Het is niet wereldwijd uniek. U kunt de waarde combineren met een voorvoegsel van uw naamconventie om een betekenisvolle naam te maken. In het volgende voorbeeld ziet u de indeling van de geretourneerde waarde. De werkelijke waarde verschilt per opgegeven parameters.

tcvhiyu5h2o5o

In de volgende voorbeelden ziet u hoe uniqueString u een unieke waarde maakt voor veelgebruikte niveaus.

Uniek bereik voor abonnement

"[uniqueString(subscription().subscriptionId)]"

Uniek bereik voor resourcegroep

"[uniqueString(resourceGroup().id)]"

Uniek bereik voor implementatie voor een resourcegroep

"[uniqueString(resourceGroup().id, deployment().name)]"

In het volgende voorbeeld ziet u hoe u een unieke naam maakt voor een opslagaccount op basis van uw resourcegroep. Binnen de resourcegroep is de naam niet uniek als deze op dezelfde manier wordt samengesteld.

"resources": [{
  "name": "[concat('storage', uniqueString(resourceGroup().id))]",
  "type": "Microsoft.Storage/storageAccounts",
  ...

Als u telkens wanneer u een sjabloon implementeert een nieuwe unieke naam moet maken en de resource niet wilt bijwerken, kunt u de utcNow-functie gebruiken met uniqueString. U kunt deze benadering gebruiken in een testomgeving. Zie utcNow voor een voorbeeld.

Retourwaarde

Een tekenreeks met 13 tekens.

Voorbeelden

Het volgende voorbeeld retourneert resultaten van uniquestring:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [],
  "outputs": {
    "uniqueRG": {
      "type": "string",
      "value": "[uniqueString(resourceGroup().id)]"
    },
    "uniqueDeploy": {
      "type": "string",
      "value": "[uniqueString(resourceGroup().id, deployment().name)]"
    }
  }
}

uri

uri(baseUri, relativeUri)

Hiermee maakt u een absolute URI door de baseUri en de relativeUri-tekenreeks te combineren.

Gebruik in Bicep de URI-functie .

Parameters

Parameter	Vereist	Type	Description
baseUri	Ja	tekenreeks	De basis-URI-tekenreeks. Let op het gedrag van de verwerking van de afsluitende slash (/), zoals beschreven in deze tabel.
relativeUri	Ja	tekenreeks	De relatieve URI-tekenreeks die moet worden toegevoegd aan de basis-URI-tekenreeks.

• Als baseUri eindigt op een afsluitende slash, is het resultaat baseUri gevolgd door relativeUri.

• Als baseUri niet eindigt op een afsluitende slash, gebeurt er een van de twee dingen.

  • Als baseUri helemaal geen slashes heeft (afgezien van de // voorzijde) is het resultaat baseUri gevolgd door relativeUri.

  • Als baseUri een aantal slashes heeft, maar niet eindigt op een slash, wordt alles van de laatste slash verwijderd uit de baseUri en wordt het resultaat baseUri gevolgd door relativeUri.

Hieronder volgen een aantal voorbeelden:

uri('http://contoso.org/firstpath', 'myscript.sh') -> http://contoso.org/myscript.sh
uri('http://contoso.org/firstpath/', 'myscript.sh') -> http://contoso.org/firstpath/myscript.sh
uri('http://contoso.org/firstpath/azuredeploy.json', 'myscript.sh') -> http://contoso.org/firstpath/myscript.sh
uri('http://contoso.org/firstpath/azuredeploy.json/', 'myscript.sh') -> http://contoso.org/firstpath/azuredeploy.json/myscript.sh

Voor volledige details worden de parameters baseUri en relativeUri omgezet zoals opgegeven in RFC 3986, sectie 5.

Retourwaarde

Een tekenreeks die de absolute URI voor de basis- en relatieve waarden vertegenwoordigt.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een koppeling maakt naar een geneste sjabloon op basis van de waarde van de bovenliggende sjabloon.

"templateLink": "[uri(deployment().properties.templateLink.uri, 'nested/azuredeploy.json')]"

In de volgende voorbeeldsjabloon ziet u hoe uriu , uriComponenten uriComponentToString.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "variables": {
    "uriFormat": "[uri('http://contoso.com/resources/', 'nested/azuredeploy.json')]",
    "uriEncoded": "[uriComponent(variables('uriFormat'))]"
  },
  "resources": [
  ],
  "outputs": {
    "uriOutput": {
      "type": "string",
      "value": "[variables('uriFormat')]"
    },
    "componentOutput": {
      "type": "string",
      "value": "[variables('uriEncoded')]"
    },
    "toStringOutput": {
      "type": "string",
      "value": "[uriComponentToString(variables('uriEncoded'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
uriOutput	String	http://contoso.com/resources/nested/azuredeploy.json
componentOutput	String	http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json
toStringOutput	String	http://contoso.com/resources/nested/azuredeploy.json

uriComponent

uricomponent(stringToEncode)

Codeert een URI.

Gebruik in Bicep de functie uriComponent .

Parameters

Parameter	Vereist	Type	Description
stringToEncode	Ja	tekenreeks	De waarde die moet worden gecodeerd.

Retourwaarde

Een tekenreeks van de gecodeerde URI-waarde.

Voorbeelden

In de volgende voorbeeldsjabloon ziet u hoe uriu , uriComponenten uriComponentToString.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "variables": {
    "uriFormat": "[uri('http://contoso.com/resources/', 'nested/azuredeploy.json')]",
    "uriEncoded": "[uriComponent(variables('uriFormat'))]"
  },
  "resources": [
  ],
  "outputs": {
    "uriOutput": {
      "type": "string",
      "value": "[variables('uriFormat')]"
    },
    "componentOutput": {
      "type": "string",
      "value": "[variables('uriEncoded')]"
    },
    "toStringOutput": {
      "type": "string",
      "value": "[uriComponentToString(variables('uriEncoded'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
uriOutput	String	http://contoso.com/resources/nested/azuredeploy.json
componentOutput	String	http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json
toStringOutput	String	http://contoso.com/resources/nested/azuredeploy.json

uriComponentToString

uriComponentToString(uriEncodedString)

Retourneert een tekenreeks van een URI-gecodeerde waarde.

Gebruik in Bicep de functie uriComponentToString .

Parameters

Parameter	Vereist	Type	Description
uriEncodedString	Ja	tekenreeks	De gecodeerde URI-waarde die moet worden geconverteerd naar een tekenreeks.

Retourwaarde

Een gedecodeerde tekenreeks met URI-gecodeerde waarde.

Voorbeelden

In het volgende voorbeeld ziet u hoe uriu , uriComponenten uriComponentToString.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "variables": {
    "uriFormat": "[uri('http://contoso.com/resources/', 'nested/azuredeploy.json')]",
    "uriEncoded": "[uriComponent(variables('uriFormat'))]"
  },
  "resources": [
  ],
  "outputs": {
    "uriOutput": {
      "type": "string",
      "value": "[variables('uriFormat')]"
    },
    "componentOutput": {
      "type": "string",
      "value": "[variables('uriEncoded')]"
    },
    "toStringOutput": {
      "type": "string",
      "value": "[uriComponentToString(variables('uriEncoded'))]"
    }
  }
}

De uitvoer uit het voorgaande voorbeeld met de standaardwaarden is:

Name	Type	Weergegeven als
uriOutput	String	http://contoso.com/resources/nested/azuredeploy.json
componentOutput	String	http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json
toStringOutput	String	http://contoso.com/resources/nested/azuredeploy.json

Volgende stappen

• Zie De structuur en syntaxis van ARM-sjablonen begrijpen voor een beschrijving van de secties in een ARM-sjabloon.
• Zie Gekoppelde en geneste sjablonen gebruiken bij het implementeren van Azure-resources als u meerdere sjablonen wilt samenvoegen.
• Als u een bepaald aantal keren wilt herhalen wanneer u een type resource maakt, raadpleegt u resource-iteratie in ARM-sjablonen.
• Zie Resources implementeren met ARM-sjablonen en Azure PowerShell om te zien hoe u de sjabloon implementeert die u hebt gemaakt.