Συναρτήσεις χρόνου εκτέλεσης συμβολοσειρών X++

Note

Οι ομάδες ενδιαφέροντος της κοινότητας έχουν πλέον μετακινηθεί από το Yammer στο Microsoft Viva Engage. Για να συμμετάσχετε σε μια κοινότητα Viva Engage και να συμμετάσχετε στις τελευταίες συζητήσεις, συμπληρώστε τη φόρμα Αίτηση πρόσβασης στο Finance and Operations Viva Engage Community και επιλέξτε την κοινότητα στην οποία θέλετε να συμμετάσχετε.

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

σπίρτο

Αναζητά μια συμβολοσειρά ή παράσταση σε μια άλλη συμβολοσειρά.

int match(str pattern, str text)

Παράμετροι

Παράμετρος	Περιγραφή
μοτίβο	Η συμβολοσειρά ή η παράσταση για αναζήτηση.
κείμενο	Η συμβολοσειρά προς αναζήτηση.

Επιστρεφόμενη αξία

1 εάν το μοτίβο βρίσκεται στη συμβολοσειρά. διαφορετικά, 0 (μηδέν).

Παρατηρήσεις

Η αναζήτηση δεν κάνει διάκριση πεζών-κεφαλαίων. Οι ακόλουθοι ειδικοί χαρακτήρες μπορούν να χρησιμοποιηθούν για τη δημιουργία του μοτίβου για την παράμετρο pattern .

• \: Μια ανάστροφη κάθετο (\) nullifies, ή διαφυγής, η ειδική μεταχείριση ειδικών χαρακτήρων, έτσι ώστε ένας ειδικός χαρακτήρας να μπορεί να αντιστοιχιστεί όπως ένα κανονικό γράμμα. Ένα ζεύγος ανάστροφων καθέτων μεταφράζεται σε μία μη χαρακτηριστική ανάστροφη κάθετο. Παραδείγματα:

  • match("ab$cd","ab$cd"); Η επιστρέφει 0.
  • match("ab\$cd","ab$cd"); Η επιστρέφει 0. Η ανάστροφη κάθετο δεν είναι διαφυγής.
  • match("ab\\$cd","ab$cd"); Η επιστρέφει 1. Η ανάστροφη κάθετο και το σύμβολο του δολαρίου δραπετεύονται.

• < ή ^: Μια αριστερή γωνία αγκύλης (<) ή μια σιρκονφex (^) στην αρχή μιας παράστασης χρησιμοποιείται για να συμφωνεί με την αρχή μιας γραμμής. Παραδείγματα:

  • match("<abc","abcdef"); επιστρέφει 1.
  • match("<abc","defabc"); επιστρέφει 0.
  • match("^abc","abcdef"); Η επιστρέφει 1.
  • match("^abc","defabc"); Η επιστρέφει 0.

• > ή $: Μια δεξιά γωνία αγκύλης (>) ή ένα σύμβολο δολαρίου ($) στο τέλος της παράστασης χρησιμοποιείται για να συμφωνεί με το τέλος μιας γραμμής. Παραδείγματα:

  • match("abc>","abcdef"); επιστρέφει 0.
  • match("abc>","defabc"); επιστρέφει 1.

• ? ή.: Ένα ερωτηματικό (?) ή μια τελεία (.) αντιστοιχεί οποιονδήποτε χαρακτήρα στην ίδια θέση. Παραδείγματα:

  • match("abc.def","abc#def"); Η επιστρέφει 1.
  • match("colou?r","colouXr"); Η επιστρέφει 1.

• :x: Η άνω και κάτω τελεία (:) καθορίζει μια ομάδα χαρακτήρων για αντιστοίχιση, όπως υποδεικνύεται από τον χαρακτήρα που ακολουθεί αμέσως.

• :a: Ορίζει την αντιστοίχιση σε γράμματα. Παραδείγματα:

  • match("ab:acd","ab#cd"); Η επιστρέφει 0.
  • match("ab:acd","abxyzcd"); Η επιστρέφει 0.
  • match("ab:acd","abxcd"); Η επιστρέφει 1.

• :d: Ορίζει την αντιστοίχιση σε αριθμητικούς χαρακτήρες. Παραδείγματα:

  • match("ab:dcd","ab3cd"); Η επιστρέφει 1.
  • match("ab:dcd","ab123cd"); Η επιστρέφει 0.
  • match("ab:dcd","abcd"); Η επιστρέφει 0.

• :n: Ορίζει την αντιστοίχιση σε αλφαριθμητικούς χαρακτήρες. Παραδείγματα:

  • match("ab:ncd","ab%cd"); Η επιστρέφει 0.
  • match("ab:ncd","ab9cd"); Η επιστρέφει 1.
  • match("ab:ncd","abXcd"); Η επιστρέφει 1.

