ก่อนหน้า ถัดไป

คลาส BirtStr

คลาส BirtStr จัดเตรียมฟังก์ชันเพื่อจัดการกับสตริง, ตัวอย่างเช่น, เพื่อเชื่อมสตริง, ตัดช่องว่างพิเศษ, ขอรับส่วนของสตริง, และแสดงสตริงในรูปของตัวพิมพ์เล็กหรือตัวพิมพ์ใหญ่ คลาสนี้เป็นแบบสแตติก แอ็พพลิเคชันไม่สามารถสร้างอินสแตนซ์ของคลาส

BirtStr.charLength

ฟังก์ชันนี้จะคืนค่าความยาวของสตริงที่ระบุ

ไวยากรณ์

integer BirtStr.charLength( string source )

พารามิเตอร์

source

String สตริงที่ต้องการประเมินค่า

คืนค่า

Integer จำนวนอักขระในสตริงที่ระบุไว้

ตัวอย่าง

ตัวอย่างต่อไปนี้จะคืนค่าความยาวของสตริงที่ระบุ:

BirtStr.charLength( "Julie Murphy" ) // ส่งคืน 12

ตัวอย่างต่อไปนี้ส่งคืนความยาวของแต่ละค่าในฟิลด์ CustomerName:

BirtStr.charLength( row["CustomerName"] )

BirtStr.concat

ฟังก์ชันนี้จะคืนค่าสตริงที่เป็นผลลัพธ์จากการเชื่อมสตริงที่ระบุ

ไวยากรณ์

string BirtStr.concat( string source1, ..., sourceN )

พารามิเตอร์

source1, ..., sourceN

String สตริงที่ต้องการเชื่อม

คืนค่า

String สตริงที่เป็นผลลัพธ์มาจากการเชื่อมชุดของสตริง

ตัวอย่าง

ตัวอย่างต่อไปนี้ส่งคืนแอดเดรสแบบเต็มด้วยการเชื่อมค่าจากฟิลด์จำนวนมาก:

