X++-runtimefuncties tekenreeks

Opmerking

Community-belangengroepen zijn nu verplaatst van Yammer naar Microsoft Viva Engage. Als u wilt deelnemen aan een Viva Engage-community en deel wilt nemen aan de meest recente discussies, vult u het formulier Toegang aanvragen tot Finance and Operations Viva Engage Community in en kiest u de community waaraan u wilt deelnemen.

In dit artikel worden de runtimefuncties voor tekenreeksen beschreven.

lucifer

Zoekt naar een tekenreeks of expressie in een andere tekenreeks.

int match(str pattern, str text)

Parameterwaarden

Kenmerk	Description
pattern	De tekenreeks of expressie die u zoekt.
Tekst	De tekenreeks die moet worden gezocht.

Retourwaarde

1 als het patroon zich in de tekenreeks bevindt; anders , 0 (nul).

Opmerkingen

De zoekopdracht is niet hoofdlettergevoelig. De volgende speciale tekens kunnen worden gebruikt om het patroon voor de patroonparameter te maken.

• \: Een backslash (\) nullifeert, of escapen, de speciale behandeling van speciale tekens, zodat een speciaal teken kan worden vergeleken als een normale letter. Een paar backslashes wordt omgezet in één niet-speciale backslash. Examples:

  • match("ab$cd","ab$cd"); retourneert 0.
  • match("ab\$cd","ab$cd"); retourneert 0. De backslash is niet ontsnapt.
  • match("ab\\$cd","ab$cd"); retourneert 1. Het backslash- en dollarteken zijn ontsnapt.

• < of ^: Een haakje links () of een omtrek (<^) aan het begin van een expressie wordt gebruikt om het begin van een lijn te vinden. Examples:

  • match("<abc","abcdef"); retourneert 1.
  • match("<abc","defabc"); retourneert 0.
  • match("^abc","abcdef"); retourneert 1.
  • match("^abc","defabc"); retourneert 0.

• > of $: Aan het einde van de expressie wordt een rechte hoekhaak (>) of een dollarteken ($) gebruikt om het einde van een regel te vinden. Examples:

  • match("abc>","abcdef"); retourneert 0.
  • match("abc>","defabc"); retourneert 1.

• ? of.: Een vraagteken (?) of een punt (.) komt overeen met een willekeurig teken in dezelfde positie. Examples:

  • match("abc.def","abc#def"); retourneert 1.
  • match("colou?r","colouXr"); retourneert 1.

• :x: Met een dubbele punt (:) wordt een groep tekens opgegeven die moeten overeenkomen, zoals aangegeven door het teken dat direct volgt.

• :a: Hiermee stelt u de overeenkomst in op letters. Examples:

  • match("ab:acd","ab#cd"); retourneert 0.
  • match("ab:acd","abxyzcd"); retourneert 0.
  • match("ab:acd","abxcd"); retourneert 1.

• :d: Hiermee stelt u de overeenkomst in op numerieke tekens. Examples:

  • match("ab:dcd","ab3cd"); retourneert 1.
  • match("ab:dcd","ab123cd"); retourneert 0.
  • match("ab:dcd","abcd"); retourneert 0.

• :n: Hiermee stelt u de overeenkomst in op alfanumerieke tekens. Examples:

  • match("ab:ncd";"ab%cd"); retourneert 0.
  • match("ab:ncd","ab9cd"); retourneert 1.
  • match("ab:ncd","abXcd"); retourneert 1.

• :SPATIE: SPATIE is het spatieteken (" "). Hiermee stelt u de overeenkomst in op lege waarden, tabulaties en besturingstekens zoals Enter (nieuwe regel). Examples:

  • match("ab: cd","ab cd"); retourneert 1.
  • match("ab: cd","ab\ncd"); retourneert 1.
  • match("ab: cd","ab\tcd"); retourneert 1.
  • match("ab: cd","ab cd"); retourneert 0. Alleen de eerste spatie komt overeen.

