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.
Denne funksjonen returnerer lengden av en gitt streng.
Syntaks
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:
Følgende eksempel returnerer lengden av hver verdi i CustomerName-feltet:
Denne funksjonen returnerer strengen som er resultatet av at de oppgitte strengene ble sammenkjedet.
Syntaks
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"] )
Denne funksjonen returnerer posisjonen for en oppgitt delstreng i en gitt streng.
Syntaks
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:
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.
Hvis kundenavnet er Julie Murphy, returnerer uttrykket Julie.
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
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:
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.
Hvis kundenavnet er Julie Murphy, returnerer uttrykket Julie.
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
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:
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.
Hvis kundenavnet er Julie Murphy, returnerer uttrykket Murphy. Hvis kundenavnet er Kwai Li, returnerer uttrykket Li.
Denne funksjonen returnerer posisjonen for en oppgitt delstreng i en gitt streng. Delstrengen kan inneholde jokertegn.
Syntaks
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:
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:
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:
Følgende eksempel søker etter strengmønsteret S*A i hver verdi i ProductCode-feltet. Hvis produktkoden er KBS5412A, returnerer uttrykket 2.
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.
Hvis produktnavnet er XMS-ModelA-1234, returnerer uttrykket XMS.
Denne funksjonen konverterer alle bokstaver i en streng til små bokstaver.
Syntaks
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:
Denne funksjonen konverterer alle bokstaver i en streng til store bokstaver.
Syntaks
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:
Denne funksjonen returnerer en streng der alle foranstilte og etterfølgende blanktegn er fjernet. Den fjerner ikke blanktegn mellom ord.
Syntaks
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.
Denne funksjonen returnerer en streng der alle foranstilte og etterfølgende blanktegn er fjernet. Den fjerner ikke blanktegn mellom ord.
Syntaks
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.
Denne funksjonen returnerer en streng der alle etterfølgende blanktegn er fjernet. Den fjerner ikke blanktegn mellom ord.
Syntaks
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.