A Bicep sztringfüggvényei

Cikk
07/11/2024

Ez a cikk a Bicep-függvényeket ismerteti a sztringek használatához.

base64

base64(inputString)

A bemeneti sztring base64-ábrázolását adja vissza.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
inputString	Igen	húr	A base64-ábrázolásként visszaadandó érték.

Visszaadott érték

A base64-ábrázolást tartalmazó sztring.

Példák

Az alábbi példa a base64 függvény használatát mutatja be.

param stringData string = 'one, two, three'
param jsonFormattedData string = '{\'one\': \'a\', \'two\': \'b\'}'

var base64String = base64(stringData)
var base64Object = base64(jsonFormattedData)

output base64Output string = base64String
output toStringOutput string = base64ToString(base64String)
output toJsonOutput object = base64ToJson(base64Object)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
base64Output	Sztring	b25lLCB0d28sIHRocmVl
toStringOutput	Sztring	egy két há'
toJsonOutput	Objektum	{"one": "a", "two": "b"}

base64ToJson

base64ToJson(base64Value)

A base64-ábrázolás JSON-objektummá alakít át.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
base64Value	Igen	húr	A JSON-objektummá alakítandó base64-ábrázolás.

Visszaadott érték

JSON-objektum.

Példák

Az alábbi példa a base64ToJson függvényt használja egy base64-érték konvertálásához:

param stringData string = 'one, two, three'
param jsonFormattedData string = '{\'one\': \'a\', \'two\': \'b\'}'

var base64String = base64(stringData)
var base64Object = base64(jsonFormattedData)

output base64Output string = base64String
output toStringOutput string = base64ToString(base64String)
output toJsonOutput object = base64ToJson(base64Object)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
base64Output	Sztring	b25lLCB0d28sIHRocmVl
toStringOutput	Sztring	egy két há'
toJsonOutput	Objektum	{"one": "a", "two": "b"}

base64ToString

base64ToString(base64Value)

Egy base64-ábrázolás sztringgé alakít át.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
base64Value	Igen	húr	A sztringgé alakítandó base64-ábrázolás.

Visszaadott érték

A konvertált base64 érték sztringje.

Példák

Az alábbi példa a base64ToString függvényt használja egy base64-érték konvertálásához:

param stringData string = 'one, two, three'
param jsonFormattedData string = '{\'one\': \'a\', \'two\': \'b\'}'

var base64String = base64(stringData)
var base64Object = base64(jsonFormattedData)

output base64Output string = base64String
output toStringOutput string = base64ToString(base64String)
output toJsonOutput object = base64ToJson(base64Object)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
base64Output	Sztring	b25lLCB0d28sIHRocmVl
toStringOutput	Sztring	egy két há'
toJsonOutput	Objektum	{"one": "a", "two": "b"}

összefűzés

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

Több sztringértéket egyesít, és visszaadja az összefűzött sztringet, vagy több tömböt egyesít, és visszaadja az összefűzött tömböt. Az olvashatóság javítása érdekében a függvény helyett sztring-interpolációt concat() használjon. Bizonyos esetekben azonban, például a többsoros sztringek sztringcseréje esetén előfordulhat, hogy vissza kell esnie a függvény vagy areplace() concat() függvény használatára.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
arg1	Igen	sztring vagy tömb	Az összefűzés első sztringje vagy tömbje.
további argumentumok	Nem	sztring vagy tömb	További sztringek vagy tömbök szekvenciális sorrendben az összefűzéshez.

Ez a függvény tetszőleges számú argumentumot tartalmazhat, és sztringeket vagy tömböket is elfogadhat a paraméterekhez. A paraméterekhez azonban nem adhat meg tömböket és sztringeket. A sztringek csak más sztringekkel vannak összefűzve.

Visszaadott érték

Összefűzött értékek sztringje vagy tömbje.

Példák

Az alábbi példa az interpoláció és a függvény használata közötti összehasonlítást concat() mutatja be. A két kimenet ugyanazt az értéket adja vissza.

param prefix string = 'prefix'

output concatOutput string = concat(prefix, 'And', uniqueString(resourceGroup().id))
output interpolationOutput string = '${prefix}And${uniqueString(resourceGroup().id)}'

Az előző példában az alapértelmezett értékkel rendelkező kimenetek a következők:

Név	Típus	Érték
concatOutput	Sztring	előtagAnd5yj4yjf5mbg72
interpolationOutput	Sztring	előtagAnd5yj4yjf5mbg72

Az interpoláció jelenleg nem támogatott többsoros sztringekben. Az alábbi példa az interpoláció és a függvény használata közötti összehasonlítást concat() mutatja be.

var blocked = 'BLOCKED'

output concatOutput string = concat('''interpolation
is ''', blocked)
output interpolationOutput string = '''interpolation
is ${blocked}'''

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
concatOutput	Sztring	interpolation\nis BLOCKED
interpolationOutput	Sztring	interpolation\nis ${blocked}

contains

contains(container, itemToFind)

Ellenőrzi, hogy egy tömb tartalmaz-e értéket, egy objektum tartalmaz-e kulcsot, vagy egy sztring tartalmaz-e részsztringet. A sztringek összehasonlítása megkülönbözteti a kis- és nagybetűk értékét. Ha azonban egy objektum tartalmaz kulcsot, az összehasonlítás érzéketlen.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
tároló	Igen	tömb, objektum vagy sztring	A keresendő értéket tartalmazó érték.
itemToFind	Igen	sztring vagy int	A keresendő érték.

