Concat

Artikel
05/11/2024

Synopsis

Returnerar en sträng med kombinerade värden.

Syntax

concat(<inputValue>, <inputValue>[, <inputValue>...])

Description

Funktionen concat() kombinerar flera värden och returnerar de sammanfogade värdena som en enda sträng. Avgränsa varje värde med kommatecken. Funktionen concat() är variadisk. Du måste skicka minst två värden till funktionen. Funktionen kan acceptera valfritt antal argument.

Funktionen sammanfogar indatavärdena utan kopplingstecken. Den accepterar endast strängar eller matriser med strängar som indatavärden. Indatavärdena måste vara av samma typ. Om du skickar en sträng och en matris till samma funktion genererar funktionen ett fel.

Exempel

Exempel 1 – Sammanfoga strängar

Konfigurationen använder concat() funktionen för att ansluta strängarna abc och def

# concat.example.1.dsc.config.yaml
$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
resources:
  - name: Echo 'abcdef'
    type: Test/Echo
    properties:
      output: "[concat('abc', 'def')]"

dsc --input-file concat.example.1.dsc.config.yaml config get

results:
- name: Echo 'abcdef'
  type: Test/Echo
  result:
    actualState:
      output: abcdef
messages: []
hadErrors: false

Exempel 2 – Sammanfoga matriser med strängar

Konfigurationen concat() använder funktionen för att returnera en kombinerad matris med strängar från två matriser med strängar. Den använder YAML:s vikta syntax för flera linjer för att göra funktionen mer läsbar.

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

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

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

Parametrar

inputValue

Funktionen concat() förväntar sig att två eller flera indatavärden av samma typ sammanfogas. Varje värde måste vara antingen en sträng eller en matris med strängar. Om ett värde är en sträng och den andra en matris, eller om värdet inte är en sträng eller matris med strängar, genererar DSC ett fel när konfigurationsdokumentet verifieras.

Type:         [string, array(string)]
Required:     true
MinimumCount: 2
MaximumCount: 18446744073709551615

Utdata

När varje inputValue är en sträng concat()returnerar en enda sträng med varje inputValue sammanfogat. När varje inputValue är en matris med strängar concat() returnerar en utplattad matris som innehåller strängarna från varje indatamatris.

Type: [string, array]

Dela via