Functions/Format-ReverseString.ps1
|
Function Format-ReverseString { <# .SYNOPSIS To reverse a string, or an array of strings .DESCRIPTION To reverse a string, or an array of strings. Function aliased to 'Reverse' .PARAMETER String The string you wish to be reversed. Can be a string or an array of strings. Can be passed from the pipeline .PARAMETER IncludeInput Switch to include the input along with the output. Aliased to 'IncludeOriginal' for backward compatibility .EXAMPLE Format-ReverseString -String 'Hello' olleH .EXAMPLE Format-ReverseString -String 'Hello' -IncludeInput Original Reverse -------- ------- Hello olleH .EXAMPLE '758', '129' | Format-ReverseString -IncludeInput Original Reverse -------- ------- 758 857 129 921 #> [CmdletBinding(ConfirmImpact='None')] [alias('ReverseString')] [OutputType('string')] param( [Parameter(Mandatory, HelpMessage='Enter a string you wish to be reversed',Position=0,ValueFromPipeline)] [string[]] $String, [Alias('IncludeOriginal')] [switch] $IncludeInput ) begin { Write-Verbose -Message "Starting [$($MyInvocation.Mycommand)]" } process { foreach ($currentString in $String) { $ReturnVal = [string]::Join('', $currentString[($currentString.Length-1)..0]) if ($IncludeInput) { New-Object -TypeName 'psobject' -Property ([ordered] @{ Original = $currentString Reverse = $ReturnVal }) } else { write-output -InputObject $ReturnVal } } } end { Write-Verbose -Message "Ending [$($MyInvocation.Mycommand)]" } } |