Föregående Nästa

Klass BirtStr

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.

BirtStr.charLength

Funktionen returnerar längden på en given sträng.

Syntax

integer BirtStr.charLength( string source )

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:

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

Följande exempel returnerar längden på varje värde i fältet CustomerName:

BirtStr.charLength( row["CustomerName"] )

BirtStr.concat

Funktionen returnerar resultatsträngen av strängar som sammanfogas (konkateneras).

Syntax

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

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"] )

BirtStr.indexOf

Funktionen returnerar positionen för en given delsträng i en sträng.

Syntax

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

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:

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

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.

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

Om kundnamnet är Julie Murphy, returnerar uttrycket Julie.

BirtStr.left

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

string BirtStr.left( string source, integer n )

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:

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

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.

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

Om kundnamnet är Julie Murphy, returnerar uttrycket Julie.

BirtStr.right

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

String BirtStr.right( String source, integer n )

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:

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

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.

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

Om kundnamnet är Julie Murphy, returnerar uttrycket Murphy. Om kundnamnet är Kwai Li, returnerar uttrycket Li.

BirtStr.search

Funktionen returnerar positionen för en given delsträng i en sträng. Delsträngen kan innehålla jokertecken.

Syntax

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

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:

"R\\*10"

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:

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

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.

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

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.

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

Om produktnamnet är XMS-ModelA-1234, returnerar uttrycket XMS.

BirtStr.toLower

Funktionen konverterar alla bokstäver i en sträng till gemener.

Syntax

string BirtStr.toLower( string source )

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:

BirtStr.toLower( row["productLine"] )

BirtStr.toUpper

Funktionen konverterar alla bokstäver i en sträng till versaler.

Syntax

string BirtStr.toUpper( string source )

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:

BirtStr.toUpper( row["customerName"] )

BirtStr.trim

Funktionen returnerar en sträng där alla inledande och efterföljande blanktecken har tagits bort. Blanktecken mellan ord tas inte bort.

Syntax

string BirtStr.trim( string source )

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.

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

BirtStr.trimLeft

Funktionen returnerar en sträng där alla inledande och efterföljande blanktecken har tagits bort. Blanktecken mellan ord tas inte bort.

Syntax

string BirtStr.trimLeft( string source )

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.

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

BirtStr.trimRight

Funktionen returnerar en sträng där alla efterföljande blanktecken har tagits bort. Blanktecken mellan ord tas inte bort.

Syntax

string BirtStr.trimRight( string source )

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.

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

(c) Copyright Actuate Corporation 2013