concat

Riepilogo

Restituisce una stringa di valori combinati.

Sintassi

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

Descrizione

La concat() funzione combina più valori e restituisce i valori concatenati come singola stringa. Separare ogni valore con una virgola. La concat() funzione è variadic. È necessario passare almeno due valori alla funzione. La funzione può accettare qualsiasi numero di argomenti.

La funzione concatena i valori di input senza alcun carattere di join. Accetta solo stringhe o matrici di stringhe come valori di input. I valori di input devono essere dello stesso tipo. Se si passa una stringa e una matrice alla stessa funzione, la funzione genera un errore.

Esempio

Esempio 1 - Stringhe concatenate

La configurazione usa la concat() funzione per unire le stringhe abc e def

# concat.example.1.dsc.config.yaml
$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
resources:
  - name: Echo 'abcdef'
    type: Microsoft.DSC.Debug/Echo
    properties:
      output: "[concat('abc', 'def')]"

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

results:
- name: Echo 'abcdef'
  type: Microsoft.DSC.Debug/Echo
  result:
    actualState:
      output: abcdef
messages: []
hadErrors: false

Esempio 2 - Matrici concatenate di stringhe

La configurazione usa la concat() funzione per restituire una matrice combinata di stringhe da due matrici di stringhe. Usa la sintassi multilinea piegata di YAML per rendere la funzione più leggibile.

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

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

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

Parametri

inputValue

La concat() funzione prevede due o più valori di input dello stesso tipo per concatenare. Ogni valore deve essere una stringa o una matrice di stringhe. Se un valore è una stringa e l'altro una matrice o un valore non è una stringa o una matrice di stringhe, DSC genera un errore durante la convalida del documento di configurazione.

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

Output

Quando ogni inputValue è una stringa, concat()restituisce una singola stringa con ogni inputValue concatenata insieme. Quando ogni inputValue è una matrice di stringhe, concat() restituisce una matrice flat contenente le stringhe da ogni matrice di input.

Type: [string, array]