Forrige Næste

Klassen BirtStr

Klassen BirtStr indeholder funktioner til behandling af strenge, f.eks. sammenkæde strenge, fjerne ekstra mellemrum, hente dele af en streng og få vist strenge med små bogstaver eller store bogstaver. Klassen er statisk. Programmet kan ikke oprette forekomster af klassen.

BirtStr.charLength

Funktionen returnerer længden på en given streng.

Syntaks

integer BirtStr.charLength( string source )

Parameter

source

Streng. Den streng, der skal evalueres.

Returnerer

Heltal. Antallet af tegn i den angivne streng.

Eksempler

Følgende eksempel returnerer længden af en angivet streng:

BirtStr.charLength( "Julie Murphy" ) // returnerer 12

Følgende eksempel returnerer længden på hver værdi i feltet CustomerName:

BirtStr.charLength( row["CustomerName"] )

BirtStr.concat

Funktionen returnerer den streng, der er resultatet af, at angivne strenge sammenføjes.

Syntaks

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

Parameter

source1, ..., sourceN

Streng. De strenge, der skal sammenføjes.

Returnerer

Streng. Den streng, der er resultatet af, at en række strenge sammenføjes.

Eksempel

Følgende eksempel returnerer en fuldstændig adresse, ved at værdier fra flere felter sammenføjes:

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

BirtStr.indexOf

Funktionen returnerer en angivet delstrengs placering i en given streng.

Syntaks

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

Parametre

target

Streng. Den delstreng, der skal søges efter. Der skelnes mellem store og små bogstaver i søgningen.

source

Streng. Den streng, hvor der skal søges efter en angivet delstreng.

start

Heltal. Valgfrit. Det sted i kildestrengen, hvor søgningen starter. Hvis du udelader argumentet, starter søgningen fra første tegn i strengen.

Returnerer

Heltal. Delstrengens numeriske placering i strengen. Det første tegn i en streng har positionen 0. Hvis delstrengen ikke bliver fundet, returnerer funktionen -1.

Eksempler

Følgende eksempel returnerer den numeriske position for angivne tegn i bestemte strenge:

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

Følgende eksempel bruger BirtStr.indexOf( ) sammen med BirtStr.left( ) til at få vist de tegn, der står før mellemrumstegnet i et kundenavn. Funktionen BirtStr.left( ) uddrager en delstreng med en angivet længde med start ved det første tegn. I dette eksempel er længden på den delstreng, der skal vises, lig med mellemrumstegnets numeriske position.

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

Hvis kundenavnet er Julie Murphy, returnerer udtrykket Julie.

BirtStr.left

Funktionen uddrager en delstreng med en angivet længde fra en streng med start ved tegnet yderst til venstre (det første).

Syntaks

string BirtStr.left( string source, integer n )

Parametre

source

Streng. Den streng, som en delstreng skal uddrages fra.

n

Heltal. Det antal tegn, der skal uddrages, med start ved første tegn.

Returnerer

Streng. En delstreng med en bestemt længde.

*
*
*

Eksempler

Følgende eksempel returnerer delstrenge med forskellige længder fra bestemte strenge:

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

Følgende eksempel bruger BirtStr.indexOf( ) sammen med BirtStr.left( ) til at få vist de tegn, der står før mellemrumstegnet i et kundenavn. Funktionen BirtStr.left( ) uddrager en delstreng med en angivet længde med start ved det første tegn. I dette eksempel er længden på den delstreng, der skal vises, lig med mellemrumstegnets numeriske position.

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

Hvis kundenavnet er Julie Murphy, returnerer udtrykket Julie.

BirtStr.right

Funktionen uddrager en delstreng med en angivet længde fra en streng med start ved tegnet yderst til højre (det sidste).

Syntaks

String BirtStr.right( String source, integer n )

Parametre

source

Streng. Den streng, som en delstreng skal uddrages fra.

n

Heltal. Det antal tegn, der skal uddrages, med start ved sidste tegn.

Returnerer

Streng. En delstreng med en bestemt længde.

*
*
*

Eksempler

Følgende eksempel returnerer delstrenge med forskellige længder fra bestemte strenge:

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

Følgende eksempel bruger BirtStr.right( ) sammen med funktionerne BirtStr.indexOf( ) og BirtStr.charLength( ) til at vise de tegn, der står efter mellemrumstegnet i et kundenavn. I eksemplet antages, at antallet af tegn efter bindestregen varierer. Derfor er længden på hele strengen (returneres af BirtStr.charLength( )) minus længden ind til bindestregen (returneres af BirtStr.indexOf( )) det antal tegn, der skal vises.

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

Hvis kundenavnet er Julie Murphy, returnerer udtrykket Murphy. Hvis kundenavnet er Kwai Li, returnerer udtrykket Li.

BirtStr.search