• :ΔΙΑΣΤΗΜΑ: ΔΙΑΣΤΗΜΑ είναι ο χαρακτήρας διαστήματος (" "). Ορίζει την αντιστοίχιση σε κενά, σε μορφή πίνακα και χαρακτήρες στοιχείων ελέγχου, όπως το Enter (νέα γραμμή). Παραδείγματα:

  • match("ab: cd","ab cd"); Η επιστρέφει 1.
  • match("ab: cd","ab\ncd"); Η επιστρέφει 1.
  • match("ab: cd","ab\tcd"); Η επιστρέφει 1.
  • match("ab: cd","ab cd"); Η επιστρέφει 0. Μόνο το πρώτο διάστημα συμφωνεί.

• *: Μια παράσταση που ακολουθείται από αστερίσκο ("*") απαιτεί συμφωνία για μηδέν, μία ή περισσότερες εμφανίσεις της προηγούμενης παράστασης. Παραδείγματα:

  • match("abc*d","abd"); Η επιστρέφει 1.
  • match("abc*d","abcd"); Η επιστρέφει 1.
  • match("abc*d","abcccd"); Η επιστρέφει 1.
  • match("abc*d","abxd"); Η επιστρέφει 0.

• +: Μια παράσταση που ακολουθείται από ένα σύμβολο συν (+) απαιτεί μια αντιστοιχία για μία ή περισσότερες εμφανίσεις της προηγούμενης παράστασης. Παραδείγματα:

  • match("abc+d","abd"); Η επιστρέφει 0.
  • match("abc+d","abcd"); Η επιστρέφει 1
  • match("abc+d","abcccd"); Η επιστρέφει 1.
  • match("abc+d","abxd"); Η επιστρέφει 0.

• -: Μια παράσταση που ακολουθείται από ένα σύμβολο μείον (-) απαιτεί μια αντιστοιχία για το μηδέν ή μία εμφάνιση της προηγούμενης παράστασης. Με άλλα λόγια, η προηγούμενη παράσταση είναι προαιρετική. Παραδείγματα:

  • match("colou-r","color"); Η επιστρέφει 1.
  • match("colou-r","color"); Η επιστρέφει 1.

• []: Αντιστοιχεί έναν μεμονωμένο χαρακτήρα με οποιονδήποτε χαρακτήρα που περικλείεται στις αγκύλες. Μια περιοχή χαρακτήρων μπορεί να καθοριστεί από δύο χαρακτήρες που διαχωρίζονται με ένα σύμβολο μείον (-). Για παράδειγμα, το [a-z] συμφωνεί με όλα τα γράμματα μεταξύ ενός και του z, [0-9] αντιστοιχίσει ένα ψηφίο και το [0-9a-f] συμφωνεί με ένα δεκαεξαδικό ψηφίο. Παραδείγματα:

  • match("[abc]","apple"); Η επιστρέφει 1, επειδή συμφωνεί με το in "apple."
  • match("[abc]","kiwi"); Η επιστρέφει 0, επειδή το "ακτινίδιο" δεν περιέχει a, b ή c.
  • match("gr[ae]y","grey"); Η επιστρέφει 1. Αυτή η παράσταση συμφωνεί επίσης με το "γκρι".
  • match("gr[ae]y","graey"); Η συνάρτηση επιστρέφει 0, επειδή αντιστοιχίζεται μόνο ένας χαρακτήρας μεταξύ "gr" και "y".

• [^]: Εάν ο πρώτος χαρακτήρας στο κείμενο που περικλείεται σε αγκύλες είναι μια περιτομή (^), η παράσταση συμφωνεί με όλους τους χαρακτήρες εκτός από τους χαρακτήρες που περικλείονται στις αγκύλες. Παραδείγματα:

  • match("[^bc]at","bat"); Η επιστρέφει 0.
  • match("[^bc]at","hat"); Η επιστρέφει 1.
  • match("[^abc]","bat"); Η επιστρέφει 1. Οτιδήποτε εκτός από ένα, b ή c συμφωνεί. Επομένως, το t συμφωνεί.

strAlpha

Αντιγράφει μόνο τους αλφαριθμητικούς χαρακτήρες από μια συμβολοσειρά.

str strAlpha(str _text)

Παράμετροι

Παράμετρος	Περιγραφή
_Κείμενο	Η συμβολοσειρά από την οποία θα γίνει αντιγραφή.

Επιστρεφόμενη αξία

Μια νέα συμβολοσειρά που περιέχει όλους τους αλφαριθμητικούς χαρακτήρες από την καθορισμένη συμβολοσειρά.

Παρατηρήσεις

Για παράδειγμα, η συνάρτηση strAlpha("2+2=5 is this correct?") επιστρέφει τη συμβολοσειρά 225isthiscorrect.

Παράδειγμα

static void strAlphaExample(Args _arg)
{
    str s;
    ;
    s = strAlpha("?a*bc123.");
    print s;
    pause;
}

strCmp

Συγκρίνει δύο συμβολοσειρές κειμένου.

int strCmp(str text1, str text2)

