Replace- ja Substitute-funktio

Koskee seuraavia: Pohjaan perustuvat sovellukset Dataverse -kaavasarakkeet Työpöytätyökulut Mallipohjaiset sovellukset Power Platform CLI

Korvaa tekstimerkkijonon osa toisella merkkijonolla.

Description

Replace-funktio tunnistaa korvattavan tekstin sen aloituskohdan ja pituuden mukaan.

Substitute-funktio tunnistaa korvattavan tekstin etsimällä vastaavan merkkijonon. Jos useampi kuin yksi vastine löytyy, voit korvata ne kaikki tai määrittää yhden korvattavaksi.

Jos välität yksittäisen merkkijonon, palautusarvo on muunnettu merkkijono. Jos välität yksisarakkeisen, merkkijonoja sisältävän taulukon, palautusarvo on yksisarakkeinen taulukko, joka sisältää muokattuja merkkijonoja sarakkeessa Value. Jos käytät monisarakkeista taulukkoa, voit muokata sen yksisarakkeiseksi taulukoksi kohdan Taulukoiden käyttö mukaan.

Syntaksi

Replace( String, StartingPosition, NumberOfCharacters, NewString )

• String – Pakollinen. Käsiteltävä merkkijono.
• StartingPosition – Pakollinen. Merkin sijainti, josta korvaus aloitetaan. String-arvon ensimmäinen merkki on sijainnissa 1.
• NumberOfCharacters – Pakollinen. Korvattavien merkkien määrä kohdassa String.
• NewString – Pakollinen. Korvaava merkkijono. Tämän argumentin merkkien määrä voi olla eri kuin NumberOfCharacters-argumentin.

Substitute( String, OldString, NewString [, InstanceNumber ] )

• String – Pakollinen. Käsiteltävä merkkijono.
• OldString – Pakollinen. Korvattava merkkijono.
• NewString – Pakollinen. Korvaava merkkijono. OldString ja NewString voivat olla eri pituisia.
• InstanceNumber – Valinnainen. Tämän argumentin avulla voit määrittää, mikä OldString -ilmentymä korvataan, jos String sisältää useita ilmentymiä. Jos tätä argumenttia ei määritetä, kaikki esiintymät korvataan.

Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )

• SingleColumnTable – Pakollinen. Käsiteltävä yksisarakkeinen merkkijonotaulukko.
• StartingPosition – Pakollinen. Merkin sijainti, josta korvaus aloitetaan. Taulukon jokaisen merkkijonon ensimmäinen merkki on vastaa sijaintia 1.
• NumberOfCharacters – Pakollinen. Korvattavien merkkien määrä kussakin merkkijonossa.
• NewString – Pakollinen. Korvaava merkkijono. Tämän argumentin merkkien määrä voi olla eri kuin NumberOfCharacters-argumentin.

Substitute( SingleColumnTable, OldString, NewString [, InstanceNumber ] )

• SingleColumnTable – Pakollinen. Käsiteltävä yksisarakkeinen merkkijonotaulukko.
• OldString – Pakollinen. Korvattava merkkijono.
• NewString – Pakollinen. Korvaava merkkijono. OldString ja NewString voivat olla eri pituisia.
• InstanceNumber – Valinnainen. Tämän argumentin avulla voit määrittää, mikä OldString -ilmentymä korvataan, jos String sisältää useita ilmentymiä. Jos tätä argumenttia ei määritetä, kaikki esiintymät korvataan.

Esimerkit

Kaava	Kuvaus	Tulos
Replace( "abcdefghijk", 6, 5, "*" )	Korvaa viisi merkkiä tekstissä "abcdefghijk" yhdellä "*"-merkillä, joka alkaa kuudennesta merkistä ("f").	"abcde*k"
Replace( "2019", 3, 2, "20" )	Korvaa kaksi viimeistä merkkiä tekstissä "2019" tekstillä "20".	"2020"
Replace( "123456", 1, 3, "_" )	Korvaa kolme ensimmäistä merkkiä tekstissä "123456" yhdellä "_"-merkillä.	"_456"
Substitute( "Sales Data", "Sales", "Cost" )	Korvaa merkkijonon "Cost" tekstillä "Sales".	"Cost Data"
Substitute( "Quarter 1, 2018", "1", "2", 1 )	Korvaa vain ensimmäisen "1"-ilmentymän merkillä "2", koska neljännessä argumentissa (InstanceNumber) on arvo 1.	"Quarter 2, 2018"
Substitute( "Quarter 1, 2011", "1", "2", 3 )	Korvaa vain kolmannen "1"-ilmentymän merkillä "2", koska neljännessä argumentissa (InstanceNumber) on arvo 3.	"Quarter 1, 2012"
Substitute( "Quarter 1, 2011", "1", "2" )	Korvaa kaikki "1"-ilmentymät merkillä "2", koska neljättä argumenttia (InstanceNumber) ei määritetä.	"Quarter 2, 2022"
Replace( [ "Quarter 1, 2018", "Quarter 2, 2011", "Quarter 4, 2019" ], 9, 1, "3" )	Korvaa yhden sarakkeen taulukon jokaisen tietueen yhdeksännen merkin tekstillä "3".	Yhden sarakkeen taulukko, jossa on Value seuraavat arvot sisältävä sarake: [ "Vuosineljännes 3, 2018", "Quarter 3, 2011", "Quarter 3, 2019" ]
Substitute( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3", 1 )	Koska neljännessä argumentissa (InstanceNumber) on arvo 1, korvataan vain yhden sarakkeen taulukon jokaisen tietueen ensimmäisen "1"-ilmentymän merkillä "3".	Yhden sarakkeen taulukko, jossa on Value-sarake, jossa on seuraavat arvot: [ "Vuosineljännes 3, 2018", "Quarter 3, 2011", "Q3,2019"]
Substitute( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3" )	Koska neljättä argumenttia (InstanceNumber) ei määritetä, korvataan yhden sarakkeen taulukon jokaisen tietueen kaikki "1"-ilmentymät merkillä "3".	Yhden sarakkeen taulukko, jossa on Value-sarake, jossa on seuraavat arvot: [ "Vuosineljännes 3, 2038", "Quarter 3, 2033", "Q3,2039"]