Klassen BirtStr tillhandahåller funktioner för att ändra strängar, t.ex. sammanfoga stränga, justera extra blanktecken, hämta delar av strängar och visa strängar med gemener eller versaler. Klassen är statisk. Tillämpningen kan inte skapa förekomster av klassen.
Funktionen returnerar längden på en given sträng.
Syntax
Parameter
source
Sträng. Den sträng som ska utvärderas.
Returnerar
Heltal. Antalet tecken i angiven sträng.
Exempel
Följande exempel returnerar längden på en viss sträng:
Följande exempel returnerar längden på varje värde i fältet CustomerName:
Funktionen returnerar resultatsträngen av strängar som sammanfogas (konkateneras).
Syntax
Parameter
source1, ..., sourceN
Sträng. De strängar som ska sammanfogas.
Returnerar
Sträng. Resultatet av strängarna som har konkatenerats.
Exempel
Följande exempel returnerar en fullständig adress genom att konkatenera värden från flera fält:
BirtStr.concat( row["AddressLine1"], ", ", row["AddressLine2"], ", ", row["City"], " ", row["PostalCode"], "row["State"], ", ", row["Country"] )
Funktionen returnerar positionen för en given delsträng i en sträng.
Syntax
Parametrar
target
Sträng. Den delsträng som ska eftersökas. Sökningen är skiftberoende.
source
Sträng. Den sträng som ska eftersökas för angiven delsträng.
start
Heltal. Valfritt. Den position i källsträngen där sökningen startar. Om du utesluter det här argumentet startar sökningen från det första tecknet i strängen.
Returnerar
Heltal. Den numeriska positionen för delsträngen i strängen. Det första tecknet i en sträng startar vid 0. Om delsträngen inte hittas returnerar funktionen -1.
Exempel
Följande exempel returnerar den numeriska positionen för angivna tecken i vissa strängar:
I följande exempel används BirtStr.indexOf( ) tillsammans med BirtStr.left( ) till att visa tecknen som föregår blanktecknet i ett kundnamn. Funktionen BirtStr.left( ) extraherar en delsträng med angiven längd, med början från det första tecknet. I det här exemplet är längden på delsträngen som ska visas lika med den numeriska positionen för blanktecknet.
Om kundnamnet är Julie Murphy, returnerar uttrycket Julie.
Funktionen extraherar en delsträng med angiven längd från en sträng med start från tecknet längst till vänster, eller det första tecknet.
Syntax
Parametrar
source
Sträng. Strängen som delsträngen ska extraheras ifrån.
n
Heltal. Antalet tecken som ska extraheras, med början på det första tecknet.
Returnerar
Sträng. En delsträng med angiven längd.
Exempel
Följande exempel returnerar delsträngar med varierande längd från vissa strängar:
I följande exempel används BirtStr.indexOf( ) tillsammans med BirtStr.left( ) till att visa tecknen som föregår blanktecknet i ett kundnamn. Funktionen BirtStr.left( ) extraherar en delsträng med angiven längd, med början från det första tecknet. I det här exemplet är längden på delsträngen som ska visas lika med den numeriska positionen för blanktecknet.
Om kundnamnet är Julie Murphy, returnerar uttrycket Julie.
Funktionen extraherar en delsträng med angiven längd från en sträng med start från tecknet längst till höger, eller det sista tecknet.
Syntax
Parametrar
source
Sträng. Strängen som delsträngen ska extraheras ifrån.
n
Heltal. Antalet tecken som ska extraheras, med början på det sista tecknet.
Returnerar
Sträng. En delsträng med angiven längd.
Exempel
Följande exempel returnerar delsträngar med varierande längd från vissa strängar:
I följande exempel används BirtStr.right( ) tillsammans med BirtStr.indexOf( ) och BirtStr.charLength( ) till att visa tecknen som visas efter blanktecknet i ett kundnamn. Det förutsätts att antalet tecken efter bindestrecket varierar. Därför är längden på hela strängen (som returneras av BirtStr.charLength( )) minus längden till bindestrecket (som returneras av BirtStr.indexOf( )) det antal tecken som visas.
Om kundnamnet är Julie Murphy, returnerar uttrycket Murphy. Om kundnamnet är Kwai Li, returnerar uttrycket Li.
Funktionen returnerar positionen för en given delsträng i en sträng. Delsträngen kan innehålla jokertecken.
Syntax
Parametrar
pattern
Sträng. Strängmönstret som ska eftersökas. Sökningen är skiftberoende. Du kan använda följande jokertecken i ett mönster:
Om strängen innehåller en asterisk eller ett frågetecken ska dessa föregås av två omvända snedstreck (\\). Exempel: Om du vill hitta delsträngen R*10 använder du följande strängmönster:
source
Sträng. Den sträng som ska eftersökas för angiven delsträng.
index
Heltal. Valfritt. Den position i källsträngen där sökningen startar. Om du utesluter det här argumentet startar sökningen från det första tecknet i strängen.
Returnerar
Heltal. Den numeriska positionen för delsträngen i strängen. Det första tecknet i en sträng startar vid 0. Om delsträngen inte hittas returnerar funktionen -1.
Exempel
Följande exempel returnerar den numeriska positionen för angivna strängmönster i vissa strängar:
Följande exempel söker efter strängmönstret, S*A, i varje värde i fältet ProductCode. Om produktkoden är KBS5412A, returnerar uttrycket 2.
I följande exempel används BirtStr.search( ) tillsammans med BirtStr.left( ) till att visa tecknen som föregår strängmönstret, -Model*, i ett produktnamn. Funktionen BirtStr.left( ) extraherar en delsträng med angiven längd, med början från det första tecknet. I det här exemplet är längden på delsträngen som ska visas lika med den numeriska positionen för strängmönstret.
Om produktnamnet är XMS-ModelA-1234, returnerar uttrycket XMS.
Funktionen konverterar alla bokstäver i en sträng till gemener.
Syntax
Parameter
source
Sträng. Strängen som ska konverteras.
Returnerar
Sträng. Angiven sträng med gemener.
Exempel
Följande exempel visar alla värden i fältet productLine med gemener:
Funktionen konverterar alla bokstäver i en sträng till versaler.
Syntax
Parameter
source
Sträng. Strängen som ska konverteras.
Returnerar
Sträng. Angiven sträng med versaler.
Exempel
Följande exempel visar alla värden i fältet customerName med versaler:
Funktionen returnerar en sträng där alla inledande och efterföljande blanktecken har tagits bort. Blanktecken mellan ord tas inte bort.
Syntax
Parameter
source
Sträng. Strängen där blanktecken ska tas bort.
Returnerar
Sträng. En sträng där alla inledande och efterföljande blanktecken har tagits bort.
Exempel
I följande exempel används BirtStr.trim( ) till att ta bort alla inledande och efterföljande blanktecken från värden i datafälten FirstName och LastName.
Funktionen returnerar en sträng där alla inledande och efterföljande blanktecken har tagits bort. Blanktecken mellan ord tas inte bort.
Syntax
Parameter
source
Sträng. Strängen där blanktecken ska tas bort.
Returnerar
Sträng. En sträng där alla inledande blanktecken har tagits bort.
Exempel
I följande exempel sammanfogas en bokstavssträng med varje värde i fältet customerName. BirtStr.trimLeft( ) tar bort alla blanktecken som föregår customerName-värdet så att det inte finns några extra blanktecken mellan bokstavssträngen och customerName-värdet.
Funktionen returnerar en sträng där alla efterföljande blanktecken har tagits bort. Blanktecken mellan ord tas inte bort.
Syntax
Parameter
source
Sträng. Strängen där blanktecken ska tas bort.
Returnerar
Sträng. En sträng där alla efterföljande blanktecken har tagits bort.
Exempel
I följande exempel sammanfogas varje värde i fältet Comment med ett semikolon, och sedan med ett värde i fältet Action. BirtStr.trimRight( ) tar bort alla blanktecken efter Comment-värdet så att det inte finns några extra blanktecken mellan Comment-strängen och semikolonet.