• *: voor een expressie die wordt gevolgd door een sterretje ('*') is een overeenkomst vereist voor nul, een of meer exemplaren van de voorgaande expressie. Examples:

  • match("abc*d","abd"); retourneert 1.
  • match("abc*d","abcd"); retourneert 1.
  • match("abc*d","abcccd"); retourneert 1.
  • match("abc*d","abxd"); retourneert 0.

• +: Voor een expressie die wordt gevolgd door een plusteken (+) is een overeenkomst vereist voor een of meer exemplaren van de voorgaande expressie. Examples:

  • match("abc+d","abd"); retourneert 0.
  • match("abc+d","abcd"); retourneert 1
  • match("abc+d","abcccd"); retourneert 1.
  • match("abc+d","abxd"); retourneert 0.

• -: Voor een expressie die wordt gevolgd door een minteken (-) is een overeenkomst vereist voor nul of één exemplaar van de voorgaande expressie. Met andere woorden, de voorgaande expressie is optioneel. Examples:

  • match("colou-r","color"); retourneert 1.
  • match("colou-r","colour"); retourneert 1.

• []: Komt overeen met één teken met een willekeurig teken dat tussen de vierkante haken staat. Een bereik met tekens kan worden opgegeven door twee tekens, gescheiden door een minteken (-). [a-z] komt bijvoorbeeld overeen met alle letters tussen a en z, [0-9] komt overeen met een cijfer en [0-9a-f] komt overeen met een hexadecimaal cijfer. Examples:

  • match("[abc]","apple"); retourneert 1, omdat deze overeenkomt met de a in 'appel'.
  • match("[abc]","error"); retourneert 0, omdat 'kiwi' geen a, b of c bevat.
  • match("gr[ae]y","grey"); retourneert 1. Deze expressie komt ook overeen met 'grijs'.
  • match("gr[ae]y","graey"); retourneert 0, omdat er slechts één teken tussen 'gr' en 'y' overeenkomt.

• [^]: Als het eerste teken in de tekst tussen vierkante haken een omtrek^ () is, komt de expressie overeen met alle tekens, behalve de tekens die tussen de haakjes staan. Examples:

  • match("[^bc]at","bat"); retourneert 0.
  • match("[^bc]at","hat"); retourneert 1.
  • match("[^abc]","bat"); retourneert 1. Alles behalve a, b of c komt overeen. Daarom komt de t overeen.

strAlpha

Hiermee worden alleen de alfanumerieke tekens uit een tekenreeks gekopieerd.

str strAlpha(str _text)

Parameterwaarden

Kenmerk	Description
_Sms	De tekenreeks waaruit moet worden gekopieerd.

Retourwaarde

Een nieuwe tekenreeks die alle alfanumerieke tekens uit de opgegeven tekenreeks bevat.

Opmerkingen

StrAlpha("2+2=5 is dit juist?") retourneert bijvoorbeeld de tekenreeks 225isthiscorrect.

Example

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

strCmp

Vergelijkt twee tekenreeksen.

int strCmp(str text1, str text2)

Parameterwaarden

Kenmerk	Description
tekst1	De eerste tekenreeks.
tekst2	De tweede tekenreeks.

Retourwaarde

0 als de twee tekenreeksen identiek zijn, 1 als de eerste tekenreeks eerder sorteert of -1 als de tweede tekenreeks eerder sorteert.

Opmerkingen

De vergelijking die door deze methode wordt uitgevoerd, is hoofdlettergevoelig.

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

Converteert alle hoofdletters naar kleine letters en converteert alle tekens met accenten naar de bijbehorende niet-begeleide kleine letters.

str strColSeq(str text)

Parameterwaarden

Kenmerk	Description
Tekst	De tekenreeks waaruit tekens moeten worden gekopieerd en geconverteerd.

Retourwaarde

De geconverteerde tekenreeks.

Opmerkingen

De strColSeq-functie bestaat voor achterwaartse compatibiliteitsdoeleinden. Deze functie ondersteunt alleen de toewijzing voor de volgende West-Europese tekens:

• AàáâãäÀÁÂÃÄBCçÇDEèéêëÈÉÊËËËËËËFGHIíîïÎÍÎÏJKLMNñÑOòóôõöóÔÕÖPQRSTUúúüÜÚÚÚÚÚÚÚÚÚÚÜWXYýÝZæøÅÅ
• aaaaaaaaaaabcccdeeeeeeeeefghiiiiiiiiijklmnnooooooooopqrstuuuuuuuuuvwxyyz~...Ç~...Ç

Gebruik voor unicode-compatibele functionaliteit de Win32 LCMapString Application Programming Interface (API) via de DLL - en DLLFunc-klassen .

Example

In het volgende voorbeeld wordt abcdeabcde afgedrukt.

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

strDel

Hiermee maakt u een kopie van een tekenreeks waaruit de opgegeven subtekenreeks wordt verwijderd.

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

Parameterwaarden

Kenmerk	Description
_Sms	De tekenreeks waaruit moet worden gekopieerd.
_positie	De positie waar tijdens de kopieerbewerking tekens moeten worden genegeerd.
_getal	Het aantal tekens dat moet worden genegeerd. Een minteken vóór de parameter _number geeft aan dat _number-1 tekens vóór het teken op _position moeten worden verwijderd samen met het teken op _position.

Retourwaarde

De resterende tekens die uit de tekenreeks worden gekopieerd.

Opmerkingen

De strDel-functie is een aanvulling op de subtekenreeksfunctie .

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

strFind

Zoekt in een tekenreeks naar het eerste exemplaar van een van de opgegeven tekens.

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

Parameterwaarden

Kenmerk	Description
_Sms	De tekenreeks die moet worden gezocht.
_karakters	De tekens die moeten worden gezocht.
_positie	De positie in de tekenreeks waar de zoekopdracht begint.
_getal	Een ondertekend getal dat de richting van de zoekopdracht aangeeft en hoeveel posities er in de tekenreeks moeten worden gezocht.

Retourwaarde

De waarde van de positie van het eerste exemplaar van een van de opgegeven tekens of 0 wanneer er geen tekens zijn gevonden.

Opmerkingen

Als u vanaf het begin van de tekenreeks naar het einde wilt zoeken, gebruikt u 1 als de waarde van de parameter _position . Als de waarde van de parameter _number negatief is, doorzoekt het systeem het aantal tekens achterwaarts vanaf de opgegeven positie. De zoekopdracht is niet hoofdlettergevoelig. Dit is een voorbeeld.

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).

De strFind-functie is een aanvulling op de strNFind-functie .

strFmt

Hiermee wordt de opgegeven tekenreeks opgemaakt en worden alle exemplaren van n vervangen door het nde argument.

str strFmt(str _string, ...)

Parameterwaarden

Kenmerk	Description
_snaar	De tekenreeksen die moeten worden opgemaakt.

Retourwaarde

De opgemaakte tekenreeks.

Opmerkingen

Als er geen argument is opgegeven voor een parameter, wordt de parameter geretourneerd als '%n' in de tekenreeks. De tekenreeksconversie van waarden van het werkelijke type is beperkt tot twee decimalen. Waarden worden afgerond, niet afgekapt. De methode System.String::Format van Microsoft .NET Framework kan worden gebruikt om meer functionaliteit te krijgen, zoals wordt weergegeven in het voorbeeld.

Example

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
    **********/
}

strIns

Hiermee wordt een tekenreeks gemaakt door een tekenreeks in te voegen in een andere tekenreeks.

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

Parameterwaarden

Kenmerk	Description
_text1	De tekenreeks waaraan de andere tekenreeks moet worden ingevoegd.
_text2	De tekenreeks die moet worden ingevoegd in de andere tekenreeks.
_positie	De positie waar het eerste teken van de parameter _text2 moet voorkomen in de uitvoertekenreeks.

Retourwaarde

De gecombineerde tekenreeks.

Opmerkingen

De strIns-functie is een aanvulling op de strDel-functie . Als de waarde van de parameter _position groter is dan de lengte van de oorspronkelijke tekenreeks, wordt de in te voegen tekenreeks toegevoegd aan het einde van de oorspronkelijke tekenreeks.

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

strKeep

Hiermee wordt een tekenreeks gemaakt met alleen de tekens uit de eerste invoertekenreeks die door de tweede invoertekenreeks moet worden opgegeven.

