Προηγούμενο Επόμενο

Κλάση BirtStr

Η κλάση BirtStr παρέχει συναρτήσεις για το χειρισμό σειρών χαρακτήρων, για παράδειγμα τη συνένωση σειρών χαρακτήρων, την περικοπή επιπλέον κενών, τη λήψη τμημάτων μιας σειράς χαρακτήρων και την εμφάνιση σειρών χαρακτήρων με κεφαλαίους ή πεζούς χαρακτήρες. Αυτή η κλάση είναι στατική. Η εφαρμογή δεν μπορεί να δημιουργήσει χρήσεις της κλάσης.

BirtStr.charLength

Αυτή η συνάρτηση επιστρέφει το μήκος μιας δεδομένης σειράς χαρακτήρων.

Σύνταξη

integer BirtStr.charLength( προέλευση )

Παράμετρος

προέλευση

Σειρά χαρακτήρων. Η σειρά χαρακτήρων που θα αποτιμηθεί.

Επιστρέφει

Ακέραιος. Ο αριθμός χαρακτήρων στην καθορισμένη σειρά χαρακτήρων.

Παραδείγματα

Το ακόλουθο παράδειγμα επιστρέφει το μήκος μιας συγκεκριμένης σειράς χαρακτήρων:

BirtStr.charLength( "Julie Murphy" ) // επιστρέφει την τιμή 12

Το ακόλουθο παράδειγμα επιστρέφει το μήκος της κάθε τιμής στο πεδίο CustomerName:

BirtStr.charLength( row["CustomerName"] )

BirtStr.concat

Αυτή η συνάρτηση επιστρέφει τη σειρά χαρακτήρων που προκύπτει από τη συνένωση καθορισμένων σειρών.

Σύνταξη

string BirtStr.concat( προέλευση1, ..., προέλευσηN )

Παράμετρος

προέλευση1, ..., προέλευσηN

Σειρά χαρακτήρων. Οι σειρές χαρακτήρων που θα συνενωθούν.

Επιστρέφει

Σειρά χαρακτήρων. Η σειρά χαρακτήρων που προκύπτει από τη συνένωση πολλαπλών σειρών χαρακτήρων.

Παράδειγμα

Το ακόλουθο παράδειγμα επιστρέφει μια πλήρη διεύθυνση συνενώνοντας τιμές από πολλαπλά πεδία:

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

BirtStr.indexOf

Αυτή η συνάρτηση επιστρέφει τη θέση ενός καθορισμένου τμήματος σε μια δεδομένη σειρά χαρακτήρων.

Σύνταξη

integer BirtStr.indexOf( προορισμός, προέλευση, έναρξη )

Παράμετροι

προορισμός

Σειρά χαρακτήρων. Το τμήμα σειράς χαρακτήρων που θα αναζητηθεί. Ισχύει η διάκριση πεζών-κεφαλαίων για την αναζήτηση.

προέλευση

Σειρά χαρακτήρων. Η σειρά χαρακτήρων στην οποία θα αναζητηθεί το καθορισμένο τμήμα σειράς χαρακτήρων.

έναρξη

Ακέραιος. Προαιρετική. Η θέση στη σειρά χαρακτήρων προέλευσης από όπου ξεκινά η αναζήτηση. Αν παραλείψετε αυτό το όρισμα, η συνάρτηση ξεκινά την αναζήτηση από τον πρώτο χαρακτήρα της σειράς χαρακτήρων.

Επιστρέφει

Ακέραιος. Η αριθμητική θέση του τμήματος στη σειρά χαρακτήρων. Ο πρώτος χαρακτήρας μιας σειράς χαρακτήρων βρίσκεται στη θέση 0. Αν δεν βρεθεί το τμήμα της σειράς χαρακτήρων, η συνάρτηση επιστρέφει -1.

Παραδείγματα

