Bagikan melalui

Fungsi numerik untuk templat ARM

Resource Manager menyediakan fungsi berikut untuk bekerja dengan bilangan bulat di templat Azure Resource Manager (templat ARM):

Petunjuk / Saran

Bicep direkomendasikan karena menawarkan kemampuan yang sama dengan templat ARM, dan sintaksnya lebih mudah digunakan. Untuk mempelajari selengkapnya tentang menggunakan int, , mindan max di Bicep, lihat numeric fungsi. Untuk nilai numerik lainnya, lihat operator numerik .

tambahkan

add(operand1, operand2)

Mengembalikan jumlah dari dua bilangan bulat yang disediakan.

Fungsi add tidak didukung di Bicep. Gunakan operator sebagai gantinya+.

Parameter-parameternya

Pengaturan Diperlukan Tipe Deskripsi
operand1 Ya int (integer) Angka pertama yang akan ditambahkan.
operand2 Ya int (integer) Angka kedua untuk ditambahkan.

Mengembalikan nilai

Bilangan bulat yang berisi jumlah parameter.

Contoh

Contoh berikut menambahkan dua parameter:

{
  "$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'))]"
    }
  }
}

Output nilai default dari contoh sebelumnya adalah:

Nama Tipe Nilai
addResult Integer 8

copyIndex

copyIndex(loopName, offset)

Mengembalikan indeks perulangan perulangan.

Di Bicep, gunakan perulangan berulang.

Parameter-parameternya

Pengaturan Diperlukan Tipe Deskripsi
loopName Tidak. string Nama perulangan untuk mendapatkan iterasi.
Offset Tidak. int (integer) Angka yang akan ditambahkan ke nilai iterasi berbasis nol.

Komentar

Fungsi ini selalu digunakan dengan objek salin . Jika tidak ada nilai yang disediakan untuk offset, nilai iterasi saat ini dikembalikan. Nilai perulangan dimulai dari nol.

Properti loopName memungkinkan Anda menentukan apakah copyIndex mengacu pada iterasi sumber daya atau iterasi properti. Jika tidak ada nilai yang disediakan untuk loopName, iterasi jenis sumber daya saat ini digunakan. Berikan nilai untuk loopName saat melakukan iterasi pada properti.

Untuk informasi selengkapnya tentang menggunakan penyalinan, lihat:

Contoh

Contoh berikut menunjukkan perulangan salinan dan nilai indeks yang disertakan dalam nama:

{
  "$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')]"
      }
    }
  ]
}

Mengembalikan nilai

Bilangan bulat yang mewakili indeks perulangan saat ini.

div

div(operand1, operand2)

Mengembalikan pembagian bilangan bulat dari dua bilangan bulat yang disediakan.

Fungsi div tidak didukung di Bicep. Gunakan operator sebagai gantinya/.

Parameter-parameternya

Pengaturan Diperlukan Tipe Deskripsi
operand1 Ya int (integer) Angka yang dibagi.
operand2 Ya int (integer) Angka yang digunakan untuk membagi. Tidak bisa 0.

Mengembalikan nilai

Bilangan bulat yang mewakili pembagian.

Contoh

Contoh berikut membagi satu parameter dengan parameter lain:

{
  "$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'))]"
    }
  }
}

Output nilai default dari contoh sebelumnya adalah:

Nama Tipe Nilai
divResult Integer 2

float

float(arg1)

Mengonversi nilai menjadi angka titik mengambang. Anda hanya menggunakan fungsi ini saat meneruskan parameter kustom ke aplikasi, seperti Aplikasi Logika.

Fungsi float tidak didukung di Bicep.

Parameter-parameternya

Pengaturan Diperlukan Tipe Deskripsi
arg1 Ya string atau int Nilai yang akan dikonversi ke angka titik mengambang.

Mengembalikan nilai

Angka titik mengambang.

Contoh

Contoh berikut menunjukkan cara menggunakan float untuk meneruskan parameter ke Aplikasi Logika:

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

int (integer)

int(valueToConvert)

Mengonversi nilai yang ditentukan menjadi bilangan bulat.

Di Bicep, gunakan int fungsi .

Parameter-parameternya

Pengaturan Diperlukan Tipe Deskripsi
valueToConvert Ya string atau int Nilai yang akan dikonversi menjadi bilangan bulat.

Mengembalikan nilai