str strKeep(str _text1, str _text2)

Parameterwaarden

Kenmerk	Description
_text1	De tekenreeks die de tekens bevat die kunnen worden gebruikt om een uitvoertekenreeks te maken.
_text2	De tekenreeks die aangeeft welke tekens moeten worden bewaard voor de uitvoertekenreeks.

Retourwaarde

Een tekenreeks van de tekens die worden bewaard.

Opmerkingen

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

De strKeep-functie is een aanvulling op de strRem-functie .

strLen

Berekent de lengte van de opgegeven tekenreeks.

int strLen(str text)

Parameterwaarden

Kenmerk	Description
Tekst	De tekenreeks voor het berekenen van de lengte van.

Retourwaarde

De lengte van de opgegeven tekenreeks.

Opmerkingen

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

strLine

Hiermee haalt u één regel op uit een tekenreeks die meerdere regels omvat.

str strLine(str string, int count)

Parameterwaarden

Kenmerk	Description
touw	Een tekenreeks die meerdere regels kan omvatten.
count	De verschuiving van de regel die moet worden geretourneerd.

Retourwaarde

Een gekopieerde regel van de tekenreeks die is opgegeven door de tekenreeksparameter .

Opmerkingen

De eerste regel van de tekenreeks heeft een verschuiving van 0. U kunt meerdere regels aan één tekenreeks toewijzen door de \n of \r\n tekens in de tekenreeks in te sluiten. Daarnaast kunt u het at-teken (@) direct vóór het aanhalingsteken openen gebruiken en de Enter-toets gebruiken om delen van de tekenreekswaarde over meerdere regels in de X++-code-editor te verdelen.

Example

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

strLTrim

Hiermee verwijdert u lege voorlooptekens uit een tekenreeks.

str strLTrim(str text)

Parameterwaarden

Kenmerk	Description
Tekst	De tekenreeks waaruit de voorloop lege waarden moeten worden verwijderd.

Retourwaarde

De tekenreeks die gelijk is aan de tekst waaruit lege voorloopspaties zijn verwijderd.

Opmerkingen

De functie strLTrim is een aanvulling op de strRTrim-functie .

Example

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

strLwr

Converteert alle letters in de opgegeven tekenreeks naar kleine letters.

str strLwr(str _text)

Parameterwaarden

Kenmerk	Description
_Sms	De tekenreeks die moet worden geconverteerd naar kleine letters.

Retourwaarde

Een kopie van de opgegeven tekenreeks die alleen kleine letters bevat.

Opmerkingen

De strLwr-functie is een aanvulling op de strUpr-functie . De strLwr-functie maakt gebruik van de functie LCMapString in de Win32-API.

Example

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

strNFind

Hiermee wordt gezocht naar een deel van een tekenreeks voor het eerste exemplaar van een teken dat niet is opgenomen in de opgegeven lijst met tekens.

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

Parameterwaarden

Kenmerk	Description
_Sms	De tekenreeks die u wilt zoeken.
_karakters	De lijst met tekens die moeten worden uitgesloten van de zoekopdracht.
_positie	De positie in de tekenreeks waarop de zoekopdracht moet worden gestart.
_getal	Een ondertekend getal dat de richting van de zoekopdracht aangeeft en hoeveel posities er moeten worden gezocht. Als een minteken voorafgaat aan _number, zoekt het systeem _number tekens in omgekeerde volgorde van _position.

Retourwaarde

De positie van het eerste exemplaar van een teken dat niet is opgegeven door de parameter _characters of 0 wanneer er geen teken is gevonden.

Opmerkingen

De zoekopdracht is niet hoofdlettergevoelig. Als u vanaf het begin van de tekenreeks naar het einde wilt zoeken, gebruikt u de waarde 1 voor de parameter _position . Als een minteken voorafgaat aan de waarde van de parameter _number , worden de tekens in omgekeerde volgorde doorzocht vanaf de positie die is opgegeven door de parameter _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.

De strNFind-functie is een aanvulling op de strFind-functie .

strPoke

