PR Summary

This pull request adds 2 new containment operators:

• -any (ex. 1..5 -any { $_ -eq 2 })
  • Takes a collection as its lhs operand and a predicate as its rhs operand. Returns true if the predicate is true for any lhs value, returns false otherwise
• -all (ex. 1..5 -all { $_ -gt 0 })
  • Takes a collection as its lhs operand and a predicate as its rhs operand. Returns true if the predicate is true for all lhs value, returns false otherwise

If a non-delegate-like object is passed as the rhs operand, we perform a scalar equality comparison against each item in lhs.

A related update to the EditorSyntax definition has been prepared here: PowerShell/EditorSyntax#189

PR Context

This PR is partly motivated by the discussion in #7925, and my own frustration with having to cast nested loop structures to perform similar containment testing.

For example, to find a directory in which all files a marked hidden:

# with the current binary operators
Get-ChildItem -Directory -Recurse |Where {
  $files = @($_ |Get-ChildItem -File -Force) 
  $files.Count -gt 0 -and ($files |Where Attributes -notlike "*hidden*").Count -eq 0
}

# with `-all`
Get-ChildItem -Directory -Recurse |Where {
  @($_ |Get-ChildItem -File -Force) -all {$_.Attributes -like "*hidden*"}
}

(I'm aware that dynamic parameter aliases exist specifically for attribute filtering in the FileSystem provider, but that's sort of missing the point, -any/-all would work in any context)

TODO:

• Should we include a negation? (-notany/-none and -notall)
• Should we include case-sensitive variants? (only applies to the -contains fallback edge case)
• Should we include more/better tests? (for containment operators in general)

PR Checklist

• PR has a meaningful title
  • Use the present tense and imperative mood when describing your changes
• Summarized changes
• Make sure all .h, .cpp, .cs, .ps1 and .psm1 files have the correct copyright header
• This PR is ready to merge and is not Work in Progress.
  • If the PR is work in progress, please add the prefix WIP: or [ WIP ] to the beginning of the title (the WIP bot will keep its status check at Pending while the prefix is present) and remove the prefix when the PR is ready.
• Breaking changes
  • None
  • OR
  • Experimental feature(s) needed
    • Experimental feature name(s):
• User-facing changes
  • Not Applicable
  • OR
  • Documentation needed
    • Issue filed:
• Testing - New and feature
  • N/A or can only be tested interactively
  • OR
  • Make sure you've added a new test if existing tests do not effectively test the code changed
• Tooling
  • I have considered the user experience from a tooling perspective and don't believe tooling will be impacted.
  • OR
  • I have considered the user experience from a tooling perspective and enumerated concerns in the summary. This may include:
    • Impact on PowerShell Editor Services which is used in the PowerShell extension for VSCode (which runs in a different PS Host).
    • Impact on Completions (both in the console and in editors) - one of PowerShell's most powerful features.
    • Impact on PSScriptAnalyzer (which provides linting & formatting in the editor extensions).
    • Impact on EditorSyntax (which provides syntax highlighting with in VSCode, GitHub, and many other editors).