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, kus alamstringi otsing algab. 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 võivad 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 tühi | Tõrge. |
| find on nullpikkusega | Avaldise koopia. |
| asendamine on nullpikkusega | Avaldise koopia, kus kõik otsingu esinemiskorrad on eemaldatud. |
| start>Len(avaldis) | Nullpikkusega string. Stringi asendamine algab argumendiga start tähistatud kohast. |
| arv 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). |