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.
Essa função retorna o tamanho de determinada sequencia.
Sintaxe
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:
O exemplo a seguir retorna o comprimento de cada valor no campo CustomerName:
Essa função retorna a sequencia que resulta da concatenação das sequencias especificadas.
Sintaxe
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"] )
Essa função retorna a posição de uma subsequencia especificada em uma determinada sequencia.
Sintaxe
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:
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.
Se o nome do cliente for Julie Murphy, a expressão retornará Julie.
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
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:
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.
Se o nome do cliente for Julie Murphy, a expressão retornará Julie.
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
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:
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.
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.
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
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:
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:
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.
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.
Se o nome do produto for XMS-ModelA-1234, a expressão retornará XMS.
Essa função converte todas as letras em uma sequencia em minúscula.
Sintaxe
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:
Essa função converte todas as letras em uma sequencia em maiúscula.
Sintaxe
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:
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
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.
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
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.
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
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.