Funktionen returnerer en angivet delstrengs placering i en given streng. Delstrengen kan indeholde jokertegn.

Syntaks

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

Parametre

pattern

Streng. Det strengmønster, der skal søges efter. Der skelnes ikke mellem store og små bogstaver i søgningen. Du kan bruge følgende jokertegn i et mønster:

*
*

Hvis en stjerne eller et spørgsmålstegn i en streng skal opfattes som tegnet selv, skal du sætte to omvendte skråstreger (\\) foran tegnet. Brug f.eks. følgende strengmønster til at finde delstrengen R*10:

"R\\*10"

source

Streng. Den streng, hvor der skal søges efter en angivet delstreng.

index

Heltal. Valgfrit. Det sted i kildestrengen, hvor søgningen starter. Hvis du udelader argumentet, starter søgningen fra første tegn i strengen.

Returnerer

Heltal. Delstrengens numeriske placering i strengen. Det første tegn i en streng har positionen 0. Hvis delstrengen ikke bliver fundet, returnerer funktionen -1.

Eksempler

Følgende eksempel returnerer den numeriske position for angivne strengmønstre i bestemte strenge:

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

Følgende eksempel søger efter strengmønsteret S*A i hver værdi i feltet ProductCode. Hvis produktkoden er KBS5412A, returnerer funktionen 2.

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

Følgende eksempel bruger BirtStr.search( ) sammen med BirtStr.left( ) til at vise de tegn, der står før strengmønsteret -Model* i et produktnavn. Funktionen BirtStr.left( ) uddrager en delstreng med en angivet længde med start ved det første tegn. I dette eksempel er længden på den delstreng, der skal vises, lig med strengmønsterets numeriske position.

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

Hvis produktnavnet er XMS-ModelA-1234, returnerer udtrykket XMS.

BirtStr.toLower

Funktionen konverterer alle bogstaver i en streng til små bogstaver.

Syntaks

string BirtStr.toLower( string source )

Parameter

source

Streng. Den streng, der skal konverteres til små bogstaver.

Returnerer

Streng. Den angivne streng med udelukkende små bogstaver.

Eksempel

Følgende eksempel viser alle værdierne i feltet productLine med små bogstaver:

BirtStr.toLower( row["productLine"] )

BirtStr.toUpper

Funktionen konverterer alle bogstaver i en streng til store bogstaver.

Syntaks

string BirtStr.toUpper( string source )

Parameter

source

Streng. Den streng, der skal konverteres til store bogstaver.

Returnerer

Streng. Den angivne streng med udelukkende store bogstaver.

Eksempel

Følgende eksempel viser alle værdierne i feltet customerName med store bogstaver:

BirtStr.toUpper( row["customerName"] )

BirtStr.trim

Funktionen returnerer en streng, hvor alle foranstillede og efterstillede blanktegn er fjernet. Den fjerner ikke blanktegn mellem ord.

Syntaks

string BirtStr.trim( string source )

Parameter

source

Streng. Den streng, som foranstillede og efterstillede blanktegn skal fjernes fra.

Returnerer

Streng. En streng, hvor alle foranstillede og efterstillede blanktegn er fjernet.

Eksempel

Følgende eksempel bruger BirtStr.trim( ) til at fjerne alle foranstillede og efterstillede blanktegn fra værdier i datafelterne FirstName og LastName.

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

BirtStr.trimLeft

Funktionen returnerer en streng, hvor alle foranstillede og efterstillede blanktegn er fjernet. Den fjerner ikke blanktegn mellem ord.

Syntaks

string BirtStr.trimLeft( string source )

Parameter

source

Streng. Den streng, som foranstillede blanktegn skal fjernes fra.

Returnerer

Streng. En streng, hvor alle foranstillede blanktegn er fjernet.

Eksempel

Følgende eksempel sammenføjer en konstantstreng med hver værdi i feltet customerName. BirtStr.trimLeft( ) fjerner alle blanktegn før customerName-værdien, så der ikke er nogen blanktegn mellem konstantstrengen og customerName-værdien.

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

BirtStr.trimRight

Funktionen returnerer en streng med alle efterstillede blanktegn fjernet. Den fjerner ikke blanktegn mellem ord.

Syntaks

string BirtStr.trimRight( string source )

Parameter

source

Streng. Den streng, som efterstillede blanktegn skal fjernes fra.

Returnerer

Streng. En streng, hvor alle efterstillede blanktegn er fjernet.

Eksempel

Følgende eksempel sammenføjer hver værdi i feltet Comment med et semikolon og derefter med en værdi i feltet Action. BirtStr.trimRight( ) fjerner alle blanktegn efter Comment-værdien, så der ikke er nogen ekstra blanktegn mellem Comment-strengen og semikolonet.

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

(c) Copyright Actuate Corporation 2013