Funkcijos IsMatch, Match ir MatchAll

Taikoma: Drobės programoms Modeliu pagrįstoms programoms Power Pages Power Platform CLI

Tikrindama ieško atitikmens arba pagal modelį išgauna teksto eilutės dalis.

Aprašas

Funkcija IsMatch tikrina, ar teksto eilutė atitinka modelį, kuris gali apimti įprastus simbolius, iš anksto apibrėžtus modelius arba reguliarųjį reiškinį. Funkcijos Match ir MatchAll pateikia elementus, kurių atitikmenų buvo ieškoma, įskaitant antrinius atitikmenis.

Naudokite IsMatch, jei norite patikrinti, ką vartotojas įvedėte teksto įvesties valdiklyje. Pavyzdžiui, galite įsitikinti, kad vartotojas įvedė galiojantį el. pašto adresą, prieš rezultatus įrašant į jūsų duomenų šaltinį. Jei įrašas neatitinka jūsų kriterijų, įtraukite kitų valdiklių, raginančių vartotoją pataisyti įrašą.

Naudokite Match, jei norite išgauti pirmąją teksto eilutę, atitinkančią modelį, o MatchAll – jei norite išgauti visas atitinkančias teksto eilutes. Be to, galite išgauti antrinius atitikmenis ir išanalizuoti sudėtines eilutes.

Atitiktis grąžina pirmojo rasto atitikmens informacijos įrašą, o "MatchAll" pateikia kiekvieno rasto atitikmens įrašų lentelę. Įraše arba įrašuose yra:

Šios funkcijos palaiko MatchOptions. Numatytasis veikimas

• Šios funkcijos atitikmenų ieško atsižvelgdamos į raidžių dydį. Naudokite MatchOptions.IgnoreCase, kad atliktumėte didžiųjų ir mažųjų raidžių atitikmenis.
• "IsMatch " atitinka visą teksto eilutę ("Complete MatchOption"), o "Match " ir "MatchAll" ieško atitikmens bet kurioje teksto eilutės vietoje (yra "MatchOption"). Complete, Contains, BeginsWith ar EndsWith naudokite pagal savo situaciją.

"IsMatch " grąžina teisingą , jei teksto eilutė atitinka šabloną, arba klaidingą , jei neatitinka. Atitiktis pateikiama tuščia, jei nerandama atitikmens, kurį galima patikrinti naudojant funkciją IsBlank . MatchAll grąžina tuščią lentelę, jei nerandama atitikmens, kurį galima patikrinti naudojant funkciją IsEmpty .

Jei, norėdami išskaidyti teksto eilutę, naudojate MatchAll, apsvarstykite galimybę naudoti funkciją Split, kurią paprasčiau naudoti ir kuri yra greitesnė.

Modeliai

Naudojant šias funkcijas svarbiausia aprašyi modelį, kurio atitikmenų ieškosite. Modelis aprašomas teksto eilutėje, derinant tolesnius elementus.

• Įprastus simbolius, pvz., abc ar 123.
• Iš anksto apibrėžtus modelius, pvz., Letter, MultipleDigits ar Email. (Šiuos modelius apibrėžia Match išvardijimas.)
• Reguliariųjų reiškinių kodus, pvz., \d+\s+\d+ ar [a-z]+.

Sujunkite šiuos elementus naudodami eilučių sujungimo operatorių &. Pavyzdžiui, "abc" &; Digit & "\s+" yra tinkamas raštas, atitinkantis simbolius "a", "b" ir "c", po kurių eina skaitmuo nuo 0 iki 9, po kurio eina bent vienas tarpo simbolis.

Įprasti simboliai

Paprasčiausias modelis yra įprastų simbolių seka, kurios tikslių atitikmenų ieškoma.

Pavyzdžiui, kai kartu naudojama funkcija IsMatch, eilutė „Sveiki“ tiksliai atitinka modelį Sveiki. Ne daugiau ir ne mažiau. Eilutė „sveiki!“ modelio neatitinka dėl šauktuko pabaigoje ir netinkamo raidės „s“ dydžio. (Norėdami sužinoti apie būdus, kaip šį veikimą modifikuoti, žr. MatchOptions.)

Modelių kalboje tam tikri simboliai paliekami specialiems tikslams. Norėdami naudoti šiuos simbolius, prieš simbolį įtraukite \ (kairinį brūkšnį), kad nurodytumėte, jog reikia atsižvelgti į patį simbolį, arba naudokite vieną iš vėliau šioje temoje aprašytų iš anksto apibrėžtų modelių. Tolesnėje lentelėje išvardyti specialieji simboliai.

