about_Join

RUBRIQUE
    about_join

DESCRIPTION COURTE
    Décrit comment l'opérateur de jointure (-join) combine plusieurs 
    chaînes en une.


DESCRIPTION LONGUE
    L'opérateur de jointure concatène un jeu 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 présente la syntaxe pour 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. La valeur par défaut est l'absence de séparateur ("").
	

  Notes
      L'opérateur de jointure unaire (-join <string[]>) a la priorité sur
      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 (située avant la première 
      virgule) lui est soumise.


      Pour utiliser l'opérateur de jointure unaire, mettez les 
      chaînes entre parenthèses ou 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 des 
      espaces :

	
          "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", "SP", "ERSHELL" 
          $a -join "OW"
          WINDOWSPOWERSHELL


      L'instruction suivante joint les lignes d'une chaîne 
      here-string en une seule et même chaîne. Parce qu'une chaîne 
      here-string est une chaîne unique, les lignes qu'elle contient 
      doivent être fractionnées pour pouvoir être jointes. Vous 
      pouvez utiliser cette méthode pour joindre les chaînes d'un 
      fichier XML ayant été enregistré comme chaîne here-string :


          $a = @'
          a
          b
          c
          '@

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

VOIR AUSSI
    about_Operators
    about_Comparison_Operators
    about_Split