A Bicep sztringfüggvényei

  • Cikk

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 Szükséges 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 Szükséges 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 Szükséges 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ótconcat() 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 Szükséges 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 Szükséges 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

Igaz , ha az elem megtalálható; ellenkező esetben Hamis.

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 Szükséges 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 Szükséges 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-e.

Névtér: sys.

Paraméterek

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

Visszaadott érték

Igaz értéket ad vissza, ha az érték üres; 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 = ''

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

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

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 Szükséges 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

Igaz , ha a sztring utolsó karaktere vagy karaktere megegyezik az értékkel, ellenkező esetben Hamis.

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 Szükséges 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 Szükséges 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 Szükséges 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 Szükséges 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 Szükséges 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; Két; 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 Szükséges 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 Szükséges 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 Szükséges 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@2018-07-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 Szükséges 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 Szükséges 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 Szükséges 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 Szükséges 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 Szükséges 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

Igaz , ha a sztring első karaktere vagy karaktere megegyezik az értékkel, ellenkező esetben Hamis.

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 Szükséges 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 Szükséges 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 Szükséges 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 Szükséges 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 THR Enterprise kiadás

toUpper

toUpper(stringToChange)

A megadott sztringet nagybetűssé alakítja.

Névtér: sys.

Paraméterek

Paraméter Szükséges 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 THR Enterprise kiadás

Berendezés

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 Szükséges 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 Szükséges 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@2018-07-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 Szükséges 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 a baseUri záró perjelben végződik, az eredmény egyszerűen baseUri, amelyet a relativeUri követ.

  • Ha a baseUri nem végződik záró perjellel, két dolog egyike történik.

    • Ha a baseUri-nak egyáltalán nincsenek perjelei (az "//" előtértől eltekintve) az eredmény egyszerűen baseUri, amelyet relatívUri követ.

    • Ha a baseUri-nak vannak perjelei, de nem végződik perjellel, az utolsó perjeltől kezdve minden el lesz távolítva a baseUri-ból, és az eredmény a baseUri és a relativeUri lesz.

Í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/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 baseUri és a relativeUri paraméterek az RFC 3986 5. szakaszában meghatározottak szerint lesznek feloldva.

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 Szükséges 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 Szükséges 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