Anterior Seguinte

Classe BirtStr

A classe BirtStr faculta funções para manipular cadeias como, por exemplo, concatenar cadeias, ajustar espaços a mais, obter partes de uma cadeia e apresentar cadeias em letra maiúscula ou minúscula. Esta classe é estática. A aplicação não pode criar ocorrências da classe.

BirtStr.charLength

Esta função devolve o comprimento de uma determinada cadeia.

Sintaxe

integer BirtStr.charLength( string source )

Parâmetro

source

String. A cadeia a avaliar.

Devoluções

Integer. O número de caracteres na cadeia especificada.

Exemplos

O exemplo seguinte devolve o comprimento de uma cadeia específica:

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

O exemplo seguinte devolve o comprimento de cada valor no campo CustomerName (Nome de cliente):

BirtStr.charLength( row["CustomerName"] )

BirtStr.concat

Esta função devolve a cadeia que resulta da concatenação de cadeias especificadas.

Sintaxe

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

Parâmetro

source1, ..., sourceN

String. As cadeias a concatenar.

Devoluções

String. A cadeia que resulta da concatenação de uma série de cadeias.

Exemplo

O exemplo seguinte devolve um endereço completo ao concatenar valores de vários campos:

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

BirtStr.indexOf

Esta função devolve a posição de uma subcadeia especificada numa determinada cadeia.

Sintaxe

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

Parâmetros

target

String. A subcadeia a procurar. A procura é sensível a maiúsculas e minúsculas.

source

String. A cadeia na qual procurar uma subcadeia especificada.

start

Integer. Opcional. A posição na cadeia de origem em que começa a procura. Se omitir este argumento, a função iniciar a pesquisa pelo primeiro carácter da cadeia.

Devoluções

Integer. A posição numérica da subcadeia na cadeia. O primeiro carácter de uma cadeia começa no 0. Se a sub-cadeia não for encontrada, a função devolve -1.

Exemplos

O exemplo seguinte devolve a posição numérica de caracteres especificados em cadeias específicas:

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

O exemplo seguinte utiliza BirtStr.indexOf( ) com BirtStr.left( ) para apresentar os caracteres que precedem o carácter de espaço no nome de um cliente. A função BirtStr.left( ) extrai uma subcadeia com um comprimento especificado, a começar pelo primeiro carácter. Neste exemplo, o comprimento de uma subcadeia a apresentar é igual à posição numérica do carácter de espaço.

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

Caso o nome de cliente seja Julie Murphy, a expressão devolve Julie.

BirtStr.left

Esta função extrai uma subcadeia de um comprimento especificado a partir de uma cadeia, começando do carácter mais à esquerda ou pelo primeiro.

Sintaxe

string BirtStr.left( string source, integer n )

Parâmetros

source

String. A cadeia da qual extrair uma subcadeia.

n

Integer. O número de caracteres a extrair, começando pelo primeiro carácter.

Devoluções

Sring. Uma subcadeia de comprimento específico.

*
*
*

Exemplos

O exemplo seguinte devolve subcadeias de vários comprimentos de cadeias específicas:

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

O exemplo seguinte utiliza BirtStr.indexOf( ) com BirtStr.left( ) para apresentar os caracteres que precedem o carácter de espaço no nome de um cliente. A função BirtStr.left( ) extrai uma subcadeia com um comprimento especificado, a começar pelo primeiro carácter. Neste exemplo, o comprimento de uma subcadeia a apresentar é igual à posição numérica do carácter de espaço.

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

Caso o nome de cliente seja Julie Murphy, a expressão devolve Julie.

BirtStr.right

Esta função extrai uma sub-cadeia de um comprimento especificado a partir de uma cadeia, começando no carácter mais à direita ou pelo último.

Sintaxe

String BirtStr.right( String source, integer n )

Parâmetros

source

String. A cadeia da qual extrair uma subcadeia.

n

Integer. O número de caracteres a extrair, começando pelo último carácter.

Devoluções

String. Uma subcadeia de comprimento específico.

*
*
*

Exemplos

O exemplo seguinte devolve subcadeias de vários comprimentos de cadeias específicas:

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

O exemplo seguinte utiliza BirtStr.right( ) com as funções BirtStr.indexOf( ) e BirtStr.charLength( ) para apresentar os caracteres que aparecem depois do carácter de espaço num nome de cliente. Este exemplo parte do princípio que o número de caracteres após o hífen varia. Consequentemente, o comprimento de uma cadeia inteira (devolvido por BirtStr.charLength( )), menos o comprimento até ao hífen (devolvido por BirtStr.indexOf( )) corresponde ao número de caracteres a apresentar.

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

Caso o nome de cliente seja Julie Murphy, a expressão devolve Murphy. Caso o nome de cliente seja Kwai Li, a expressão devolve Li.

BirtStr.search

