Tagastab stringi, milles üks määratud alamstring on määratud arv kordi asendatud teise alamstringiga.
Süntaks
Replace( expression, find, replace [, start ] [, count ] [, compare ] )
Funktsiooni Replace süntaksil on järgmised argumendid.
|
Argument |
Kirjeldus |
|
avaldis |
Nõutav. Asendatavat alamstringi sisaldav stringavaldis. |
|
find |
Nõutav. Otsitav alamstring. |
|
replace |
Nõutav. Asendamiseks kasutatav alamstring. |
|
start |
Valikuline. Avaldise koht, kust alamstringi otsingut alustatakse. Kui see jäetakse välja, eeldatakse, et see on 1. |
|
count |
Valikuline. Alamstringide asendamiste arv. Kui see jäetakse välja, on vaikeväärtus –1, mis tähendab, et asendusi tehakse igal võimalusel. |
|
compare |
Valikuline. Arvväärtus, mis tähistab alamstringidega kasutatavat võrdlust. Väärtusi vt jaotisest „Sätted“. |
Sätted
Argumendil compare saavad olla järgmised väärtused.
|
Konstant |
Väärtus |
Kirjeldus |
|
vbUseCompareOption |
–1 |
Teeb lause Option Compare sätet kasutades võrdluse. |
|
vbBinaryCompare |
0 |
Teeb binaarvõrdluse. |
|
vbTextCompare |
1 |
Teeb tekstivõrdluse. |
|
vbDatabaseCompare |
2 |
Ainult Microsoft Office Access 2007. Võrdleb andmebaasis olevate väärtuste põhjal. |
Tagastusväärtused
Replace tagastab järgmised väärtused.
|
Tingimus |
Replace-funktsiooni tagastatav väärtus |
|
Avaldis on nullpikkusega |
Nullpikkusega string („”) |
|
Avaldis on nullpikkusega |
Tõrge. |
|
Argument find on nullpikkusega |
Avaldise koopia. |
|
Argument replace on nullpikkusega |
Avaldise koopia, kus on eemaldatud kõik argumendi find esinemisjuhud. |
|
start > Len(expression) |
Nullpikkusega string. Stringi asendamine algab argumendiga start tähistatud kohast. |
|
Argument count on 0 |
Avaldise koopia. |
Kommentaarid
Funktsiooni Replace tagastusväärtus on asendatud string, mis algab argumendiga start määratud kohast ja lõpeb avaldisestringi lõpus. See pole algse stringi täielik koopia.
Näide
|
Avaldis |
Tulemid |
|
SELECT ProductID, Replace(ProductID,"PRO","Product") AS ReplaceID FROM ProductSales; |
Tagastab väärtuse "ProductID", leiab tekstist "ProductID" väärtuse "PRO" ja asendab selle väärtusega "Product" ("Toode") ning kuvab tulemi veerus ReplaceID (Asendatud ID). |