div

Synopsis

Returnerar kvoten för divisionen av två heltal.

Syntax

div(<operands>)

Description

Funktionen div() returnerar kvoten för divisionen av två heltal. Om resultatet av divisionen inte är ett heltal returnerar funktionen värdet för divisionen som avrundats ned till närmaste heltal.

Exempel

Exempel 1 – Dela upp två heltal

Det här exempeldokumentet visar hur du kan använda div() funktionen för att returnera divisionen av två heltal.

# div.example.1.dsc.config.yaml
$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
resources:
- name: Dividing integers
  type: Test/Echo
  properties:
    output: "[div(6,3)]"

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

results:
- name: Dividing integers
  type: Test/Echo
  result:
    actualState:
      output: 2
messages: []
hadErrors: false

Exempel 2 – Dela upp utdata från kapslade funktioner

Det här exempeldokumentet visar hur du kan använda div() funktionen för att dela upp utdata från kapslade konfigurationsfunktioner. Eftersom utdata är 14 och 5 är slutresultatet 2. DSC returnerar det fullständiga heltalsvärdet utan resten. Resultatet avrundas inte upp till 3.

# div.example.2.dsc.config.yaml
$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
resources:
- name: Dividing nested functions
  type: Test/Echo
  properties:
    output: "[div(mul(7,2), add(4,1))]"

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

results:
- name: Dividing nested functions
  type: Test/Echo
  result:
    actualState:
      output: 2
messages: []
hadErrors: false

Parametrar

Operander

Funktionen div() förväntar sig exakt två heltal som indata. Operanderna kan vara antingen ett heltal eller utdata för alla konfigurationsfunktioner som returnerar ett heltal. Funktionen delar den första operanden med den andra operanden. Avgränsa operanderna med kommatecken (,).

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

Utdata

Funktionen div() returnerar ett heltalsvärde som representerar divisionen av den första operanden med den andra operanden. Om divisionsresultatet inte är ett heltal returnerar funktionen heltalsvärdet för resultatet utan bråkrester.

Type: integer