Visszaadott érték

Trueha az elem megtalálható; egyéb esetben. False

Példák

Az alábbi példa bemutatja, hogyan használható különböző típusú:

param stringToTest string = 'OneTwoThree'
param objectToTest object = {
  one: 'a'
  two: 'b'
  three: 'c'
}
param arrayToTest array = [
  'one'
  'two'
  'three'
]

output stringTrue bool = contains(stringToTest, 'e')
output stringFalse bool = contains(stringToTest, 'z')
output objectTrue bool = contains(objectToTest, 'one')
output objectFalse bool = contains(objectToTest, 'a')
output arrayTrue bool = contains(arrayToTest, 'three')
output arrayFalse bool = contains(arrayToTest, 'four')

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
stringTrue	Bool	Igaz
stringFalse	Bool	Hamis
objectTrue	Bool	Igaz
objectFalse	Bool	Hamis
arrayTrue	Bool	Igaz
arrayFalse	Bool	Hamis

dataUri

dataUri(stringToConvert)

Egy értéket adat URI-vá alakít át.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
stringToConvert	Igen	húr	Az adat URI-vá konvertálandó érték.

Visszaadott érték

Adat URI-ként formázott sztring.

Példák

Az alábbi példa egy értéket adat URI-vá alakít át, és egy adat URI-t sztringgé alakít át:

param stringToTest string = 'Hello'
param dataFormattedString string = 'data:;base64,SGVsbG8sIFdvcmxkIQ=='

output dataUriOutput string = dataUri(stringToTest)
output toStringOutput string = dataUriToString(dataFormattedString)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
dataUriOutput	Sztring	data:text/plain; charset=utf8; base64,SGVsbG8=
toStringOutput	Sztring	Helló világ!

dataUriToString

dataUriToString(dataUriToConvert)

Az adat URI formátumú értékét sztringgé alakítja át.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
dataUriToConvert	Igen	húr	Az átalakítandó adat URI-értéke.

Visszaadott érték

A konvertált értéket tartalmazó sztring.

Példák

Az alábbi példa egy értéket adat URI-vá alakít át, és egy adat URI-t sztringgé alakít át:

param stringToTest string = 'Hello'
param dataFormattedString string = 'data:;base64,SGVsbG8sIFdvcmxkIQ=='

output dataUriOutput string = dataUri(stringToTest)
output toStringOutput string = dataUriToString(dataFormattedString)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
dataUriOutput	Sztring	data:text/plain; charset=utf8; base64,SGVsbG8=
toStringOutput	Sztring	Helló világ!

üres

empty(itemToTest)

Meghatározza, hogy egy tömb, objektum vagy sztring üres vagy null értékű-e.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
itemToTest	Igen	tömb, objektum vagy sztring	Az az érték, amely ellenőrzi, hogy üres vagy null értékű-e.

Visszaadott érték

Igaz értéket ad vissza, ha az érték üres vagy null; ellenkező esetben Hamis.

Példák

Az alábbi példa azt ellenőrzi, hogy egy tömb, objektum és sztring üres-e.

param testArray array = []
param testObject object = {}
param testString string = ''
param testNullString string?

output arrayEmpty bool = empty(testArray)
output objectEmpty bool = empty(testObject)
output stringEmpty bool = empty(testString)
output stringNull bool = empty(testNullString)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
arrayEmpty	Bool	Igaz
objectEmpty	Bool	Igaz
stringEmpty	Bool	Igaz
stringNull	Bool	Igaz

endsWith

endsWith(stringToSearch, stringToFind)

Meghatározza, hogy egy sztring értéke végződik-e. Az összehasonlítás kis- és nagybetűket nem érzékelyítő.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
stringToSearch	Igen	húr	A keresendő elemet tartalmazó érték.
stringToFind	Igen	húr	A keresendő érték.

Visszaadott érték

Trueha a sztring utolsó karaktere vagy karaktere megegyezik az értékkel; egyéb esetben. False

Példák

Az alábbi példa a startsWith és a endsWith függvény használatát mutatja be:

output startsTrue bool = startsWith('abcdef', 'ab')
output startsCapTrue bool = startsWith('abcdef', 'A')
output startsFalse bool = startsWith('abcdef', 'e')
output endsTrue bool = endsWith('abcdef', 'ef')
output endsCapTrue bool = endsWith('abcdef', 'F')
output endsFalse bool = endsWith('abcdef', 'e')

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
startsTrue	Bool	Igaz
startsCapTrue	Bool	Igaz
startsFalse	Bool	Hamis
endsTrue	Bool	Igaz
endsCapTrue	Bool	Igaz
endsFalse	Bool	Hamis

első

first(arg1)

A sztring első karakterét vagy a tömb első elemét adja vissza. Ha üres sztringet ad meg, a függvény üres sztringet eredményez. Üres tömb esetén a függvény visszaadja a függvényt null.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
arg1	Igen	tömb vagy sztring	Az első elem vagy karakter beolvasásának értéke.

Visszaadott érték

A tömb első elemének karakterlánca, vagy a tömb első elemének típusa (sztring, int, tömb vagy objektum).

Példák

