Anterior Siguiente

Clase BirtStr

La clase BirtStr proporciona funciones para manipular series, por ejemplo, para concatenar series, recortar espacios extra, obtener partes de una serie y visualizar series en mayúsculas o minúsculas. Esta clase es estática. La aplicación no puede crear instancias de la clase.

BirtStr.charLength

Esta función devuelve la longitud de una serie dada.

Sintaxis

integer BirtStr.charLength( string source )

Parámetro

source

Serie. La serie a evaluar.

Devuelve

Entero. El número de caracteres en la serie especificada.

Ejemplos

El ejemplo siguiente devuelve la longitud de una serie específica:

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

El ejemplo siguiente devuelve la longitud de cada valor en el campo CustomerName:

BirtStr.charLength( row["CustomerName"] )

BirtStr.concat

Esta función devuelve la serie resultante de concatenar series especificadas.

Sintaxis

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

Parámetro

source1, ..., sourceN

Serie. Las series a concatenar.

Devuelve

Serie. La serie que resulta de concatenar varias series.

Ejemplo

El ejemplo siguiente devuelve una dirección completa concatenando valores de varios campos:

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

BirtStr.indexOf

Esta función devuelve la posición de una subserie especificada en una serie dada.

Sintaxis

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

Parámetros

target

Serie. La subserie que buscar. La búsqueda es sensible a las mayúsculas/minúsculas.

source

Serie. La serie en que debe buscarse una subserie especificada.

start

Entero. Opcional. La posición en la serie de origen donde empieza la búsqueda. Si omite este argumento, la función inicia la búsqueda desde el primer carácter de la serie.

Devuelve

Entero. La posición numérica de la subserie en la serie. El primer carácter de una serie empieza en 0. Si no se encuentra la subserie, la función devuelve -1.

Ejemplos

El ejemplo siguiente devuelve la posición numérica de caracteres especificados en series específicas:

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

El ejemplo siguiente utiliza BirtStr.indexOf( ) junto con BirtStr.left( ) para visualizar los caracteres que preceden al carácter de espacio en un nombre de cliente. La función BirtStr.left( ) extrae una subserie de una longitud especificada, empezando por el primer carácter. En este ejemplo, la longitud de la subserie a visualizar es igual a la posición numérica del carácter de espacio.

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

Si el nombre de cliente es Julie Murphy, la expresión devuelve Julie.

BirtStr.left

Esta función extrae de una serie una subserie de una longitud especificada, empezando por el primer carácter o el situado más a la izquierda

Sintaxis

string BirtStr.left( string source, integer n )

Parámetros

source

Serie. La serie de la que extrae una subserie.

n

Entero. El número de caracteres a extraer, empezando por el primer carácter.

Devuelve

Serie. Una subserie de una longitud específica.

*
*
*

Ejemplos

El ejemplo siguiente devuelve subseries de diversas longitudes de series específicas:

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

El ejemplo siguiente utiliza BirtStr.indexOf( ) junto con BirtStr.left( ) para visualizar los caracteres que preceden al carácter de espacio en un nombre de cliente. La función BirtStr.left( ) extrae una subserie de una longitud especificada, empezando por el primer carácter. En este ejemplo, la longitud de la subserie a visualizar es igual a la posición numérica del carácter de espacio.

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

Si el nombre de cliente es Julie Murphy, la expresión devuelve Julie.

BirtStr.right

Esta función extrae de una serie una subserie de una longitud especificada, empezando por el último carácter o el situado más a la derecha.

Sintaxis

String BirtStr.right( String source, integer n )

Parámetros

source

Serie. La serie de la que extrae una subserie.

n

Entero. El número de caracteres a extraer, empezando por el último carácter.

Devuelve

Serie. Una subserie de una longitud específica.

*
*
*

Ejemplos

El ejemplo siguiente devuelve subseries de diversas longitudes de series específicas:

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

El ejemplo siguiente utiliza BirtStr.right( ) junto con las funciones BirtStr.indexOf( ) y BirtStr.charLength( ) para visualizar los caracteres que aparecen después del carácter de espacio en un nombre de cliente. Este ejemplo presupone que el número de caracteres después del guión varía. Por lo tanto, la longitud de toda la serie (devuelta por BirtStr.charLength( )) menos la longitud hasta el guión (devuelta por BirtStr.indexOf( )) es el número de caracteres a visualizar.

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

Si el nombre de cliente es Julie Murphy, la expresión devuelve Murphy. Si el nombre de cliente es Kwai Li, la expresión devuelve Li.

BirtStr.search

