Palauttaa merkkijonon, jossa määritetty alimerkkijono on korvattu toisella alimerkkijonolla tietyn määrän kertoja.
Syntaksi
Korvaa(lauseke, etsi, korvaa [, aloita ] [, laske ] [, vertaile ] )
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 alimerkkijonon haku 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äarvo | virheen. |
| etsi on tyhjä | Lausekkeen kopio. |
| korvaa on tyhjä | Lausekkeen kopio, jossa kaikki etsimisen ilmentymät on poistettu. |
| Aloittaa>Len(lauseke) | tyhjän merkkijonon. Merkkijonon vaihto alkaa aloitusnäytön osoittamasta sijainnista. |
| määrä on 0 | Lausekkeen kopio. |
Huomautuksia
Korvaa-funktion palautusarvo on merkkijono, jonka korvaamiset on tehty ja joka alkaa alku-argumentin määrittämästä sijainnista ja päättyy lausekemerkkijonon loppuun. Se ei ole alkuperäisen merkkijonon kopio alusta loppuun.
Esimerkki
| Lauseke | Tulokset |
|---|---|
| SELECT ProductID, Replace(ProductID,"PRO","Product") AS ReplacedID FROM ProductSales; | Palauttaa Tuotetunnus-arvon, etsii tuotteen tunnuksen "PRO" ja korvaa sen tuotteella ja näyttää tuloksen Korvattutunnus-sarakkeessa. |