| Wiki Markup |
|---|
{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} |
...
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
| Code Block |
|---|
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} |
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 Block |
|---|
BirtStr.charLength ("Julie Murphy") // devuelve 12
{code}
|
El
...
ejemplo
...
siguiente
...
devuelve
...
la
...
longitud
...
de
...
cada
...
valor
...
en
...
el
...
campo
...
CustomerName:
...
| Code Block |
|---|
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 Block |
|---|
BirtStr.concat (Source1, ..., sourceN)
{code}
*Parámetro*
|
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 Block |
|---|
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 Block |
|---|
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 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: {code} 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:
| Code Block |
|---|
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 Block |
|---|
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.
...
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
| Code Block |
|---|
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.
* 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:
{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.
- 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:
| Code Block |
|---|
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 Block |
|---|
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.
...
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 Block |
|---|
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.
* 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:
{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.
- 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:
| Code Block |
|---|
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 Block |
|---|
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.
...
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 Block |
|---|
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: "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} í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:
| Code Block |
|---|
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
{code}
|
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.
...
| Code Block |
|---|
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
...
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.
...
| Code Block |
|---|
stringPatternPosition = BirtStr.search ("-Model*", row ["ProductName"]);
DisplayString = BirtStr.left (row ["ProductName"], stringPatternPosition);
{code}
|
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
| Code Block |
|---|
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} |
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 Block |
|---|
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 Block |
|---|
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} |
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 Block |
|---|
BirtStr.toUpper (row ["customerName"])
{code}
h3. |
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
| Code Block |
|---|
BirtStr.trim (fuente)
{code}
*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.
{code} |
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.
| Code Block |
|---|
BirtStr.trim (row ["Nombre"]) + "" + BirtStr.trim (row ["Apellido"])
{code}
h3. |
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
| Code Block |
|---|
BirtStr.trimLeft (fuente)
{code}
*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.
{code} |
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.
| Code Block |
|---|
"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 Block |
|---|
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 del valor de comentario de modo que no hay caracteres en blanco entre la cadena de comentario y el punto y coma. {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 del valor de comentario de modo que no hay caracteres en blanco entre la cadena de comentario y el punto y coma.
| Code Block |
|---|
BirtStr.trimRight (row ["comentario"]) + "" + row ["Acción"])
{code}
----
|
...
| Wiki Markup |
|---|
{scrollbar} |