Bilangan bulat dari nilai yang dikonversi.

Contoh

Contoh templat berikut mengonversi nilai parameter yang disediakan pengguna menjadi bilangan bulat:

{
  "$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'))]"
    }
  }
}

Output nilai default dari contoh sebelumnya adalah:

Nama Tipe Nilai
intResult Integer 4

maksimum

max(arg1)

Mengembalikan nilai maksimum dari array bilangan bulat atau daftar bilangan bulat yang dipisahkan koma.

Di Bicep, gunakan max fungsi .

Parameter-parameternya

Pengaturan Diperlukan Tipe Deskripsi
arg1 Ya array bilangan bulat, atau daftar bilangan bulat yang dipisahkan koma Kumpulan untuk mendapatkan nilai maksimum.

Mengembalikan nilai

Bilangan bulat yang mewakili nilai maksimum dari koleksi.

Contoh

Contoh berikut menunjukkan cara menggunakan max dengan array dan daftar bilangan bulat:

{
  "$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)]"
    }
  }
}

Output nilai default dari contoh sebelumnya adalah:

Nama Tipe Nilai
arrayOutput Integer 5
intOutput Integer 5

mnt

min(arg1)

Mengembalikan nilai minimum dari array bilangan bulat atau daftar bilangan bulat yang dipisahkan koma.

Di Bicep, gunakan min fungsi .

Parameter-parameternya

Pengaturan Diperlukan Tipe Deskripsi
arg1 Ya array bilangan bulat, atau daftar bilangan bulat yang dipisahkan koma Kumpulan untuk mendapatkan nilai minimum.

Mengembalikan nilai

Bilangan bulat yang mewakili nilai minimum dari koleksi.

Contoh

Contoh berikut menunjukkan cara menggunakan min dengan array dan daftar bilangan bulat:

{
  "$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)]"
    }
  }
}

Output nilai default dari contoh sebelumnya adalah:

Nama Tipe Nilai
arrayOutput Integer 0
intOutput Integer 0

Modifikasi

mod(operand1, operand2)

Mengembalikan kuota pembagian bilangan bulat menggunakan dua bilangan bulat yang disediakan.

Fungsi mod tidak didukung di Bicep. Gunakan operator% sebagai gantinya.

Parameter-parameternya

Pengaturan Diperlukan Tipe Deskripsi
operand1 Ya int (integer) Angka yang dibagi.
operand2 Ya int (integer) Angka yang digunakan untuk membagi, Tidak boleh 0.

Mengembalikan nilai

Bilangan bulat yang mewakili sisanya.

Contoh

Contoh berikut mengembalikan kuota pembagian satu parameter dengan parameter lain:

{
  "$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'))]"
    }
  }
}

Output nilai default dari contoh sebelumnya adalah:

Nama Tipe Nilai
modResult Integer 1

mul

mul(operand1, operand2)

Mengembalikan perkalian dari dua bilangan bulat yang disediakan.

Fungsi mul tidak didukung di Bicep. Gunakan operator * sebagai gantinya.

Parameter-parameternya

Pengaturan Diperlukan Tipe Deskripsi
operand1 Ya int (integer) Angka pertama yang akan dikalikan.
operand2 Ya int (integer) Angka kedua untuk dikalikan.

Mengembalikan nilai

Bilangan bulat yang mewakili perkalian.

Contoh

Contoh berikut mengalikan satu parameter dengan parameter lainnya:

{
  "$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)]"
    }
  }
}

Output nilai default dari contoh sebelumnya adalah:

Nama Tipe Nilai
mulResult Integer 45

Subkategori

sub(operand1, operand2)

Mengembalikan pengurangan dua bilangan bulat yang disediakan.

Fungsi sub tidak didukung di Bicep. Gunakan operator - sebagai gantinya.

Parameter-parameternya

Pengaturan Diperlukan Tipe Deskripsi
operand1 Ya int (integer) Angka yang dikurangi dari.
operand2 Ya int (integer) Angka yang dikurangi.

Mengembalikan nilai

Bilangan bulat yang mewakili pengurangan.

Contoh

Contoh berikut mengurangi satu parameter dari parameter lain:

{
  "$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'))]"
    }
  }
}

Output nilai default dari contoh sebelumnya adalah:

Nama Tipe Nilai
subResult Integer 4

Langkah selanjutnya

  • Last updated on