createArray

Zusammenfassung

Gibt ein Array von Werten aus der Eingabe zurück.

Syntax

createArray(<inputValue>)

BESCHREIBUNG

Die createArray() Funktion gibt ein Array von Werten aus den Eingabewerten zurück. Sie können diese Funktion verwenden, um Arrays eines beliebigen Typs zu erstellen. Die Eingabewerte müssen vom gleichen Typ sein : Zahlen, Zeichenfolgen, Objekte oder Arrays. Wenn es sich bei den Eingabewerten um Objekte oder Arrays handelt, müssen es sich nicht um Objekte mit denselben Eigenschaften oder Arrays desselben Typs handeln. Wenn die Eingabewerte Arrays sind, gibt die Funktion ein Array von Arrays zurück.

Beispiele

Beispiel 1: Create eines Arrays ganzzahliger Zahlen

Beispiel synopsis

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

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

results:
- name: Echo array of integers
  type: Microsoft.DSC.Debug/Echo
  result:
    actualState:
      output:
      - 1
      - 3
      - 5
messages: []
hadErrors: false

Beispiel 2: Create eines Arrays von Arrays

Diese Konfiguration gibt ein Array zurück, bei dem die Elemente im Array ebenfalls Arrays sind. Das erste Unterarray enthält nur ganze Zahlen. Das zweite Unterarray enthält nur Zeichenfolgen.

# createArray.example.2.dsc.config.yaml
$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
resources:
- name: Create array of arrays
  type: Microsoft.DSC.Debug/Echo
  properties:
    output: "[createArray(createArray(1,3,5), createArray('a', 'b', 'c'))]"

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

results:
- name: Create array of arrays
  type: Microsoft.DSC.Debug/Echo
  result:
    actualState:
      output:
      - - 1
        - 3
        - 5
      - - a
        - b
        - c
messages: []
hadErrors: false

Beispiel 3: Create eines abgeflachten Arrays von Zeichenfolgen

Diese Konfiguration verwendet die funktion concat(), um zwei neu erstellte Arrays von Zeichenfolgen zu verketten. Es verwendet die faltete mehrlineare Zeichenfolgensyntax von YAML, um die Funktion besser lesbar zu machen.

# createArray.example.3.dsc.config.yaml
$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
resources:
- name: Echo flattened array
  type: Microsoft.DSC.Debug/Echo
  properties:
    output: >-
      [concat(
        createArray('a', 'b', 'c'),
        createArray('d', 'e', 'f')
      )]

dsc config get --file createArray.example.3.dsc.config.yaml

results:
- name: Echo flattened array
  type: Microsoft.DSC.Debug/Echo
  result:
    actualState:
      output:
      - a
      - b
      - c
      - d
      - e
      - f
messages: []
hadErrors: false

Parameter

inputValue

Die createArray() Funktion erwartet null oder mehr Eingabewerte desselben Typs. Trennen Sie jeden Wert durch ein Komma. Wenn sich der Typ eines Eingabewerts vom ersten Wert unterscheidet, gibt DSC einen Fehler für die Funktion zurück.

Type:         [integer, string, number, object, array]
Required:     false
MinimumCount: 0
MaximumCount: 18446744073709551615

Ausgabe

Die createArray() Funktion gibt ein Array von Werten zurück. Wenn es sich bei den Eingabewerten um Arrays handelt, handelt es sich bei dem zurückgegebenen Wert um ein Array von Arrays, nicht um ein abgeflachtes Array der Eingabewerte. Sie können ein abgeflachtes Array von Zeichenfolgenarrays mit der Funktion concat() zurückgeben, wie in Beispiel 3.

Type: array