Pavyzdžiui, galite ieškoti „Sveiki?“ atitikmenų, naudodami modelį „Sveiki\?“ su kairiniu brūkšniu prieš klaustuką.

Iš anksto apibrėžti modeliai

Naudojant iš anksto apibrėžtus modelius, paprasta ieškoti vieno iš simbolių rinkinio arba kelių simbolių sekos atitikmenų. Naudokite eilučių sujungimo operatorių ir derinkite savo teksto eilutes su atitikties nariais išvardijimas:

Pavyzdžiui, raštas "A" ir "MultipleDigits " atitiks raidę "A", po kurios eina vienas ar daugiau skaitmenų.

Reguliarieji reiškiniai

Šių funkcijų naudojamas modelis yra reguliarusis reiškinys. Kurti reguliariuosius reiškinius padeda anksčiau šioje temoje aprašyti įprasti simboliai ir iš anksto apibrėžti modeliai.

Reguliarieji reiškiniai yra labai veiksmingi, prieinami daugelyje programavimo kalbų ir naudojami įvairiausiems tikslams. Taip pat jie dažnai gali atrodyti kaip atsitiktinė skyrybos ženklų seka. Šiame straipsnyje neaprašyti visi reguliariųjų reiškinių aspektai, tačiau žiniatinklyje yra gausu informacijos, mokomosios medžiagos ir įrankių.

Reguliarieji reiškiniai būna skirtingų dialektų, o „Power Apps“ naudoja „JavaScript“ dialekto variantą. Norėdami peržiūrėti įvadą į sintaksę, žr. Reguliariųjų reiškinių sintaksė. Palaikomi pavadinti antriniai atitikmenys (kartais vadinami įrašymo grupėmis):

• Pavadinti antriniai atitikmenys: (?<name> ...)
• Pavadintos atgalinės nurodos: \k<name>

Pirmiau šioje temoje pateiktoje Match išvardijimų lentelėje kiekvienas išvardijimas rodomas toje pačioje eilutėje, kaip ir atitinkamas reguliarusis reiškinys.

Atitikmenų ieškos parinktys

Galite modifikuoti šių funkcijų veikimą nurodydami vieną ar daugiau parinkčių, kurias galite derinti naudodami eilutės sujungimo operatorių (&).

MatchAll rezultatas atitinka standartinio reguliariųjų reiškinių modifikatoriaus „g“ naudojimą.

Sintaksė

IsMatch( tekstas,raštas [, parinktys ] )

• Tekstas – būtinas. Teksto eilutė, kurią reikia tikrinti.
• Raštas – būtinas. Modelis, kurį reikia tikrinti kaip teksto eilutę. Sujunkite iš anksto apibrėžtus modelius, kuriuos apibrėžia Match išvardijimas, arba pateikite reguliarųjį reiškinį. Raštas turi būti pastovi formulė be jokių kintamųjų, duomenų šaltinių ar kitų dinaminių nuorodų, kurios keičiasi vykdant programą.
• Parinktys – neprivaloma. MatchOptions išvardijimo reikšmių teksto eilutės junginys. Numatyta, kad naudojama MatchOptions.Complete.

Match(tekstas,raštas [, parinktys ] )

• Tekstas – būtinas. Teksto eilutė, kurios atitikmenų reikia ieškoti.
• Raštas – būtinas. Modelis, kurio atitikmenys turi būti ieškomi kaip teksto eilutė. Sujunkite iš anksto apibrėžtus modelius, kuriuos apibrėžia Match išvardijimas, arba pateikite reguliarųjį reiškinį. Raštas turi būti pastovi formulė be jokių kintamųjų, duomenų šaltinių ar kitų dinaminių nuorodų, kurios keičiasi vykdant programą.
• Parinktys – neprivaloma. MatchOptions išvardijimo reikšmių teksto eilutės junginys. Numatyta, kad naudojama MatchOptions.Contains.

MatchAll(tekstas,raštas [, parinktys ] )

• Tekstas – būtinas. Teksto eilutė, kurios atitikmenų reikia ieškoti.
• Raštas – būtinas. Modelis, kurio atitikmenys turi būti ieškomi kaip teksto eilutė. Sujunkite iš anksto apibrėžtus modelius, kuriuos apibrėžia Match išvardijimas, arba pateikite reguliarųjį reiškinį. Raštas turi būti pastovi formulė be jokių kintamųjų, duomenų šaltinių ar kitų dinaminių nuorodų, kurios keičiasi vykdant programą.
• Parinktys – neprivaloma. MatchOptions išvardijimo reikšmių teksto eilutės junginys. Numatyta, kad naudojama MatchOptions.Contains.

