about_Join

TEMA
    about_join

DESCRIPCIÓN BREVE
    Describe cómo combina el operador de combinación (-join) varias 
    cadenas en una sola.


DESCRIPCIÓN DETALLADA
    El operador de combinación concatena un conjunto de cadenas en 
    una sola. Las cadenas se anexan a la cadena resultante en el 
    orden en que aparecen en el comando. 


  Sintaxis
      En el diagrama siguiente se muestra la sintaxis del operador de 
      combinación.

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


  Parámetros
      String[]
          Especifica una o varias cadenas que se van a unir.


      Delimiter
      Especifica uno o más caracteres colocados entre las cadenas concatenadas.
          El valor predeterminado es que no haya ningún delimitador ("").
    

  Notas
      El operador de combinación unario (-join <string[]>) tiene mayor 
      precedencia que una coma. En consecuencia, si se envía una lista de cadenas 
      delimitadas por comas al operador de combinación unario, solamente se envía 
      la primera cadena (antes de la primera coma) al operador.


      Para utilizar el operador de combinación unario, deben indicarse las 
      cadenas entre paréntesis, o bien almacenarlas en una variable y, 
      a continuación, enviar esa variable a la combinación.


      Por ejemplo:

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

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


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


  Ejemplos
      La instrucción siguiente une tres cadenas:

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

    
      La instrucción siguiente une tres cadenas delimitadas por un espacio:

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


      Las instrucciones siguientes utilizan un delimitador de varios 
      caracteres para unir tres cadenas:


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


      La instrucción siguiente une las líneas de una cadena multilínea 
      intercalada en el código en una sola. Dado que la cadena multilínea 
      intercalada en el código es una sola cadena, es preciso dividir las 
      cadenas que contiene para poder unirlas después. Este método se puede 
      utilizar para volver a unir las cadenas de un archivo XML que se ha 
      guardado en una cadena multilínea intercalada en el código:


          $a = @'
          a
          b
          c
          '@

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

VEA TAMBIÉN
    about_Operators
    about_Comparison_Operators
    about_Split