Forrige Neste

Klassen BirtStr

BirtStr-klassen har funksjoner for å manipulere strenger, for eksempel for å sammenkjede strenger, kutte ekstra mellomrom, hente deler av en streng og vise strenger med små eller store bokstaver. Denne klassen er statisk. Applikasjonen kan ikke opprette forekomster av klassen.

BirtStr.charLength

Denne funksjonen returnerer lengden av en gitt streng.

Syntaks

integer BirtStr.charLength( string source )

Parameter

source

Streng. Strengen som skal evalueres.

Returnerer

Heltall. Antall tegn i den oppgitte strengen.

Eksempler

Følgende eksempel returnerer lengden av en oppgitt streng:

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

Følgende eksempel returnerer lengden av hver verdi i CustomerName-feltet:

BirtStr.charLength( row["CustomerName"] )

BirtStr.concat

Denne funksjonen returnerer strengen som er resultatet av at de oppgitte strengene ble sammenkjedet.

Syntaks

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

Parameter

source1, ..., sourceN

Streng. Strengene som skal sammenkjedes.

Returnerer

Streng. Strengen som er resultatet av at en serie av strenger ble sammenkjedet.

Eksempel

Følgende eksempel returnerer en fullstendig adresse ved å sammenkjede verdier fra flere felt:

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

BirtStr.indexOf

Denne funksjonen returnerer posisjonen for en oppgitt delstreng i en gitt streng.

Syntaks

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

Parametere

target

Streng. Delstrengen det skal søkes etter. Søket skiller mellom små og store bokstaver.

source

Streng. Strengen der det skal letes etter en oppgitt delstreng.

start

Heltall. Valgfri. Posisjonen i kildestrengen der søket starter. Hvis du utelater dette argumentet, starter funksjonen søket fra det første tegnet i strengen.

Returnerer

Heltall. Delstrengens numeriske posisjon i strengen. Det første tegnet i en streng starter på 0. Hvis delstrengen ikke blir funnet, returnerer funksjonen -1.

Eksempler

Følgende eksempel returnerer den numeriske posisjonen for oppgitte tegn i bestemte strenger:

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

Følgende eksempel bruker BirtStr.indexOf( ) sammen med BirtStr.left( ) til å vise tegnene som kommer før mellomromstegnet i et kundenavn. Funksjonen BirtStr.left( ) trekker ut en delstreng med en oppgitt lengde, med start fra første tegn. I dette eksempelet er lengden på delstrengen som skal vises, lik den numeriske posisjonen til mellomromstegnet.

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

Hvis kundenavnet er Julie Murphy, returnerer uttrykket Julie.

BirtStr.left

Denne funksjonen trekker ut en delstreng med en oppgitt lengde fra en streng, med start fra tegnet lengst til venstre, eller det første tegnet.

Syntaks

string BirtStr.left( string source, integer n )

Parametere

source

Streng. Strengen som det skal trekkes ut en delstreng fra.

n

Heltall. Antall tegn som skal trekkes ut, med start fra første tegn.

Returnerer

Streng. En delstreng med en oppgitt lengde.

*
*
*

Eksempler

Følgende eksempel returnerer delstrenger med forskjellig lengde fra bestemte strenger:

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

Følgende eksempel bruker BirtStr.indexOf( ) sammen med BirtStr.left( ) til å vise tegnene som kommer før mellomromstegnet i et kundenavn. Funksjonen BirtStr.left( ) trekker ut en delstreng med en oppgitt lengde, med start fra første tegn. I dette eksempelet er lengden på delstrengen som skal vises, lik den numeriske posisjonen til mellomromstegnet.

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

Hvis kundenavnet er Julie Murphy, returnerer uttrykket Julie.

BirtStr.right

Denne funksjonen trekker ut en delstreng med en oppgitt lengde fra en streng, med start fra tegnet lengst til høyre, eller det siste tegnet.

Syntaks

String BirtStr.right( String source, integer n )

Parametere

source

Streng. Strengen som det skal trekkes ut en delstreng fra.

n

Heltall. Antall tegn som skal trekkes ut, med start fra siste tegn.

Returnerer

Streng. En delstreng med en oppgitt lengde.

*
*
*

Eksempler

Følgende eksempel returnerer delstrenger med forskjellig lengde fra bestemte strenger:

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

Følgende eksempel bruker BirtStr.right( ) sammen med funksjonene BirtStr.indexOf( ) og BirtStr.charLength( ) til å vise tegnene som blir vist etter mellomromstegnet i et kundenavn. Dette eksempelet antar at antall tegn eter bindestreken varierer. Derfor er lengden av hele strengen (returnert av BirtStr.charLength( )) minus lengden frem til bindestreken (returnert av BirtStr.indexOf( )), antall tegn som skal vises.

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

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

BirtStr.search

Denne funksjonen returnerer posisjonen for en oppgitt delstreng i en gitt streng. Delstrengen kan inneholde jokertegn.