Παράμετροι

Παράμετρος	Περιγραφή
text1	Η πρώτη συμβολοσειρά.
text2	Η δεύτερη συμβολοσειρά.

Επιστρεφόμενη αξία

0 εάν οι δύο συμβολοσειρές είναι πανομοιότυπες, 1 εάν η πρώτη συμβολοσειρά ταξινομεί νωρίτερα ή -1 εάν η δεύτερη συμβολοσειρά ταξινομεί νωρίτερα.

Παρατηρήσεις

Η σύγκριση που εκτελέστηκε από αυτή τη μέθοδο κάνει διάκριση πεζών-κεφαλαίων.

print strCmp("abc", "abc"); //Returns the value 0.
print strCmp("abc", "ABC"); //Returns the value 1.
print strCmp("aaa", "bbb"); //Returns the value -1.
print strCmp("ccc", "bbb"); //Returns the value 1.

strColSeq

Μετατρέπει όλους τους χαρακτήρες κεφαλαίων σε πεζούς χαρακτήρες και μετατρέπει όλους τους χαρακτήρες που έχουν τόνους στους αντίστοιχους χαρακτήρες πεζών χωρίς κέντρο.

str strColSeq(str text)

Παράμετροι

Παράμετρος	Περιγραφή
κείμενο	Η συμβολοσειρά από την οποία θα αντιγράψετε και μετατρέψετε χαρακτήρες.

Επιστρεφόμενη αξία

Η συμβολοσειρά κειμένου που έχει μετατραπεί.

Παρατηρήσεις

Η συνάρτηση strColSeq υπάρχει για λόγους συμβατότητας με προηγούμενες εκδόσεις. Αυτή η συνάρτηση υποστηρίζει μόνο την αντιστοίχιση για τους ακόλουθους χαρακτήρες Δυτικής Ευρώπης:

• AàáâäàÀÁÂÄBCçÇDEèéêëÈÉÉÊËFGHIííïïÌÍÌÍNÑNñÑOóóöÖÓÓÓÓÓNÖPQRSTUúüüÜÚÜÚÜÜWXYýÝZøåÅØÅ
• aaaaaaaaaaabcccdeeeeeeeeeeefiiiiiiiiiiijklmnnnooooooooooopqrstuuuuuwyyz~♦Ç~♦Ç~♦Ç

Για λειτουργικότητα συμβατή με Unicode, χρησιμοποιήστε τη διασύνδεση προγραμματισμού εφαρμογών Win32 LCMapString (API) μέσω των κλάσεων DLL και DLLFunc .

Παράδειγμα

Το παρακάτω παράδειγμα εμφανίζει abcdeabcde.

    static void strColSeqExample(Args _arg)
    {
            ;
            print strColSeq("");
            pause;
    }

strDel

Δημιουργεί ένα αντίγραφο μιας συμβολοσειράς, από την οποία καταργείται η καθορισμένη δευτερεύουσα συμβολοσειρά.

str strDel(str _text, int _position, int _number)

Παράμετροι

Παράμετρος	Περιγραφή
_Κείμενο	Η συμβολοσειρά από την οποία θα γίνει αντιγραφή.
_θέση	Η θέση στην οποία θα αρχίσετε να παραβλέπετε χαρακτήρες κατά τη λειτουργία αντιγραφής.
_αριθμός	Ο αριθμός χαρακτήρων που θα αγνοηθούν. Ένα σύμβολο μείον μπροστά από την παράμετρο _number υποδεικνύει ότι _number-1 χαρακτήρες πριν από τον χαρακτήρα στη _position θα πρέπει να καταργηθούν μαζί με τον χαρακτήρα κατά _position.

Επιστρεφόμενη αξία

Οι υπόλοιποι χαρακτήρες που αντιγράφονται από τη συμβολοσειρά.

Παρατηρήσεις

Η συνάρτηση strDel είναι συμπληρωματική της συνάρτησης δευτερεύουσας συμβολοσειράς .

strDel("ABCDEFGH",2,3); //Returns the string "AEFGH".
strDel("ABCDEFGH",4,3); //Returns the string "ABCGH".

strFind

Αναζητά μια συμβολοσειρά για την πρώτη εμφάνιση ενός από τους καθορισμένους χαρακτήρες.

int strFind(str _text, str _characters, int _position, int _number)

Παράμετροι

Παράμετρος	Περιγραφή
_Κείμενο	Η συμβολοσειρά προς αναζήτηση.
_Χαρακτήρες	Οι χαρακτήρες για αναζήτηση.
_θέση	Η θέση στη συμβολοσειρά όπου ξεκινά η αναζήτηση.
_αριθμός	Ένας υπογεγραμμένη αριθμός που υποδεικνύει την κατεύθυνση της αναζήτησης και πόσες θέσεις για αναζήτηση στη συμβολοσειρά.

Επιστρεφόμενη αξία