Az alábbi példa bemutatja, hogyan használható az első függvény tömbökkel és sztringekkel.

param arrayToTest array = [
  'one'
  'two'
  'three'
]

output arrayOutput string = first(arrayToTest)
output stringOutput string = first('One Two Three')

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
arrayOutput	Sztring	egy
stringOutput	Sztring	O

format

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

Formázott sztringet hoz létre a bemeneti értékekből.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
formatString	Igen	húr	Az összetett formátum sztringje.
arg1	Igen	sztring, egész szám vagy logikai érték	A formázott sztringben szerepeltetni kívánt érték.
további argumentumok	Nem	sztring, egész szám vagy logikai érték	További értékek a formázott sztringben.

Megjegyzések

Ezzel a függvénnyel formázhat egy sztringet a Bicep-fájlban. Ugyanazokat a formázási beállításokat használja, mint a System.String.Format metódus a .NET-ben.

Példák

Az alábbi példa a formátumfüggvény használatát mutatja be.

param greeting string = 'Hello'
param name string = 'User'
param numberToFormat int = 8175133
param objectToFormat object = { prop: 'value' }

output formatTest string = format('{0}, {1}. Formatted number: {2:N0}', greeting, name, numberToFormat)
output formatObject string = format('objectToFormat: {0}', objectToFormat)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
formatTest	Sztring	`Hello, User. Formatted number: 8,175,133`
formatObject	Sztring	`objectToFormat: {'prop':'value'}`

guid

guid(baseString, ...)

A paraméterként megadott értékek alapján globálisan egyedi azonosító formájában hoz létre értéket.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
baseString	Igen	húr	A KIVONAT függvényben a GUID létrehozásához használt érték.
szükség szerint további paraméterek	Nem	húr	Az egyediséget meghatározó érték létrehozásához szükség szerint annyi sztringet adhat hozzá.

Megjegyzések

Ez a függvény akkor hasznos, ha globálisan egyedi azonosító formátumú értéket kell létrehoznia. Olyan paraméterértékeket ad meg, amelyek korlátozzák az eredmény egyediségének hatókörét. Megadhatja, hogy a név egyedi legyen-e előfizetésre, erőforráscsoportra vagy üzembe helyezésre.

A visszaadott érték nem véletlenszerű sztring, hanem a paraméterek kivonatfüggvényének eredménye. A visszaadott érték 36 karakter hosszú. Ez nem globálisan egyedi. Ha olyan új GUID-t szeretne létrehozni, amely nem a paraméterek kivonatértékén alapul, használja a newGuid függvényt .

Feljegyzés

A paraméterek sorrendje befolyásolja a visszaadott értéket. Példa:

guid('hello', 'world') és guid('world', 'hello')

ne adja vissza ugyanazt az értéket.

Az alábbi példák bemutatják, hogyan hozhat létre egyedi értéket a gyakran használt szintek guidjaival.

Előfizetésre vonatkozó egyedi hatókör

guid(subscription().subscriptionId)

Erőforráscsoportra vonatkozó egyedi hatókör

guid(resourceGroup().id)

Erőforráscsoport üzembe helyezésének egyedi hatóköre

guid(resourceGroup().id, deployment().name)

A guid függvény implementálja az algoritmust az RFC 4122 §4.3-ából. Az eredeti forrás néhány módosítással megtalálható a GuidUtility-ben.

Visszaadott érték

Globálisan egyedi azonosító formátumban 36 karaktert tartalmazó sztring.

Példák

Az alábbi példa a GUID-ból származó eredményeket adja vissza:

output guidPerSubscription string = guid(subscription().subscriptionId)
output guidPerResourceGroup string = guid(resourceGroup().id)
output guidPerDeployment string = guid(resourceGroup().id, deployment().name)

indexOf

indexOf(stringToSearch, stringToFind)

Egy érték első pozícióját adja vissza egy sztringen belül. Az összehasonlítás kis- és nagybetűket nem érzékelyítő.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
stringToSearch	Igen	húr	A keresendő elemet tartalmazó érték.
stringToFind	Igen	húr	A keresendő érték.

Visszaadott érték

Egy egész szám, amely a keresendő elem pozícióját jelöli. Az érték nulla alapú. Ha az elem nem található, a rendszer a -1 értéket adja vissza.

Példák

Az alábbi példa az indexOf és a lastIndexOf függvény használatát mutatja be:

output firstT int = indexOf('test', 't')
output lastT int = lastIndexOf('test', 't')
output firstString int = indexOf('abcdef', 'CD')
output lastString int = lastIndexOf('abcdef', 'AB')
output notFound int = indexOf('abcdef', 'z')

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
firstT	Int	0
lastT	Int	3
firstString	Int	2
lastString	Int	0
notFound	Int	1-

Csatlakozás

join(inputArray, delimiter)

Egy sztringtömböt egyetlen sztringbe illeszt, elválasztójellel elválasztva.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
inputArray	Igen	Egy sztringtömb.	Összekapcsolandó sztringek tömbje.
Határoló	Igen	A sztring felosztásához használandó elválasztó.

Visszaadott érték

Egy sztring.

Példák

Az alábbi példa a bemeneti sztringtömböt vesszővel vagy pontosvesszővel tagolt sztringekké alakítja.

var arrayString = [
  'one'
  'two'
  'three'
]

