Page Comparison

{scrollbar}
----
h2. 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.

h3. BirtStr.charLength

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

 *Sintaxis*
{code}
BirtStr.charLength (fuente)
{code}

 *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:
{code}
BirtStr.charLength ("Julie Murphy") // devuelve 12
{code}

El ejemplo siguiente devuelve la longitud de cada valor en el campo CustomerName:
{code}
BirtStr.charLength (row ["CustomerName"])
{code}


h3. BirtStr.concat

Esta función devuelve la cadena que resulta de la concatenación de cadenas especificadas.

 *Sintaxis*
{code}
BirtStr.concat (Source1, ..., sourceN)
{code}

 *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:
{code}
BirtStr.concat (row ["AddressLine1"], "", row ["AddressLine2"], "", row ["ciudad"], "", row ["Código postal"], "row [" Estado "] , "", row ["País"])
{code}


h3. BirtStr.indexOf

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

 *Sintaxis*
{code}
BirtStr.indexOf (destino, origen, principio)
{code}

 *Parámetros*

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

fuente - La cadena en la quecual 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:
{code}
BirtStr.indexOf ("", "Julie Murphy") // devuelve 5
BirtStr.indexOf ("-", "Modela-1234-567") // devuelve 6
BirtStr.indexOf ("-", "Modela-1234-567", 7) // devuelve 11
{code}

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.
{code}
spaceCharPosition = BirtStr.indexOf ("", row ["customerName"]);
displayFirstName = BirtStr.left (row ["customerName"], spaceCharPosition);
{code}

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


h3. BirtStr.left

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

 *Sintaxis*
{code}
BirtStr.left (fuente, n)
{code}

 *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.
n

* Si se omite n, el número de caracteres a extraer, la función devuelve el primer carácter único.
n* 
Si n es cero, la función devuelve una cadena vacía.
n
* 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:
{code}
BirtStr.left ("Julie Murphy", 5) // devuelve Julie
BirtStr.left ("Julie Murphy", 12) // devuelve Julie Murphy
{code}

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.
{code}
spaceCharPosition = BirtStr.indexOf ("", row ["customerName"]);
displayFirstName = BirtStr.left (row ["customerName"], spaceCharPosition);
{code}

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


h3. 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*
{code}
BirtStr.right (fuente, n)
{code}

 *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.

n
* Si se omite n, en el número de caracteres a extraer, la función devuelve el último carácter único.
n* 
Si n es cero, la función devuelve una cadena vacía.
n* 
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:
{code}
BirtStr.right ("Julie Murphy", 6) // devuelve Murphy
BirtStr.right ("Julie Murphy", 12) // devuelve Julie Murphy
{code}

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.
{code}
spaceCharPosition = BirtStr.indexOf ("", row ["customerName"]);
displayLastName = BirtStr.right (row ["customerName"], (BirtStr.charLength (row ["customerName"] - (spaceCharPosition + 1)))
{code}

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.


h3. 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*
{code}
BirtStr.search (patrón, la fuente, el índice)
{code}

 *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:
"I 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:
{code}
BirtStr.search ("XM?", "XMS-ModelaModelA-1234-567") // devuelve 0
BirtStr.search ("Modela \*", "XMS-ModelaModelA-1234-567") // devuelve 4
BirtStr.search ("-", "XMS-ModelaModelA-1234-567", 4) // devuelve 10
{code}
En el siguiente ejemplo para el patrón de encordadotexto, S * A, en cada valor en el campo ProductCode. Si el código de producto es KBS5412A, la expresión devuelve 2.
{code}
BirtStr.search ("S * A", row ["ProductCode"])
{code}

En el ejemplo siguiente BirtStr.search usos (), en relación con BirtStr.left () para mostrar los caracteres que preceden al patrón de encordadotexto, * 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 encordadotexto.
{code}
stringPatternPosition = BirtStr.search ("Modelo \-Model*", row ["ProductName"]);
DisplayString = BirtStr.left (row ["ProductName"], stringPatternPosition);
{code}

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


h3. BirtStr.toLower

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

 *Sintaxis*
{code}
BirtStr.toLower (fuente)
{code}

 *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:
{code}
BirtStr.toLower (row ["ProductLine"])
BirtStr.toUpper
{code}

h3. BirtStr.toUpper

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

 *Sintaxis*
{code}
BirtStr.toUpper (fuente)
{code}

 *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:
{code}
BirtStr.toUpper (row ["customerName"])
{code}


h3. BirtStr.trim

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

 *Sintaxis*
{code}
BirtStr.trim (fuente)
{code}

 *Parámetro*

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

 *Devoluciones*

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

 *Ejemplo*

En el ejemplo siguiente se utiliza BirtStr.trim () para eliminar todos los personajesespacios iniciales y finales en blanco de los valores en los campos de datos Nombre y Apellidos.
{code}
BirtStr.trim (row ["Nombre"]) + "" + BirtStr.trim (row ["Apellido"])
{code}


h3. BirtStr.trimLeft

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

 *Sintaxis*
{code}
BirtStr.trimLeft (fuente)
{code}

 *Parámetro*

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

 *Devoluciones*

Una cadena con todos los personajesespacios 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.
{code}
"Nombre del cliente:" + BirtStr.trimLeft (row ["customerName"])
{code}


h3. 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*
{code}
BirtStr.trimRight (fuente)
{code}

 *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 de que eldel valor de comentario de modo que no hay caracteres en blanco entre la cadena de comentario y el punto y coma.
{code}
BirtStr.trimRight (row ["comentario"]) + "" + row ["Acción"])
{code}

----
{scrollbar}