|
|
|
|
|
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.
O número de caracteres na cadeia especificada.
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):
BirtStr.concat
Esta função devolve a cadeia que resulta da concatenação de cadeias especificadas.
A cadeia que resulta da concatenação de uma série de cadeias.
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.
A subcadeia a procurar. A procura é sensível a maiúsculas e minúsculas.
A cadeia na qual procurar uma subcadeia especificada.
Opcional. A posição na cadeia de origem em que começa a procura. Caso omita este argumento, a função começa a procura no primeiro carácter da cadeia.
A posição numérica da subcadeia na cadeia.O primeiro carácter de uma cadeia começa por 0. Caso não se encontre a subcadeia, a função devolve -1.
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.
BirtStr.left
Esta função extrai uma subcadeia com um comprimento especificado de uma cadeia, começando pelo carácter mais à esquerda ou primeiro carácter.
A cadeia da qual extrair uma subcadeia.
O número de caracteres a extrair, começando pelo primeiro carácter.
Uma subcadeia com um comprimento específico.
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.
BirtStr.right
Esta função extrai uma subcadeia com um comprimento especificado de uma cadeia, começando pelo carácter mais à direita ou último carácter.
A cadeia da qual extrair uma subcadeia.
O número de caracteres a extrair, começando pelo último carácter.
Uma subcadeia com um comprimento específico.
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.
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 subcadeia especificada numa determinada cadeia. A subcadeia pode conter caracteres globais.
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:
A cadeia na qual procurar uma subcadeia especificada.
Opcional. A posição na cadeia de origem em que começa a procura. Caso omita este argumento, a função começa a procura no primeiro carácter da cadeia.
A posição numérica da subcadeia na cadeia.O primeiro carácter de uma cadeia começa por 0. Caso não se encontre a subcadeia, a função devolve -1.
O exemplo seguinte devolve a posição numérica de padrões de cadeia especificados em cadeias específicas:
BirtStr.search( "XM?", "XMS-ModelA-1234-567" ) // devolve 0BirtStr.search( "ModelA*", "XMS-ModelA-1234-567" ) // devolve 4BirtStr.search( "-", "XMS-ModelA-1234-567", 4 ) // devolve 10O exemplo seguinte procura o padrão de cadeia, S*A, em cada valor no campo ProductCode (Código de produto). Caso o código do produto seja 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.
BirtStr.toLower
Esta função converte todas as letras de uma cadeia em minúsculas.
A cadeia a converter para minúsculas.
A cadeia especificada toda em letras minúsculas.
O exemplo seguinte apresenta todos os valores no campo productLine (Linha de produto) em minúsculas:
BirtStr.toUpper
Esta função converte todas as letras de uma cadeia em maiúsculas.
A cadeia a converter para maiúsculas.
A cadeia especificada toda em letras maiúsculas.
O exemplo seguinte apresenta todos os valores no campo customerName (Nome de cliente) em maiúsculas:
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.
A cadeia da qual remover caracteres em branco iniciais e finais.
Uma cadeia sem quaisquer caracteres em branco iniciais e finais.
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.
A cadeia da qual remover caracteres em branco iniciais.
Uma cadeia sem quaisquer caracteres em branco iniciais.
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).
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.
A cadeia da qual remover caracteres em branco finais.
Uma cadeia sem quaisquer caracteres em branco finais.
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.
| (c) Copyright Actuate Corporation 2009 |