max

Zusammenfassung

Gibt den Maximalwert aus einer Reihe ganzzahliger Werte zurück.

Syntax

max(<integerList>)

BESCHREIBUNG

Die max() Funktion gibt den Maximalwert aus einem Array von ganzen Zahlen oder einer durch Trennzeichen getrennten Liste von ganzen Zahlen zurück.

Beispiele

Beispiel 1: Zurückgeben des Maximums aus einer durch Trennzeichen getrennten Liste ganzer Zahlen

Diese Konfiguration gibt die größte Zahl aus einer Liste mit ganzen Zahlen zurück.

# max.example.1.dsc.config.yaml
$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
resources:
- name: Echo maximum value
  type: Microsoft.DSC.Debug/Echo
  properties:
    output: "[max(3, 2, 5, 1, 7)]"

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

results:
- name: Echo maximum value
  type: Microsoft.DSC.Debug/Echo
  result:
    actualState:
      output: 7
messages: []
hadErrors: false

Beispiel 2: Zurückgeben des Maximums aus einem Array ganzer Zahlen

Diese Konfiguration gibt die größte Zahl aus einem Array ganzzahliger Werte an, das als Verweis auf eine andere Ressource instance abgerufen wird. Es verwendet die faltete mehrlineige Syntax von YAML, um die Funktion lesbarer zu machen.

# max.example.2.dsc.config.yaml
$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
resources:
- name: Echo integer array
  type: Microsoft.DSC.Debug/Echo
  properties:
    output:
    - 3
    - 2
    - 5
    - 1
    - 7
- name: Echo maximum integer
  type: Microsoft.DSC.Debug/Echo
  properties:
    output: >-
      [max(
        reference(
          resourceId('Microsoft.DSC.Debug/Echo', 'Echo integer array')
        ).actualState.output
      )]
  dependsOn:
  - "[resourceId('Microsoft.DSC.Debug/Echo', 'Echo integer array')]"

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

results:
- name: Echo integer array
  type: Microsoft.DSC.Debug/Echo
  result:
    actualState:
      output:
      - 3
      - 2
      - 5
      - 1
      - 7
- name: Echo maximum integer
  type: Microsoft.DSC.Debug/Echo
  result:
    actualState:
      output: 7

Parameter

integerList

Die max() Funktion erwartet entweder ein einzelnes Array von ganzen Zahlen oder ein durch Trennzeichen getrenntes Array von ganzen Zahlen. Wenn Sie ganze Zahlen direkt übergeben, trennen Sie jede ganze Zahl durch ein Komma. Wenn Sie ein Arrayobjekt übergeben, akzeptiert die Funktion nur ein einzelnes Array als Argument.

Type:         [integer, array(integer)]
Required:     true
MinimumCount: 1
MaximumCount: 18446744073709551615

Ausgabe

Die max() Funktion gibt eine einzelne ganze Zahl zurück, die den größten Wert in der Eingabe darstellt.

Type: integer