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. |
