createArray

Artikel
05/11/2024

Synopsis

Returnerar en matris med värden från indata.

Syntax

createArray(<inputValue>)

Description

Funktionen createArray() returnerar en matris med värden från indatavärdena. Du kan använda den här funktionen för att skapa matriser av valfri typ. Indatavärdena måste vara av samma typ – tal, strängar, objekt eller matriser. När indatavärdena är objekt eller matriser behöver de inte vara objekt med samma egenskaper eller matriser av samma typ. När indatavärdena är matriser returnerar funktionen en matris med matriser.

Exempel

Exempel 1 – Skapa en matris med heltal

exempelsynopsis

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

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

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

Exempel 2 – Skapa en matris med matriser

Den här konfigurationen returnerar en matris där objekten i matrisen också är matriser. Den första undermatrisen innehåller endast heltal. Den andra delmatrisen innehåller endast strängar.

# createArray.example.2.dsc.config.yaml
$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
resources:
- name: Create array of arrays
  type: Test/Echo
  properties:
    output: "[createArray(createArray(1,3,5), createArray('a', 'b', 'c'))]"

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

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

Exempel 3 – Skapa en utplattad matris med strängar

Den här konfigurationen använder funktionen concat() för att sammanfoga två nyligen skapade matriser med strängar. Den använder YAML:s vikta strängsyntax med flera ledningar för att göra funktionen mer läsbar.

# createArray.example.3.dsc.config.yaml
$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
resources:
- name: Echo flattened array
  type: Test/Echo
  properties:
    output: >-
      [concat(
        createArray('a', 'b', 'c'),
        createArray('d', 'e', 'f')
      )]

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

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

Parametrar

inputValue

Funktionen createArray() förväntar sig noll eller fler indatavärden av samma typ. Avgränsa varje värde med ett kommatecken. Om typen av indatavärde skiljer sig från det första värdet returnerar DSC ett fel för funktionen.

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

Utdata

Funktionen createArray() returnerar en matris med värden. När indatavärdena är matriser är det returnerade värdet en matris med matriser, inte en utplattad matris med indatavärdena. Du kan returnera en utplattad matris med strängmatriser med funktionen concat(), som i exempel 3.

Type: array

Dela via