Hiermee overschrijft u een deel van een tekenreeks met een andere tekenreeks.

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

Parameterwaarden

Kenmerk	Description
_text1	De oorspronkelijke tekenreeks.
_text2	De tekenreeks waarmee een deel van de oorspronkelijke tekenreeks moet worden vervangen.
_positie	De positie van de oorspronkelijke tekenreeks waarop de tekens moeten worden vervangen.

Retourwaarde

De nieuwe tekenreeks.

Opmerkingen

De nieuwe tekenreeks kan langer zijn dan de oorspronkelijke tekenreeks. Als de waarde van de parameter _position echter groter is dan de lengte van de tekenreeks, wordt de oorspronkelijke tekenreeks geretourneerd zonder vervangingen.

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

Voegt een tekenreeks toe met het opgegeven aantal punttekens, gevolgd door een dubbele punt en een spatieteken.

str strPrompt(str _string, _int len)

Parameterwaarden

Kenmerk	Description
_snaar	De oorspronkelijke tekenreeks.
_Len	De gewenste uiteindelijke lengte van de tekenreeks.

Retourwaarde

Een tekenreeks die lijkt op een prompt voor gebruikersinvoer.

Opmerkingen

In atypische gevallen, waarbij de waarde van de parameter _len slechts iets meer is dan de lengte van de oorspronkelijke tekenreeks, krijgt de hoogste prioriteit om de volgruimte toe te voegen. Vervolgens krijgt de dubbele punt voorrang. De laagste prioriteit wordt gegeven aan de perioden. Negatieve waarden voor de parameter _len retourneren de invoertekenreeks die is toegevoegd met een volgruimte.

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..: ".

Example

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

strRem

Hiermee verwijdert u de tekens die zijn opgegeven in de ene tekenreeks uit een andere tekenreeks.

str strRem(str text1, str text2)

Parameterwaarden

Kenmerk	Description
tekst1	De tekenreeks waaruit tekens moeten worden verwijderd.
tekst2	De tekens die moeten worden uitgesloten van de uitvoertekenreeks.

Retourwaarde

De resterende inhoud van de oorspronkelijke tekenreeks.

Opmerkingen

Deze functie is hoofdlettergevoelig.

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

Deze functie is een aanvulling op de strKeep-functie .

strRep

Hiermee wordt een tekenreeks herhaald.

str strRep(str _text, str _number)

Parameterwaarden

Kenmerk	Description
_Sms	De tekenreeks die moet worden herhaald.
_getal	Het aantal keren dat de tekenreeks moet worden herhaald.

Retourwaarde

Een nieuwe tekenreeks die de inhoud van de oorspronkelijke tekenreeks bevat die het opgegeven aantal keren wordt herhaald.

Example

In het volgende voorbeeld wordt de tekenreeks ABABABABABAB afgedrukt.

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

strRTrim

Hiermee verwijdert u de afsluitende spatietekens van het einde van een tekenreeks.

str strRTrim(str _text)

Parameterwaarden

Kenmerk	Description
_Sms	De tekenreeks waaruit de volgspaties moeten worden verwijderd.

Retourwaarde

Een kopie van de opgegeven tekenreeks die geen volgruimtetekens bevat.

Opmerkingen

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

De strRTrim-functie is een aanvulling op de strLTrim-functie .

strScan

Zoekt in een tekenreeks naar een exemplaar van een andere tekenreeks.

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

Parameterwaarden

Kenmerk	Description
_text1	De tekenreeks waarin moet worden gezocht.
_text2	De tekenreeks die moet worden gevonden.
_positie	De eerste positie in de _text1 parameter waarop een vergelijking moet worden uitgevoerd.
_getal	Het aantal posities in de parameter _text1 om de vergelijking opnieuw uit te voeren. Als een minteken voorafgaat aan de parameter _number , doorzoekt het systeem het aantal tekens in omgekeerde volgorde vanaf de opgegeven positie.

Retourwaarde

De positie waarop de opgegeven tekenreeks is gevonden in de tekenreeks; anders , 0 (nul).

Opmerkingen

