Palauttaa merkkijonon, jossa määritetty alimerkkijono on korvattu toisella alimerkkijonolla tietyn määrän kertoja.
Syntaksi
Replace( lauseke, etsi, korvaa [, alku ] [, määrä ] [, vertaa ] )
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 etsiminen 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
Vertaa -argumentilla on 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 -sovelluksessa. 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ä |
kopion lausekkeesta. |
korvaa on tyhjä |
kopion lausekkeesta, josta on poistettu kaikki etsi-esiintymät. |
alku > Len(lauseke) |
tyhjän merkkijonon. Merkkijonon vaihto alkaa aloitusnäytön osoittamasta sijainnista. |
määrä on 0 |
kopion lausekkeesta. |
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. |