TEMA
about_Break
DESCRIPCIÓN BREVE
Describe una instrucción que se puede utilizar para salir
inmediatamente las instrucciones Foreach, For, While, Do o Switch.
DESCRIPCIÓN DETALLADA
Cuando una instrucción Break aparece en un bucle (como un bucle
Foreach, For, Switch o While), la instrucción Break hace que Windows
PowerShell salga inmediatamente del bucle. En una construcción Switch
que no sea un bucle, Break hace que Windows PowerShell salga del bloque
de código Switch.
Una instrucción Break puede incluir una etiqueta que permita
salir de los bucles incrustados. Una etiqueta puede especificar
cualquier palabra clave de bucle, como Foreach, For o While, en
un script. Cuando se utiliza una etiqueta, Break sale del bucle
especificado. Break sale del bucle especificado sin tener en
cuenta en qué bucle se encuentre la instrucción Break.
En el siguiente ejemplo se muestra cómo usar una instrucción
Break para cerrar una instrucción For:
for($i=1; $i -le 10; $i++)
{
Write-Host $i
break
}
En este ejemplo, la instrucción Break sale del bucle For cuando
la variable $i es igual a 1. Aunque la instrucción For se evalúa
en True hasta que $i sea mayor que 10, Windows PowerShell llega a la
instrucción Break la primera vez que se ejecuta el bucle For.
Es más común para utilizar la instrucción Break en un bucle donde es
necesario que se cumpla una condición interna. Observe el siguiente
ejemplo de la instrucción Foreach:
$i=0
$varB = 10,20,30,40
foreach ($val in $varB)
{
$i++
if ($val -eq 30)
{
break
}
}
Write-Host "Se encontró 30 en la posición de matriz $i"
En este ejemplo, la instrucción Foreach recorre la matriz $varB
en iteración. Cada vez que se ejecuta el bloque de código, la
variable $i se incrementa en 1. La instrucción If se evalúa en
False las primeras dos veces que se ejecuta el bucle. La tercera
vez que se ejecuta el bucle, $i es igual a 3 y la variable $val
es igual a 30. En este punto, se ejecuta la instrucción Break y
el bucle Foreach se cierra.
Para salir de las demás instrucciones de bucle se hace lo mismo
que para salir del bucle Foreach. En el siguiente ejemplo, la
instrucción Break cierra una instrucción While cuando se
intercepta una excepción DivideByZeroException con la instrucción
Trap.
$i = 3
while ($true)
{
trap [DivideByZeroException]
{
Write-Host "se interceptó una división por cero" break
}
1 / $i--
}
Una instrucción Break puede incluir una etiqueta. Si utiliza la
palabra clave Break con una etiqueta, Windows PowerShell sale del
bucle etiquetado en lugar de salir del bucle actual. La sintaxis
de una etiqueta es la siguiente (en este ejemplo se muestra una
etiqueta en un bucle While):
:miEtiqueta while (<condición>) { <lista de instrucciones>}
La etiqueta está compuesta de un signo de dos puntos seguido por
un nombre asignado por el usuario. La etiqueta debe ser el primer
símbolo (token) de una instrucción y debe ir seguida de la
palabra clave de bucle (en este caso, While).
En Windows PowerShell, solamente las palabras clave de bucle,
como Foreach, For y While, pueden tener etiqueta.
Break saca la ejecución del bucle etiquetado. En los bucles
incrustados, el resultado es distinto que cuando se utiliza la
palabra clave Break por sí sola. En este ejemplo esquemático hay una
instrucción While con una instrucción For:
:miEtiqueta while (<condición 1>)
{
for ($item in $items)
{
if (<condición 2>) { break miEtiqueta }
$item = $x # Instrucción dentro del bucle For }
}
}
$a = $c # Instrucción después del bucle While etiquetado
Si condición 2 se evalúa en True, la ejecución del script va
directamente a la instrucción situada después del bucle
etiquetado. En el ejemplo, la ejecución se inicia de nuevo con la
instrucción "$a = $c".
Es posible anidar muchos bucles etiquetados, como se muestra en
ejemplo esquemático el siguiente.
:rojo while (<condición1>)
{
:amarillo while (<condición2>)
{
while (<condición3>)
{
if ($a) {break}
if ($b) {break rojo}
if ($c) {break amarillo}
}
# Después del bucle más interno
}
# Después del bucle "amarillo"
}
# Después del bucle "rojo"
Si la variable $b se evalúa en True, la ejecución del script se
reanuda después del bucle etiquetado como "rojo". Si la variable $c se
evalúa en True, la ejecución del control de script se reanuda después
del bucle etiquetado como "amarillo".
Si la variable $a se evalúa en True, la ejecución se reanuda
después del bucle más interno. No se necesita ninguna etiqueta.
Windows PowerShell no limita a qué distancia pueden reanudar la
ejecución las etiquetas. La etiqueta puede pasar el control
incluso a través de los límites de las llamadas de los script y las
funciones.
La palabra clave Break se utiliza para salir de la construcción
Switch. Por ejemplo, la siguiente instrucción Switch usa instrucciones
Break para comprobar si se cumple la condición más específica:
$var = "word2"
switch -regex ($var)
{
"word2"
{
Write-Host "Exacto" $_
break
}
"word.*"
{
Write-Host "Coincide el prefijo" $_ break
}
"w.*"
{
Write-Host "Coincide al menos la primera letra" $_ break
}
default
{
Write-Host "No coincide nada" $_
break
}
}
En este ejemplo, la variable $var se crea e inicializa en el
valor de cadena "word2". La instrucción Switch usa la clase Regex para
hallar primero la coincidencia del valor de la variable con el
término "word2". (La clase Regex es una clase de Microsoft .NET
Framework de expresión regular.) Dado que coinciden el valor de la
variable y la primera prueba de la instrucción Switch, se ejecuta el
primer bloque de código de esta instrucción.
Cuando Windows PowerShell llega a la primera instrucción Break, la
instrucción Switch se cierra. Si se quitaran las cuatro instrucciones
Break del ejemplo, se cumplirían las cuatro condiciones. En este
ejemplo se usa la instrucción Break para mostrar los resultados
cuando se cumple la condición más específica.
VEA TAMBIÉN
about_Comparison_Operators
about_For
about_Foreach
about_Switch
about_While