div

Zusammenfassung

Gibt den Quotienten für die Aufteilung von zwei ganzen Zahlen zurück.

Syntax

div(<operands>)

BESCHREIBUNG

Die div() Funktion gibt den Quotienten für die Aufteilung von zwei ganzen Zahlen zurück. Wenn das Ergebnis der Division keine ganze Zahl ist, gibt die Funktion den Wert der Division zurück, der auf die nächste ganze Zahl gerundet ist.

Beispiele

Beispiel 1: Zwei ganze Zahlen teilen

In diesem Beispieldokument wird gezeigt, wie Sie die div() Funktion verwenden können, um die Aufteilung von zwei ganzen Zahlen zurückzugeben.

# div.example.1.dsc.config.yaml
$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
resources:
- name: Dividing integers
  type: Microsoft.DSC.Debug/Echo
  properties:
    output: "[div(6,3)]"

dsc config get --file div.example.1.dsc.config.yaml config get

results:
- name: Dividing integers
  type: Microsoft.DSC.Debug/Echo
  result:
    actualState:
      output: 2
messages: []
hadErrors: false

Beispiel 2: Teilen der Ausgabe geschachtelter Funktionen

In diesem Beispieldokument wird gezeigt, wie Sie die div() Funktion verwenden können, um die Ausgaben geschachtelter Konfigurationsfunktionen aufzuteilen. Da die Ausgaben 14 und 5 sind, ist das Endergebnis 2. DSC gibt den vollständigen ganzzahligen Wert ohne den Rest zurück. Das Ergebnis wird nicht auf 3 aufgerundet.

# div.example.2.dsc.config.yaml
$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
resources:
- name: Dividing nested functions
  type: Microsoft.DSC.Debug/Echo
  properties:
    output: "[div(mul(7,2), add(4,1))]"

dsc config get --file div.example.2.dsc.config.yaml

results:
- name: Dividing nested functions
  type: Microsoft.DSC.Debug/Echo
  result:
    actualState:
      output: 2
messages: []
hadErrors: false

Parameter

Operanden

Die div() Funktion erwartet genau zwei ganze Zahlen als Eingabe. Die Operanden können entweder eine ganze Zahl oder die Ausgabe einer beliebigen Konfigurationsfunktion sein, die eine ganze Zahl zurückgibt. Die Funktion teilt den ersten Operanden durch den zweiten Operanden. Trennen Sie die Operanden durch ein Komma (,).

Type:         integer
Required:     true
MinimumCount: 2
MaximumCount: 2

Ausgabe

Die div() Funktion gibt einen ganzzahligen Wert zurück, der die Division des ersten Operanden durch den zweiten Operanden darstellt. Wenn das Divisionsergebnis keine ganze Zahl ist, gibt die Funktion den ganzzahligen Wert des Ergebnisses ohne den Bruch rest zurück.

Type: integer