about_Join

Description courte

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

Description longue

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.

Délimiteur : spécifie un ou plusieurs caractères placés entre les chaînes concaténées. La valeur par défaut n’est pas délimiteur (« »).

Notes

L’opérateur de jointure unaire (chaîne de jointure <[]>) a une priorité supérieure à 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) est envoyée à l’opérateur de jointure.

Pour utiliser l’opérateur de jointure unaire, placez les chaînes entre parenthèses ou stockez les chaînes 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 délimiteur à plusieurs caractères pour joindre trois chaînes :

$a = "WIND", "S P", "ERSHELL"
$a -join "OW"
WINDOWS POWERSHELL

L’instruction suivante joint les lignes d’une chaîne ici en une seule chaîne. Étant donné qu’une chaîne ici est une chaîne, les lignes de la chaîne ici doivent être fractionnées avant de pouvoir être jointes. Vous pouvez utiliser cette méthode pour rejoindre les chaînes dans un fichier XML qui a été enregistré dans une chaîne ici :

$a = @'
a
b
c
'@

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

Voir aussi