Το ακόλουθο παράδειγμα επιστρέφει την αριθμητική θέση των καθορισμένων χαρακτήρων σε συγκεκριμένες σειρές χαρακτήρων:

BirtStr.indexOf( " ", "Julie Murphy" ) // επιστρέφει την τιμή 5
BirtStr.indexOf( "-", "ModelA-1234-567" ) // επιστρέφει την τιμή 6
BirtStr.indexOf( "-", "ModelA-1234-567", 7 ) // επιστρέφει την τιμή 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( προέλευση, ακέραιος n )

Παράμετροι

προέλευση

Σειρά χαρακτήρων. Η σειρά χαρακτήρων από την οποία θα εξαχθεί ένα τμήμα.

n

Ακέραιος. Ο αριθμός των χαρακτήρων που θα εξαχθούν, ξεκινώντας από τον πρώτο χαρακτήρα.

Επιστρέφει

Σειρά χαρακτήρων. Ένα τμήμα σειράς χαρακτήρων με το καθορισμένο μήκος.

*
*
*

Παραδείγματα

Το ακόλουθο παράδειγμα επιστρέφει τμήματα σειρών χαρακτήρων με διαφορετικά μήκη από συγκεκριμένες σειρές χαρακτήρων:

BirtStr.left( "Julie Murphy", 5 ) // επιστρέφει την τιμή Julie
BirtStr.left( "Julie Murphy", 12 ) // επιστρέφει την τιμή 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( προέλευση, ακέραιος n )

Παράμετροι

προέλευση

Σειρά χαρακτήρων. Η σειρά χαρακτήρων από την οποία θα εξαχθεί ένα τμήμα.

n

Ακέραιος. Ο αριθμός των χαρακτήρων που θα εξαχθούν, ξεκινώντας από τον τελευταίο χαρακτήρα.

Επιστρέφει

Σειρά χαρακτήρων. Ένα τμήμα σειράς χαρακτήρων με το καθορισμένο μήκος.

*
*
*

Παραδείγματα

Το ακόλουθο παράδειγμα επιστρέφει τμήματα σειρών χαρακτήρων με διαφορετικά μήκη από συγκεκριμένες σειρές χαρακτήρων:

BirtStr.right( "Julie Murphy", 6 ) // επιστρέφει την τιμή Murphy
BirtStr.right( "Julie Murphy", 12 ) // επιστρέφει την τιμή Julie Murphy

Το ακόλουθο παράδειγμα χρησιμοποιεί την BirtStr.right( ) σε συνδυασμό με τις συναρτήσεις BirtStr.indexOf( ) και BirtStr.charLength( ) για την εμφάνιση των χαρακτήρων που έπονται του χαρακτήρα κενού διαστήματος σε ένα όνομα πελάτη. Σε αυτό το παράδειγμα θεωρείται δεδομένο ότι ο αριθμός των χαρακτήρων μετά την παύλα ποικίλλει. Επομένως, για να βρεθεί ο αριθμός των χαρακτήρων που εμφανίζονται πρέπει να αφαιρεθεί το μήκος των χαρακτήρων μέχρι την παύλα (που επιστρέφεται από την BirtStr.indexOf( )) από το μήκος ολόκληρης της σειράς χαρακτήρων (που επιστρέφεται από την BirtStr.charLength( )).

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

Αν το όνομα πελάτη είναι Julie Murphy, η έκφραση επιστρέφει την τιμή Murphy. Αν το όνομα πελάτη είναι Kwai Li, η έκφραση επιστρέφει την τιμή Li.

BirtStr.search

Αυτή η συνάρτηση επιστρέφει τη θέση ενός καθορισμένου τμήματος σε μια δεδομένη σειρά χαρακτήρων. Το τμήμα σειράς χαρακτήρων μπορεί να περιέχει χαρακτήρες υποκατάστασης.

Σύνταξη

integer BirtStr.search( μοτίβο, προέλευση, δείκτης )

