Compartilhar via

about_Split

  • Artigo

Descrição breve

Explica como usar o operador Split para dividir uma ou mais cadeias de caracteres em subcadeias de caracteres.

Descrição longa

O operador Split divide uma ou mais cadeias de caracteres em subcadeias de caracteres. Você pode alterar os seguintes elementos da operação Dividir:

  • Delimitador. O padrão é espaço em branco, mas você pode especificar caracteres, strings, padrões ou blocos de script que especificam o delimitador. O operador Split no PowerShell usa uma expressão regular no delimitador, em vez de um caractere simples.
  • Número máximo de subcadeias de caracteres. O padrão é retornar todas as substrings. Se você especificar um número menor que o número de subcadeias de caracteres, as subcadeias de caracteres restantes serão concatenadas na última subcadeia de caracteres.
  • Opções que especificam as condições sob as quais o delimitador é correspondido, como SimpleMatch e Multiline.

Sintaxe

O diagrama a seguir mostra a sintaxe do operador -split.

Os nomes dos parâmetros não aparecem no comando. Inclua apenas os valores de parâmetro. Os valores devem aparecer na ordem especificada no diagrama de sintaxe.

-Split <String>
-Split (<String[]>)
<String> -Split <Delimiter>[,<Max-substrings>[,"<Options>"]]
<String> -Split {<ScriptBlock>} [,<Max-substrings>]

Você pode substituir -iSplit ou -cSplit por -split em qualquer instrução binária Split (uma instrução Split que inclui um delimitador ou bloco de script). Os -iSplit operadores and -split não diferenciam maiúsculas de minúsculas. O -cSplit operador diferencia maiúsculas de minúsculas, o que significa que maiúsculas e minúsculas são consideradas quando as regras do delimitador são aplicadas.

Parâmetros

<String> ou <String>

Especifica uma ou mais cadeias de caracteres a serem divididas. Se você enviar várias cadeias de caracteres, todas as cadeias de caracteres serão divididas usando as mesmas regras de delimitador.

Exemplo:

-split "red yellow blue green"
red
yellow
blue
green

<Delimitador>

Os caracteres que identificam o final de uma substring. O delimitador padrão é o espaço em branco, incluindo espaços e caracteres não imprimíveis, como nova linha ('n) e tabulação ('t). Quando as cadeias de caracteres são divididas, o delimitador é omitido de todas as subcadeias de caracteres. Exemplo:

"Lastname:FirstName:Address" -split ":"
Lastname
FirstName
Address

Por padrão, o delimitador é omitido dos resultados. Para preservar todo ou parte do delimitador, coloque entre parênteses a parte que você deseja preservar. Se o <Max-substrings> parâmetro for adicionado, isso terá precedência quando o comando dividir a coleção. Se você optar por incluir um delimitador como parte da saída, o comando retornará o delimitador como parte da saída; No entanto, dividir a cadeia de caracteres para retornar o delimitador como parte da saída não conta como uma divisão.

Exemplos:

"Lastname:FirstName:Address" -split "(:)"
Lastname
:
FirstName
:
Address

"Lastname/:/FirstName/:/Address" -split "/(:)/"
Lastname
:
FirstName
:
Address

<Max-substrings>

Especifica o número máximo de subcadeias de caracteres retornadas pela operação de divisão. O padrão é todas as subcadeias de caracteres divididas pelo delimitador. Se houver mais substrings, elas serão concatenadas para a substring final. Se houver menos substrings, todas as substrings serão retornadas. Um valor de 0 retorna todas as substrings.

Exemplo:

$c = "Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune"
$c -split ",", 5

Mercury
Venus
Earth
Mars
Jupiter,Saturn,Uranus,Neptune

Se você enviar mais de uma cadeia de caracteres (uma matriz de cadeias de caracteres) para o -split operador, o Max-substrings limite será aplicado a cada cadeia de caracteres separadamente.

$c = 'a,b,c','1,2,3,4,5'
$c -split ',', 3

a
b
c
1
2
3,4,5

<Max-substrings> não especifica o número máximo de objetos retornados. No exemplo a seguir, <Max-substrings> é definido como 3. Isso resulta em três valores de subcadeia de caracteres, mas um total de cinco cadeias de caracteres na saída resultante. O delimitador é incluído após as divisões até que o máximo de três subcadeias de caracteres seja atingido. Delimitadores adicionais na subcadeia de caracteres final tornam-se parte da subcadeia de caracteres.

'Chocolate-Vanilla-Strawberry-Blueberry' -split '(-)', 3

Chocolate
-
Vanilla
-
Strawberry-Blueberry

Valores negativos são ignorados.

<Bloco de script>

Uma expressão que especifica regras para aplicar o delimitador. A expressão deve ser avaliada como $true ou $false. Coloque o bloco de script entre chaves.

Exemplo:

$c = "Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune"
$c -split {$_ -eq "e" -or $_ -eq "p"}

M
rcury,V
nus,
arth,Mars,Ju
it
r,Saturn,Uranus,N

tun

<Opções>

Coloque o nome da opção entre aspas. As opções são válidas somente quando o <parâmetro Max-substrings> é usado na instrução.

A sintaxe do parâmetro Opções é:

"SimpleMatch [,IgnoreCase]"

"[RegexMatch] [,IgnoreCase] [,CultureInvariant]
[,IgnorePatternWhitespace] [,ExplicitCapture]
[,Singleline | ,Multiline]"

As opções do SimpleMatch são:

  • SimpleMatch: use a comparação de cadeia de caracteres simples ao avaliar o delimitador. Não pode ser usado com RegexMatch.
  • IgnoreCase: força a correspondência sem distinção entre maiúsculas e minúsculas, mesmo que o operador -cSplit seja especificado.