Esta função devolve a posição de uma sub-cadeia especificada numa determinada cadeia. A sub-cadeia pode conter caracteres globais.

Sintaxe

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

Parâmetros

pattern

String. O padrão de cadeia a procurar. A procura é insensível a maiúsculas e minúsculas. Pode utilizar os seguintes caracteres globais num padrão:

*
*

Para corresponder a um asterisco ou ponto de interrogação literal numa cadeia, coloque dois caracteres de barra invertida (\\) antes desses caracteres. Por exemplo, para encontrar a subcadeia R*10, utilize o seguinte padrão de cadeia:

"R\\*10"

source

String. A cadeia na qual procurar uma subcadeia especificada.

index

Integer. Opcional. A posição na cadeia de origem em que começa a procura. Se omitir este argumento, a função iniciar a pesquisa pelo primeiro carácter da cadeia.

Devoluções

Integer. A posição numérica da subcadeia na cadeia. O primeiro carácter de uma cadeia começa no 0. Se a sub-cadeia não for encontrada, a função devolve -1.

Exemplos

O exemplo seguinte devolve a posição numérica de padrões de cadeia especificados em cadeias especificadas:

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

O exemplo seguinte procura o padrão de cadeia, S*A, em cada valor no campo ProductCode (Código de produto). Se o código do produto for KBS5412A, a expressão devolve 2.

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

O exemplo seguinte utiliza BirtStr.search( ) com BirtStr.left( ) para apresentar os caracteres que precedem o padrão de cadeia, -Model*, num nome de produto. A função BirtStr.left( ) extrai uma subcadeia com um comprimento especificado, a começar pelo primeiro carácter. Neste exemplo, o comprimento de uma subcadeia a apresentar é igual à posição numérica do padrão de cadeia.

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

Caso o nome do produto seja XMS-ModelA-1234, a expressão devolve XMS.

BirtStr.toLower

Esta função converte todas as letras de uma cadeia em minúsculas.

Sintaxe

string BirtStr.toLower( string source )

Parâmetro

source

String. A cadeia a converter para minúsculas.

Devoluções

String. A cadeia especificada toda em letras minúsculas

Exemplo

O exemplo seguinte apresenta todos os valores no campo productLine (Linha de produto) em minúsculas:

BirtStr.toLower( row["productLine"] )

BirtStr.toUpper

Esta função converte todas as letras de uma cadeia em maiúsculas.

Sintaxe

string BirtStr.toUpper( string source )

Parâmetro

source

String. A cadeia a converter para maiúsculas.

Devoluções

String. A cadeia especificada toda em letras maiúsculas

Exemplo

O exemplo seguinte apresenta todos os valores no campo customerName (Nome de cliente) em maiúsculas:

BirtStr.toUpper( row["customerName"] )

BirtStr.trim

Esta função devolve uma cadeia sem quaisquer caracteres em branco iniciais e finais. A função não remove caracteres em branco entre palavras.

Sintaxe

string BirtStr.trim( string source )

Parâmetro

source

String. A cadeia da qual remover caracteres em branco iniciais e finais.

Devoluções

String. Uma cadeia sem quaisquer caracteres em branco iniciais e finais.

Exemplo

O exemplo seguinte utiliza BirtStr.trim( ), para remover todos os caracteres em branco iniciais e finais de valores nos campos FirstName (Nome próprio) e Lastname (Apelido).

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

BirtStr.trimLeft

Esta função devolve uma cadeia sem quaisquer caracteres em branco iniciais e finais. A função não remove caracteres em branco entre palavras.

Sintaxe

string BirtStr.trimLeft( string source )

Parâmetro

source

String. A cadeia da qual remover caracteres em branco iniciais e finais.

Devoluções

String. Uma cadeia sem quaisquer caracteres em branco iniciais e finais.

Exemplo

O exemplo seguinte concatena uma cadeia literal com cada valor no campo customerName (Nome de cliente). BirtStr.trimLeft( ) remove todos os caracteres em branco que precedam o valor customerName (Nome de cliente), para que não haja caracteres em branco a mais entre a cadeia literal e o valor customerName (Nome de cliente).

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

BirtStr.trimRight

Esta função devolve uma cadeia sem quaisquer caracteres em branco finais. A função não remove caracteres em branco entre palavras.

Sintaxe

string BirtStr.trimRight( string source )

Parâmetro

source

String. A cadeia da qual remover caracteres em branco finais.

Devoluções

String. Uma cadeia sem quaisquer caracteres em branco finais.

Exemplo

O exemplo seguinte concatena cada valor no campo Comment (Comentário) com um ponto e vírgula e depois com um valor no campo Action (Acção). BirtStr.trimRight( ) remove todos os caracteres em branco após o valor Comment (Comentário) para que não haja caracteres em branco a mais entre a cadeia Comment (Comentário) e o ponto e vírgula.

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

(c) Copyright Actuate Corporation 2013