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"])