createArray

Riepilogo

Restituisce una matrice di valori dall'input.

Sintassi

createArray(<inputValue>)

Descrizione

La createArray() funzione restituisce una matrice di valori dai valori di input. È possibile usare questa funzione per creare matrici di qualsiasi tipo. I valori di input devono essere dello stesso tipo: numeri, stringhe, oggetti o matrici. Quando i valori di input sono oggetti o matrici, non devono essere oggetti con le stesse proprietà o matrici dello stesso tipo. Quando i valori di input sono matrici, la funzione restituisce una matrice di matrici.

Esempio

Esempio 1 : Create una matrice di interi

sinopsi di esempio

# 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

Esempio 2 : Create una matrice di matrici

Questa configurazione restituisce una matrice in cui gli elementi della matrice sono anche matrici. La prima matrice secondaria contiene solo numeri interi. La seconda matrice secondaria contiene solo stringhe.

# 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

Esempio 3: Create una matrice flat di stringhe

Questa configurazione usa la funzione concat() per concatenare due matrici di stringhe appena create. Usa la sintassi stringa multilinea piegata di YAML per rendere la funzione più leggibile.

# 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

Parametri

inputValue

La createArray() funzione prevede zero o più valori di input dello stesso tipo. Separare ogni valore con una virgola. Se il tipo di qualsiasi valore di input è diverso dal primo valore, DSC restituisce un errore per la funzione.

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

Output

La createArray() funzione restituisce una matrice di valori. Quando i valori di input sono matrici, il valore restituito è una matrice di matrici, non una matrice flat dei valori di input. È possibile restituire una matrice flat di matrici di stringhe con la funzione concat(), come nell'esempio 3.

Type: array