output firstOutput string = join(arrayString, ',')
output secondOutput string = join(arrayString, ';')

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
firstOutput	Sztring	"egy,kettő,három"
secondOutput	Sztring	"egy; Kettő; három"

Ehhez a függvényhez a Bicep CLI 0.8.X-es vagy újabb verziója szükséges.

json

json(arg1)

Egy érvényes JSON-sztringet JSON-adattípussá alakít át. További információ: json függvény.

Névtér: sys.

utolsó

last(arg1)

A sztring utolsó karakterét vagy a tömb utolsó elemét adja vissza.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
arg1	Igen	tömb vagy sztring	Az utolsó elem vagy karakter beolvasásának értéke.

Visszaadott érték

Egy tömb utolsó elemének utolsó karakterének vagy típusának (sztring, int, tömb vagy objektum) karakterlánca.

Példák

Az alábbi példa bemutatja, hogyan használható az utolsó függvény tömbökkel és sztringekkel.

param arrayToTest array = [
  'one'
  'two'
  'three'
]

output arrayOutput string = last(arrayToTest)
output stringOutput string = last('One Two Three')

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
arrayOutput	Sztring	három
stringOutput	Sztring	e

lastIndexOf

lastIndexOf(stringToSearch, stringToFind)

Egy karakterláncon belüli érték utolsó pozícióját adja vissza. Az összehasonlítás kis- és nagybetűket nem érzékelyítő.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
stringToSearch	Igen	húr	A keresendő elemet tartalmazó érték.
stringToFind	Igen	húr	A keresendő érték.

Visszaadott érték

Egy egész szám, amely a megkeresendő elem utolsó pozícióját jelöli. Az érték nulla alapú. Ha az elem nem található, a rendszer a -1 értéket adja vissza.

Példák

Az alábbi példa a függvények és lastIndexOf a indexOf függvények használatát mutatja be:

output firstT int = indexOf('test', 't')
output lastT int = lastIndexOf('test', 't')
output firstString int = indexOf('abcdef', 'CD')
output lastString int = lastIndexOf('abcdef', 'AB')
output notFound int = indexOf('abcdef', 'z')

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
firstT	Int	0
lastT	Int	3
firstString	Int	2
lastString	Int	0
notFound	Int	1-

length (hossz)

length(string)

Visszaadja egy sztring karaktereinek számát, egy tömb elemeit vagy egy objektum gyökérszintű tulajdonságait.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
arg1	Igen	tömb, sztring vagy objektum	Az elemek számának lekéréséhez használandó tömb, a karakterek számának lekéréséhez használandó sztring vagy a gyökérszintű tulajdonságok számának lekéréséhez használni kívánt objektum.

Visszaadott érték

Egy int.

Példák

Az alábbi példa a hossz tömbökkel és sztringekkel való használatát mutatja be:

param arrayToTest array = [
  'one'
  'two'
  'three'
]
param stringToTest string = 'One Two Three'
param objectToTest object = {
  propA: 'one'
  propB: 'two'
  propC: 'three'
  propD: {
    'propD-1': 'sub'
    'propD-2': 'sub'
  }
}

output arrayLength int = length(arrayToTest)
output stringLength int = length(stringToTest)
output objectLength int = length(objectToTest)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
arrayLength	Int	3
stringLength	Int	13
objectLength	Int	4

newGuid

newGuid()

Globálisan egyedi azonosító formátumú értéket ad vissza. Ez a függvény csak egy paraméter alapértelmezett értékében használható.

Névtér: sys.

Megjegyzések

Ezt a függvényt csak egy paraméter alapértelmezett értékének kifejezésén belül használhatja. Ha ezt a függvényt bárhol máshol használja egy Bicep-fájlban, hibát ad vissza. A függvény nem engedélyezett a Bicep-fájl más részeiben, mert minden híváskor más értéket ad vissza. Ugyanazon Bicep-fájl ugyanazon paraméterekkel való üzembe helyezése nem eredményezne megbízhatóan ugyanazokat az eredményeket.

A newGuid függvény eltér a guid függvénytől, mert nem vesz fel paramétereket. Amikor ugyanazokkal a paraméterekkel hívja meg a GUID azonosítót, az minden alkalommal ugyanazt az azonosítót adja vissza. Akkor használja a GUID-t, ha megbízhatóan kell létrehoznia ugyanazt a GUID-t egy adott környezethez. Használja a newGuid-t, ha minden alkalommal más azonosítóra van szüksége, például erőforrásokat helyez üzembe egy tesztkörnyezetben.

A newGuid függvény a .NET-keretrendszer Guid struktúráját használja a globálisan egyedi azonosító létrehozásához.

Ha egy korábbi sikeres üzembe helyezés ismételt üzembe helyezésének lehetőségét használja, és a korábbi üzembe helyezés tartalmaz egy újGuid-t használó paramétert, a paraméter nem lesz újraértékelve. Ehelyett a rendszer automatikusan újra felhasználja a korábbi üzembe helyezés paraméterértékét a visszaállítási üzembe helyezés során.

Tesztkörnyezetben előfordulhat, hogy ismétlődően kell üzembe helyeznie azokat az erőforrásokat, amelyek csak rövid ideig élnek. Az egyedi nevek létrehozása helyett a newGuid és az uniqueString használatával egyedi neveket hozhat létre.