Η τιμή της θέσης της πρώτης εμφάνισης ενός από τους καθορισμένους χαρακτήρες ή 0 όταν δεν βρέθηκε κανένας.

Παρατηρήσεις

Για να κάνετε αναζήτηση από την αρχή της συμβολοσειράς μέχρι το τέλος, χρησιμοποιήστε το 1 ως την τιμή της παραμέτρου _position . Εάν η τιμή της παραμέτρου _number είναι αρνητική, το σύστημα αναζητά τον αριθμό χαρακτήρων προς τα πίσω από την καθορισμένη θέση. Η αναζήτηση δεν κάνει διάκριση πεζών-κεφαλαίων. Εδώ είναι ένα παράδειγμα.

strFind("ABCDEFGHIJ","KHD",1,10); //Returns the value 4 (the position where "D" was found).
strFind("ABCDEFGHIJ","KHD",10,-10); //Returns the value 8 (the position where "H" was found).

Η συνάρτηση strFind είναι συμπληρωματική της συνάρτησης strNFind .

strFmt

Μορφοποιεί την καθορισμένη συμβολοσειρά και αντικαθιστά οποιεσδήποτε εμφανίσεις του n με το όρισμα nth.

str strFmt(str _string, ...)

Παράμετροι

Παράμετρος	Περιγραφή
_σειρά	Οι συμβολοσειρές για μορφοποίηση.

Επιστρεφόμενη αξία

Η μορφοποιημένη συμβολοσειρά.

Παρατηρήσεις

Εάν δεν παρέχεται όρισμα για μια παράμετρο, η παράμετρος επιστρέφει ως "%n" στη συμβολοσειρά. Η μετατροπή συμβολοσειρών τιμών πραγματικού τύπου περιορίζεται σε δύο δεκαδικά ψηφία. Οι τιμές στρογγυλοποιούνται, δεν περικόπτονται. Η μέθοδος System.String::Format από το Microsoft .NET Framework μπορεί να χρησιμοποιηθεί για να αποκτήσετε περισσότερες λειτουργίες, όπως φαίνεται στο παράδειγμα.

Παράδειγμα

static void strFmtExampleJob(Args _arg)
{
    System.Double sysDouble;
    real r = 8.3456789;
    int  i = 42;
    utcDateTime utc = str2DateTime("2008-01-16 13:44:55" ,321); // 321 == YMD.
    str  s;
    ;
    s = strFmt("real = %1, int = %2, utcDateTime = %3, [%4]", r, i, utc);
    info("X1:  " + s);
    //
    sysDouble = r;
    s = System.String::Format("{0:##.####}", sysDouble);
    info("N1:  " + s);
    //
    s = System.String::Format("{0,6:C}", sysDouble); // $
    info("N2:  " + s);
    /**********  Actual Infolog output
    Message (02:16:05 pm)
    X1:  real = 8.35, int = 42, utcDateTime = 1/16/2008 01:44:55 pm, [%4]
    N1:  8.3457
    N2:   $8.35
    **********/
}

Συμβολοσειρά

Δημιουργεί μια συμβολοσειρά εισάγοντας μία συμβολοσειρά σε μια άλλη.

str strIns(str _text1, str _text2, int _position)

Παράμετροι

Παράμετρος	Περιγραφή
_text1	Η συμβολοσειρά στην οποία θα εισαχθεί η άλλη συμβολοσειρά.
_text2	Η συμβολοσειρά για εισαγωγή στην άλλη συμβολοσειρά.
_θέση	Η θέση όπου εμφανίζεται ο πρώτος χαρακτήρας της παραμέτρου _text2 στη συμβολοσειρά εξόδου.

Επιστρεφόμενη αξία

Η συνδυασμένη συμβολοσειρά κειμένου.

Παρατηρήσεις

Η συνάρτηση strIns είναι συμπληρωματική της συνάρτησης strDel . Εάν η τιμή της παραμέτρου _position είναι μεγαλύτερη από το μήκος της αρχικής συμβολοσειράς, η συμβολοσειρά που θα εισαχθεί προσαρτάται στο τέλος της αρχικής συμβολοσειράς.

strIns("ABFGH","CDE",3); //Returns the string "ABCDEFGH".
strIns("ABCD","EFGH",10); //Returns the string "ABCDEFGH".

strKeep

Δημιουργεί μια συμβολοσειρά χρησιμοποιώντας μόνο τους χαρακτήρες από την πρώτη συμβολοσειρά εισόδου που καθορίζει η δεύτερη συμβολοσειρά εισόδου, θα πρέπει να διατηρούνται.

str strKeep(str _text1, str _text2)

Παράμετροι

Παράμετρος	Περιγραφή
_text1	Η συμβολοσειρά που περιέχει τους χαρακτήρες που μπορούν να χρησιμοποιηθούν για τη δημιουργία μιας συμβολοσειράς εξόδου.
_text2	Η συμβολοσειρά που καθορίζει τους χαρακτήρες που θα διατηρούνται για τη συμβολοσειρά εξόδου.

