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