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