De vergelijkingen zijn niet hoofdlettergevoelig. Waarden voor de parameter _position die kleiner zijn dan 1 , worden behandeld als 1. De richting van de scan wordt bepaald door het teken dat is opgegeven in de parameter _number . Een positief teken geeft aan dat elke opeenvolgende vergelijking één positie dichter bij het einde van de tekenreeks begint. Een negatief teken geeft aan dat elke vergelijking één positie dichter bij het begin van de tekenreeks begint.

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

strUpr

Converteert alle letters in een tekenreeks naar hoofdletters.

str strUpr(str _text)

Parameterwaarden

Kenmerk	Description
_Sms	De tekenreeks die moet worden geconverteerd naar hoofdletters.

Retourwaarde

Een kopie van de opgegeven tekenreeks die alleen kleine letters bevat.

Opmerkingen

De strUpr-functie is een aanvulling op de strLwr-functie . De strUpr-functie maakt gebruik van de functie LCMapString() in de Win32-API.

Example

In het volgende voorbeeld wordt ABCDD55EFGHIJ afgedrukt.

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

subStr

Haalt een deel van een tekenreeks op.

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

Parameterwaarden

Kenmerk	Description
_Sms	De oorspronkelijke tekenreeks.
_positie	De positie in de oorspronkelijke tekenreeks waar het onderdeel dat moet worden opgehaald, begint.
_getal	Een ondertekend geheel getal dat de richting en het aantal posities aangeeft dat moet worden opgehaald uit de oorspronkelijke tekenreeks. Als een minteken voorafgaat aan _number, selecteert het systeem de subtekenreeks achterwaarts vanaf de opgegeven positie.

Retourwaarde

Een subtekenreeks van de oorspronkelijke tekenreeks.

Opmerkingen

Als een minteken voorafgaat aan de waarde van de parameter _number , wordt de subtekenreeks achterwaarts geselecteerd vanaf de opgegeven positie.

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

Controleert of de tekenreeks een andere tekenreeks bevat.

boolean strContains(str _text, str _potentialContains)

Parameterwaarden

Kenmerk	Description
_Sms	De oorspronkelijke tekenreeks waarin moet worden gezocht.
_potentialContains	De tekenreeks die moet worden gevonden.

Retourwaarde

Waar als de oorspronkelijke tekenreeks de gezochte tekenreeks bevat; anders, onwaar.

Opmerkingen

De vergelijkingen zijn niet hoofdlettergevoelig.

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

strStartsWith

Controleert of de tekenreeks begint met een andere tekenreeks.

boolean strStartsWith(str _string, str _potentialStart)

Parameterwaarden

Kenmerk	Description
_snaar	De oorspronkelijke tekenreeks waarin moet worden gezocht.
_potentialStart	De mogelijke tekenreeks die zich aan het begin bevindt.

Retourwaarde

Waar als de mogelijke tekenreeks het begin is van de oorspronkelijke tekenreeks; anders, onwaar.

Opmerkingen

De vergelijkingen zijn niet hoofdlettergevoelig.

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

strEndsWith

Hiermee wordt gecontroleerd of de tekenreeks eindigt op een andere tekenreeks.

boolean strEndsWith(str _string, str _potentialEnd)

Parameterwaarden

Kenmerk	Description
_snaar	De oorspronkelijke tekenreeks waarin moet worden gezocht.
_potentialEnd	De mogelijke tekenreeks die zich aan het einde bevindt.

Retourwaarde

Waar als de mogelijke tekenreeks de oorspronkelijke tekenreeks beëindigt; anders, onwaar.

Opmerkingen

De vergelijkingen zijn niet hoofdlettergevoelig.

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

strLRTrim

Hiermee verwijdert u voorloop- en staartspaties uit een tekenreeks.

str strLRTrim(str text)

Parameterwaarden

Kenmerk	Description
Tekst	De tekenreeks waaruit de voorloop- en staartspaties moeten worden verwijderd.

Retourwaarde

Een kopie van de opgegeven tekenreeks die geen voorloop- en volgruimtetekens bevat.

Opmerkingen

De functie strLRTrim is een aanvulling op de functies strRTrim en strLTrim .

Example

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