Παράμετροι

μοτίβο

Σειρά χαρακτήρων. Το μοτίβο σειράς χαρακτήρων που θα αναζητηθεί. Δεν ισχύει η διάκριση πεζών-κεφαλαίων για την αναζήτηση. Μπορείτε να χρησιμοποιήσετε τους ακόλουθους χαρακτήρες υποκατάστασης στο μοτίβο:

*
Ο αστερίσκος ( * ) αντικαθίσταται από μηδέν ή περισσότερους χαρακτήρες, συμπεριλαμβανομένων των κενών. Για παράδειγμα, η σειρά χαρακτήρων t*n επιστρέφει τις τιμές tn, tin και teen.
*

Για να αναζητήσετε τους ίδιους τους χαρακτήρες αστερίσκου ή αγγλικού ερωτηματικού σε μια σειρά χαρακτήρων, προσθέστε δύο αντικαθέτους (\\) πριν από αυτούς. Για παράδειγμα, για να βρείτε τη σειρά χαρακτήρων R*10, χρησιμοποιήστε το ακόλουθο μοτίβο σειράς χαρακτήρων:

"R\\*10"

προέλευση

Σειρά χαρακτήρων. Η σειρά χαρακτήρων στην οποία θα αναζητηθεί το καθορισμένο τμήμα σειράς χαρακτήρων.

δείκτης

Ακέραιος. Προαιρετική. Η θέση στη σειρά χαρακτήρων προέλευσης από όπου ξεκινά η αναζήτηση. Αν παραλείψετε αυτό το όρισμα, η συνάρτηση ξεκινά την αναζήτηση από τον πρώτο χαρακτήρα της σειράς χαρακτήρων.

Επιστρέφει

Ακέραιος. Η αριθμητική θέση του τμήματος στη σειρά χαρακτήρων. Ο πρώτος χαρακτήρας μιας σειράς χαρακτήρων βρίσκεται στη θέση 0. Αν δεν βρεθεί το τμήμα της σειράς χαρακτήρων, η συνάρτηση επιστρέφει -1.

Παραδείγματα

Το ακόλουθο παράδειγμα επιστρέφει την αριθμητική θέση των καθορισμένων μοτίβων σε συγκεκριμένες σειρές χαρακτήρων:

BirtStr.search( "XM?", "XMS-ModelA-1234-567" ) // επιστρέφει την τιμή 0
BirtStr.search( "ModelA*", "XMS-ModelA-1234-567" ) // επιστρέφει την τιμή 4
BirtStr.search( "-", "XMS-ModelA-1234-567", 4 ) // επιστρέφει την τιμή 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( προέλευση )

Παράμετρος

προέλευση

Σειρά χαρακτήρων. Η σειρά χαρακτήρων τα γράμματα της οποίας θα μετατραπούν σε πεζά.

Επιστρέφει

Σειρά χαρακτήρων. Η καθορισμένη σειρά χαρακτήρων μόνο με πεζά γράμματα.

Παράδειγμα

Το ακόλουθο παράδειγμα εμφανίζει όλες τις τιμές του πεδίου productLine με πεζά γράμματα:

BirtStr.toLower( row["productLine"] )

BirtStr.toUpper

Αυτή η συνάρτηση μετατρέπει όλα τα γράμματα μιας σειράς χαρακτήρων σε κεφαλαία.

Σύνταξη

string BirtStr.toUpper( προέλευση )

Παράμετρος

προέλευση

Σειρά χαρακτήρων. Η σειρά χαρακτήρων τα γράμματα της οποίας θα μετατραπούν σε κεφαλαία.

Επιστρέφει

Σειρά χαρακτήρων. Η καθορισμένη σειρά χαρακτήρων μόνο με κεφαλαία γράμματα.

Παράδειγμα

Το ακόλουθο παράδειγμα εμφανίζει όλες τις τιμές του πεδίου customerName με κεφαλαία γράμματα:

BirtStr.toUpper( row["customerName"] )

BirtStr.trim

Αυτή η συνάρτηση επιστρέφει μια σειρά χαρακτήρων από την οποία έχουν αφαιρεθεί όλα τα προτασσόμενα και καταληκτικά κενά διαστήματα. Δεν αφαιρεί τα κενά διαστήματα ανάμεσα στις λέξεις.

Σύνταξη

string BirtStr.trim( προέλευση )

Παράμετρος

προέλευση

Σειρά χαρακτήρων. Η σειρά χαρακτήρων από την οποία θα αφαιρεθούν τα προτασσόμενα και καταληκτικά κενά διαστήματα.

Επιστρέφει

Σειρά χαρακτήρων. Μια σειρά χαρακτήρων από την οποία έχουν αφαιρεθεί όλα τα προτασσόμενα και καταληκτικά κενά διαστήματα.

Παράδειγμα

Το ακόλουθο παράδειγμα χρησιμοποιεί τη συνάρτηση BirtStr.trim( ) για να αφαιρέσει όλα τα προτασσόμενα και καταληκτικά κενά διαστήματα από τις τιμές στα πεδία δεδομένων FirstName και LastName.

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

BirtStr.trimLeft

Αυτή η συνάρτηση επιστρέφει μια σειρά χαρακτήρων από την οποία έχουν αφαιρεθεί όλα τα προτασσόμενα και καταληκτικά κενά διαστήματα. Δεν αφαιρεί τα κενά διαστήματα ανάμεσα στις λέξεις.

Σύνταξη

string BirtStr.trimLeft( προέλευση )

Παράμετρος

προέλευση

Σειρά χαρακτήρων. Η σειρά χαρακτήρων από την οποία θα αφαιρεθούν τα προτασσόμενα κενά διαστήματα.

Επιστρέφει

Σειρά χαρακτήρων. Μια σειρά χαρακτήρων από την οποία έχουν αφαιρεθεί όλα τα προτασσόμενα κενά διαστήματα.

Παράδειγμα

Το ακόλουθο παράδειγμα συνενώνει μια λεκτική σταθερά με κάθε τιμή του πεδίου customerName. Η συνάρτηση BirtStr.trimLeft( ) αφαιρεί όλα τα κενά διαστήματα που βρίσκονται πριν την τιμή customerName, έτσι ώστε να μην υπάρχουν επιπλέον κενά ανάμεσα στη λεκτική σταθερά και την τιμή customerName.

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

BirtStr.trimRight

Αυτή η συνάρτηση επιστρέφει μια σειρά χαρακτήρων από την οποία έχουν αφαιρεθεί όλα τα καταληκτικά κενά διαστήματα. Δεν αφαιρεί τα κενά διαστήματα ανάμεσα στις λέξεις.

Σύνταξη

string BirtStr.trimRight( προέλευση )

Παράμετρος

προέλευση

Σειρά χαρακτήρων. Η σειρά χαρακτήρων από την οποία θα αφαιρεθούν τα καταληκτικά κενά διαστήματα.

Επιστρέφει

Σειρά χαρακτήρων. Μια σειρά χαρακτήρων από την οποία έχουν αφαιρεθεί όλα τα καταληκτικά κενά διαστήματα.

Παράδειγμα

Το ακόλουθο παράδειγμα συνενώνει κάθε τιμή του πεδίου Comment με ένα ελληνικό ερωτηματικό και στη συνέχεια με μια τιμή από το πεδίο Action. Η συνάρτηση BirtStr.trimRight( ) αφαιρεί όλα τα κενά διαστήματα που βρίσκονται μετά την τιμή Comment, έτσι ώστε να μην υπάρχουν επιπλέον κενά ανάμεσα στη σειρά χαρακτήρων Comment και το ελληνικό ερωτηματικό.

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

(c) Copyright Actuate Corporation 2013