BirtStr.concat( row["AddressLine1"], ", ", row["AddressLine2"], ", ", row["City"], " ", row["PostalCode"], "row["State"], ", ", row["Country"] )

BirtStr.indexOf

ฟังก์ชันนี้จะคืนค่าตำแหน่งของสตริงย่อยที่ระบุในสตริงที่ระบุ

ไวยากรณ์

integer BirtStr.indexOf( sring target, string source, integer start )

พารามิเตอร์

target

String สตริงย่อยที่ต้องการค้นหา การค้นหาจะคำนึงถึงขนาดตัวพิมพ์

source

String สตริงที่ต้องการค้นหาสตริงย่อยที่ระบุเฉพาะ

start

Integer ตัวเลือก ตำแหน่งในสตริงต้นทางที่การค้นหาเริ่มต้น ถ้าคุณละเว้นอาร์กิวเมนต์นี้, ฟังก์ชันจะเริ่มต้นค้นหาจากอักขระแรกของสตริง

คืนค่า

Integer ตำแหน่งที่เป็นตัวเลขของสตริงย่อยในสตริง อักขระแรกของสตริงเริ่มต้นที่ 0 ถ้าไม่พบสตริง, ฟังก์ชันจะส่งคืน -1

ตัวอย่าง

ตัวอย่างต่อไปนี้ส่งคืนตำแหน่งตัวเลขของอักขระที่ระบุไว้ในสตริงที่ระบุเฉพาะ:

BirtStr.indexOf( " ", "Julie Murphy" ) // returns 5
BirtStr.indexOf( "-", "ModelA-1234-567" ) // returns 6
BirtStr.indexOf( "-", "ModelA-1234-567", 7 ) // returns 11

ตัวอย่างต่อไปนี้ ใช้ BirtStr.indexOf( ) ร่วมกับ BirtStr.left( ) เพื่อแสดงอักขระที่นำหน้าอักขระช่องว่างในชื่อลูกค้า ฟังก์ชัน BirtStr.left( ) จะดึงสตริงย่อยตามความยาวที่ระบุ เริ่มต้นจากอักขระตัวแรก ในตัวอย่างนี้, ความยาวของสตริงย่อยที่ต้องการแสดงตำแหน่งตัวเลขของอักขระช่องว่าง

spaceCharPosition = BirtStr.indexOf( " ", row["customerName"] );
displayFirstName = BirtStr.left( row["customerName"], spaceCharPosition );

ถ้าชื่อลูกค้าคือ Julie Murphy นิพจน์จะคืนค่า Julie

BirtStr.left

ฟังก์ชันนี้แยกสตริงย่อยของความยาวที่ระบุออกจากสตริง, เริ่มต้นจากซ้ายสุด, หรืออักขระแรก

ไวยากรณ์

string BirtStr.left( string source, integer n )

พารามิเตอร์

source

String สตริงที่แยกสตริงย่อย

n

Integer จำนวนอักขระที่ต้องการแยก, เริ่มต้นจากอักขระแรก

คืนค่า

Sring สตริงย่อยของความยาวที่ระบุไว้

*
*
*

ตัวอย่าง

ตัวอย่างต่อไปนี้จะคืนค่าสตริงย่อยของความยาวต่างๆจากสตริงที่ระบุ:

BirtStr.left( "Julie Murphy", 5 ) // returns Julie
BirtStr.left( "Julie Murphy", 12 ) // returns Julie Murphy

ตัวอย่างต่อไปนี้ ใช้ BirtStr.indexOf( ) ร่วมกับ BirtStr.left( ) เพื่อแสดงอักขระที่นำหน้าอักขระช่องว่างในชื่อลูกค้า ฟังก์ชัน BirtStr.left( ) จะดึงสตริงย่อยตามความยาวที่ระบุ เริ่มต้นจากอักขระตัวแรก ในตัวอย่างนี้, ความยาวของสตริงย่อยที่ต้องการแสดงตำแหน่งตัวเลขของอักขระช่องว่าง

spaceCharPosition = BirtStr.indexOf( " ", row["customerName"] );
displayFirstName = BirtStr.left( row["customerName"], spaceCharPosition );

ถ้าชื่อลูกค้าคือ Julie Murphy นิพจน์จะคืนค่า Julie

BirtStr.right

ฟังก์ชันแยกสตริงย่อยของความยาวที่ระบุไว้จากสตริง, เริ่มต้นจากขวาสุด, หรืออักขระสุดท้าย

ไวยากรณ์

String BirtStr.right( String source, integer n )

พารามิเตอร์

source

String สตริงที่แยกสตริงย่อย

n

Integer จำนวนของอักขระที่ต้องการแยก, เริ่มต้นจากอักขระตัวสุดท้าย

คืนค่า

String สตริงย่อยของความยาวที่ระบุไว้

*
*
*

ตัวอย่าง

ตัวอย่างต่อไปนี้จะคืนค่าสตริงย่อยของความยาวต่างๆจากสตริงที่ระบุ:

BirtStr.right( "Julie Murphy", 6 ) // returns Murphy
BirtStr.right( "Julie Murphy", 12 ) // returns Julie Murphy

ตัวอย่างต่อไปนี้ใช้ฟังก์ชัน BirtStr.right( ) ร่วมกับ BirtStr.indexOf( ) และ BirtStr.charLength( ) เพื่อแสดงอักขระที่ปรากฏหลังจากอักขระช่องว่างในชื่อลูกค้า ตัวอย่างนี้สันนิษฐานว่าจำนวนอักขระหลังจากขีดกลางต่างกัน ดังนั้น, ความยาวของสตริงทั้งหมด (ที่ส่งคืนโดย BirtStr.charLength( )) ลบความยาวจนถึง hyphen (ส่งคืนโดย BirtStr.indexOf( )) คือจำนวนของอักขระที่ต้องการแสดง

spaceCharPosition = BirtStr.indexOf( " ", row["customerName"] );
displayLastName = BirtStr.right( row["customerName"], (BirtStr.charLength( row["customerName"] - (spaceCharPosition + 1)) )

ถ้าชื่อลูกค่า คือ Julie Murphy นิพจน์จะคืนค่า Murphy ถ้าชื่อลูกค้าคือ Kwai Li, นิพจน์จะส่งคืน Li

BirtStr.search

ฟังก์ชันนี้จะส่งคืนตำแหน่งของสตริงย่อยที่ระบุในสตริงที่กำหนด สตริงย่อยสามารถมีอักขระ wildcard

ไวยากรณ์

integer BirtStr.search( string pattern, string source, integer index )

พารามิเตอร์

pattern

String รูปแบบสตริงที่ต้องการค้น การค้นหาจะคำนึงถึงขนาดตัวพิมพ์ คุณสามารถใช้อักขระ wildcard ต่อไปนี้ในรูปแบบ:

*
*

เมื่อต้องการจับคู่ตัวอักษรเครื่องหมายดอกจันหรือเครื่องหมายคำถามในสตริง, ให้นำหน้าอักขระเหล่านั้นด้วยอักขระแบ็กสแลชสองตัว (\\) ตัวอย่างเช่น, เมื่อต้องการค้นหาสตริงย่อย R*10, ให้ใช้รูปแบบสตริงต่อไปนี้:

"R\\*10"

source

String สตริงที่ต้องการค้นหาสตริงย่อยที่ระบุเฉพาะ

index

Integer ตัวเลือก ตำแหน่งในสตริงต้นทางที่การค้นหาเริ่มต้น ถ้าคุณละเว้นอาร์กิวเมนต์นี้, ฟังก์ชันจะเริ่มต้นค้นหาจากอักขระแรกของสตริง

คืนค่า

Integer ตำแหน่งที่เป็นตัวเลขของสตริงย่อยในสตริง อักขระแรกของสตริงเริ่มต้นที่ 0 ถ้าไม่พบสตริง, ฟังก์ชันจะส่งคืน -1

ตัวอย่าง

ตัวอย่างต่อไปนี้ส่งคืนตำแหน่งตัวเลขของรูปแบบสตริงที่ระบุไว้ในสตริงที่ระบุเฉพาะ:

BirtStr.search( "XM?", "XMS-ModelA-1234-567" ) // returns 0
BirtStr.search( "ModelA*", "XMS-ModelA-1234-567" ) // returns 4
BirtStr.search( "-", "XMS-ModelA-1234-567", 4 ) // returns 10

ตัวอย่างต่อไปนี้ค้นหารูปแบบสตริง, S*A, ในแต่ละค่าในฟิลด์ ProductCode ถ้าโค้ดผลิตภัณฑ์คือ KBS5412A นิพจน์จะคืนค่า 2

BirtStr.search( "S*A", row["ProductCode"] )

ตัวอย่างต่อไปนี้ใช้ BirtStr.search( ) ร่วมกับ BirtStr.left( ) เพื่อแสดงอักขระที่นำหน้าแพตเทิร์นสตริง -Model* ใยชื่อผลิตภัณฑ์ ฟังก์ชัน BirtStr.left( ) จะดึงสตริงย่อยตามความยาวที่ระบุ เริ่มต้นจากอักขระตัวแรก ในตัวอย่างนี้, ความยาวของสตริงย่อยที่ต้องการแสดงเท่ากับตำแหน่งตัวเลขของรูปแบบสตริง

stringPatternPosition = BirtStr.search( "-Model*", row["productName"] );
displayString = BirtStr.left( row["productName"], stringPatternPosition );

ถ้าชื่อผลิตภัณฑ์คือ XMS-ModelA-1234 นิพจน์จะคืนค่า XMS

BirtStr.toLower

ฟังก์ชันนี้จะแปลงตัวอักษรทั้งหมดในสตริงเป็นตัวพิมพ์เล็ก

ไวยากรณ์

string BirtStr.toLower( string source )

พารามิเตอร์

source

String สตริงที่ต้องการแปลงเป็นตัวพิมพ์เล็ก

คืนค่า

String สตริงที่ระบุเป็นตัวอักษรตัวพิมพ์เล็กทั้งหมด

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงค่าทั้งหมดในฟิลด์ productLine เป็นตัวพิมพ์เล็ก:

BirtStr.toLower( row["productLine"] )

BirtStr.toUpper

ฟังก์ชันนี้จะแปลงตัวอักษรทั้งหมดในสตริงเป็นตัวพิมพ์ใหญ่

ไวยากรณ์

string BirtStr.toUpper( string source )

พารามิเตอร์

source

String สตริงที่ต้องการแปลงเป็นตัวพิมพ์ใหญ่

คืนค่า

String สตริงที่ระบุเป็นตัวอักษรตัวพิมพ์ใหญ่ทั้งหมด

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงค่าทั้งหมดในฟิลด์ customerName เป็นตัวอักษรตัวพิมพ์ใหญ่:

BirtStr.toUpper( row["customerName"] )

BirtStr.trim

ฟังก์ชันนี้ส่งคืนสตริงด้วยอักขระนำหน้าและอักขระลงท้ายที่ถูกลบทิ้ง มันจะไม่ลบอักขระว่างระหว่างคำ

ไวยากรณ์

string BirtStr.trim( string source )

พารามิเตอร์

source

String สตริงที่ต้องการลบอักขระนำหน้าและอักขระลงท้ายที่เป็นอักขระช่องว่าง

คืนค่า

String สตริงที่มีอักขระนำหน้าและอักขระลงท้ายด้วยช่องว่างถูกลบทิ้ง

ตัวอย่าง

ตัวอย่างต่อไปนี้ใช้ BirtStr.trim( ) เพื่อลบอักขระช่องว่างที่นำหน้าและลงท้ายออกจากค่าในฟิลด์ข้อมูล FirstName และ LastName

BirtStr.trim( row["FirstName"]) + " " + BirtStr.trim(row["LastName"] )

BirtStr.trimLeft

ฟังก์ชันนี้ส่งคืนสตริงด้วยอักขระนำหน้าและอักขระลงท้ายที่ถูกลบทิ้ง มันจะไม่ลบอักขระว่างระหว่างคำ

ไวยากรณ์

string BirtStr.trimLeft( string source )

พารามิเตอร์

source

String สตริงที่ต้องการลบอักขระช่องว่างที่นำหน้า

คืนค่า

String สตริงที่มีอักขระช่องว่างที่นำหน้าทั้งหมดถูกลบทิ้ง

ตัวอย่าง

ตัวอย่างต่อไปนี้เชื่อมสตริงอักขระด้วยค่าแต่ละค่าในฟิลด์ customerName BirtStr.trimLeft( ) ลบอักขระช่องว่างทั้งหมดที่นำหน้าด้วยค่า customerName ดังนั้น จึงไม่มีอักขระว่างพิเศษระหว่างสตริงอักขระและค่า customerName

"Customer name: " + BirtStr.trimLeft( row["customerName"] )

BirtStr.trimRight

ฟังก์ชันนี้จะคืนค่าสตริงที่ลบอักขระว่างที่ส่วนท้ายออก มันจะไม่ลบอักขระว่างระหว่างคำ

ไวยากรณ์

string BirtStr.trimRight( string source )

พารามิเตอร์

source

String สตริงที่ต้องการลบอักขระที่ลงท้ายด้วยช่องว่างทิ้ง

คืนค่า

String สตริงที่มีอักขระช่องว่างที่ลงท้ายทั้งหมดถูกลบทิ้ง

ตัวอย่าง

ตัวอย่างต่อไปนี้เชื่อมแต่ละค่าในฟิลด์ ข้อคิดเห็น ด้วยเซมิโคลอน, ด้วยค่าในฟิลด์แอ็คชัน BirtStr.trimRight( ) ลบอักขระช่องว่างทั้งหมดหลังค่า ข้อคิดเห็น เพื่อให้ไม่มีอักขระช่องว่างพิเศษระหว่างสตริงข้อคิดเห็นและเซมิโคลอน

BirtStr.trimRight( row["Comment"]) + "; " + row["Action"] )

(c) ลิขสิทธิ์ Actuate Corporation 2013