La clase BirtComp proporciona funciones para comparar valores, por ejemplo, para probar si un valor es igual a, mayor que o menor que otro valor. Todas las funciones devuelven valores booleanos. Esta clase es estática. La aplicación no puede crear instancias de la clase.
Esta función compara uno o más valores con el contenido de un campo.
Sintaxis
Parámetros
source
Un campo con contenido a utilizar para la comparación.
target
El valor o valores a buscar en el origen.
Devuelve
Booleano. True si un valor de destino coincide con un valor de origen; de lo contrario, devuelve false.
Ejemplos
El ejemplo siguiente prueba si Canada, Mexico o USA son valores en el campo Country. Si alguno de los países está en el campo, la función devuelve true.
El ejemplo siguiente prueba si el 15 de enero de 2009 o el 31 de enero de 2009 son valores en el campo payDate:
El ejemplo siguiente prueba si dos códigos de producto específicos son valores en el campo productCode. Si aparece uno de los dos valores en el campo, se muestra la serie Obsolete; de lo contrario, el valor productCode se visualiza como aparece en el campo.
Esta función prueba si hay un valor entre dos valores especificados.
Sintaxis
Parámetros
source
El valor a probar.
target1
El primer valor en el rango de valores con que comparar.
target2
El segundo valor en el rango de valores con que comparar.
Devuelve
True si el valor de origen está entre los valores target1 y target; de lo contrario, devuelve false.
Ejemplos
Las siguientes expresiones prueban valores de campo para ver si están dentro de un rango de valores especificado:
El ejemplo siguiente calcula fechas de envío. Si un valor OrderDate está en diciembre de 2008 (entre 12/01/08 y 12/31/08), añada 5 días al valor OrderDate. Si un valor OrderDate está en un mes que no es diciembre, añada 3 días al valor OrderDate.
Esta función prueba si un valor de serie coincide con otro valor de serie, dadas las condiciones especificadas.
Sintaxis
Parámetros
source1
El primer valor de serie a utilizar en la comparación.
source2
El segundo valor de serie a utilizar en la comparación.
ignoreCase
Especifique true para realizar una comparación que no distinga mayúsculas y minúsculas. Especifique false para realizar una comparación que distinga mayúsculas y minúsculas.
trim
Especifique true para eliminar blancos iniciales o finales antes de comparar los dos valores. Los blancos en medio de una serie no se eliminan. Especifique false si desea que la comparación incluya blancos iniciales o finales.
Devuelve
True si el valor source1 coincide con el valor source2; de lo contrario, devuelve false.
Ejemplos
Las siguientes expresiones comparan series con distintas condiciones especificadas:
Esta función prueba si un valor es igual a otro valor.
Sintaxis
Parámetros
source
El primer valor a utilizar en la comparación.
target
El segundo valor a utilizar en la comparación.
Devuelve
True si el valor de origen es igual que el valor de destino; de lo contrario, devuelve false.
Ejemplos
Las siguientes expresiones prueban valores de campo para ver si son iguales a valores especificados:
Esta función prueba si un valor es mayor o igual que otro valor.
Sintaxis
Parámetros
source
El primer valor a utilizar en la comparación.
target
El segundo valor a utilizar en la comparación.
Devuelve
True si el valor de origen es mayor o igual que el valor de destino; de lo contrario, devuelve false.
Ejemplos
Las siguientes expresiones prueban valores de campo para ver si son mayores o iguales a valores especificados:
Esta función prueba si un valor es mayor que otro valor.
Sintaxis
Parámetros
source
El primer valor a utilizar en la comparación.
target
El segundo valor a utilizar en la comparación.
Devuelve
True si el valor de origen es mayor o igual que el valor de destino; de lo contrario, devuelve false.
Ejemplos
Las siguientes expresiones prueban valores de campo para ver si son mayores que valores especificados:
Esta función prueba si un valor es menor o igual que otro valor.
Sintaxis
Parámetros
source
El primer valor a utilizar en la comparación.
target
El segundo valor a utilizar en la comparación.
Devuelve
True si el valor de origen es menor o igual que el valor de destino; de lo contrario, devuelve false.
Ejemplos
Las siguientes expresiones prueban valores de campo para ver si son menores o iguales a valores especificados:
Esta función prueba si un valor es menor que otro valor.
Sintaxis
Parámetros
source
El primer valor a utilizar en la comparación.
target
El segundo valor a utilizar en la comparación.
Devuelve
True si el valor de origen es menor que el valor de destino; de lo contrario, devuelve false.
Ejemplos
Las siguientes expresiones prueban valores de campo para ver si son menores que valores especificados:
Esta función prueba si un valor de serie coincide con un patrón. El patrón debe utilizar la sintaxis de coincidencia de patrón de SQL.
Sintaxis
Parámetros
source
El valor de serie a evaluar.
target
El patrón de serie a comparar. Debe especificar el patrón entre comillas (" "). Utilice mayúsculas y minúsculas correctamente al escribir los caracteres que desee comparar. Puede utilizar el carácter especial siguiente en un patrón:
Para emparejar un carácter de porcentaje (%) o subrayado (_) literal, coloque antes de esos caracteres dos caracteres de barra inclinada invertida (\\). Por ejemplo, para emparejar S_10, utilice el siguiente patrón:
Para emparejar 50%, utilice el siguiente patrón:
Devuelve
True si el valor de origen coincide con el valor de destino; de lo contrario, devuelve false.
Ejemplos
El ejemplo siguiente devuelve true para los valores del campo productCode que empiezan por S18:
El ejemplo siguiente devuelve true para los valores de productName que contienen la subserie Ford precedida de un solo carácter:
Esta función prueba si un valor de serie coincide con un patrón. El patrón debe utilizar la sintaxis de expresión regular de JavaScript.
Sintaxis
Parámetros
source
El valor de serie a evaluar.
target
El patrón de serie a comparar. En la sintaxis de expresión regular de JavaScript, especificará un patrón dentro de un par de caracteres de barra inclinada (/). Puede utilizar cualquier carácter especial soportado por las expresiones regulares de JavaScript, por ejemplo los siguientes:
Para emparejar un carácter especial literalmente coloque, antes del carácter
especial, un carácter de barra inclinada invertida (\). Por ejemplo, para emparejar S*10, utilice el siguiente patrón:
Devuelve
True si el valor de origen coincide con el valor de destino; de lo contrario, devuelve false.
Ejemplos
El ejemplo siguiente devuelve true para los valores del campo productCode que empiezan por S18:
El ejemplo siguiente devuelve true para los valores de productName que contienen la subserie Ford:
Esta función prueba si no hay un valor entre dos valores especificados.
Sintaxis
Parámetros
source
El valor a probar.
target1
El primer valor en el rango de valores con que comparar.
target2
El segundo valor en el rango de valores con que comparar.
Devuelve
True si el valor de origen no está entre los valores target1 y target; de lo contrario, devuelve false.
Ejemplos
Las siguientes expresiones prueban valores de campo para ver si están fuera de un rango de valores especificado:
El ejemplo siguiente calcula fechas de envío. Si un valor OrderDate no está en diciembre de 2008 (no está entre 12/01/08 y 12/31/08), añada 3 días al valor OrderDate. Si un valor OrderDate está en diciembre, añada 5 días al valor OrderDate.
Esta función prueba si un valor no es igual a otro valor.
Sintaxis
Parámetros
source
El primer valor a utilizar en la comparación.
target
El segundo valor a utilizar en la comparación.
Devuelve
True si el valor de origen no es igual que el valor de destino; de lo contrario, devuelve false.
Ejemplos
Las siguientes expresiones prueban valores de campo para ver si no son iguales a valores especificados:
Esta función prueba si un valor de serie coincide o no con un
patrón. El patrón debe utilizar la sintaxis de coincidencia de patrón de SQL.
Sintaxis
Parámetros
source
El valor de serie a evaluar.
target
El patrón de serie a comparar. Debe especificar el patrón entre comillas (" "). Utilice mayúsculas y minúsculas correctamente al escribir los caracteres que desee comparar. Puede utilizar el carácter especial siguiente en un patrón:
Para emparejar un carácter de porcentaje (%) o subrayado (_) literal, coloque antes de esos caracteres dos caracteres de barra inclinada invertida (\\). Por ejemplo, para emparejar S_10, utilice el siguiente patrón:
Para emparejar 50%, utilice el siguiente patrón:
Devuelve
True si el valor de origen no coincide con el valor de destino; de lo contrario, devuelve false.
Ejemplos
El ejemplo siguiente devuelve false para los valores del campo productCode que empiezan por S18:
El ejemplo siguiente devuelve false para los valores de productName que contienen la subserie Ford precedida de un solo carácter: