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.
Esta función devuelve la longitud de una serie dada.
Sintaxis
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:
El ejemplo siguiente devuelve la longitud de cada valor en el campo CustomerName:
Esta función devuelve la serie resultante de concatenar series especificadas.
Sintaxis
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"] )
Esta función devuelve la posición de una
subserie especificada en una serie dada.
Sintaxis
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:
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.
Si el nombre de cliente es Julie Murphy, la expresión devuelve Julie.
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
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:
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.
Si el nombre de cliente es Julie Murphy, la expresión devuelve Julie.
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
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:
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.
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.
Esta función devuelve la posición de una subserie especificada en una serie dada. La subserie puede contener caracteres comodín.
Sintaxis
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:
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:
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.
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.
Si el nombre de producto es XMS-ModelA-1234, la expresión devuelve XMS.
Esta función convierte todas las letras de una serie a minúsculas.
Sintaxis
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:
Esta función convierte todas las letras de una serie a mayúsculas.
Sintaxis
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:
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
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.
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
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.
Esta función devuelve una serie en la que se han eliminado todos los blancos finales. No elimina los blancos entre palabras.
Sintaxis
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.