Syntaks

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

Parametere

pattern

Streng. Strengmønsteret det skal søkes etter. Søket skiller ikke mellom små og store bokstaver. Du kan bruke de følgende jokertegnene i et mønster:

*
En stjerne ( * ) samsvarer med null eller flere tegn, inkludert mellomrom. For eksempel samsvarer t*n med tn, tin og teen.
*

Hvis du vil finne samsvar med en virkelig stjerne eller et virkelig spørsmålstegn i en streng, setter du to omvendte skråstreker (\\) foran disse tegnene. Hvis du for eksempel vil finne delstrengen R*10, bruker du følgende strengmønster:

"R\\*10"

source

Streng. Strengen der det skal letes etter en oppgitt delstreng.

index

Heltall. Valgfri. Posisjonen i kildestrengen der søket starter. Hvis du utelater dette argumentet, starter funksjonen søket fra det første tegnet i strengen.

Returnerer

Heltall. Delstrengens numeriske posisjon i strengen. Det første tegnet i en streng starter på 0. Hvis delstrengen ikke blir funnet, returnerer funksjonen -1.

Eksempler

Følgende eksempel returnerer den numeriske posisjonen for oppgitte strengmønstre i bestemte strenger:

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

Følgende eksempel søker etter strengmønsteret S*A i hver verdi i ProductCode-feltet. Hvis produktkoden er KBS5412A, returnerer uttrykket 2.

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

Følgende eksempel bruker BirtStr.search( ) sammen med BirtStr.left( ) til å vise de tegnene som kommer før strengmønsteret -Model* i et produktnavn. Funksjonen BirtStr.left( ) trekker ut en delstreng med en oppgitt lengde, med start fra første tegn. I dette eksempelet er lengden på delstrengen som skal vises, lik den numeriske posisjonen til strengmønsteret.

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

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

BirtStr.toLower

Denne funksjonen konverterer alle bokstaver i en streng til små bokstaver.

Syntaks

string BirtStr.toLower( string source )

Parameter

source

Streng. Strengen som skal konverteres til små bokstaver.

Returnerer

Streng. Den oppgitte strengen med bare små bokstaver.

Eksempel

Følgende eksempel viser alle verdiene i productLine-feltet med små bokstaver:

BirtStr.toLower( row["productLine"] )

BirtStr.toUpper

Denne funksjonen konverterer alle bokstaver i en streng til store bokstaver.

Syntaks

string BirtStr.toUpper( string source )

Parameter

source

Streng. Strengen som skal konverteres til store bokstaver.

Returnerer

Streng. Den oppgitte strengen med bare store bokstaver.

Eksempel

Følgende eksempel viser alle verdiene i customerName-feltet med store bokstaver:

BirtStr.toUpper( row["customerName"] )

BirtStr.trim

Denne funksjonen returnerer en streng der alle foranstilte og etterfølgende blanktegn er fjernet. Den fjerner ikke blanktegn mellom ord.

Syntaks

string BirtStr.trim( string source )

Parameter

source

Streng. Strengen der foranstilte og etterfølgende blanktegn skal fjernes.

Returnerer

Streng. En streng der alle foranstilte og etterfølgende blanktegn er fjernet.

Eksempel

Følgende eksempel bruker BirtStr.trim( ) til å fjerne alle foranstilte og etterfølgende blanktegn fra verdier i datafeltene FirstName og LastName.

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

BirtStr.trimLeft

Denne funksjonen returnerer en streng der alle foranstilte og etterfølgende blanktegn er fjernet. Den fjerner ikke blanktegn mellom ord.

Syntaks

string BirtStr.trimLeft( string source )

Parameter

source

Streng. Strengen der foranstilte blanktegn skal fjernes.

Returnerer

Streng. En streng der alle foranstilte blanktegn er fjernet.

Eksempel

Følgende eksempel sammenkjeder en litteralstreng med hver verdi i customerName-feltet. BirtStr.trimLeft( ) fjerner alle blanktegn som står før customerName-verdien slik at det ikke finnes noen blanktegn mellom litteralstrengen og customerName-verdien.

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

BirtStr.trimRight

Denne funksjonen returnerer en streng der alle etterfølgende blanktegn er fjernet. Den fjerner ikke blanktegn mellom ord.

Syntaks

string BirtStr.trimRight( string source )

Parameter

source

Streng. Strengen der etterfølgende blanktegn skal fjernes.

Returnerer

Streng. En streng der alle etterfølgende blanktegn er fjernet.

Eksempel

Følgende eksempel sammenkjeder hver verdi i Comment-feltet med et semikolon, og deretter med en verdi i Action-feltet. BirtStr.trimRight( ) fjerner alle blanktegn etter Comment-verdien slik at det ikke finnes noen ekstra blanktegn mellom Comment-strengen og semikolonet.

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

(c) Copyright Actuate Corporation 2013