Sdílet prostřednictvím


Číselné funkce pro šablony ARM

Resource Manager poskytuje následující funkce pro práci s celými čísly v šabloně Azure Resource Manageru (šablona ARM):

Tip

Bicep se doporučuje, protože nabízí stejné možnosti jako šablony ARM a syntaxe se snadněji používá. Další informace o použití , intmina max v Bicep najdete v tématu numeric funkce. Další číselné hodnoty najdete v číselných operátorech.

přidat

add(operand1, operand2)

Vrátí součet dvou zadaných celých čísel.

Funkce add není v Bicep podporovaná. + Místo toho použijte operátor.

Parametry

Parameter Povinné Typ Popis
operand1 Ano int (integer) První číslo, které se má přidat.
operand2 Ano int (integer) Druhé číslo, které se má sčítat.

Návratová hodnota

Celé číslo, které obsahuje součet parametrů.

Příklad

Následující příklad přidá dva parametry:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "first": {
      "type": "int",
      "defaultValue": 5,
      "metadata": {
        "description": "First integer to add"
      }
    },
    "second": {
      "type": "int",
      "defaultValue": 3,
      "metadata": {
        "description": "Second integer to add"
      }
    }
  },
  "resources": [
  ],
  "outputs": {
    "addResult": {
      "type": "int",
      "value": "[add(parameters('first'), parameters('second'))]"
    }
  }
}

Výstup výchozích hodnot z předchozího příkladu je:

Název Typ Hodnota
addResult int 8

copyIndex

copyIndex(loopName, offset)

Vrátí index smyčky iterace.

V Bicep použijte iterativní smyčky.

Parametry

Parameter Povinné Typ Popis
loopName Ne řetězec Název smyčky pro získání iterace.
posun Ne int (integer) Číslo, které se má přidat k hodnotě iterace založené na nule.

Poznámky

Tato funkce se vždy používá s objektem kopírování . Pokud není pro posun zadaná žádná hodnota, vrátí se aktuální hodnota iterace. Hodnota iterace začíná nulou.

Vlastnost loopName umožňuje určit, zda copyIndex odkazuje na iteraci prostředku nebo iteraci vlastností. Pokud pro loopName není zadána žádná hodnota, použije se iterace aktuálního typu prostředku. Při iterování vlastnosti zadejte hodnotu loopName .

Další informace o použití kopie najdete tady:

Příklad

Následující příklad ukazuje smyčku kopírování a hodnotu indexu obsaženou v názvu:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storageCount": {
      "type": "int",
      "defaultValue": 2
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[format('{0}storage{1}', range(0, parameters('storageCount'))[copyIndex()], uniqueString(resourceGroup().id))]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "properties": {},
      "copy": {
        "name": "storagecopy",
        "count": "[parameters('storageCount')]"
      }
    }
  ]
}

Návratová hodnota

Celé číslo představující aktuální index iterace.

div

div(operand1, operand2)

Vrátí celočíselné dělení dvou zadaných celých čísel.

Funkce div není v Bicep podporovaná. / Místo toho použijte operátor.

Parametry

Parameter Povinné Typ Popis
operand1 Ano int (integer) Číslo, které se dělí.
operand2 Ano int (integer) Číslo, které se používá k dělení. Nemůže být 0.

Návratová hodnota

Celé číslo představující dělení.

Příklad

Následující příklad vydělí jeden parametr jiným parametrem:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "first": {
      "type": "int",
      "defaultValue": 8,
      "metadata": {
        "description": "Integer being divided"
      }
    },
    "second": {
      "type": "int",
      "defaultValue": 3,
      "metadata": {
        "description": "Integer used to divide"
      }
    }
  },
  "resources": [
  ],
  "outputs": {
    "divResult": {
      "type": "int",
      "value": "[div(parameters('first'), parameters('second'))]"
    }
  }
}

Výstup výchozích hodnot z předchozího příkladu je:

Název Typ Hodnota
divResult int 2

float

float(arg1)

Převede hodnotu na číslo s plovoucí desetinou čárkou. Tuto funkci použijete pouze při předávání vlastních parametrů do aplikace, například aplikace logiky.

Funkce float není v Bicep podporovaná.

Parametry

Parameter Povinné Typ Popis
arg1 řekl: Ano řetězec nebo int Hodnota, která se má převést na číslo s plovoucí desetinou čárkou.

Návratová hodnota

Číslo s plovoucí desetinou čárkou.

Příklad

Následující příklad ukazuje, jak pomocí příkazu float předat parametry do aplikace logiky:

{
  "type": "Microsoft.Logic/workflows",
  "properties": {
    ...
    "parameters": {
      "custom1": {
        "value": "[float('3.0')]"
      },
      "custom2": {
        "value": "[float(3)]"
      },

int (integer)

int(valueToConvert)

Převede zadanou hodnotu na celé číslo.

V Bicep použijte int funkci.

Parametry

Parameter Povinné Typ Popis
valueToConvert Ano řetězec nebo int Hodnota, která se má převést na celé číslo.

Návratová hodnota

Celé číslo převedené hodnoty.

Příklad

Následující příklad šablony převede hodnotu parametru poskytnuté uživatelem na celé číslo:

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

Výstup výchozích hodnot z předchozího příkladu je:

Název Typ Hodnota
intResult int 4

maximálně

max(arg1)

Vrátí maximální hodnotu z pole celých čísel nebo seznamu celých čísel oddělených čárkami.

V Bicep použijte max funkci.

Parametry

Parameter Povinné Typ Popis
arg1 řekl: Ano pole celých čísel nebo seznam celých čísel oddělených čárkami Kolekce pro získání maximální hodnoty.

Návratová hodnota

Celé číslo představující maximální hodnotu z kolekce.

Příklad

Následující příklad ukazuje, jak se používá max s polem a seznamem celých čísel:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "arrayToTest": {
      "type": "array",
      "defaultValue": [ 0, 3, 2, 5, 4 ]
    }
  },
  "resources": [],
  "outputs": {
    "arrayOutput": {
      "type": "int",
      "value": "[max(parameters('arrayToTest'))]"
    },
    "intOutput": {
      "type": "int",
      "value": "[max(0,3,2,5,4)]"
    }
  }
}

Výstup výchozích hodnot z předchozího příkladu je:

Název Typ Hodnota
arrayOutput int 5
intOutput int 5

minuta

min(arg1)

Vrátí minimální hodnotu z pole celých čísel nebo seznamu celých čísel oddělených čárkami.

V Bicep použijte min funkci.

Parametry

Parameter Povinné Typ Popis
arg1 řekl: Ano pole celých čísel nebo seznam celých čísel oddělených čárkami Kolekce pro získání minimální hodnoty.

Návratová hodnota

Celé číslo představující minimální hodnotu z kolekce.

Příklad

Následující příklad ukazuje, jak se používá min s polem a seznamem celých čísel:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "arrayToTest": {
      "type": "array",
      "defaultValue": [ 0, 3, 2, 5, 4 ]
    }
  },
  "resources": [],
  "outputs": {
    "arrayOutput": {
      "type": "int",
      "value": "[min(parameters('arrayToTest'))]"
    },
    "intOutput": {
      "type": "int",
      "value": "[min(0,3,2,5,4)]"
    }
  }
}

Výstup výchozích hodnot z předchozího příkladu je:

Název Typ Hodnota
arrayOutput int 0
intOutput int 0

zkratka modulo

mod(operand1, operand2)

Vrátí podíl celočíselného dělení pomocí dvou zadaných celých čísel.

Funkce mod není v Bicep podporovaná. Místo toho použijte operátor% .

Parametry

Parameter Povinné Typ Popis
operand1 Ano int (integer) Číslo, které se dělí.
operand2 Ano int (integer) Číslo, které se používá k dělení, nemůže být 0.

Návratová hodnota

Celé číslo představující zbytek.

Příklad

Následující příklad vrátí podíl vydělení jednoho parametru jiným parametrem:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "first": {
      "type": "int",
      "defaultValue": 7,
      "metadata": {
        "description": "Integer being divided"
      }
    },
    "second": {
      "type": "int",
      "defaultValue": 3,
      "metadata": {
        "description": "Integer used to divide"
      }
    }
  },
  "resources": [
  ],
  "outputs": {
    "modResult": {
      "type": "int",
      "value": "[mod(parameters('first'), parameters('second'))]"
    }
  }
}

Výstup výchozích hodnot z předchozího příkladu je:

Název Typ Hodnota
modResult int 1

mul

mul(operand1, operand2)

Vrátí násobení dvou zadaných celých čísel.

Funkce mul není v Bicep podporovaná. Místo toho použijte operátor * .

Parametry

Parameter Povinné Typ Popis
operand1 Ano int (integer) První číslo, které se má násobit.
operand2 Ano int (integer) Druhé číslo, které se má vynásobit.

Návratová hodnota

Celé číslo představující násobení

Příklad

Následující příklad vynásobí jeden parametr jiným:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "first": {
      "type": "int",
      "defaultValue": 5,
      "metadata": {
        "description": "First integer to multiply"
      }
    },
    "second": {
      "type": "int",
      "defaultValue": 3,
      "metadata": {
        "description": "Second integer to multiply"
      }
    }
  },
  "resources": [
  ],
  "outputs": {
    "mulResult": {
      "type": "int",
      "value": "[mul(mul(parameters('first'), parameters('second')), 3)]"
    }
  }
}

Výstup výchozích hodnot z předchozího příkladu je:

Název Typ Hodnota
mulResult int 45

náhradník (assuming "sub" is intended as "substitute")

sub(operand1, operand2)

Vrátí odčítání dvou zadaných celých čísel.

Funkce sub není v Bicep podporovaná. Místo toho použijte operátor - .

Parametry

Parameter Povinné Typ Popis
operand1 Ano int (integer) Číslo, které je odečítané.
operand2 Ano int (integer) Číslo, které se odečítá.

Návratová hodnota

Celé číslo představující odčítání.

Příklad

Následující příklad odečte jeden parametr od druhého:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "first": {
      "type": "int",
      "defaultValue": 7,
      "metadata": {
        "description": "Integer subtracted from"
      }
    },
    "second": {
      "type": "int",
      "defaultValue": 3,
      "metadata": {
        "description": "Integer to subtract"
      }
    }
  },
  "resources": [
  ],
  "outputs": {
    "subResult": {
      "type": "int",
      "value": "[sub(parameters('first'), parameters('second'))]"
    }
  }
}

Výstup výchozích hodnot z předchozího příkladu je:

Název Typ Hodnota
subResult int 4

Další kroky