Επιστρεφόμενη αξία

Μια συμβολοσειρά των χαρακτήρων που διατηρούνται.

Παρατηρήσεις

strKeep("ABBCDDEFGHB","BCD"); //Returns the string "BBCDDB".
strKeep("abcZcba","bc") //Returns the string "bccb".

Η συνάρτηση strKeep είναι συμπληρωματική της συνάρτησης strRem .

strLen

Υπολογίζει το μήκος της καθορισμένης συμβολοσειράς.

int strLen(str text)

Παράμετροι

Παράμετρος	Περιγραφή
κείμενο	Η συμβολοσειρά στην οποία θα υπολογιστεί το μήκος.

Επιστρεφόμενη αξία

Το μήκος της καθορισμένης συμβολοσειράς.

Παρατηρήσεις

strLen("ABC"); //Returns the value 3.
strLen("ABCDEFGHIJ"); //Returns the value 10.

συμβολοσειρά

Ανακτά μια μοναδική γραμμή από μια συμβολοσειρά που εκτείνεται σε πολλές γραμμές.

str strLine(str string, int count)

Παράμετροι

Παράμετρος	Περιγραφή
string	Μια συμβολοσειρά που μπορεί να εκτείνεται σε πολλές γραμμές.
μετρώ	Η μετατόπιση της γραμμής προς επιστροφή.

Επιστρεφόμενη αξία

Μια αντιγραμμένη γραμμή της συμβολοσειράς που καθορίζεται από την παράμετρο συμβολοσειράς .

Παρατηρήσεις

Η πρώτη γραμμή της συμβολοσειράς έχει μετατόπιση 0. Μπορείτε να αντιστοιχίσετε πολλές γραμμές σε μία συμβολοσειρά, ενσωματώνοντας τους \n ή \r\n χαρακτήρες στη συμβολοσειρά. Επιπλέον, μπορείτε να χρησιμοποιήσετε το σύμβολο (@) αμέσως πριν από το εισαγωγικό ανοίγματος και να χρησιμοποιήσετε το πλήκτρο Enter για να διανείμετε τμήματα της τιμής συμβολοσειράς σε πολλές γραμμές στο πρόγραμμα επεξεργασίας κώδικα X++.

Παράδειγμα

str mytxt = "first-line\nsecond-line\nlast-line";
// Prints "second-line".
print strLine(mytxt,1);
// Prints "last-line".
print strLine(mytxt,2);            

strLTrim

Καταργεί τα αρχικά κενά από μια συμβολοσειρά κειμένου.

str strLTrim(str text)

Παράμετροι

Παράμετρος	Περιγραφή
κείμενο	Η συμβολοσειρά από την οποία θα διαγραφούν τα αρχικά κενά.

Επιστρεφόμενη αξία

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

Παρατηρήσεις

Η συνάρτηση strLTrim είναι συμπληρωματική της συνάρτησης strRTrim .

Παράδειγμα

// Returns the text string "ABC-DEFG".
strLTrim("   ABC-DEFG");

συμβολοσειρά

Μετατρέπει όλα τα γράμματα της καθορισμένης συμβολοσειράς σε πεζά.

str strLwr(str _text)

Παράμετροι

Παράμετρος	Περιγραφή
_Κείμενο	Η συμβολοσειρά προς μετατροπή σε πεζά.

Επιστρεφόμενη αξία

Ένα αντίγραφο της καθορισμένης συμβολοσειράς που περιέχει μόνο πεζά γράμματα.

Παρατηρήσεις

Η συνάρτηση strLwr είναι συμπληρωματική της συνάρτησης strUpr . Η συνάρτηση strLwr χρησιμοποιεί τη συνάρτηση LCMapString στο API Win32.

Παράδειγμα

static void strLwrExample(Args _args)
{
    // Returns the text string "abcdd55efghij".
    print strLwr("Abcdd55EFGHIJ");
    pause;
}

strNFind

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

int strNFind(str _text, str _characters, int _position, int _number)

Παράμετροι

Παράμετρος	Περιγραφή
_Κείμενο	Η συμβολοσειρά κειμένου προς αναζήτηση.
_Χαρακτήρες	Η λίστα χαρακτήρων που θα εξαιρεθούν από την αναζήτηση.
_θέση	Η θέση στη συμβολοσειρά από την οποία θα ξεκινήσει η αναζήτηση.
_αριθμός	Ένας υπογεγραμμένη αριθμός που υποδεικνύει την κατεύθυνση της αναζήτησης και πόσες θέσεις για αναζήτηση. Εάν ένα σύμβολο μείον προηγείται _number, το σύστημα αναζητά χαρακτήρες _number σε αντίστροφη σειρά από _position.

Επιστρεφόμενη αξία

Η θέση της πρώτης εμφάνισης ενός χαρακτήρα που δεν καθορίζεται από την παράμετρο _characters ή 0 όταν δεν βρέθηκε κανένας.