Ügyeljen arra, hogy újra üzembe helyezzen egy Bicep-fájlt, amely az alapértelmezett érték newGuid függvényére támaszkodik. Amikor újra üzembe helyezi a paramétert, és nem ad meg értéket, a függvény újraértékelódik. Ha egy meglévő erőforrást szeretne frissíteni ahelyett, hogy újat hozna létre, adja meg a paraméter értékét a korábbi üzembe helyezésből.

Visszaadott érték

Globálisan egyedi azonosító formátumban 36 karaktert tartalmazó sztring.

Példák

Az alábbi példa egy új azonosítóval rendelkező paramétert mutat be.

param guidValue string = newGuid()

output guidOutput string = guidValue

Az előző példában szereplő kimenet minden üzemelő példány esetében eltérő, de a következőhöz hasonló lesz:

Név	Típus	Érték
guidOutput	húr	b76a51fc-bd72-4a77-b9a2-3c29e7d2e551

Az alábbi példa a newGuid függvényt használja egy tárfiók egyedi nevének létrehozásához. Ez a Bicep-fájl olyan tesztkörnyezetben működhet, ahol a tárfiók rövid ideig létezik, és nem kerül újra üzembe.

param guidValue string = newGuid()

var storageName = 'storage${uniqueString(guidValue)}'

resource myStorage 'Microsoft.Storage/storageAccounts@2023-04-01' = {
  name: storageName
  location: 'West US'
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  properties: {}
}

output nameOutput string = storageName

Az előző példában szereplő kimenet minden üzemelő példány esetében eltérő, de a következőhöz hasonló lesz:

Név	Típus	Érték
nameOutput	húr	storagenziwvyru7uxie

padLeft

padLeft(valueToPad, totalLength, paddingCharacter)

Egy jobbra igazított sztringet ad vissza úgy, hogy karaktereket ad hozzá balra, amíg el nem éri a megadott teljes hosszt.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
valueToPad	Igen	sztring vagy int	A jobbra igazított érték.
totalLength	Igen	egész	A visszaadott sztringben szereplő karakterek teljes száma.
paddingCharacter	Nem	egyetlen karakter	A bal oldali kitöltéshez használandó karakter, amíg el nem éri a teljes hosszt. Az alapértelmezett érték egy szóköz.

Ha az eredeti sztring hosszabb, mint a beszúrandó karakterek száma, a rendszer nem ad hozzá karaktereket.

Visszaadott érték

Legalább a megadott karakterszámmal rendelkező sztring.

Példák

Az alábbi példa bemutatja, hogyan lehet a felhasználó által megadott paraméter értékét a nulla karakter hozzáadásával beszedni, amíg el nem éri a karakterek teljes számát.

param testString string = '123'

output stringOutput string = padLeft(testString, 10, '0')

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
stringOutput	Sztring	0000000123

helyettesít

replace(originalString, oldString, newString)

Egy új sztringet ad vissza, amely az egyik sztring összes példányát lecseréli egy másik sztringre.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
originalString	Igen	húr	Az az érték, amely egy sztring összes példányát lecseréli egy másik sztringre.
oldString	Igen	húr	Az eredeti sztringből eltávolítandó sztring.
newString	Igen	húr	Az eltávolított sztring helyett hozzáadni kívánt sztring.

Visszaadott érték

Sztring a lecserélt karakterekkel.

Példák

Az alábbi példa bemutatja, hogyan távolíthatja el az összes kötőjelet a felhasználó által megadott sztringből, és hogyan cserélheti le a sztring egy részét egy másik sztringre.

param testString string = '123-123-1234'

output firstOutput string = replace(testString, '-', '')
output secondOutput string = replace(testString, '1234', 'xxxx')

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
firstOutput	Sztring	1231231234
secondOutput	Sztring	123-123-xxxx

Kihagyás

skip(originalValue, numberToSkip)

A megadott számú karakter után az összes karaktert tartalmazó sztringet, vagy egy tömböt ad vissza, amely a megadott számú elem után az összes elemet tartalmazza.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
originalValue	Igen	tömb vagy sztring	A kihagyáshoz használandó tömb vagy sztring.
numberToSkip	Igen	egész	Az kihagyandó elemek vagy karakterek száma. Ha ez az érték 0 vagy kevesebb, a rendszer az érték összes elemét vagy karakterét visszaadja. Ha nagyobb, mint a tömb vagy a sztring hossza, a függvény üres tömböt vagy sztringet ad vissza.

Visszaadott érték

Tömb vagy sztring.

Példák

Az alábbi példa kihagyja a tömb megadott számú elemét és a sztringben megadott számú karaktert.

param testArray array = [
  'one'
  'two'
  'three'
]
param elementsToSkip int = 2
param testString string = 'one two three'
param charactersToSkip int = 4

output arrayOutput array = skip(testArray, elementsToSkip)
output stringOutput string = skip(testString, charactersToSkip)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
arrayOutput	Tömb	["három"]
stringOutput	Sztring	két három

hasít

split(inputString, delimiter)

A megadott elválasztójelekkel tagolt bemeneti sztring részsztringeit tartalmazó karakterlánctömböt ad vissza.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
inputString	Igen	húr	A felosztandó sztring.
Határoló	Igen	sztring vagy sztringtömb	A sztring felosztásához használandó elválasztó.

Visszaadott érték