As opções RegexMatch são:

  • RegexMatch: use a correspondência de expressão regular para avaliar o delimitador. Esse é o comportamento padrão. Não pode ser usado com SimpleMatch.
  • IgnoreCase: força a correspondência sem distinção entre maiúsculas e minúsculas, mesmo que o operador -cSplit seja especificado.
  • CultureInvariant: ignora as diferenças culturais no idioma ao avaliar o delimitador. Válido apenas com RegexMatch.
  • IgnorePatternWhitespace: ignora espaços em branco sem escape e comentários marcados com o sinal numérico (#). Válido apenas com RegexMatch.
  • Multilinha: o modo Multilinha força ^ e $ corresponde ao início e ao final de cada linha, em vez do início e do fim da cadeia de caracteres de entrada.
  • Singleline: o modo Singleline trata a cadeia de caracteres de entrada como uma SingleLine. Ele força o . caractere a corresponder a todos os caracteres (incluindo novas linhas), em vez de corresponder a todos os caracteres, EXCETO a nova linha \n.
  • ExplicitCapture: ignora grupos de correspondência não nomeados para que apenas grupos de captura explícitos sejam retornados na lista de resultados. Válido apenas com RegexMatch.

Observação

SingleLine é o comportamento padrão. Singleline e Multiline não podem ser usados em conjunto com o parâmetro options. Isso foi resolvido no PowerShell 6.0. A solução alternativa é usar Mode-Modifiers em sua expressão regular. Você pode ler mais sobre modificadores de modo em Opções de expressão regular

OPERADORES DE DIVISÃO UNÁRIA E BINÁRIA

O operador de divisão unário (-split <string>) tem maior precedência do que uma vírgula. Como resultado, se você enviar uma lista separada por vírgulas de cadeias de caracteres para o operador de divisão unária, somente a primeira cadeia de caracteres (antes da primeira vírgula) será dividida.

Use um dos seguintes padrões para dividir mais de uma cadeia de caracteres:

  • Use o operador de divisão binária (<string []> -split <delimiter>)
  • Coloque todas as strings entre parênteses
  • Armazene as strings em uma variável e envie a variável para o operador de divisão

Considere o seguinte exemplo:

PS> -split "1 2", "a b"
1
2
a b

PS> "1 2", "a b" -split " "
1
2
a
b

PS> -split ("1 2", "a b")
1
2
a
b

PS> $a = "1 2", "a b"
PS> -split $a
1
2
a
b

Exemplos

A instrução a seguir divide a cadeia de caracteres em espaços em branco.

-split "Windows PowerShell 2.0`nWindows PowerShell with remoting"


Windows
PowerShell
2.0
Windows
PowerShell
with
remoting

A instrução a seguir divide a cadeia de caracteres em qualquer vírgula.

"Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -split ','

Mercury
Venus
Earth
Mars
Jupiter
Saturn
Uranus
Neptune

A instrução a seguir divide a cadeia de caracteres no padrão "er".

"Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -split 'er'

M
cury,Venus,Earth,Mars,Jupit
,Saturn,Uranus,Neptune

A instrução a seguir executa uma divisão que diferencia maiúsculas de minúsculas na letra "N".

"Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -cSplit 'N'

Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,
eptune

A instrução a seguir divide a cadeia de caracteres em "e" e "t".

"Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -split '[et]'

M
rcury,V
nus,
ar
h,Mars,Jupi

r,Sa
urn,Uranus,N
p
un

A instrução a seguir divide a cadeia de caracteres em "e" e "r", mas limita as subcadeias de caracteres resultantes a seis subcadeias de caracteres.

"Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -split '[er]', 6

M

cu
y,V
nus,
arth,Mars,Jupiter,Saturn,Uranus,Neptune

A instrução a seguir divide uma cadeia de caracteres em três subcadeias de caracteres.

"a,b,c,d,e,f,g,h" -split ",", 3

a
b
c,d,e,f,g,h

A instrução a seguir divide duas cadeias de caracteres em três subcadeias de caracteres. (O limite é aplicado a cada cadeia de caracteres independentemente.)

"a,b,c,d", "e,f,g,h" -split ",", 3

a
b
c,d
e
f
g,h

A instrução a seguir divide cada linha na cadeia de caracteres aqui no primeiro dígito. Ele usa a opção Multilinha para reconhecer o início de cada linha e string.

O 0 representa o valor "return all" do parâmetro Max-substrings. Você pode usar opções, como Multilinha, somente quando o valor Max-substrings for especificado.

$a = @'
1The first line.
2The second line.
3The third of three lines.
'@
$a -split "^\d", 0, "multiline"


The first line.

The second line.

The third of three lines.

A instrução a seguir usa o caractere de barra invertida para escapar do delimitador de ponto (.).

Com o padrão, RegexMatch, o ponto entre aspas (".") é interpretado para corresponder a qualquer caractere, exceto a um caractere de nova linha. Como resultado, a instrução Split retorna uma linha em branco para cada caractere, exceto nova linha.

"This.is.a.test" -split "\."

This
is
a
test

A instrução a seguir usa a opção SimpleMatch para direcionar o operador -split para interpretar o delimitador de ponto (.) literalmente.

O 0 representa o valor "return all" do parâmetro Max-substrings. Você pode usar opções, como SimpleMatch, somente quando o valor Max-substrings for especificado.

"This.is.a.test" -split ".", 0, "simplematch"

This
is
a
test

A instrução a seguir divide a cadeia de caracteres em um dos dois delimitadores, dependendo do valor de uma variável.

$i = 1
$c = "LastName, FirstName; Address, City, State, Zip"
$c -split $(if ($i -lt 1) {","} else {";"})

LastName, FirstName
 Address, City, State, Zip

Confira também