about_Do

Descrição breve

Executa uma lista de instruções uma ou mais vezes, sujeita a uma While ou Until condição.

Descrição longa

A Do palavra-chave funciona com a While palavra-chave ou a Until palavra-chave para executar as instruções em um bloco de script, sujeito a uma condição. Ao contrário do loop relacionado While , o bloco de script em um Do loop sempre é executado pelo menos uma vez.

Um loop Do-While é uma variedade do While loop. Em um loop Do-While , a condição é avaliada após a execução do bloco de script. Como em um loop While, o bloco de script é repetido desde que a condição seja avaliada como verdadeira.

Como um loop Do-While , um loop Do-Until sempre é executado pelo menos uma vez antes que a condição seja avaliada. No entanto, o bloco de script é executado somente enquanto a condição é false.

As Continue palavras-chave de controle e Break fluxo podem ser usadas em um loop Do-While ou em um loop Do-Until .

Sintaxe

A seguir é mostrada a sintaxe da instrução Do-While :

do {<statement list>} while (<condition>)

A seguir mostra a sintaxe da instrução Do-Until :

do {<statement list>} until (<condition>)

A lista de instruções contém uma ou mais instruções que são executadas sempre que o loop é inserido ou repetido.

A parte de condição da instrução é resolvida como true ou false. Para obter mais informações sobre como os booleanos são avaliados, consulte about_Booleans.

Exemplo

O exemplo a seguir de uma Do instrução conta os itens em uma matriz até chegar a um item com um valor 0.

PS> $x = 1,2,78,0
PS> do { $count++; $a++; } while ($x[$a] -ne 0)
PS> $count
3

O exemplo a seguir usa a Until palavra-chave. Observe que o não igual ao operador (-ne) é substituído pelo igual ao operador (-eq).

PS> $x = 1,2,78,0
PS> do { $count++; $a++; } until ($x[$a] -eq 0)
PS> $count
3

O exemplo a seguir grava todos os valores de uma matriz, ignorando qualquer valor menor que zero.

do {
  if ($x[$a] -lt 0) { continue }
  Write-Host $x[$a]
}
while (++$a -lt 10)

Confira também