Switch-funktio

Arvioi lausekeluettelon ja palauttaa muuttuja-arvon tai lausekkeen, joka liittyy luettelon ensimmäiseen lausekkeeseen ja joka on Tosi.

Syntaksi

Switch(lauseke-1, arvo-1 [, lauseke-2, arvo-2 ] ... [, lauseke-n, arvo-n ] )

Switch-funktion syntaksilla on seuraavat argumentit:

Argumentti	Kuvaus
lauseke	Pakollinen. Arvioitava muuttujalauseke.
arvo	Pakollinen. Arvo tai lauseke, joka palautetaan, jos vastaava lauseke on Tosi.

Huomautuksia

Switch-funktion argumenttiluettelo koostuu lauseke- ja arvopareista. Lausekkeet arvioidaan vasemmalta oikealle ja arvo, joka liitetään ensimmäiseen lausekkeeseen, joka arvioidaan arvoksi Tosi, palautetaan. Jos osia ei ole yhdistetty oikein, tapahtuu suorituksenaikainen virhe. Jos esimerkiksi lauseke-1 on Tosi, Switch palauttaa arvon -1. Jos lauseke-1 on Epätosi mutta lauseke-2 on Tosi, Switch palauttaa arvon -2 ja niin edelleen.

Switch palauttaa tyhjäarvon, jos

• mikään lausekkeista ei ole Tosi
• ensimmäisen Tosi-lausekkeen arvo vastaa tyhjäarvoa.

Switch arvioi kaikki lausekkeet, vaikka se palauttaa vain yhden niistä. Tästä syystä sinun kannattaa tarkkailla ei-toivottuja sivuvaikutuksia. Jos esimerkiksi minkä tahansa lausekkeen arvioinnin tuloksena on jako nollalla, tapahtuu virhe.

Kyselyesimerkki

Lauseke	Tulokset
SELECT ProductSales.ProductID, Switch([ProductID]="PRO_XYZ1","First",[ProductID]="PRO_XYZ2","Two",[ProductID]="PRO_XYZ1","Ten") AS testSwitch FROM ProductSales;	Palauttaa "Tuotetunnus", arvioi "Switch"-kaavan lausekkeet ja vaihtaa olemassa olevat arvot määritettyihin arvoihin kaikille "Tosi"-lausekkeille. Esimerkki: "PRO_XYZ1" korvataan sanalla "Ensimmäinen", "PRO_XYZ2" korvataan "Kaksi" ja niin edelleen.

VBA-esimerkki

Tässä esimerkissä Switch-funktion avulla palautetaan kielen nimi, joka vastaa kaupungin nimeä.

Function MatchUp (CityName As String)
    Matchup = Switch(CityName = "London", "English", _
              CityName = "Rome", "Italian", _
              CityName = "Paris", "French")
End Function