IsMatch pavyzdžiai

Įprasti simboliai

Įsivaizduokite, kad jūsų programoje yra teksto įvesties valdiklis pavadinimu TextInput1. Vartotojas į šį valdiklį įveda reikšmes, kad jos būtų saugomos duomenų bazėje.

Į TextInput1 vartotojas įveda Labas, pasauli.

Iš anksto apibrėžti modeliai

Reguliarieji reiškiniai

Match ir MatchAll pavyzdžiai

Panagrinėkime pastarąjį pavyzdį. Jei šią eilutę norėtumėte konvertuoti į datos / laiko reikšmę naudodami funkciją Time, pavadintus antrinius atitikmenis turite perduoti atskirai. Norėdami tai atlikti, galite naudoti funkciją With, dirbdami su įrašu, kurį pateikia Match:

With(
    Match( "PT2H1M39S", "PT(?:(?<hours>\d+)H)?(?:(?<minutes>\d+)M)?(?:(?<seconds>\d+)S)?" ),
   Time( Value( hours ), Value( minutes ), Value( seconds ) )
)

Šiems pavyzdžiams įtraukite mygtuko valdiklį, jo ypatybę OnSelect nustatykite kaip šią formulę, tada pasirinkite mygtuką:

Set( pangram, "The quick brown fox jumps over the lazy dog." )

Formulė	Aprašas	Rezultatas
Match( pangram, "THE", IgnoreCase )	Teksto eilutėje, esančioje kintamajame pangram, randami visi „THE“ atitikmenys. Eilutėje yra du atitikmenys, tačiau pateikiamas tik pirmasis, nes naudojate Match, o ne MatchAll. Stulpelis SubMatches yra tuščias, nes nebuvo apibrėžta jokių antrinių atitikmenų.	{ FullMatch: "The", SubMatches: [ ], StartMatch: 32 }
MatchAll( pangram, "the" )	Teksto eilutėje, esančioje kintamajame pangram, randami visi „the“ atitikmenys. Testas skiria didžiąsias ir mažąsias raides, todėl randamas tik antrasis „the“ egzempliorius. Stulpelis SubMatches yra tuščias, nes nebuvo apibrėžta jokių antrinių atitikmenų.
MatchAll( pangram, "the", IgnoreCase )	Teksto eilutėje, esančioje kintamajame pangram, randami visi „the“ atitikmenys. Šiuo atveju testas didžiųjų ir mažųjų raidžių neskiria, todėl randami abu žodžio egzemplioriai. Stulpelis SubMatches yra tuščias, nes nebuvo apibrėžta jokių antrinių atitikmenų.
MatchAll( pangram, "\b\wo\w\b" )	Randa visus trijų raidžių žodžius, kurių viduryje yra raidė „o“. Atkreipkite dėmesį, kad „brown“ nėra įtrauktas, nes tai nėra trijų raidžių žodis, todėl neatitinka „\b“ (žodžio ribų).
Match( pangram, "\b\wo\w\b\s\*(?<between>\w.+\w)\s\*\b\wo\w\b" )	Ieško visų simbolių tarp „fox“ ir „dog“ atitikmenų.	{ between: "jumps over the lazy", FullMatch: "fox jumps over the lazy dog", SubMatches: [ "jumps over the lazy" ], StartMatch: 17 }

Norėdami MatchAll rezultatus peržiūrėti galerijoje, atlikite tolesnius veiksmus.

1. Tuščiame ekrane įterpkite tuščią vertikalųjį valdiklį Gallery.

2. Galerijos ypatybę Items nustatykite kaip MatchAll( pangram, "\w+" ) arba MatchAll( pangram, MultipleLetters ).

   

3. Galerijos valdiklio viduryje pasirinkite Įtraukti elementą iš skirtuko Įterpimas, kad pasirinktumėte galerijos šabloną.

4. Į galerijos šabloną įtraukite žymos valdiklį.

5. Žymos ypatybę Text nustatykite kaip ThisItem.FullMatch.

   Į galeriją įtraukiamas kiekvienas mūsų pavyzdinio teksto žodis. Norėdami visus žodžius matyti viename ekrane, pakeiskite galerijos šablono ir žymos valdiklio dydį.