Παρατηρήσεις

Η αναζήτηση δεν κάνει διάκριση πεζών-κεφαλαίων. Για να κάνετε αναζήτηση από την αρχή της συμβολοσειράς μέχρι το τέλος, χρησιμοποιήστε την τιμή 1 για την παράμετρο _position . Εάν ένα σύμβολο μείον προηγείται της τιμής της παραμέτρου _number , η αναζήτηση των χαρακτήρων γίνεται με αντίστροφη σειρά, ξεκινώντας από τη θέση που καθορίζεται από την παράμετρο _position .

strNFind("ABCDEFGHIJ","ABCDHIJ",1,10); //Returns the value 5 (the position of "E");
strNFind("CDEFGHIJ","CDEFGIJ",10,-10); //Returns the value 6 (the position of "H").
strNFind("abcdef","abCdef",3,2) //Returns the value 0.
strNFind("abcdef", "abcef",3,2) //Returns the value 4.

Η συνάρτηση strNFind είναι συμπληρωματική της συνάρτησης strFind .

strPoke

Αντικαθιστά μέρος μιας συμβολοσειράς με μια άλλη συμβολοσειρά.

str strPoke(str _text1, str _text2, int _position)

Παράμετροι

Παράμετρος	Περιγραφή
_text1	Η αρχική συμβολοσειρά.
_text2	Η συμβολοσειρά με την οποία θα αντικατασταθεί μέρος της αρχικής συμβολοσειράς.
_θέση	Η θέση της αρχικής συμβολοσειράς στην οποία θα ξεκινήσει η αντικατάσταση των χαρακτήρων.

Επιστρεφόμενη αξία

Η νέα συμβολοσειρά.

Παρατηρήσεις

Η νέα συμβολοσειρά μπορεί να είναι μεγαλύτερη από την αρχική συμβολοσειρά. Ωστόσο, εάν η τιμή της παραμέτρου _position είναι μεγαλύτερη από το μήκος της συμβολοσειράς, η αρχική συμβολοσειρά επιστρέφεται χωρίς αντικαταστάσεις.

strPoke("12345678","AAA",3); //Returns the string "12AAA678".
strPoke("abcde","4567",4); //Returns the string "abc4567".
strPoke("abcde", "4567", "10"); //Returns the string "abcde".

strPrompt

Προσαρτά μια συμβολοσειρά με τον καθορισμένο αριθμό χαρακτήρων περιόδου, ακολουθούμενο από άνω και κάτω τελεία και χαρακτήρα διαστήματος.

str strPrompt(str _string, _int len)

Παράμετροι

Παράμετρος	Περιγραφή
_σειρά	Η αρχική συμβολοσειρά.
_len	Το επιθυμητό τελικό μήκος της συμβολοσειράς.

Επιστρεφόμενη αξία

Μια συμβολοσειρά που μοιάζει με προτροπή για εισαγωγή από τον χρήστη.

Παρατηρήσεις

Σε άτυπες περιπτώσεις, όπου η τιμή της παραμέτρου _len είναι ελαφρώς μεγαλύτερη από το μήκος της αρχικής συμβολοσειράς, δίνεται η υψηλότερη προτεραιότητα στην προσθήκη του χώρου στο τέλος. Στη συνέχεια, δίνεται προτεραιότητα στην άνω και κάτω τελεία. Η χαμηλότερη προτεραιότητα δίνεται στις περιόδους. Οι αρνητικές τιμές για την παράμετρο _len επιστρέφουν τη συμβολοσειρά εισόδου προσαρτημένη με τελικό χώρο.

strPrompt("ab",-1); //Returns "ab ".
strPrompt("ab",3); //Returns "ab ".
strPrompt("ab",4); //Returns "ab: ".
strPrompt("ab",5); //Returns "ab.: ".
strPrompt("ab",6); //Returns "ab..: ".

Παράδειγμα

static void JobStrPromptDemo(Args _args)
{
    // Printed string is "[abc..: ]"
    print "[", strPrompt("abc", 7), "]";
    pause;
}

strRem

Καταργεί τους χαρακτήρες που καθορίζονται σε μία συμβολοσειρά από μια άλλη συμβολοσειρά.

str strRem(str text1, str text2)

Παράμετροι

Παράμετρος	Περιγραφή
text1	Η συμβολοσειρά από την οποία θα καταργηθούν χαρακτήρες.
text2	Οι χαρακτήρες που θα εξαιρεθούν από τη συμβολοσειρά εξόδου.

Επιστρεφόμενη αξία

Το υπόλοιπο περιεχόμενο της αρχικής συμβολοσειράς.

Παρατηρήσεις

Αυτή η λειτουργία κάνει διάκριση πεζών-κεφαλαίων.

strRem("abcd_abcd","Bc"); //Returns the string "abd_abd".
strRem("ABCDEFGABCDEFG","ACEG"); //Returns the string "BDFBDF".

