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.
Esta função devolve o comprimento de uma determinada cadeia.
Sintaxe
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:
O exemplo seguinte devolve o comprimento de cada valor no campo CustomerName (Nome de cliente):
Esta função devolve a cadeia que resulta da concatenação de cadeias especificadas.
Sintaxe
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"] )
Esta função devolve a posição de uma subcadeia especificada numa determinada cadeia.
Sintaxe
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:
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.
Caso o nome de cliente seja Julie Murphy, a expressão devolve Julie.
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
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:
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.
Caso o nome de cliente seja Julie Murphy, a expressão devolve Julie.
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
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:
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.
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.
Esta função devolve a posição de uma sub-cadeia especificada numa determinada cadeia. A sub-cadeia pode conter caracteres globais.
Sintaxe
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:
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:
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.
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.
Caso o nome do produto seja XMS-ModelA-1234, a expressão devolve XMS.
Esta função converte todas as letras de uma cadeia em minúsculas.
Sintaxe
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:
Esta função converte todas as letras de uma cadeia em maiúsculas.
Sintaxe
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:
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
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).
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
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).
Esta função devolve uma cadeia sem quaisquer caracteres em branco finais. A função não remove caracteres em branco entre palavras.
Sintaxe
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.