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.
Funktionen returnerer længden på en given streng.
Syntaks
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:
Følgende eksempel returnerer længden på hver værdi i feltet CustomerName:
Funktionen returnerer den streng, der er resultatet af, at angivne strenge sammenføjes.
Syntaks
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"] )
Funktionen returnerer en angivet delstrengs placering i en given streng.
Syntaks
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:
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.
Hvis kundenavnet er Julie Murphy, returnerer udtrykket Julie.
Funktionen uddrager en delstreng med en angivet længde fra en streng med start ved tegnet yderst til venstre (det første).
Syntaks
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:
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.
Hvis kundenavnet er Julie Murphy, returnerer udtrykket Julie.
Funktionen uddrager en delstreng med en angivet længde fra en streng med start ved tegnet yderst til højre (det sidste).
Syntaks
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:
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.
Hvis kundenavnet er Julie Murphy, returnerer udtrykket Murphy. Hvis kundenavnet er Kwai Li, returnerer udtrykket Li.
Funktionen returnerer en angivet delstrengs placering i en given streng. Delstrengen kan indeholde jokertegn.
Syntaks
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:
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:
Følgende eksempel søger efter strengmønsteret S*A i hver værdi i feltet ProductCode. Hvis produktkoden er KBS5412A, returnerer funktionen 2.
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.
Hvis produktnavnet er XMS-ModelA-1234, returnerer udtrykket XMS.
Funktionen konverterer alle bogstaver i en streng til små bogstaver.
Syntaks
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:
Funktionen konverterer alle bogstaver i en streng til store bogstaver.
Syntaks
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:
Funktionen returnerer en streng, hvor alle foranstillede og efterstillede blanktegn er fjernet. Den fjerner ikke blanktegn mellem ord.
Syntaks
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.
Funktionen returnerer en streng, hvor alle foranstillede og efterstillede blanktegn er fjernet. Den fjerner ikke blanktegn mellem ord.
Syntaks
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.
Funktionen returnerer en streng med alle efterstillede blanktegn fjernet. Den fjerner ikke blanktegn mellem ord.
Syntaks
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.