Αυτή η συνάρτηση είναι συμπληρωματική με τη συνάρτηση strKeep .

strRep

Επαναλαμβάνει μια συμβολοσειρά χαρακτήρων.

str strRep(str _text, str _number)

Παράμετροι

Παράμετρος	Περιγραφή
_Κείμενο	Η συμβολοσειρά προς επανάληψη.
_αριθμός	Ο αριθμός των φορών που θα επαναληφθεί η συμβολοσειρά.

Επιστρεφόμενη αξία

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

Παράδειγμα

Το παρακάτω παράδειγμα εμφανίζει τη συμβολοσειρά κειμένου ABABABABAB.

static void strRepExample(Args _arg)
{
    str strL;
    ;
    strL = strRep("AB",6);
    print strL;
    pause;
}

strRTrim

Καταργεί τους χαρακτήρες διαστήματος που ακολουθούν από το τέλος μιας συμβολοσειράς.

str strRTrim(str _text)

Παράμετροι

Παράμετρος	Περιγραφή
_Κείμενο	Η συμβολοσειρά από την οποία θα καταργηθούν οι χαρακτήρες διαστήματος που ακολουθούν.

Επιστρεφόμενη αξία

Ένα αντίγραφο της καθορισμένης συμβολοσειράς που δεν περιλαμβάνει χαρακτήρες διαστήματος που ακολουθούν.

Παρατηρήσεις

strRTrim("ABC-DEFG- "); //Returns the string "ABC-DEFG-".
strRTrim(" CD "); //Returns " CD".

Η συνάρτηση strRTrim είναι συμπληρωματική της συνάρτησης strLTrim .

strScan

Αναζητά μια συμβολοσειρά κειμένου για μια εμφάνιση μιας άλλης συμβολοσειράς.

int strScan(str _text1, str _text2, int _position, int _number)

Παράμετροι

Παράμετρος	Περιγραφή
_text1	Η συμβολοσειρά στην οποία θα γίνει η αναζήτηση.
_text2	Η συμβολοσειρά προς εύρεση.
_θέση	Η πρώτη θέση στην παράμετρο _text1 για την εκτέλεση μιας σύγκρισης.
_αριθμός	Ο αριθμός θέσεων στην παράμετρο _text1 για επανάληψη της σύγκρισης. Εάν ένα σύμβολο μείον προηγείται της παραμέτρου _number , το σύστημα αναζητά τον αριθμό χαρακτήρων σε αντίστροφη σειρά από την καθορισμένη θέση.

Επιστρεφόμενη αξία

Η θέση στην οποία βρέθηκε η καθορισμένη συμβολοσειρά στη συμβολοσειρά. διαφορετικά, 0 (μηδέν).

Παρατηρήσεις

Οι συγκρίσεις δεν κάνουν διάκριση πεζών-κεφαλαίων. Οι τιμές για την παράμετρο _position που είναι μικρότερες από 1 αντιμετωπίζονται ως 1. Η κατεύθυνση της σάρωσης ελέγχεται από το πρόσημο που καθορίζεται στην παράμετρο _number . Ένα θετικό πρόσημο υποδεικνύει ότι κάθε διαδοχική σύγκριση ξεκινά μία θέση πιο κοντά στο τέλος της συμβολοσειράς. Ένα αρνητικό πρόσημο υποδεικνύει ότι κάθε σύγκριση ξεκινά μία θέση πιο κοντά στην αρχή της συμβολοσειράς.

strScan("ABCDEFGHIJ","DEF",1,10); //Returns the value 4.
strScan ("ABCDEFGHIJ","CDE",10,-10); //Returns the value 3.

strUpr

Μετατρέπει όλα τα γράμματα μιας συμβολοσειράς σε κεφαλαία.

str strUpr(str _text)

Παράμετροι

Παράμετρος	Περιγραφή
_Κείμενο	Η συμβολοσειρά προς μετατροπή σε κεφαλαία γράμματα.

Επιστρεφόμενη αξία

Ένα αντίγραφο της καθορισμένης συμβολοσειράς που περιέχει μόνο πεζά γράμματα.

Παρατηρήσεις

Η συνάρτηση strUpr είναι συμπληρωματική της συνάρτησης strLwr . Η συνάρτηση strUpr χρησιμοποιεί τη συνάρτηση LCMapString() στο API Win32.

Παράδειγμα

Το παρακάτω παράδειγμα εμφανίζει ABCDD55EFGHIJ.

static void strUprExample(Args _args)
{
    print strUpr("Abcdd55EFGhiJ");
    pause;
}

δευτερεύουσα συμβολοσειρά

Ανακτά μέρος μιας συμβολοσειράς.

str subStr(str _text, int _position, int _number)

Παράμετροι

