Anterior Avançar

Classe BirtStr

A classe BirtStr fornece funções para manipular sequências, por exemplo, concatenar sequências, remover espaços extras, obter partes de uma sequência e exibir sequências em minúsculas ou maiúsculas. Essa classe é estática. O aplicativo não pode criar instâncias da classe.

BirtStr.charLength

Essa função retorna o tamanho de determinada sequencia.

Sintaxe

integer BirtStr.charLength( string source )

Parâmetro

source

Sequência. A sequência a ser avaliada.

Retornos

Número Inteiro. O número de caracteres na sequência especificada.

Exemplos

O exemplo a seguir retorna o tamanho de uma sequencia específica:

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

O exemplo a seguir retorna o comprimento de cada valor no campo CustomerName:

BirtStr.charLength( row["CustomerName"] )

BirtStr.concat

Essa função retorna a sequencia que resulta da concatenação das sequencias especificadas.

Sintaxe

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

Parâmetro

source1, ..., sourceN

Sequência. As sequências a serem concatenadas.

Retornos

Sequência. A sequência resultante da concatenação de uma série de sequências.

Exemplo

O exemplo a seguir retorna um endereço completo concatenando valores de diversos campos:

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

BirtStr.indexOf

Essa função retorna a posição de uma subsequencia especificada em uma determinada sequencia.

Sintaxe

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

Parâmetros

destino

Sequência. A subsequência a ser procurada. A procura faz distinção entre maiúsculas e minúsculas.

source

Sequência. A sequência na qual procurar uma subsequência especificada.

iniciar

Número Inteiro. Opcional. A posição na sequencia de origem em que a procura inicia. Se você omitir este argumento, a função iniciará a procura a partir do primeiro caractere da sequência.

Retornos

Número Inteiro. A posição numérica da subsequência na sequência. O primeiro caractere de uma sequência começa com 0. Se a subsequência não for localizada, a função retornará -1.

Exemplos

O exemplo a seguir retorna a posição numérica de caracteres especificados em sequências específicas:

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

O exemplo a seguir usa BirtStr.indexOf( ) em conjunto com BirtStr.left( ) para exibir os caracteres que precedem o caractere de espaço em um nome do cliente. A função BirtStr.left( ) extrai uma subsequência de um comprimento especificado, começando do primeiro caractere. Neste exemplo, o comprimento da subsequência a ser exibida é igual à posição numérica do caractere de espaço.

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

Se o nome do cliente for Julie Murphy, a expressão retornará Julie.

BirtStr.left

Esta função extrai uma subsequência de um comprimento especificado de uma sequência, começando do caractere mais à esquerda ou do primeiro caractere.

Sintaxe

string BirtStr.left( string source, integer n )

Parâmetros

source

Sequência. A sequência da qual extrair uma subsequência.

n

Número Inteiro. O número de caracteres a ser extraído, começando do primeiro caractere.

Retornos

Sequência. Uma subsequência de um comprimento específico.

*
*
*

Exemplos

O exemplo a seguir retorna subsequencias de vários comprimentos a partir de sequencias específicas:

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

O exemplo a seguir usa BirtStr.indexOf( ) em conjunto com BirtStr.left( ) para exibir os caracteres que precedem o caractere de espaço em um nome do cliente. A função BirtStr.left( ) extrai uma subsequência de um comprimento especificado, começando do primeiro caractere. Neste exemplo, o comprimento da subsequência a ser exibida é igual à posição numérica do caractere de espaço.

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

Se o nome do cliente for Julie Murphy, a expressão retornará Julie.

BirtStr.right

Esta função extrai uma subsequência de um comprimento especificado de uma sequência, começando do caractere mais à direita ou do último caractere.

Sintaxe

String BirtStr.right( String source, integer n )

Parâmetros

source

Sequência. A sequência da qual extrair uma subsequência.

n

Número Inteiro. O número de caracteres a ser extraído, começando do último caractere.

Retornos

Sequência. Uma subsequência de um comprimento específico.

*
*
*

Exemplos

O exemplo a seguir retorna subsequencias de vários comprimentos a partir de sequencias específicas:

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

O exemplo a seguir usa BirtStr.right( ) em conjunto com as funções BirtStr.indexOf( ) e BirtStr.charLength( ) para exibir os caracteres que aparecem após o caractere de espaço em um nome do cliente. Este exemplo presume que o número de caracteres após o hífen varia. Portanto, o comprimento da sequência inteira (retornado por BirtStr.charLength( )) menos o comprimento até o hífen (retornado por BirtStr.indexOf( )) é o número de caracteres a serem exibidos.

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

Se o nome do cliente for Julie Murphy, a expressão retornará Murphy. Se o nome do cliente for Kwai Li, a expressão retornará Li.

