De functies Replace en Substitute
Van toepassing op:
Canvas-apps Dataverse-formulekolommen Bureaubladstromen Modelgestuurde apps Power Platform CLI
Een deel van een teksttekenreeks vervangen door een andere tekenreeks.
Omschrijving
De functie Replace identificeert de tekst die moet worden vervangen aan de hand van een beginpositie en lengte.
De functie Substitute identificeert de tekst die moet worden vervangen door een overeenkomende tekenreeks te zoeken. Als er meer dan een overeenkomende tekenreeksen worden gevonden, kunt u ze allemaal vervangen of opgeven welke u wilt vervangen.
Als u één tekenreeks doorgeeft, is de retourwaarde de gewijzigde tekenreeks. Als u een tabel met één kolom doorgeeft die tekenreeksen bevat, is de retourwaarde een tabel met één kolom met een Value-kolom van gewijzigde tekenreeksen. Als u een tabel met meerdere kolommen hebt, kunt u deze omvormen tot een tabel met één kolom, zoals wordt beschreven in werken met tabellen.
Syntaxis
Replace( Tekenreeks, Beginpositie, AantalTekens, NieuweTekenreeks )
- String: vereist. De tekenreeks die moet worden bewerkt.
- StartingPosition: vereist. De tekenpositie waar de vervanging moet beginnen. Het eerste teken van Tekenreeks bevindt zich op positie 1.
- NumberOfCharacters: vereist. Het aantal tekens dat moet worden vervangen in Tekenreeks.
- NewString: vereist. De vervangende tekenreeks. Het aantal tekens in dit argument kan verschillen van het argument AantalTekens.
Substitute( Tekenreeks, OudeTekenreeks, NieuweTekenreeks [, Instantienummer ] )
- String: vereist. De tekenreeks die moet worden bewerkt.
- OldString: vereist. De tekenreeks die moet worden vervangen.
- NewString: vereist. De vervangende tekenreeks. OldString en NewString kunnen verschillende lengtes hebben.
- InstanceNumber: optioneel. Gebruik dit argument om op te geven welke instantie van OudeTekenreeks moet worden vervangen als Tekenreeks meer dan één instantie bevat. Als u dit argument niet opgeeft, worden alle instanties vervangen.
Replace( TabelMetEénKolom, Beginpositie, AantalTekens, NieuweTekenreeks )
- SingleColumnTable: vereist. Een tabel met één kolom die tekenreeksen bevat die moeten worden bewerkt.
- StartingPosition: vereist. De tekenpositie waar de vervanging moet beginnen. Het eerste teken van elke tekenreeks in de tabel bevindt zich op positie 1.
- NumberOfCharacters: vereist. Het aantal tekens dat moet worden vervangen in elke tekenreeks.
- NewString: vereist. De vervangende tekenreeks. Het aantal tekens in dit argument kan verschillen van het argument AantalTekens.
Substitute( TabelMetEénKolom, OudeTekenreeks, NieuweTekenreeks [, Instantienummer ] )
- SingleColumnTable: vereist. Een tabel met één kolom die tekenreeksen bevat die moeten worden bewerkt.
- OldString: vereist. De tekenreeks die moet worden vervangen.
- NewString: vereist. De vervangende tekenreeks. OldString en NewString kunnen verschillende lengtes hebben.
- InstanceNumber: optioneel. Gebruik dit argument om op te geven welke instantie van OudeTekenreeks moet worden vervangen als Tekenreeks meer dan één instantie bevat. Als u dit argument niet opgeeft, worden alle instanties vervangen.
Voorbeelden
| Formule | Beschrijving | Resultaat |
|---|---|---|
| Replace( "abcdefghijk", 6, 5, "*" ) | Vervangt vijf tekens in "abcdefghijk" door een enkel "*"-teken, te beginnen met het zesde teken ("f"). | "abcde*k" |
| Replace( "2019", 3, 2, "20" ) | Vervangt de laatste twee tekens van "2019" door "20". | "2020" |
| Replace( "123456", 1, 3, "_" ) | Vervangt de eerste drie tekens van "123456" door één "_"-teken. | "_456" |
| Substitute( "Sales Data", "Sales", "Cost" ) | Vervangt de tekenreeks "Cost" door "Sales". | "Cost Data" |
| Substitute( "Quarter 1, 2018", "1", "2", 1 ) | Vervangt alleen de eerste instantie van "1" door "2" omdat het vierde argument (Instantienummer) 1 bevat. | "Quarter 2, 2018" |
| Substitute( "Quarter 1, 2011", "1", "2", 3 ) | Vervangt alleen de derde instantie van "1" door "2" omdat het vierde argument (Instantienummer) 3 bevat. | "Quarter 1, 2012" |
| Substitute( "Quarter 1, 2011", "1", "2" ) | Vervangt alle instanties van "1" door "2" omdat er geen vierde argument (Instantienummer) is. | "Quarter 2, 2022" |
| Replace( [ "Quarter 1, 2018", "Quarter 2, 2011", "Quarter 4, 2019" ], 9, 1, "3" ) |
Vervangt het negende teken in elk record van de tabel met één kolom door "3". | Een tabel met één kolom met een Value-kolom met de volgende waarden: [ "Quarter 3, 2018","Quarter 3, 2011", "Quarter 3, 2019" ] |
| Substitute( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3", 1 ) |
Omdat er een vierde argument (Instantienummer) is met een waarde van 1, wordt alleen de eerste instantie van "1" in elke record van de tabel met één kolom vervangen door "3". | Een tabel met één kolom met een Value-kolom met de volgende waarden: [ "Qtr 3, 2018","Quarter 3, 2011", "Q3,2019"] |
| Substitute( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3" ) |
Omdat er geen vierde argument (Instantienummer) is, worden alle instanties van "1" in elke record van de tabel met één kolom vervangen door "3". | Een tabel met één kolom met een Value-kolom met de volgende waarden: [ "Qtr 3, 2038","Quarter 3, 2033", "Q3,2039"] |