Main | Contact | Blog | Documentation

PowerShell Framework

The project dedicated to empowering your PowerShell scripting.

Test-PSFFunctionInterrupt

SYNOPSIS

Tests whether the calling function should be interrupted.

SYNTAX

Test-PSFFunctionInterrupt [<CommonParameters>]

DESCRIPTION

This helper function is designed to work in tandem with Stop-PSFFunction. When gracefully terminating a function, there is a major issue: “Return” will only stop the current one of the three blocks (Begin, Process, End). All other statements have side effects or produce lots of red text.

So, Stop-PSFFunction writes a variable into the parent scope, that signals the function should cease. This function then checks for that very variable and returns true if it is set.

This avoids having to handle odd variables in the parent function and causes the least impact on contributors.

For a more detailed explanation - including commented full-scale implementation examples - see the associated help article: Get-Help about_psf_flowcontrol

EXAMPLES

EXAMPLE 1

if (Test-PSFFunctionInterrupt) { return }

The calling function will stop if this function returns true.

PARAMETERS

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

System.Boolean

NOTES