Esta función devuelve la posición de una subserie especificada en una serie dada. La subserie puede contener caracteres comodín.

Sintaxis

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

Parámetros

pattern

Serie. El patrón de serie que buscar. La búsqueda no es sensible a las mayúsculas/minúsculas. Puede utilizar los caracteres comodín siguientes en un patrón:

*
*

Para emparejar un asterisco o interrogante literal en una serie, coloque antes de esos caracteres dos caracteres de barra inclinada invertida (\\). Por ejemplo, para buscar la subserie R*10, utilice el siguiente patrón de serie:

"R\\*10"

source

Serie. La serie en que debe buscarse una subserie especificada.

index

Entero. Opcional. La posición en la serie de origen donde empieza la búsqueda. Si omite este argumento, la función inicia la búsqueda desde el primer carácter de la serie.

Devuelve

Entero. La posición numérica de la subserie en la serie. El primer carácter de una serie empieza en 0. Si no se encuentra la subserie, la función devuelve -1.

Ejemplos

El ejemplo siguiente devuelve la posición numérica de patrones de serie especificados en series específicas:

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

El ejemplo siguiente busca el patrón de serie, S*A, en cada valor del campo ProductCode. Si el código de producto es KBS5412A, la expresión devuelve 2.

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

El ejemplo siguiente utiliza BirtStr.search( ) junto con BirtStr.left( ) para visualizar los caracteres que preceden al patrón de serie, -Model*, en un nombre de producto. La función BirtStr.left( ) extrae una subserie de una longitud especificada, empezando por el primer carácter. En este ejemplo, la longitud de la subserie a visualizar es igual a la posición numérica del patrón de serie.

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

Si el nombre de producto es XMS-ModelA-1234, la expresión devuelve XMS.

BirtStr.toLower

Esta función convierte todas las letras de una serie a minúsculas.

Sintaxis

string BirtStr.toLower( string source )

Parámetro

source

Serie. La serie que ha de convertirse en caracteres en minúsculas.

Devuelve

Serie. Toda la serie especificada en minúsculas

Ejemplo

El ejemplo siguiente muestra todos los valores del campo productLine en minúsculas:

BirtStr.toLower( row["productLine"] )

BirtStr.toUpper

Esta función convierte todas las letras de una serie a mayúsculas.

Sintaxis

string BirtStr.toUpper( string source )

Parámetro

source

Serie. La serie que ha de convertirse en caracteres en mayúsculas.

Devuelve

Serie. Toda la serie especificada en mayúsculas

Ejemplo

El ejemplo siguiente muestra todos los valores del campo customerName en mayúsculas:

BirtStr.toUpper( row["customerName"] )

BirtStr.trim

Esta función devuelve una serie en la que se han eliminado todos los blancos iniciales y finales. No elimina los blancos entre palabras.

Sintaxis

string BirtStr.trim( string source )

Parámetro

source

Serie. La serie de la que se eliminan los blancos iniciales y finales.

Devuelve

Serie. Una serie con todos los blancos iniciales y finales eliminados.

Ejemplo

El ejemplo siguiente utiliza BirtStr.trim( ) para eliminar todos los blancos iniciales y finales de valores en los campos de datos FirstName y LastName.

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

BirtStr.trimLeft

Esta función devuelve una serie en la que se han eliminado todos los blancos iniciales y finales. No elimina los blancos entre palabras.

Sintaxis

string BirtStr.trimLeft( string source )

Parámetro

source

Serie. La serie de la que se eliminan los blancos iniciales.

Devuelve

Serie. Una serie con todos los blancos iniciales eliminados.

Ejemplo

El ejemplo siguiente concatena una serie literal con cada valor del campo customerName. BirtStr.trimLeft( ) elimina todos los blancos que precedan al valor customerName de forma que no haya blancos adicionales entre la serie literal y el valor customerName.

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

BirtStr.trimRight

Esta función devuelve una serie en la que se han eliminado todos los blancos finales. No elimina los blancos entre palabras.

Sintaxis

string BirtStr.trimRight( string source )

Parámetro

source

Serie. La serie de la que se eliminan los blancos finales.

Devuelve

Serie. Una serie con todos los blancos finales eliminados.

Ejemplo

El ejemplo siguiente concatena cada valor del campo Comment con un punto y coma, y luego con un valor en el campo Action. BirtStr.trimRight( ) elimina todos los blancos que hay después del valor Comment de forma que no haya blancos adicionales entre la serie Comment y el punto y coma.

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

(c) Copyright Actuate Corporation 2013