BirtStr.search

Esta função retorna a posição de uma subsequência especificada em uma determinada sequência. A subsequência pode conter caracteres curinga.

Sintaxe

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

Parâmetros

pattern

Sequência. O padrão de sequência a ser procurado. A procura não faz distinção entre maiúsculas e minúsculas. É possível usar os seguintes caracteres curinga em um padrão:

*
*

Para corresponder a um asterisco literal ou ponto de interrogação em uma sequência, preceda esses caracteres com duas barras invertidas (\\). Por exemplo, para localizar a subsequência R*10, use o seguinte padrão de sequência:

"R\\*10"

source

Sequência. A sequência na qual procurar uma subsequência especificada.

index

Número Inteiro. Opcional. A posição na sequencia de origem em que a procura inicia. Se você omitir este argumento, a função iniciará a procura a partir do primeiro caractere da sequência.

Retornos

Número Inteiro. A posição numérica da subsequência na sequência. O primeiro caractere de uma sequência começa com 0. Se a subsequência não for localizada, a função retornará -1.

Exemplos

O exemplo a seguir retorna a posição numérica de padrões de sequência especificados em sequências específicas:

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

O exemplo a seguir procura o padrão de sequência, S*A, em cada valor no campo ProductCode. Se o código do produto for KBS5412A, a expressão retornará 2.

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

O exemplo a seguir usa BirtStr.search( ) em conjunto com BirtStr.left( ) para exibir os caracteres que precedem o padrão de sequência, -Model*, em um nome do produto. A função BirtStr.left( ) extrai uma subsequência de um comprimento especificado, começando do primeiro caractere. Neste exemplo, o comprimento da subsequência a ser exibida é igual à posição numérica do padrão de sequência.

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

Se o nome do produto for XMS-ModelA-1234, a expressão retornará XMS.

BirtStr.toLower

Essa função converte todas as letras em uma sequencia em minúscula.

Sintaxe

string BirtStr.toLower( string source )

Parâmetro

source

Sequência. A sequência a ser convertida em minúsculas.

Retornos

Sequência. A sequência especificada em todas as letras minúsculas

Exemplo

O exemplo a seguir exibe todos os valores no campo productLine em minúsculas:

BirtStr.toLower( row["productLine"] )

BirtStr.toUpper

Essa função converte todas as letras em uma sequencia em maiúscula.

Sintaxe

string BirtStr.toUpper( string source )

Parâmetro

source

Sequência. A sequência a ser convertida em maiúsculas.

Retornos

Sequência. A sequência especificada em todas as letras maiúsculas

Exemplo

O exemplo a seguir exibe todos os valores no campo customerName em maiúsculas:

BirtStr.toUpper( row["customerName"] )

BirtStr.trim

Esta função retorna uma sequência com todos os caracteres em branco iniciais e finais removidos. Ela não remove caracteres em branco entre palavras.

Sintaxe

string BirtStr.trim( string source )

Parâmetro

source

Sequência. A sequência da qual remover caracteres em branco iniciais e finais.

Retornos

Sequência. Uma sequência com todos os caracteres em branco iniciais e finais removidos.

Exemplo

O exemplo a seguir usa BirtStr.trim( ) para remover todos os caracteres em branco iniciais e finais de valores nos campos de dados FirstName e LastName.

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

BirtStr.trimLeft

Esta função retorna uma sequência com todos os caracteres em branco iniciais e finais removidos. Ela não remove caracteres em branco entre palavras.

Sintaxe

string BirtStr.trimLeft( string source )

Parâmetro

source

Sequência. A sequência da qual remover caracteres em branco iniciais.

Retornos

Sequência. Uma sequência com todos os caracteres em branco iniciais removidos.

Exemplo

O exemplo a seguir concatena uma sequência literal com cada valor no campo customerName. BirtStr.trimLeft( ) remove todos os caracteres em branco que precedem o valor customerName para que não haja caracteres em branco extras entre a sequência literal e o valor customerName.

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

BirtStr.trimRight

Essa função retorna uma sequencia com todos os caracteres de espaços em branco finais removidos. Ela não remove caracteres em branco entre palavras.

Sintaxe

string BirtStr.trimRight( string source )

Parâmetro

source

Sequência. A sequência da qual remover caracteres em branco finais.

Retornos

Sequência. Uma sequência com todos os caracteres em branco finais removidos.

Exemplo

O exemplo a seguir concatena cada valor no campo Comment com um ponto e vírgula, em seguida, com um valor no campo Action. BirtStr.trimRight( ) remove todos os caracteres em branco após o valor Comment para que não haja caracteres em branco extras entre a sequência Comment e o ponto e vírgula.

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

(c) Copyright Actuate Corporation 2013