Koans/Foundations/AboutTypeOperators.Koans.ps1

#Requires -Module PSKoans
[Koan(111)]
param()
<#
    Type Operators
 
    -is and -isnot are used to verify the type of an object, whereas -as is used to cast or convert
    an object to another type entirely.
 
    For more detailed information, refer to 'Get-Help about_Type_Operators'
#>

Describe 'Type Operators' {

    Context 'Is and IsNot Operators' {

        It 'examines the type of the left hand object' {
            45 -isnot [double] | Should -BeTrue
            'string' -is [__] | Should -BeTrue
        }

        It 'is useful for determining available methods' {
            $Value = __

            if ($Value -is [double]) {
                $Value | Should -BeOfType __
            }
            else {
                throw '$Value was of incorrect type.'
            }
        }
    }

    Context 'As Operator' {

        It 'is used to convert objects to other types' {
            $Value = '__'
            $Value | Should -BeOfType [string]

            $NewValue = $Value -as [int]
            $NewValue | Should -BeOfType int
        }

        It 'is similar to casting' {
            $String = '04'
            $Number = [int] $String
            $Number2 = $String -as [int]

            $Number | Should -Be $Number2
            $Number | Should -BeOfType __
        }

        It 'does not throw errors on a failed conversion' {
            $Casting = {
                [int]'string'
            }
            $Conversion = {
                'string' -as [int]
            }

            $Casting | Should -Throw -ExceptionType __
            $Conversion | Should -Not -Throw
            $Conversion | Should -Be __
        }
    }
}