ฟังก์ชัน IsMatch, Match และ MatchAll
ใช้กับ:
แอป Canvas แอปที่ใช้โมเดล Power Pages Power Platform CLI
ทดสอบการจับคู่หรือแยกส่วนของสตริงข้อความตามรูปแบบ
คำอธิบาย
ฟังก์ชัน IsMatch จะทดสอบว่าสตริงข้อความตรงกับรูปแบบที่อาจประกอบด้วยอักขระทั่วไป รูปแบบที่กำหนดไว้ล่วงหน้า หรือ นิพจน์ปกติ ฟังก์ชัน Match และ MatchAll ส่งคืนสิ่งที่ถูกจับคู่ รวมถึงการจับคู่ย่อย
ใช้ IsMatch เพื่อตรวจสอบความถูกต้องของสิ่งที่ผู้ใช้พิมพ์ในตัวควบคุม การป้อนข้อความ ตัวอย่างเช่น คุณสามารถยืนยันว่าผู้ใช้ได้ใส่ที่อยู่อีเมลที่ถูกต้องก่อนที่จะบันทึกผลลัพธ์ลงในแหล่งข้อมูลของคุณหรือไม่ ถ้ารายการไม่ตรงกับเกณฑ์ของคุณ ให้เพิ่มตัวควบคุมอื่นที่พร้อมท์ให้ผู้ใช้แก้ไขรายการ
ใช้ Match เพื่อแยกสตริงข้อความแรกที่ตรงกับรูปแบบ และ MatchAll เพื่อแยกสตริงข้อความทั้งหมดที่ตรงกัน คุณยังสามารถแยกการจับคู่ย่อยเพื่อแยกสตริงที่ซับซ้อน
Match ส่งคืนระเบียนข้อมูลสำหรับการจับคู่ครั้งแรกที่พบ และ MatchAll ส่งคืนตารางระเบียนสำหรับการจับคู่แต่ละครั้งที่พบ เรกคอร์ด หรือหลายเรกคอร์ด ประกอบด้วย:
| Column | ชนิด | Description |
|---|---|---|
| แมตช์ย่อยที่มีชื่อหรือแมตช์ย่อย | ข้อความ | การจับคู่ย่อยที่มีชื่อแต่ละรายการ จะมีคอลัมน์ของตัวเอง สร้างการจับคู่ย่อยที่มีชื่อ โดยใช้ (?<name>...) ในนิพจน์ปกติ หากการจับคู่ย่อยที่มีชื่อมีชื่อเดียวกับหนึ่งในคอลัมน์ที่กำหนดไว้ล่วงหน้า (ด้านล่าง) การจับคู่ย่อยจะมีความสำคัญกว่า และจะมีการสร้างคำเตือน เพื่อหลีกเลี่ยงคำเตือนนี้ให้เปลี่ยนชื่อการจับคู่ย่อย |
| ฟูลแมทช์ | Text | สตริงข้อความทั้งหมดที่ตรงกัน |
| เริ่มแมตช์ | ตัวเลข | ตำแหน่งเริ่มต้นของการจับคู่ภายในสตริงข้อความป้อนเข้า อักขระแรกของสตริง ส่งกลับ 1 |
| แมตช์ย่อย | ตารางคอลัมน์เดี่ยวของข้อความ (คอลัมน์ ค่า) | ตารางของการจับคู่ย่อยที่มีชื่อและไม่มีชื่อในลำดับที่ปรากฏในนิพจน์ทั่วไป โดยทั่วไปการจับคู่ย่อยที่มีชื่อนั้น ง่ายต่อการทำงานและได้รับการสนับสนุน ใช้ฟังก์ชัน ForAll หรือฟังก์ชัน Last( FirstN( ... ) ) เพื่อทำงานกับการจับคู่ย่อยแต่ละรายการ หากไม่มีการจับคู่ย่อยในนิพจน์ทั่วไป ตารางนี้จะแสดง แต่ว่างเปล่า |
ฟังก์ชันเหล่านี้รองรับ MatchOptions ตามค่าเริ่มต้น:
- ฟังก์ชันเหล่านี้ทำการจับคู่แบบตรงตามตัวพิมพ์ใหญ่ - เล็ก ใช้ MatchOptions.IgnoreCase เพื่อทำการจับคู่แบบตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
- IsMatch จับคู่สตริงข้อความทั้งหมด (Complete MatchOption) ขณะที่ Match และ MatchAll ค้นหาการจับคู่ที่ใดก็ได้ในสตริงข้อความ (Contains MatchOption) ใช้ CompleteContainsBeginsWith หรือ EndsWith ตามความเหมาะสมกับสถานการณ์ของคุณ
IsMatch จะส่งคืนค่า true ถ้าสตริงข้อความตรงกับรูปแบบหรือ false ถ้าไม่ตรงกัน Match จะส่งกลับ blank หากไม่พบการจับคู่ ซึ่งสามารถทดสอบได้ด้วยฟังก์ชัน IsBlank MatchAll ส่งคืนตารางว่างหากไม่พบการจับคู่ ซึ่งสามารถทดสอบได้ด้วยฟังก์ชัน IsEmpty
หากคุณกำลังใช้ MatchAll เพื่อแยกสตริงข้อความ พิจารณาใช้ฟังก์ชัน Split ซึ่งง่ายกว่าและเร็วกว่าในการใช้
รูปแบบ
จุดสำคัญในการใช้ฟังก์ชันเหล่านี้คือการอธิบายรูปแบบการจับคู่ คุณอธิบายรูปแบบในสตริงข้อความเป็นชุดของ:
- อักขระธรรมดา เช่น "abc" หรือ "123"
- รูปแบบที่กำหนดไว้ล่วงหน้า เช่น LetterMultipleDigits หรือ Email (enum Match จะกำหนดรูปแบบเหล่านี้)
- รหัสนิพจน์ปกติ เช่น "\d+\s+\d+" หรือ "[a-z]+"
รวมองค์ประกอบเหล่านี้โดยใช้ ตัวดำเนินการรวมสตริง & ตัวอย่างเช่น "abc" & Digit & "\s+" เป็นรูปแบบที่ถูกต้องที่จับคู่อักขระ "a" "b" และ "c" ตามด้วยตัวเลขจาก 0 ถึง 9 ที่ตามด้วยอักขระช่องว่างอย่างน้อยหนึ่งตัว
อักขระธรรมดา
รูปแบบที่ง่ายที่สุดคือลำดับอักขระธรรมดาที่จับคู่ให้ตรงกันทั้งหมด
ตัวอย่างเช่น เมื่อใช้กับฟังก์ชัน IsMatch สตริง "Hello" ตรงกับรูปแบบ "Hello" อย่างแน่นอน ไม่มากกว่านี้และไม่น้อยกว่านี้ สตริง "hello!" ไม่ตรงกับรูปแบบเนื่องจากเครื่องหมายอัศเจรีย์ที่ส่วนท้าย และตัวพิมพ์ไม่ถูกต้องสำหรับตัวอักษร "h" (ดู MatchOptions สำหรับวิธีการปรับเปลี่ยนลักษณะการทำงานนี้)
ในภาษาของรูปแบบ อักขระบางตัวจะถูกเก็บไว้เพื่อวัตถุประสงค์เฉพาะ เมื่อต้องการใช้งานอักขระเหล่านี้ ไม่ว่าจะนำหน้าอักขระด้วย \ (เครื่องหมายทับขวา) ที่จะระบุว่าควรใช้อักขระตามตัวอักษร หรือใช้รูปแบบที่กำหนดไว้ล่วงหน้ารูปแบบใดรูปแบบหนึ่ง ซึ่งอธิบายไว้ในส่วนท้ายของหัวข้อนี้ ตารางนี้จะแสดงรายการอักขระพิเศษ:
| อักขระพิเศษ | คำอธิบาย |
|---|---|
| - | จุดหรือมหัพภาค |
| - | เครื่องหมายปรัศนีย์ |
| * | เครื่องหมายดอกจัน |
| + | บวก |
| - | เครื่องหมายวงเล็บ |
| - | เครื่องหมายวงเล็บเหลี่ยม |
| { } | วงเล็บปีกกา |
| ^ | เครื่องหมายตก |
| $ | สัญลักษณ์ดอลลาร์ |
| | | แถบแนวตั้งหรือไปป์ |
| \ | เครื่องหมายทับขวา |
ตัวอย่างเช่น คุณสามารถจับคู่ "Hello?" โดยใช้รูปแบบ "Hello\?" ด้วยเครื่องหมายทับขวาหน้าเครื่องหมายคำถาม
รูปแบบที่กำหนดไว้ล่วงหน้า
รูปแบบที่กำหนดไว้ล่วงหน้าจะให้วิธีการจับคู่ ไม่ว่าชุดอักขระหนึ่งชุดหรือลำดับของอักขระหลายๆ ตัว อย่างง่าย ใช้ ตัวดำเนินการรวมสตริง & เพื่อรวมสตริงข้อความของคุณเองกับสมาชิกของ Match enum:
| enum Match | คำอธิบาย | นิพจน์ปกติ |
|---|---|---|
| ใดๆ | จับคู่อักขระใดๆ | . |
| เครื่องหมายจุลภาค | จับคู่จุลภาค | , |
| ตัวเลข | จับคู่ตัวเลขเดี่ยว ("0" ถึง "9") | \d |
| ส่งอีเมล | จับคู่ที่อยู่อีเมลที่มีเครื่องหมาย "at" ("@") และชื่อโดเมนที่มีเครื่องหมายมหัพภาค (".") | .+\@.+\\.[^\\.]{2,} |
| ยัติภังค์ | จับคู่ยัติภังค์ | \- |
| ซ้ายพาเรน | จับคู่วงเล็บซ้าย "(" | \( |
| จดหมาย | จับคู่ตัวอักษร | \p{L} |
| หลายหลัก | จับคู่ตัวเลขอย่างน้อยหนึ่งตัว | \d+ |
| หลายตัวอักษร | จับคู่ตัวอักษรอย่างน้อยหนึ่งตัว | \p{L}+ |
| หลาย ๆ NonSpaces | จับคู่ตัวอักษรอย่างน้อยหนึ่งตัวที่ไม่เพิ่มช่องว่าง (ไม่มีช่องว่าง แท็บ หรือบรรทัดใหม่) | \S+ |
| หลายพื้นที่ | จับคู่อักขระอย่างน้อยหนึ่งตัวที่เพิ่มช่องว่าง (ช่องว่าง แท็บ หรือบรรทัดใหม่) | \s+ |
| ไร้พื้นที่ | จับคู่อักขระเดี่ยวที่ไม่เพิ่มช่องว่าง | \S |
| ตัวเลขเสริม | จับคู่แบบไม่มีตัวเลข ตัวเลขตัวเดียว หรือมากกว่านั้น | \d* |
| จดหมายตัวเลือก | จับคู่แบบไม่มีตัวอักษร ตัวอักษรตัวเดียว หรือมากกว่านั้น | \p{L}* |
| ตัวเลือกไม่มีช่องว่าง | จับคู่แบบไม่มีอักขระ อักขระหนึ่งตัว หรือมากกว่านั้นที่ไม่ได้เพิ่มช่องว่าง | \S* |
| พื้นที่เสริม | จับคู่แบบไม่มีอักขระ อักขระหนึ่งตัว หรือมากกว่านั้น ที่เพิ่มช่องว่าง | \s* |
| ระยะเวลา | จับคู่มหัพภาคหรือจุด (".") | \. |
| ไรท์พาเรน | จับคู่วงเล็บขวา ")" | \) |
| ช่องว่าง | จับคู่อักขระที่เพิ่มช่องว่าง | \s |
| แท็บ | จับคู่อักขระแท็บ | \t |
ตัวอย่างเช่น รูปแบบ "A" & MultipleDigits จะจับคู่ตัวอักษร "A" ตามด้วยตัวเลขอย่างน้อยหนึ่งตัว
นิพจน์ปกติ
รูปแบบที่ฟังก์ชันเหล่านี้ใช้คือ นิพจน์ปกติ อักขระธรรมดาและรุปแบบที่กำหนดไว้ล่วงหน้าที่อธิบายไว้ก่อนหน้าในหัวข้อนี้ จะช่วยสร้างนิพจน์ปกติ
นิพจน์ปกติมีประสิทธิภาพมาก มีในภาษาสำหรับการเขียนโปรแกรมหลายภาษา และใช้เพื่อจุดประสงค์ที่หลากหลาย พวกเขายังสามารถดูเหมือนเครื่องหมายลำดับวรรคตอนแบบสุ่ม บทความนี้ไม่ได้อธิบายทุกแง่มุมของนิพจน์ปกติ แต่มีข้อมูล บทช่วยสอน และเครื่องมือต่างๆ อยู่บนเว็บที่
นิพจน์ปกติมาในภาษาเฉพาะที่แตกต่างกัน และ Power Apps ใช้ตัวแปรของภาษาเฉพาะของ JavaScript ดู ไวยากรณ์นิพจน์ปกติ สำหรับการแนะนำให้รู้จักกับไวยากรณ์ รองรับการจับคู่ย่อยที่มีชื่อ (บางครั้งเรียกว่ากลุ่มการจับภาพที่มีชื่อ):
- การจับคู่ย่อยที่มีชื่อ: (?<name> ...)
- Named backreferences: \k<name>
ในตาราง enum Match ก่อนหน้าในหัวข้อนี้ แต่ละ enum จะปรากฏในแถวเดียวกับนิพจน์ทั่วไปที่สอดคล้องกัน
ตัวเลือกจับคู่
คุณสามารถปรับเปลี่ยนลักษณะการทำงานของฟังก์ชันเหล่านี้ โดยระบุตัวเลือกอย่างน้อยหนึ่งรายการ ซึ่งคุณสามารถรวมโดยใช้ตัวดำเนินการรวมสตริง (&)
| Enum MatchOptions | Description | ผลกระทบต่อนิพจน์ปกติ |
|---|---|---|
| MatchOptions เริ่มต้นด้วย | รูปแบบต้องตรงกันตั้งแต่จุดเริ่มต้นของข้อความ | เพิ่ม ^ ลงในจุดเริ่มต้นของนิพจน์ปกติ |
| ตัวเลือกการจับคู่เสร็จสมบูรณ์ | ค่าเริ่มต้นสำหรับ IsMatch รูปแบบต้องตรงกันทั้งสตริงข้อความ ตั้งแต่ต้นจนจบ | เพิ่ม ^ ลงในจุดเริ่มต้น และ $ ลงในส่วนทัายของนิพจน์ปกติ |
| MatchOptions.ประกอบด้วย | ค่าเริ่มต้นสำหรับ Match และ MatchAll รูปแบบต้องปรากฏบางแห่งในข้อความแต่ไม่จำเป็นต้องขึ้นต้นและลงท้าย | ไม่ต้องปรับเปลี่ยนนิพจน์ปกติ |
| ตัวเลือกการจับคู่สิ้นสุดด้วย | รูปแบบต้องตรงกับลงท้ายของสตริงของข้อความ | เพิ่ม $ ลงในส่วนท้ายของนิพจน์ปกติ |
| ตัวเลือกการจับคู่ ไม่สนใจกรณี | ถือว่าตัวอักษรตัวพิมพ์ใหญ่และตัวพิมพ์เล็กเหมือนกัน ตามค่าเริ่มต้น การจับคู่จะเป็นตามตัวอักษรตัวพิมพ์เล็ก-ใหญ่ | ไม่ต้องปรับเปลี่ยนนิพจน์ปกติ ตัวเลือกนี้เทียบเท่ากับตัวดัดแปลง "i" มาตรฐานสำหรับนิพจน์ทั่วไป |
| MatchOptions.ตัวเลือกหลายบรรทัด | จับคู่ข้ามเส้นต่างๆ | ไม่ต้องปรับเปลี่ยนนิพจน์ปกติ ตัวเลือกนี้เทียบเท่ากับตัวดัดแปลง "m" มาตรฐานสำหรับนิพจน์ทั่วไป |
การใช้ MatchAll เทียบเท่ากับการใช้ตัวดัดแปลง "g" มาตรฐานสำหรับนิพจน์ทั่วไป
ไวยากรณ์
IsMatch( ข้อความ, รูปแบบ [, ตัวเลือก ] )
- ข้อความ – จำเป็น สตริงข้อความที่จะทดสอบ
- รูปแบบ – จำเป็น รูปแบบที่จะทดสอบ เป็นสตริงข้อความ รวมรูปแบบที่กำหนดไว้ล่วงหน้าที่ Enum Match กำหนด หรือระบุนิพจน์ปกติ รูปแบบ จะต้องเป็นสูตรคงที่โดยไม่มีตัวแปร แหล่งข้อมูล หรือการอ้างอิงแบบไดนามิกอื่นๆ ที่จะเปลี่ยนแปลงเมื่อแอปทำงาน
- ตัวเลือก – ไม่บังคับ การรวมสตริงข้อความของค่า enum MatchOptions ตามค่าเริ่มต้น จะใช้ MatchOptions.Complete
จับคู่( ข้อความ, รูปแบบ [, ตัวเลือก ] )
- ข้อความ – จำเป็น สตริงข้อความที่จะจับคู่
- รูปแบบ – จำเป็น รูปแบบที่จะจับคู่ เป็นสตริงข้อความ รวมรูปแบบที่กำหนดไว้ล่วงหน้าที่ Enum Match กำหนด หรือระบุนิพจน์ปกติ รูปแบบ จะต้องเป็นสูตรคงที่โดยไม่มีตัวแปร แหล่งข้อมูล หรือการอ้างอิงแบบไดนามิกอื่นๆ ที่จะเปลี่ยนแปลงเมื่อแอปทำงาน
- ตัวเลือก – ไม่บังคับ การรวมสตริงข้อความของค่า enum MatchOptions ตามค่าเริ่มต้น จะใช้ MatchOptions.Contains
จับคู่ทั้งหมด( ข้อความ, รูปแบบ [, ตัวเลือก ] )
- ข้อความ – จำเป็น สตริงข้อความที่จะจับคู่
- รูปแบบ – จำเป็น รูปแบบที่จะจับคู่ เป็นสตริงข้อความ รวมรูปแบบที่กำหนดไว้ล่วงหน้าที่ Enum Match กำหนด หรือระบุนิพจน์ปกติ รูปแบบ จะต้องเป็นสูตรคงที่โดยไม่มีตัวแปร แหล่งข้อมูล หรือการอ้างอิงแบบไดนามิกอื่นๆ ที่จะเปลี่ยนแปลงเมื่อแอปทำงาน
- ตัวเลือก – ไม่บังคับ การรวมสตริงข้อความของค่า enum MatchOptions ตามค่าเริ่มต้น จะใช้ MatchOptions.Contains
ตัวอย่าง IsMatch
อักขระธรรมดา
สมมติว่า แอปของคุณมีตัวควบคุม การป้อนข้อความ ชื่อว่า TextInput1 ผู้ใช้ใส่ค่าลงในตัวควบคุมนี้เพื่อให้จัดเก็บในฐานข้อมูล
ผู้ใช้พิมพ์ Hello world ลงใน TextInput1
| สูตร | คำอธิบาย | ผลลัพธ์ |
|---|---|---|
IsMatch( TextInput1.Text, "Hello world" ) |
ทดสอบว่าการป้อนค่าของผู้ใช้ตรงกับสตริง "Hello world" ทั้งสตริงหรือไม่ | จริง |
IsMatch( TextInput1.Text, "Good bye" ) |
ทดสอบว่าการป้อนค่าของผู้ใช้ตรงกับสตริง "Good bye" ทั้งสตริงหรือไม่ | เท็จ |
IsMatch( TextInput1.Text, "hello", Contains ) |
ทดสอบว่าการป้อนค่าของผู้ใช้มีคำว่า "hello" (ตามตัวพิมพ์เล็ก-ใหญ่) หรือไม่ | เท็จ |
IsMatch( TextInput1.Text, "hello", Contains & IgnoreCase ) |
ทดสอบว่าการป้อนค่าของผู้ใช้มีคำว่า "hello" (ตามตัวพิมพ์เล็ก-ใหญ่) หรือไม่ | จริง |
รูปแบบที่กำหนดไว้ล่วงหน้า
| สูตร | คำอธิบาย | ผลลัพธ์ |
|---|---|---|
IsMatch( "123-45-7890", Digit & Digit & Digit & Hyphen & Digit & Digit & Hyphen & Digit & Digit & Digit & Digit ) |
จับคู่หมายเลขประกันสังคมของสหรัฐอเมริกา | จริง |
IsMatch( "joan@contoso.com", Email ) |
จับคู่ที่อยู่อีเมล | จริง |
IsMatch( "123.456", MultipleDigits & Period & OptionalDigits ) |
จับคู่ลำดับตัวเลข มหัพภาค และศูน ย์หรือตัวเลขที่มากกว่านั้น | จริง |
IsMatch( "123", MultipleDigits & Period & OptionalDigits ) |
จับคู่ลำดับตัวเลข มหัพภาค และศูน ย์หรือตัวเลขที่มากกว่านั้น มหัพภาคไม่ปรากฏในข้อความในการจับคู่ รูปแบบนี้จึงไม่ตรงกัน | เท็จ |
นิพจน์ปกติ
| สูตร | คำอธิบาย | ผลลัพธ์ |
|---|---|---|
IsMatch( "986", "\d+" ) |
จับคู่จำนวนเต็มที่มากกว่าศูนย์ | จริง |
IsMatch( "1.02", "\d+(\.\d\d)?" ) |
จับคู่จำนวนสกุลเงินที่เป็นค่าบวก ถ้าค่าป้อนเข้ามีจุดทศนิยม ค่าป้อนเข้าต้องมีอักขระตัวเลข 2 ตัวตามหลังจุดทศนิยมด้วย ตัวอย่างเช่น 3.00 ถูกต้อง แต่ 3.1 ไม่ถูกต้อง | จริง |
IsMatch( "-4.95", "(-)?\d+(\.\d\d)?" ) |
จับคู่จำนวนสกุลเงินที่เป็นค่าบวกและค่าลบ ถ้าค่าป้อนเข้ามีจุดทศนิยม ค่าป้อนเข้าต้องมีอักขระตัวเลข 2 ตัวตามหลังจุดทศนิยมด้วย | จริง |
IsMatch( "111-11-1111", "\d{3}-\d{2}-\d{4}" ) |
จับคู่หมายเลขประกันสังคมของสหรัฐอเมริกา ตรวจสอบความถูกต้องของรูปแบบ ชนิด และความยาว ของฟิลด์ข้อมูลป้อนเข้าที่ให้มา สตริงที่จะจับคู่ต้องมีอักขระตัวเลขสามตัว ตามด้วยเครื่องหมายขีดกลาง และอักขระตัวเลขสองตัว ตามด้วยเครื่องหมายขีดกลาง สุดท้ายคืออักขระตัวเลขสี่ตัว | จริง |
IsMatch( "111-111-111", "\d{3}-\d{2}-\d{4}" ) |
เหมือนกับตัวอย่างก่อนหน้านี้ แต่ยัติภังค์ไม่อยู่ในที่เดียวกันในค่าป้อนเข้า | เท็จ |
IsMatch( "AStrongPasswordNot", "(?!^[0-9]\*$)(?!^[a-zA-Z]\*$)([a-zA-Z0-9]{8,10})" ) |
ตรวจสอบความถูกต้องของรหัสผ่านที่เดายาก ซึ่งต้องมีอักขระแปดตัว เก้าตัว หรือ 10 ตัว นอกจากตัวเลขอย่างน้อยหนึ่งตัวและอักขระตัวอักษรอย่างน้อยหนึ่งตัว สตริงต้องไม่มีอักขระพิเศษ | เท็จ |
อย่าง Match and MatchAll
| สูตร | คำอธิบาย | ผลลัพธ์ |
|---|---|---|
Match( "Bob Jones <bob.jones@contoso.com>", "<(?<email>" & Match.Email & ")>" |
แยกเฉพาะส่วนอีเมลของข้อมูลผู้ติดต่อ | { อีเมล: "bob.jones@contoso.com", FullMatch: "<bob.jones@contoso.com>", SubMatches: [ "bob.jones@contoso.com" ], StartMatch: 11 } |
Match( "Bob Jones <InvalidEmailAddress>", "<(?<email>" & Match.Email & ")>" |
แยกเฉพาะส่วนอีเมลของข้อมูลผู้ติดต่อ ไม่พบที่อยู่ตามกฎหมาย (ไม่มีเครื่องหมาย @) ดังนั้นฟังก์ชันจะส่งคืน blank | ว่างเปล่า |
Match( Language(), "(<language>\w{2})(?:-(?<script>\w{4}))?(?:-(?<region>\w{2}))?" ) |
แยกส่วน ภาษา สคริปต์ และภูมิภาคของแท็กภาษา ที่ฟังก์ชัน Language ส่งกลับ ผลลัพธ์เหล่านี้แสดงถึงสหรัฐอเมริกา ดู เอกสารประกอบการใช้งานฟังก์ชัน Language สำหรับตัวอย่างเพิ่มเติม อักขระกลุ่มตัวดำเนินการ (?: โดยไม่สร้างการจับคู่ย่อยอื่น | { language: "en", script: blank, region: "US", FullMatch: "en-US", SubMatches: [ "en", "", "US" ], StartMatch: 1 } |
Match( "PT2H1M39S", "PT(?:<hours>\d+)H)?(?:(?<minutes>\d+)M)?(?:(?<seconds>\d+)S)?" ) |
แยกชั่วโมง นาที และวินาที จากค่าระยะเวลา ISO 8601 ตัวเลขที่แยกออกมานั้นยังคงอยู่ในสตริงข้อความ ใช้ฟังก์ชัน Value เพื่อแปลงเป็นตัวเลข ก่อนที่จะดำเนินการทางคณิตศาสตร์กับ | { hours: "2", minutes: "1", seconds: "39", FullMatch: "PT2H1M39S" SubMatches:["2","1","39"] StartMatch: 1 } |
ลองเจาะลึกลงไปในตัวอย่างสุดท้าย หากคุณต้องการแปลงสตริงนี้เป็นค่าวันที่/เวลา โดยใช้ฟังก์ชัน Time คุณจะต้องผ่านการจับคู่ย่อยที่มีชื่อเป็นรายบุคคล ในการทำเช่นนี้ คุณสามารถใช้ฟังก์ชัน With การทำงานบนเรกคอร์โที่ Match ส่งกลับ:
With(
Match( "PT2H1M39S", "PT(?:(?<hours>\d+)H)?(?:(?<minutes>\d+)M)?(?:(?<seconds>\d+)S)?" ),
Time( Value( hours ), Value( minutes ), Value( seconds ) )
)
สำหรับตัวอย่างเหล่านี้ ให้เพิ่มตัวควบคุม ปุ่ม ตั้งค่าคุณสมบัติ OnSelect เป็นสูตรนี้ จากนั้นเลือกปุ่ม:
Set( pangram, "The quick brown fox jumps over the lazy dog." )
| สูตร | คำอธิบาย | ผลลัพธ์ |
|---|---|---|
Match( pangram, "THE", IgnoreCase ) |
ค้นหาการจับคู่ทั้งหมดของ "THE" ในสตริงข้อความที่ตัวแปร pangram ประกอบด้วย สตริงมีการจับคู่สองรายการ แต่จะส่งคืนเฉพาะรายการแรก เนื่องจากคุณใช้ Match และ ไม่ MatchAll คอลัมน์ SubMatches ว่างเปล่าเนื่องจากไม่มีการกำหนดการจับคู่ย่อย | { FullMatch: "The" SubMatches: [ ], StartMatch: 32 } |
MatchAll( pangram, "the" ) |
ค้นหาการจับคู่ทั้งหมดของ "the" ในสตริงข้อความที่ตัวแปร pangram ประกอบด้วย การทดสอบจะคำนึงถึงขนาดตัวพิมพ์ ดังนั้นจะพบอินสแตนซ์ที่สองของ "the" เท่านั้น คอลัมน์ SubMatches ว่างเปล่าเนื่องจากไม่มีการกำหนดการจับคู่ย่อย |
|
MatchAll( pangram, "the", IgnoreCase ) |
ค้นหาการจับคู่ทั้งหมดของ "the" ในสตริงข้อความที่ตัวแปร pangram ประกอบด้วย ในกรณีนี้การทดสอบจะไม่คำนึงถึงขนาดตัวพิมพ์ ดังนั้นจึงพบทั้งสองอินสแตนซ์ คอลัมน์ SubMatches ว่างเปล่าเนื่องจากไม่มีการกำหนดการจับคู่ย่อย |
|
MatchAll( pangram, "\b\wo\w\b" ) |
ค้นหาคำสามตัวอักษรทั้งหมดที่มี "o" อยู่ตรงกลาง โปรดทราบว่า "brown" ไม่รวมอยู่ เนื่องจากไม่ใช่คำสามตัวอักษรดังนั้นจึงไม่สามารถจับคู่ "\b" (ขอบเขตคำ) |
|
Match( pangram, "\b\wo\w\b\s\*(?<between>\w.+\w)\s\*\b\wo\w\b" ) |
จับคู่อักขระทั้งหมดระหว่าง "fox" และ "dog" | { between: "jumps over the lazy", FullMatch: "fox jumps over the lazy dog", SubMatches: [ "jumps over the lazy" ] StartMatch: 17 } |
เพื่อดูผลลัพธ์ของ MatchAll ในแกลเลอรี่:
ในหน้าจอที่ว่างเปล่า แทรกแนวตั้งที่ว่างเปล่า ตัวควบคุม แกลเลอรี
ตั้งค่าคุณสมบัติ Items ของแกลเลอรี่ เป็น MatchAll( pangram, "\w+" ) หรือ MatchAll( pangram, MultipleLetters )
เลือก "เพิ่มรายการจากแท็บแทรก" ที่อยู่ตรงกลางของตัวควบคุมแกลเลอรี เพื่อเลือกเทมเพลตของแกลเลอรี
เพิ่มตัวควบคุม ป้ายชื่อ ลงในเทมเพลตของแกลเลอรี
ตั้งค่าคุณสมบัติ Text ของป้ายกำกับ เป็น ThisItem.FullMatch
แกลเลอรี่เต็มไปด้วยแต่ละคำในข้อความตัวอย่างของเรา ปรับขนาดเทมเพลตของแกลเลอรี่และตัวควบคุมป้ายกำกับเพื่อดูคำทั้งหมดในหน้าจอเดียว