Sztringek tömbje.

Példák

Az alábbi példa vesszővel és vesszővel vagy pontosvesszővel osztja fel a bemeneti sztringet.

param firstString string = 'one,two,three'
param secondString string = 'one;two,three'

var delimiters = [
  ','
  ';'
]

output firstOutput array = split(firstString, ',')
output secondOutput array = split(secondString, delimiters)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
firstOutput	Tömb	["one", "two", "three"]
secondOutput	Tömb	["one", "two", "three"]

startsWith

startsWith(stringToSearch, stringToFind)

Meghatározza, hogy egy sztring egy értékkel kezdődik-e. Az összehasonlítás kis- és nagybetűket nem érzékelyítő.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
stringToSearch	Igen	húr	A keresendő elemet tartalmazó érték.
stringToFind	Igen	húr	A keresendő érték.

Visszaadott érték

Trueha a sztring első karaktere vagy karaktere megegyezik az értékkel; egyéb esetben. False

Példák

Az alábbi példa a startsWith és a endsWith függvény használatát mutatja be:

output startsTrue bool = startsWith('abcdef', 'ab')
output startsCapTrue bool = startsWith('abcdef', 'A')
output startsFalse bool = startsWith('abcdef', 'e')
output endsTrue bool = endsWith('abcdef', 'ef')
output endsCapTrue bool = endsWith('abcdef', 'F')
output endsFalse bool = endsWith('abcdef', 'e')

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
startsTrue	Bool	Igaz
startsCapTrue	Bool	Igaz
startsFalse	Bool	Hamis
endsTrue	Bool	Igaz
endsCapTrue	Bool	Igaz
endsFalse	Bool	Hamis

húr

string(valueToConvert)

