about_Join

Mis à jour: mai 2014

S'applique à: Windows PowerShell 2.0, Windows PowerShell 3.0, Windows PowerShell 4.0, Windows PowerShell 5.0

RUBRIQUE

about_join

DESCRIPTION COURTE

Décrit comment l'opérateur de jointure (-joint) combine plusieurs chaînes en une seule chaîne.

DESCRIPTION DÉTAILLÉE

L'opérateur de jointure concatène un ensemble de chaînes en une seule chaîne. Les chaînes sont ajoutées à la chaîne résultante dans l'ordre dans lequel elles apparaissent dans la commande.

Syntaxe

Le diagramme suivant montre la syntaxe de l'opérateur de jointure.

         -Join <String[]>
        <String[]> -Join <Delimiter>

Paramètres

String[]

Spécifie une ou plusieurs chaînes à joindre.

Delimiter

Spécifie un ou plusieurs caractères placés entre les chaînes concaténées.

Par défaut, il n'y a aucun séparateur ("").

Remarques

L'opérateur de jointure unaire (-join <string[]>) a une priorité plus élevée qu'une virgule. Par conséquent, si vous envoyez une liste de chaînes séparées par des virgules à l'opérateur de jointure unaire, seule la première chaîne (avant la première virgule) lui sera envoyée.

Pour utiliser l'opérateur de jointure unaire, mettez les chaînes entre parenthèses, ou bien stockez-les dans une variable, puis envoyez la variable à joindre.

Par exemple :

          -join "a", "b", "c"
          a
          b
          c

          -join ("a", "b", "c")
          abc


          $z = "a", "b", "c"
          -join $z
          abc

Exemples

L'instruction suivante joint trois chaînes :

          -join ("Windows", "PowerShell", "2.0")
          WindowsPowerShell2.0

L'instruction suivante joint trois chaînes délimitées par un espace :

          "Windows", "PowerShell", "2.0" -join " "
          Windows PowerShell 2.0

Les instructions suivantes utilisent un séparateur à plusieurs caractères pour joindre trois chaînes :

          $a = "WIND", "SP", "ERSHELL" 
          $a -join "OW"
          WINDOWSPOWERSHELL

L'instruction suivante joint les lignes d'une here-string dans une chaîne unique. Étant donné qu'une here-string correspond à une chaîne, les lignes qui la composent doivent être fractionnées avant de pouvoir être jointes. Vous pouvez utiliser cette méthode pour rejoindre les chaînes d'un fichier XML ayant été enregistré dans une here-string :

          $a = @'
          a
          b
          c
          '@

          (-split $a) -join " "
          a b c

VOIR AUSSI

about_Operators

about_Comparison_Operators

about_Split