Παράμετρος	Περιγραφή
_Κείμενο	Η αρχική συμβολοσειρά.
_θέση	Η θέση στην αρχική συμβολοσειρά όπου ξεκινά το τμήμα προς ανάκτηση.
_αριθμός	Ένας υπογεγραμμένη ακέραιος που υποδεικνύει την κατεύθυνση και τον αριθμό των θέσεων για ανάκτηση από την αρχική συμβολοσειρά. Εάν ένα σύμβολο μείον προηγείται _number, το σύστημα επιλέγει τη δευτερεύουσα συμβολοσειρά προς τα πίσω από την καθορισμένη θέση.

Επιστρεφόμενη αξία

Μια δευτερεύουσα συμβολοσειρά της αρχικής συμβολοσειράς.

Παρατηρήσεις

Εάν ένα σύμβολο μείον προηγείται της τιμής της παραμέτρου _number , η δευτερεύουσα συμβολοσειρά επιλέγεται προς τα πίσω από την καθορισμένη θέση.

subStr("ABCDEFGHIJ",3,5); //Returns the string "CDEFG".
subStr("ABCDEFGHIJ",7,-4); //Returns the string "DEFG".
subStr("abcdef",2,99) //Returns the string "bcdef".
subStr("abcdef",2,3) //Returns the string "bcd".
subStr("abcdef",2,-3); //Returns the string "ab".

strContains

Ελέγχει εάν η συμβολοσειρά κειμένου περιέχει μια άλλη συμβολοσειρά.

boolean strContains(str _text, str _potentialContains)

Παράμετροι

Παράμετρος	Περιγραφή
_Κείμενο	Η αρχική συμβολοσειρά στην οποία θα γίνει η αναζήτηση.
_potentialContains	Η συμβολοσειρά προς εύρεση.

Επιστρεφόμενη αξία

True εάν η αρχική συμβολοσειρά περιέχει τη συμβολοσειρά στην οποία έγινε αναζήτηση. διαφορετικά, false.

Παρατηρήσεις

Οι συγκρίσεις δεν κάνουν διάκριση πεζών-κεφαλαίων.

strContains("ABCDEFGHIJ","abc"); //Returns true.
strContains("ABCDEFGHIJ","ABC"); //Returns true.
strContains("ABCDEFGHIJ","K"); //Returns false.

strStartsWith

Ελέγχει εάν η συμβολοσειρά κειμένου ξεκινά με μια άλλη συμβολοσειρά.

boolean strStartsWith(str _string, str _potentialStart)

Παράμετροι

Παράμετρος	Περιγραφή
_σειρά	Η αρχική συμβολοσειρά στην οποία θα γίνει η αναζήτηση.
_potentialStart	Η πιθανή συμβολοσειρά που βρίσκεται στην αρχή.

Επιστρεφόμενη αξία

True εάν η πιθανή συμβολοσειρά είναι η αρχή της αρχικής συμβολοσειράς. διαφορετικά, false.

Παρατηρήσεις

Οι συγκρίσεις δεν κάνουν διάκριση πεζών-κεφαλαίων.

strStartsWith("ABCDEFGHIJ","abc"); //Returns true.
strStartsWith("ABCDEFGHIJ","ABC"); //Returns true.
strStartsWith("ABCDEFGHIJ","B"); //Returns false.

strEndsWith

Ελέγχει εάν η συμβολοσειρά κειμένου τελειώνει με άλλη συμβολοσειρά.

boolean strEndsWith(str _string, str _potentialEnd)

Παράμετροι

Παράμετρος	Περιγραφή
_σειρά	Η αρχική συμβολοσειρά στην οποία θα γίνει η αναζήτηση.
_potentialEnd	Η πιθανή συμβολοσειρά που βρίσκεται στο τέλος.

Επιστρεφόμενη αξία

True εάν η πιθανή συμβολοσειρά τερματίζει την αρχική συμβολοσειρά. διαφορετικά, false.

Παρατηρήσεις

Οι συγκρίσεις δεν κάνουν διάκριση πεζών-κεφαλαίων.

strEndsWith("ABCDEFGHIJ","ghij"); //Returns true.
strEndsWith("ABCDEFGHIJ","HIJ"); //Returns true.
strEndsWith("ABCDEFGHIJ","B"); //Returns false.

strLRTrim

Καταργεί τα αρχικά και τα κενά σε ουρά από μια συμβολοσειρά κειμένου.

str strLRTrim(str text)

Παράμετροι

Παράμετρος	Περιγραφή
κείμενο	Η συμβολοσειρά από την οποία θα διαγραφούν τα αρχικά και τα κενά ουράς.

Επιστρεφόμενη αξία

Ένα αντίγραφο της καθορισμένης συμβολοσειράς που δεν περιλαμβάνει αρχικούς και κορυφαίους χαρακτήρες διαστήματος.

Παρατηρήσεις

Η συνάρτηση strLRTrim είναι συμπληρωματική με τις συναρτήσεις strRTrim και strLTrim .

Παράδειγμα

// Returns the text string "ABC-DEFG".
strLRTrim("   ABC-DEFG   ");