A megadott értéket sztringgé alakítja. A sztringeket a rendszer a következőképpen adja vissza. A többi típust a rendszer az egyenértékű JSON-ábrázolássá alakítja. Ha JSON-ra kell konvertálnia egy sztringet, azaz idézőjelet vagy feloldójelet, használhatja substring(string([value]), 1, length(string([value]) - 2)a következőt: .

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
valueToConvert	Igen	Bármely	A sztringgé konvertálandó érték. Bármilyen típusú érték konvertálható, beleértve az objektumokat és a tömböket is.

Visszaadott érték

A konvertált érték sztringje.

Példák

Az alábbi példa bemutatja, hogyan konvertálhat különböző típusú értékeket sztringekké:

param testObject object = {
  valueA: 10
  valueB: 'Example Text'
}
param testArray array = [
  '\'a\''
  '"b"'
  '\\c\\'
]
param testInt int = 5
param testString string = 'foo " \' \\'

output objectOutput string = string(testObject)
output arrayOutput string = string(testArray)
output intOutput string = string(testInt)
output stringOutput string = string(testString)
output stringEscapedOutput string = substring(string([testString]), 1, length(string([testString])) - 2)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
objectOutput	Sztring	`{"valueA":10,"valueB":"Example Text"}`
arrayOutput	Sztring	`["'a'","\"b\"","\\c\\"]`
intOutput	Sztring	`5`
stringOutput	Sztring	`foo " ' \`
stringEscapedOutput	Sztring	`"foo \" ' \\"`

Substring

substring(stringToParse, startIndex, length)

Egy alsztringet ad vissza, amely a megadott karakterhelyzetben kezdődik, és a megadott számú karaktert tartalmazza.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
stringToParse	Igen	húr	Az eredeti sztring, amelyből az alsztring ki lesz nyerve.
startIndex	Nem	egész	Az alsztring nulla alapú kezdő karakterpozíciója.
length (hossz)	Nem	egész	Az alsztring karaktereinek száma. A sztringen belüli helyre kell hivatkoznia. Nullának vagy nagyobbnak kell lennie. Ha nincs megadva, a rendszer a sztring fennmaradó részét adja vissza a kezdő pozícióból.

Visszaadott érték

Az alászúrás. Vagy üres sztring, ha a hossz nulla.

Megjegyzések

A függvény meghiúsul, ha az alsztring a sztring végén túlnyúlik, vagy ha a hossz kisebb, mint nulla. Az alábbi példa a következő hibaüzenettel meghiúsul: "Az index- és hosszparamétereknek a sztring egy helyére kell hivatkoznia. Az indexparaméter: "0", a hosszparaméter: "11", a sztringparaméter hossza: "10".

param inputString string = '1234567890'

var prefix = substring(inputString, 0, 11)

Példák

Az alábbi példa egy paraméterből nyer ki egy részszúrást.

param testString string = 'one two three'
output substringOutput string = substring(testString, 4, 3)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
substringOutput	Sztring	kettő

Elvétel

take(originalValue, numberToTake)

Egy karakterláncot ad vissza, amely a megadott számú karaktert tartalmazza a sztring elejétől kezdve, vagy egy tömböt, amely a tömb kezdetétől megadott számú elemet tartalmaz.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
originalValue	Igen	tömb vagy sztring	Az elemeket átvenni kívánt tömb vagy sztring.
numberToTake	Igen	egész	A felvenni kívánt elemek vagy karakterek száma. Ha ez az érték 0 vagy kevesebb, a függvény egy üres tömböt vagy sztringet ad vissza. Ha nagyobb, mint az adott tömb vagy sztring hossza, a rendszer visszaadja a tömb vagy sztring összes elemét.

Visszaadott érték

Tömb vagy sztring.

Példák

Az alábbi példa a tömb megadott számú elemét és egy sztringből származó karaktereket veszi fel.

param testArray array = [
  'one'
  'two'
  'three'
]
param elementsToTake int = 2
param testString string = 'one two three'
param charactersToTake int = 2

output arrayOutput array = take(testArray, elementsToTake)
output stringOutput string = take(testString, charactersToTake)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
arrayOutput	Tömb	["egy", "kettő"]
stringOutput	Sztring	ekkor

toLower

toLower(stringToChange)

A megadott sztringet kisbetűssé alakítja.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
stringToChange	Igen	húr	A kisbetűssé konvertálandó érték.

Visszaadott érték

A kisbetűssé konvertált sztring.

Példák

Az alábbi példa egy paraméter értékét kisbetűssé és nagybetűssé alakítja.

param testString string = 'One Two Three'

output toLowerOutput string = toLower(testString)
output toUpperOutput string = toUpper(testString)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
toLowerOutput	Sztring	egy két há'
toUpperOutput	Sztring	EGY KÉT HÁ'

toUpper

toUpper(stringToChange)

A megadott sztringet nagybetűssé alakítja.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
stringToChange	Igen	húr	A nagybetűssé konvertálandó érték.

Visszaadott érték

A nagybetűssé konvertált sztring.

Példák

Az alábbi példa egy paraméter értékét kisbetűssé és nagybetűssé alakítja.

param testString string = 'One Two Three'

output toLowerOutput string = toLower(testString)
output toUpperOutput string = toUpper(testString)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
toLowerOutput	Sztring	egy két há'
toUpperOutput	Sztring	EGY KÉT HÁ'

nyír

trim(stringToTrim)

Eltávolítja az összes kezdő és záró szóköz karaktert a megadott sztringből.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
stringToTrim	Igen	húr	A levágandó érték.

Visszaadott érték

A sztring bevezető és záró szóköz karakterek nélkül.

Példák

Az alábbi példa levágja a szóköz karaktereket a paraméterből.

param testString string = '    one two three   '

output return string = trim(testString)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
vissza	Sztring	egy két há'

uniqueString

uniqueString(baseString, ...)

A paraméterekként megadott értékek alapján létrehoz egy determinisztikus kivonatsztringet.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
baseString	Igen	húr	A kivonatoló függvényben egy egyedi sztring létrehozásához használt érték.
szükség szerint további paraméterek	Nem	húr	Az egyediséget meghatározó érték létrehozásához szükség szerint annyi sztringet adhat hozzá.

Megjegyzések

Ez a függvény akkor hasznos, ha egyedi nevet kell létrehoznia egy erőforráshoz. Olyan paraméterértékeket ad meg, amelyek korlátozzák az eredmény egyediségének hatókörét. Megadhatja, hogy a név egyedi legyen-e előfizetésre, erőforráscsoportra vagy üzembe helyezésre.

A visszaadott érték nem véletlenszerű sztring, hanem kivonatfüggvény eredménye. A visszaadott érték 13 karakter hosszú. Ez nem globálisan egyedi. Érdemes lehet kombinálni az értéket az elnevezési konvencióból származó előtaggal, hogy értelmes nevet hozzon létre. Az alábbi példa a visszaadott érték formátumát mutatja be. A tényleges érték a megadott paraméterektől függ.

tcvhiyu5h2o5o

Az alábbi példák bemutatják, hogyan hozhat létre egyedi értéket a gyakran használt szintekhez az uniqueString használatával.

Előfizetésre vonatkozó egyedi hatókör

uniqueString(subscription().subscriptionId)

Erőforráscsoportra vonatkozó egyedi hatókör

uniqueString(resourceGroup().id)

Erőforráscsoport üzembe helyezésének egyedi hatóköre

uniqueString(resourceGroup().id, deployment().name)

Az alábbi példa bemutatja, hogyan hozhat létre egyedi nevet egy tárfióknak az erőforráscsoport alapján. Az erőforráscsoporton belül a név nem egyedi, ha ugyanúgy épül fel.

resource mystorage 'Microsoft.Storage/storageAccounts@2023-04-01' = {
  name: 'storage${uniqueString(resourceGroup().id)}'
  ...
}

Ha minden egyes Bicep-fájl üzembe helyezésekor létre kell hoznia egy új egyedi nevet, és nem kívánja frissíteni az erőforrást, használhatja az utcNow függvényt a uniqueString használatával. Ezt a megközelítést tesztkörnyezetben is használhatja. Példa: utcNow. Vegye figyelembe, hogy az utcNow függvény csak egy paraméter alapértelmezett értékének kifejezésén belül használható.

Visszaadott érték

Egy 13 karakterből álló sztring.

Példák

Az alábbi példa a uniquestring eredményeit adja vissza:

output uniqueRG string = uniqueString(resourceGroup().id)
output uniqueDeploy string = uniqueString(resourceGroup().id, deployment().name)

Uri

uri(baseUri, relativeUri)

Abszolút URI-t hoz létre a baseUri és a relativeUri sztring kombinálásával.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
baseUri	Igen	húr	Az alap uri sztring. Ügyeljen arra, hogy megfigyelje a záró perjel ('/') kezelésével kapcsolatos viselkedést, ahogyan az a táblázatból következik.
relativeUri	Igen	húr	Az alap URI-sztringhez hozzáadandó relatív URI-sztring.

Ha baseUri záró perjellel végződik, az eredményt egyszerűen baseUri a relativeUrikövetkező követi: . Ha relativeUri a kezdő perjellel is kezdődik, a záró perjel és a vezető perjel egybe lesz kombinálva.
Ha baseUri nem végződik záró perjellel, két dolog egyike történik.
- Ha baseUri egyáltalán nincsenek perjelek (az "//" előtértől eltekintve) az eredményt egyszerűen baseUri követik relativeUri.
- Ha baseUri vannak perjelei, de nem végződik perjellel, az utolsó perjeltől baseUri kezdve minden el lesz távolítva, és az eredményt baseUri a relativeUriprogram követi.

Íme néhány példa:

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/', '/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

A részletekért a rendszer az baseUri relativeUri RFC 3986 5. szakaszában megadott módon oldja fel a paramétereket és a paramétereket.

Visszaadott érték

Az alap- és relatív értékek abszolút URI-jának sztringje.

Példák

Az alábbi példa az uri, az uriComponent és az uriComponentToString használatát mutatja be:

var uriFormat = uri('http://contoso.com/resources/', 'nested/azuredeploy.json')
var uriEncoded = uriComponent(uriFormat)

output uriOutput string = uriFormat
output componentOutput string = uriEncoded
output toStringOutput string = uriComponentToString(uriEncoded)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
uriOutput	Sztring	`http://contoso.com/resources/nested/azuredeploy.json`
componentOutput	Sztring	`http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json`
toStringOutput	Sztring	`http://contoso.com/resources/nested/azuredeploy.json`

uriComponent

uricomponent(stringToEncode)

Kódolja az URI-t.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
stringToEncode	Igen	húr	A kódolandó érték.

Visszaadott érték

Az URI kódolt értékének sztringje.

Példák

Az alábbi példa az uri, az uriComponent és az uriComponentToString használatát mutatja be:

var uriFormat = uri('http://contoso.com/resources/', 'nested/azuredeploy.json')
var uriEncoded = uriComponent(uriFormat)

output uriOutput string = uriFormat
output componentOutput string = uriEncoded
output toStringOutput string = uriComponentToString(uriEncoded)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
uriOutput	Sztring	`http://contoso.com/resources/nested/azuredeploy.json`
componentOutput	Sztring	`http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json`
toStringOutput	Sztring	`http://contoso.com/resources/nested/azuredeploy.json`

uriComponentToString

uriComponentToString(uriEncodedString)

Egy URI kódolt érték sztringét adja vissza.

Névtér: sys.

Paraméterek

Paraméter	Kötelező	Típus	Leírás
uriEncodedString	Igen	húr	Az URI kódolt értéke, amely sztringgé konvertálható.

Visszaadott érték

URI kódolt érték dekódolt sztringje.

Példák

Az alábbi példa az uri, az uriComponent és az uriComponentToString használatát mutatja be:

var uriFormat = uri('http://contoso.com/resources/', 'nested/azuredeploy.json')
var uriEncoded = uriComponent(uriFormat)

output uriOutput string = uriFormat
output componentOutput string = uriEncoded
output toStringOutput string = uriComponentToString(uriEncoded)

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
uriOutput	Sztring	`http://contoso.com/resources/nested/azuredeploy.json`
componentOutput	Sztring	`http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json`
toStringOutput	Sztring	`http://contoso.com/resources/nested/azuredeploy.json`

Következő lépések

A Bicep-fájlok szakaszainak leírását a Bicep-fájlok szerkezetének és szintaxisának ismertetése című témakörben találja.
Ha adott számú alkalommal szeretne iterálni egy erőforrástípus létrehozásakor, tekintse meg a Bicep iteratív ciklusait.
A létrehozott Bicep-fájl üzembe helyezéséről az Erőforrások üzembe helyezése a Bicep és az Azure PowerShell használatával című témakörben olvashat.

Megosztás a következőn keresztül:

A Bicep sztringfüggvényei

base64

Paraméterek

Visszaadott érték

Példák

base64ToJson

Paraméterek

Visszaadott érték

Példák

base64ToString

Paraméterek

Visszaadott érték

Példák

összefűzés

Paraméterek

Visszaadott érték

Példák

contains

Paraméterek

Visszaadott érték

Példák

dataUri

Paraméterek

Visszaadott érték

Példák

dataUriToString

Paraméterek

Visszaadott érték

Példák

üres

Paraméterek

Visszaadott érték

Példák

endsWith

Paraméterek

Visszaadott érték

Példák

első

Paraméterek

Visszaadott érték

Példák

format

Paraméterek

Megjegyzések

Példák

guid

Paraméterek

Megjegyzések

Visszaadott érték

Példák

indexOf

Paraméterek

Visszaadott érték

Példák

Csatlakozás

Paraméterek

Visszaadott érték

Példák

json

utolsó

Paraméterek

Visszaadott érték

Példák

lastIndexOf

Paraméterek

Visszaadott érték

Példák

length (hossz)

Paraméterek

Visszaadott érték

Példák

newGuid

Megjegyzések

Visszaadott érték

Példák

padLeft

Paraméterek

Visszaadott érték

Példák