Palauttaa merkkijonon, jossa määritetty alimerkkijono on korvattu toisella alimerkkijonolla tietyn määrän kertoja.
Syntaksi
Replace(lauseke, etsi, korvaa [, alku ] [, laske ] [, vertailu])
Replace-funktion syntaksilla on seuraavat argumentit:
| Argumentti | Kuvaus |
|---|---|
| lauseke | Pakollinen. Merkkijonolauseke, joka sisältää korvattavan alimerkkijonon. |
| etsi | Pakollinen. Alimerkkijono, jota etsitään. |
| korvaa | Pakollinen. Korvaava alimerkkijono. |
| alku | Valinnainen. Sijainti lausekkeessa , josta merkkijonon osahaun on määrä alkaa. Jos jätetään pois, oletusarvona on 1. |
| määrä | Valinnainen. Suoritettavien alimerkkijonon korvaamisten määrä. Jos jätetään pois, oletusarvona on –1, mikä tarkoittaa, että kaikki mahdolliset merkkijonot korvataan. |
| vertaa | Valinnainen. Numeerinen arvo, joka ilmoittaa käytettävän vertailun lajin alimerkkijonojen arvioimiseen. Lisätietoja arvoista on Asetukset-osiossa. |
Asetukset
Vertailuargumentilla voi olla seuraavat arvot:
| Vakio | Arvo | Kuvaus |
|---|---|---|
| vbUseCompareOption | –1 | Suorittaa vertailun käyttämällä Asetuksen vertailu -lausekkeen asetusta. |
| vbBinaryCompare | 0 | Suorittaa binaarisen vertailun. |
| vbTextCompare | 1 | Suorittaa tekstivertailun. |
| vbDatabaseCompare | 2 | Vain Microsoft Office Access 2007. Suorittaa tietokannan tietoihin perustuvan vertailun. |
Palautusarvot
Korvaa palauttaa seuraavat arvot:
| Jos | Korvaa palauttaa |
|---|---|
| lauseke on tyhjä | Nollapituinen merkkijono ("") |
| lauseke on tyhjäarvoinen | virheen. |
| Etsi on tyhjä | Lausekkeen kopio. |
| Korvaa on tyhjä | Kopio lausekkeesta , josta on poistettu kaikki etsi-esiintymät . |
| Käynnistä>Len(lauseke) | tyhjän merkkijonon. Merkkijonon korvaus alkaa aloituksen osoittamasta kohdasta. |
| Määrä on 0 | Lausekkeen kopio. |
Huomautuksia
Replace-funktion palautusarvo on merkkijono, jossa on tehty korvauksia, joka alkaa beginin määrittämästä kohdasta ja päättyy lausekkeen merkkijonon loppuun. Se ei ole alkuperäisen merkkijonon kopio alusta loppuun.
Esimerkki
| Lauseke | Tulokset |
|---|---|
| SELECT ProductID, Replace(ProductID,"PRO","Product") AS SubstitutID FROM ProductSales; | Palauttaa Tuotetunnus-kentän, etsii sanat "PRO" kohdasta "Tuotetunnus", korvaa sanalla "Tuote" ja näyttää tuloksen sarakkeessa Korvattutunnus. |