Add Gotcha :: Breaking from the pipeline

[JohnLBevan]

It would be good to add a gotcha on breaking from pipelines...

i.e. People expect this:

    $found = $false
    $list | ForEach-Object {
        if ($_ -eq $searchFor) {
            $found = $true
            break
        }
    }
    if ($found){'Woo'}else{'Boo'}

to work like this:

    $found = $false
    foreach {$item in $list} {
        if ($item -eq $searchFor) {
            $found = $true
            break
        }
    }
    if ($found){'Woo'}else{'Boo'}

[Bill-Stewart]

Agree; this behavior is pretty well-known, but may cause confusion and is not intuitive. Normally, if I need break or continue in a loop, I use a language keyword (for, foreach, while, etc.) instead of ForEach-Object to avoid confusion.

[Objections]

Maybe add a counter to show that they are different as you can't see it on the output in this case.
Where should it be added? Under pipeline maybe?

[serjou1]

You should use return inside ForEach-Object instead of break