Η κλάση BirtStr παρέχει συναρτήσεις για το
χειρισμό σειρών χαρακτήρων, για παράδειγμα τη συνένωση σειρών χαρακτήρων, την περικοπή
επιπλέον κενών, τη λήψη τμημάτων μιας σειράς χαρακτήρων και την εμφάνιση σειρών
χαρακτήρων με κεφαλαίους ή πεζούς χαρακτήρες. Αυτή η κλάση είναι στατική. Η εφαρμογή δεν μπορεί να δημιουργήσει χρήσεις της κλάσης.
Αυτή η συνάρτηση επιστρέφει το μήκος μιας δεδομένης σειράς χαρακτήρων.
Σύνταξη
Παράμετρος
προέλευση
Σειρά χαρακτήρων. Η σειρά χαρακτήρων που θα αποτιμηθεί.
Επιστρέφει
Ακέραιος. Ο αριθμός χαρακτήρων στην καθορισμένη σειρά χαρακτήρων.
Παραδείγματα
Το ακόλουθο παράδειγμα επιστρέφει το μήκος μιας συγκεκριμένης σειράς χαρακτήρων:
Το ακόλουθο παράδειγμα επιστρέφει το μήκος της κάθε τιμής στο πεδίο CustomerName:
Αυτή η συνάρτηση επιστρέφει τη σειρά χαρακτήρων που προκύπτει από τη συνένωση καθορισμένων σειρών.
Σύνταξη
Παράμετρος
προέλευση1, ..., προέλευσηN
Σειρά χαρακτήρων. Οι σειρές χαρακτήρων που θα συνενωθούν.
Επιστρέφει
Σειρά χαρακτήρων. Η σειρά χαρακτήρων που προκύπτει από τη συνένωση πολλαπλών σειρών χαρακτήρων.
Παράδειγμα
Το ακόλουθο παράδειγμα επιστρέφει μια πλήρη διεύθυνση συνενώνοντας τιμές από πολλαπλά πεδία:
BirtStr.concat( row["AddressLine1"], ", ", row["AddressLine2"], ", ", row["City"], " ", row["PostalCode"], "row["State"], ", ", row["Country"] )
Αυτή η συνάρτηση επιστρέφει τη θέση ενός καθορισμένου τμήματος σε μια δεδομένη σειρά χαρακτήρων.
Σύνταξη
Παράμετροι
προορισμός
Σειρά χαρακτήρων. Το τμήμα σειράς χαρακτήρων που θα αναζητηθεί. Ισχύει η διάκριση πεζών-κεφαλαίων για την αναζήτηση.
προέλευση
Σειρά χαρακτήρων. Η σειρά χαρακτήρων στην οποία θα αναζητηθεί το καθορισμένο τμήμα σειράς χαρακτήρων.
έναρξη
Ακέραιος. Προαιρετική. Η θέση στη σειρά χαρακτήρων προέλευσης από όπου ξεκινά η αναζήτηση. Αν
παραλείψετε αυτό το όρισμα, η συνάρτηση ξεκινά την αναζήτηση από τον πρώτο χαρακτήρα της
σειράς χαρακτήρων.
Επιστρέφει
Ακέραιος. Η αριθμητική θέση του τμήματος στη
σειρά χαρακτήρων. Ο πρώτος χαρακτήρας μιας σειράς χαρακτήρων βρίσκεται στη θέση 0. Αν δεν
βρεθεί το τμήμα της σειράς χαρακτήρων, η συνάρτηση επιστρέφει -1.
Παραδείγματα
Το ακόλουθο παράδειγμα επιστρέφει την αριθμητική θέση των καθορισμένων χαρακτήρων σε συγκεκριμένες σειρές χαρακτήρων:
Το ακόλουθο παράδειγμα χρησιμοποιεί την
BirtStr.indexOf( ) σε συνδυασμό με την BirtStr.left( ) για την εμφάνιση των
χαρακτήρων που προηγούνται του χαρακτήρα κενού διαστήματος σε ένα όνομα πελάτη. Η
συνάρτηση BirtStr.left( ) εξάγει ένα τμήμα σειράς χαρακτήρων καθορισμένου μήκους,
ξεκινώντας από τον πρώτο χαρακτήρα. Σε αυτό το παράδειγμα, το μήκος του τμήματος σειράς
χαρακτήρων που θα εμφανιστεί ισούται με την αριθμητική θέση του χαρακτήρα κενού
διαστήματος.
Αν το όνομα πελάτη είναι Julie Murphy, η έκφραση επιστρέφει την τιμή Julie.
Αυτή η συνάρτηση εξάγει ένα τμήμα καθορισμένου
μήκους από μια σειρά χαρακτήρων, ξεκινώντας από τον πρώτο από αριστερά χαρακτήρα.
Σύνταξη
Παράμετροι
προέλευση
Σειρά χαρακτήρων. Η σειρά χαρακτήρων από την οποία θα εξαχθεί ένα τμήμα.
n
Ακέραιος. Ο αριθμός των χαρακτήρων που θα εξαχθούν, ξεκινώντας από τον πρώτο χαρακτήρα.
Επιστρέφει
Σειρά χαρακτήρων. Ένα τμήμα σειράς χαρακτήρων με το καθορισμένο μήκος.
Παραδείγματα
Το ακόλουθο παράδειγμα επιστρέφει τμήματα σειρών
χαρακτήρων με διαφορετικά μήκη από συγκεκριμένες σειρές χαρακτήρων:
Το ακόλουθο παράδειγμα χρησιμοποιεί την
BirtStr.indexOf( ) σε συνδυασμό με την BirtStr.left( ) για την εμφάνιση των
χαρακτήρων που προηγούνται του χαρακτήρα κενού διαστήματος σε ένα όνομα πελάτη. Η
συνάρτηση BirtStr.left( ) εξάγει ένα τμήμα σειράς χαρακτήρων καθορισμένου μήκους,
ξεκινώντας από τον πρώτο χαρακτήρα. Σε αυτό το παράδειγμα, το μήκος του τμήματος σειράς
χαρακτήρων που θα εμφανιστεί ισούται με την αριθμητική θέση του χαρακτήρα κενού
διαστήματος.
Αν το όνομα πελάτη είναι Julie Murphy, η έκφραση επιστρέφει την τιμή Julie.
Αυτή η συνάρτηση εξάγει ένα τμήμα καθορισμένου
μήκους από μια σειρά χαρακτήρων, ξεκινώντας από τον πρώτο από δεξιά χαρακτήρα.
Σύνταξη
Παράμετροι
προέλευση
Σειρά χαρακτήρων. Η σειρά χαρακτήρων από την οποία θα εξαχθεί ένα τμήμα.
n
Ακέραιος. Ο αριθμός των χαρακτήρων που θα εξαχθούν, ξεκινώντας από τον τελευταίο χαρακτήρα.
Επιστρέφει
Σειρά χαρακτήρων. Ένα τμήμα σειράς χαρακτήρων με το καθορισμένο μήκος.
Παραδείγματα
Το ακόλουθο παράδειγμα επιστρέφει τμήματα σειρών
χαρακτήρων με διαφορετικά μήκη από συγκεκριμένες σειρές χαρακτήρων:
Το ακόλουθο παράδειγμα χρησιμοποιεί την
BirtStr.right( ) σε συνδυασμό με τις συναρτήσεις BirtStr.indexOf( ) και
BirtStr.charLength( ) για την εμφάνιση των χαρακτήρων που έπονται του χαρακτήρα
κενού διαστήματος σε ένα όνομα πελάτη. Σε αυτό το παράδειγμα θεωρείται δεδομένο ότι ο αριθμός των χαρακτήρων μετά την παύλα ποικίλλει. Επομένως, για να βρεθεί ο αριθμός των
χαρακτήρων που εμφανίζονται πρέπει να αφαιρεθεί το μήκος των χαρακτήρων μέχρι την παύλα
(που επιστρέφεται από την BirtStr.indexOf( )) από το μήκος ολόκληρης της σειράς
χαρακτήρων (που επιστρέφεται από την BirtStr.charLength( )).
Αν το όνομα πελάτη είναι Julie Murphy, η έκφραση επιστρέφει την τιμή Murphy.
Αν το όνομα πελάτη είναι Kwai Li, η έκφραση επιστρέφει την τιμή Li.
Αυτή η συνάρτηση επιστρέφει τη θέση ενός
καθορισμένου τμήματος σε μια δεδομένη σειρά χαρακτήρων. Το τμήμα σειράς χαρακτήρων μπορεί να περιέχει χαρακτήρες υποκατάστασης.
Σύνταξη
Παράμετροι
μοτίβο
Σειρά χαρακτήρων. Το μοτίβο σειράς χαρακτήρων που θα αναζητηθεί. Δεν ισχύει η διάκριση πεζών-κεφαλαίων για την αναζήτηση. Μπορείτε να χρησιμοποιήσετε τους ακόλουθους χαρακτήρες υποκατάστασης στο μοτίβο:
Για να αναζητήσετε τους ίδιους τους χαρακτήρες
αστερίσκου ή αγγλικού ερωτηματικού σε μια σειρά χαρακτήρων, προσθέστε δύο αντικαθέτους
(\\) πριν από αυτούς. Για παράδειγμα, για να βρείτε τη σειρά χαρακτήρων R*10,
χρησιμοποιήστε το ακόλουθο μοτίβο σειράς χαρακτήρων:
προέλευση
Σειρά χαρακτήρων. Η σειρά χαρακτήρων στην οποία θα αναζητηθεί το καθορισμένο τμήμα σειράς χαρακτήρων.
δείκτης
Ακέραιος. Προαιρετική. Η θέση στη σειρά χαρακτήρων προέλευσης από όπου ξεκινά η αναζήτηση. Αν
παραλείψετε αυτό το όρισμα, η συνάρτηση ξεκινά την αναζήτηση από τον πρώτο χαρακτήρα της
σειράς χαρακτήρων.
Επιστρέφει
Ακέραιος. Η αριθμητική θέση του τμήματος στη
σειρά χαρακτήρων. Ο πρώτος χαρακτήρας μιας σειράς χαρακτήρων βρίσκεται στη θέση 0. Αν δεν
βρεθεί το τμήμα της σειράς χαρακτήρων, η συνάρτηση επιστρέφει -1.
Παραδείγματα
Το ακόλουθο παράδειγμα επιστρέφει την αριθμητική
θέση των καθορισμένων μοτίβων σε συγκεκριμένες σειρές χαρακτήρων:
Το ακόλουθο παράδειγμα αναζητά το μοτίβο S*A σε
κάθε τιμή του πεδίου ProductCode. Αν ο κωδικός προϊόντος είναι KBS5412A, η έκφραση επιστρέφει τη τιμή 2.
Το ακόλουθο παράδειγμα χρησιμοποιεί την
BirtStr.search( ) σε συνδυασμό με την BirtStr.left( ) για την εμφάνιση των
χαρακτήρων που προηγούνται του μοτίβου -Model* σε ένα όνομα πελάτη. Η
συνάρτηση BirtStr.left( ) εξάγει ένα τμήμα σειράς χαρακτήρων καθορισμένου μήκους,
ξεκινώντας από τον πρώτο χαρακτήρα. Σε αυτό το παράδειγμα, το μήκος του τμήματος σειράς
χαρακτήρων που θα εμφανιστεί ισούται με την αριθμητική θέση του μοτίβου σειράς
χαρακτήρων.
Αν το όνομα του προϊόντος είναι XMS-ModelA-1234, η έκφραση επιστρέφει την τιμή XMS.
Αυτή η συνάρτηση μετατρέπει όλα τα γράμματα μιας σειράς χαρακτήρων σε πεζά.
Σύνταξη
Παράμετρος
προέλευση
Σειρά χαρακτήρων. Η σειρά χαρακτήρων τα γράμματα της οποίας θα μετατραπούν σε πεζά.
Επιστρέφει
Σειρά χαρακτήρων. Η καθορισμένη σειρά χαρακτήρων μόνο με πεζά γράμματα.
Παράδειγμα
Το ακόλουθο παράδειγμα εμφανίζει όλες τις τιμές
του πεδίου productLine με πεζά γράμματα:
Αυτή η συνάρτηση μετατρέπει όλα τα γράμματα μιας σειράς χαρακτήρων σε κεφαλαία.
Σύνταξη
Παράμετρος
προέλευση
Σειρά χαρακτήρων. Η σειρά χαρακτήρων τα γράμματα της οποίας θα μετατραπούν σε κεφαλαία.
Επιστρέφει
Σειρά χαρακτήρων. Η καθορισμένη σειρά χαρακτήρων μόνο με κεφαλαία γράμματα.
Παράδειγμα
Το ακόλουθο παράδειγμα εμφανίζει όλες τις τιμές του πεδίου customerName με κεφαλαία γράμματα:
Αυτή η
συνάρτηση επιστρέφει μια σειρά χαρακτήρων από την οποία έχουν αφαιρεθεί όλα τα
προτασσόμενα και καταληκτικά κενά διαστήματα. Δεν αφαιρεί τα κενά διαστήματα ανάμεσα στις λέξεις.
Σύνταξη
Παράμετρος
προέλευση
Σειρά χαρακτήρων. Η σειρά χαρακτήρων από
την οποία θα αφαιρεθούν τα προτασσόμενα και καταληκτικά κενά διαστήματα.
Επιστρέφει
Σειρά χαρακτήρων. Μια σειρά χαρακτήρων από την
οποία έχουν αφαιρεθεί όλα τα προτασσόμενα και καταληκτικά κενά διαστήματα.
Παράδειγμα
Το ακόλουθο παράδειγμα χρησιμοποιεί τη συνάρτηση
BirtStr.trim( ) για να αφαιρέσει όλα τα προτασσόμενα και καταληκτικά κενά διαστήματα
από τις τιμές στα πεδία δεδομένων FirstName και LastName.
Αυτή η
συνάρτηση επιστρέφει μια σειρά χαρακτήρων από την οποία έχουν αφαιρεθεί όλα τα
προτασσόμενα και καταληκτικά κενά διαστήματα. Δεν αφαιρεί τα κενά διαστήματα ανάμεσα στις λέξεις.
Σύνταξη
Παράμετρος
προέλευση
Σειρά χαρακτήρων. Η σειρά χαρακτήρων από
την οποία θα αφαιρεθούν τα προτασσόμενα κενά διαστήματα.
Επιστρέφει
Σειρά χαρακτήρων. Μια σειρά χαρακτήρων από την
οποία έχουν αφαιρεθεί όλα τα προτασσόμενα κενά διαστήματα.
Παράδειγμα
Το ακόλουθο παράδειγμα συνενώνει μια λεκτική
σταθερά με κάθε τιμή του πεδίου customerName. Η συνάρτηση BirtStr.trimLeft( )
αφαιρεί όλα τα κενά διαστήματα που βρίσκονται πριν την τιμή customerName, έτσι ώστε να
μην υπάρχουν επιπλέον κενά ανάμεσα στη λεκτική σταθερά και την τιμή customerName.
Αυτή η
συνάρτηση επιστρέφει μια σειρά χαρακτήρων από την οποία έχουν αφαιρεθεί όλα τα
καταληκτικά κενά διαστήματα. Δεν αφαιρεί τα κενά διαστήματα ανάμεσα στις λέξεις.
Σύνταξη
Παράμετρος
προέλευση
Σειρά χαρακτήρων. Η σειρά χαρακτήρων από
την οποία θα αφαιρεθούν τα καταληκτικά κενά διαστήματα.
Επιστρέφει
Σειρά χαρακτήρων. Μια σειρά χαρακτήρων από την
οποία έχουν αφαιρεθεί όλα τα καταληκτικά κενά διαστήματα.
Παράδειγμα
Το ακόλουθο παράδειγμα συνενώνει κάθε τιμή του
πεδίου Comment με ένα ελληνικό ερωτηματικό και στη συνέχεια με μια τιμή από το πεδίο
Action. Η συνάρτηση BirtStr.trimRight( ) αφαιρεί όλα τα κενά διαστήματα που
βρίσκονται μετά την τιμή Comment, έτσι ώστε να μην υπάρχουν επιπλέον κενά ανάμεσα στη
σειρά χαρακτήρων Comment και το ελληνικό ερωτηματικό.