BirtStr

Clase BirtStr

La clase BirtStr proporciona funciones para manipular cadenas, por ejemplo, para concatenar cadenas, recortar espacios adicionales, ver las partes de una cadena, o una cadena en mayúsculas o minúsculas.

BirtStr.charLength

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

Sintaxis

BirtStr.charLength (fuente)

Parámetro

fuente - La cadena de evaluar.

Devoluciones

El número de caracteres en la cadena especificada.

Ejemplos

En el ejemplo siguiente se devuelve la longitud de una cadena 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 cadena que resulta de la concatenación de cadenas especificadas.

Sintaxis

BirtStr.concat (Source1, ..., sourceN)

Parámetro

Source1, ..., sourceN - Las cadenas para concatenar.

Devoluciones

La cadena que resulta de la concatenación de una serie de cadenas.

Ejemplo

En el ejemplo siguiente se devuelve una dirección completa mediante la concatenación de los valores de varios campos:

BirtStr.concat (row ["AddressLine1"], "", row ["AddressLine2"], "", row ["ciudad"], "", row ["Código postal"], "row [" Estado "] , "", row ["País"])

BirtStr.indexOf

Esta función devuelve la posición de una subcadena especificada en una cadena determinada.

Sintaxis

BirtStr.indexOf (destino, origen, principio)

Parámetros

objetivo - La subcadena a buscar. La búsqueda distingue entre mayúsculas y minúsculas.

fuente - La cadena en la cual se va a  buscar una subcadena especificada.

inicio - (Opcional). La posición en la cadena de origen, donde comienza la búsqueda. Si se omite este argumento, la función comienza la búsqueda desde el primer carácter de la cadena.

Devoluciones

La posición numérica de la subcadena en la cadena. El primer carácter de una cadena que comienza en 0. Si la subcadena no se encuentra, la función devuelve -1.

Ejemplos

En el ejemplo siguiente se devuelve la posición numérica de caracteres especificado en cadenas específicas:

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

En el ejemplo siguiente se utiliza BirtStr.indexOf (), en relación con BirtStr.left () para mostrar los caracteres que preceden al carácter de espacio en un nombre de cliente. El BirtStr.left () función extrae una subcadena de una longitud especificada, a partir del primer carácter. En este ejemplo, la longitud de la subcadena de pantalla 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 del cliente es Julie Murphy, la expresión devuelve Julie.

BirtStr.left

Esta función extrae una subcadena de una longitud especificada de una cadena, a partir de la más a la izquierda, o en primer lugar,.

Sintaxis

BirtStr.left (fuente, n)

Parámetros

fuente - La cadena de la que extraer una subcadena.

n - El número de caracteres para extraer, a partir del primer carácter.

Devoluciones

Una subcadena de una longitud específica.

• Si se omite n, el número de caracteres a extraer, la función devuelve el primer carácter único.
• Si n es cero, la función devuelve una cadena vacía.
• Si n es mayor que la longitud de la cadena, la función devuelve la cadena completa.

Ejemplos

El ejemplo siguiente devuelve las subcadenas de diferentes longitudes de cadenas específicas:

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

En el ejemplo siguiente se utiliza BirtStr.indexOf (), en relación con BirtStr.left () para mostrar los caracteres que preceden al carácter de espacio en un nombre de cliente. El BirtStr.left () función extrae una subcadena de una longitud especificada, a partir del primer carácter. En este ejemplo, la longitud de la subcadena de pantalla 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 del cliente es Julie Murphy, la expresión devuelve Julie.

BirtStr.right

Esta función extrae una subcadena de una longitud especificada de una cadena, a partir de la más a la derecha, o el último carácter.

Sintaxis

BirtStr.right (fuente, n)

Parámetros

fuente - La cadena de la que extraer una subcadena.

n - El número de caracteres para extraer, a partir del último carácter.

Devoluciones

Una subcadena de una longitud específica.

• Si se omite n, en el número de caracteres a extraer, la función devuelve el último carácter único.
• Si n es cero, la función devuelve una cadena vacía.
• Si n es mayor que la longitud de la cadena, la función devuelve la cadena completa.

Ejemplos

El ejemplo siguiente devuelve las subcadenas de diferentes longitudes de cadenas específicas:

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

En el ejemplo siguiente se utiliza BirtStr.right (), en relación con la BirtStr.indexOf () y BirtStr.charLength () para mostrar los caracteres que aparecen después de que el carácter de espacio en un nombre de cliente. En este ejemplo se supone que el número de caracteres después del guión varía. Por lo tanto, la longitud de la cadena completa (devuelto por BirtStr.charLength ()) menos la longitud hasta el guión (que devuelve BirtStr.indexOf ()) es el número de caracteres para mostrar.

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

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

BirtStr.search

Esta función devuelve la posición de una subcadena especificada en una cadena determinada. La subcadena puede contener caracteres comodín.

Sintaxis

BirtStr.search (patrón, la fuente, el índice)

Parámetros

patrón - El patrón de la cadena a buscar. La búsqueda distingue entre mayúsculas y minúsculas. Puede usar los siguientes caracteres comodín en un patrón:

• Un asterisco, coincide con cero o más caracteres, espacios incluidos. Por ejemplo, n * t partidos tn, el estaño y el adolescente.
• Un signo de interrogación, coincide exactamente con uno de los personajes. Por ejemplo, no? N ​​coincide con canela, diez, estaño, y una tonelada. No coincide con la adolescencia o tn.

Para coincidir con un asterisco literal o signo de interrogación en una cadena, preceden a los personajes con dos caracteres de barra invertida (\ ). Por ejemplo, para encontrar la subcadena R * 10, utilice el modelo de cadena siguientes:
"R\ \ * 10"

fuente - La cadena en la que buscar una subcadena especificada.

índice - (Opcional). La posición en la cadena de origen, donde comienza la búsqueda. Si se omite este argumento, la función comienza la búsqueda desde el primer carácter de la cadena.

Devoluciones

La posición numérica de la subcadena en la cadena. El primer carácter de una cadena que comienza en 0. Si la subcadena no se encuentra, la función devuelve -1.

Ejemplos

En el ejemplo siguiente se devuelve la posición numérica de los patrones de cadena especificada en cadenas 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

En el siguiente ejemplo para el patrón de texto, S*A, en cada valor en el campo ProductCode. Si el código de producto es KBS5412A, la expresión devuelve 2.

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

En el ejemplo siguiente BirtStr.search usos (), en relación con BirtStr.left () para mostrar los caracteres que preceden al patrón de texto, * Modelo, en nombre de un producto. El BirtStr.left () función extrae una subcadena de una longitud especificada, a partir del primer carácter. En este ejemplo, la longitud de la subcadena de pantalla es igual a la posición numérica del patrón de texto.

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

Si el nombre del producto es XMS-Modela-1234, la expresión devuelve XMS.

BirtStr.toLower

Esta función convierte todas las letras de una cadena en minúsculas.

Sintaxis

BirtStr.toLower (fuente)

Parámetro

fuente - La cadena para convertir a minúsculas.

Devoluciones

La cadena especificada en letras minúsculas

Ejemplo

El ejemplo siguiente muestra todos los valores en el campo ProductLine en minúsculas:

BirtStr.toLower (row ["ProductLine"])
BirtStr.toUpper

BirtStr.toUpper

Esta función convierte todas las letras de una cadena en mayúsculas.

Sintaxis

BirtStr.toUpper (fuente)

Parámetro

fuente - La cadena para convertir a mayúsculas.

Devoluciones

La cadena especificada en mayúsculas

Ejemplo

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

BirtStr.toUpper (row ["customerName"])

BirtStr.trim

Esta función devuelve una cadena con todos los espacios iniciales y finales en blanco eliminados. No quita los caracteres en blanco entre las palabras.

Sintaxis

BirtStr.trim (fuente)

Parámetro

fuente - La cadena de la que para eliminar los espacios iniciales y finales en blanco.

Devoluciones

Una cadena con todos los espacios iniciales y finales en blanco eliminados.

Ejemplo

En el ejemplo siguiente se utiliza BirtStr.trim () para eliminar todos los espacios iniciales y finales en blanco de los valores en los campos de datos Nombre y Apellidos.

BirtStr.trim (row ["Nombre"]) + "" + BirtStr.trim (row ["Apellido"])

BirtStr.trimLeft

Esta función devuelve una cadena con todos los espacios iniciales y finales en blanco eliminados. No quita los caracteres en blanco entre las palabras.

Sintaxis

BirtStr.trimLeft (fuente)

Parámetro

fuente - La cadena de la que para eliminar principales caracteres en blanco.

Devoluciones

Una cadena con todos los espacios principales en blanco eliminados.

Ejemplo

En el ejemplo siguiente concatena un literal de cadena con cada valor en el campo customerName. BirtStr.trimLeft () elimina todos los caracteres en blanco que precede el valor customerName modo que no hay caracteres en blanco entre la cadena literal y el valor customerName.

"Nombre del cliente:" + BirtStr.trimLeft (row ["customerName"])

BirtStr.trimRight

Esta función devuelve una cadena con todos los caracteres en blanco de cola eliminado. No quita los caracteres en blanco entre las palabras.

Sintaxis

BirtStr.trimRight (fuente)

Parámetro

fuente - La cadena de la que se arrastra para eliminar caracteres en blanco.

Devoluciones

Una cadena con todos los caracteres en blanco de cola eliminado.

Ejemplo

En el ejemplo siguiente concatena cada valor en el campo de comentario con un punto y coma, a continuación, con un valor en el campo de acción. BirtStr.trimRight () elimina todos los caracteres en blanco después del valor de comentario de modo que no hay caracteres en blanco entre la cadena de comentario y el punto y coma.

BirtStr.trimRight (row ["comentario"]) + "" + row ["Acción"])