Función escalar RTRIM

La función RTRIM elimina los caracteres contenidos en una expresión de ajusta del final de una expresión de serie. La búsqueda de caracteres compara la representación binaria de cada carácter (que consta de uno o más bytes) en la serie de ajuste para la representación binaria de cada carácter (que consta de uno o más bytes) al final de una expresión de serie. La clasificación de base de datos no afecta a la búsqueda. Si la expresión de serie se define como FOR BIT DATA o es un tipo binario, la búsqueda compara cada byte de la expresión de recorte con el byte al final de la expresión de serie.

El esquema es SYSIBM. (La versión SYSFUN de esta función que utiliza un único parámetro sigue estando disponible con el soporte para los argumentos CLOB).

expresión-serie

Expresión que especifica la serie fuente.

• Si sólo se especifica un argumento, la expresión debe devolver una serie de caracteres incorporada, una serie gráfica, una serie binaria, un valor CLOB o DBCLOB, un valor booleano, un valor numérico o un valor de fecha y hora. Si el valor es:
  • No un valor CHAR, VARCHAR, GRAPHIC, VARGRAPHIC, BINARY, VARBINARY o DBCLOB, se convierte de forma implícita a VARCHAR antes de evaluar la función
  • Un valor DBCLOB, se convierte de forma implícita en VARGRAPHIC antes de evaluar la función.
  El tipo de datos de la expresión de serie no puede ser BLOB (SQLSTATE 42815).
• Si se especifican ambos argumentos, la expresión debe devolver una serie de caracteres incorporada, valor booleano, valor numérico o valor de fecha y hora. Si el tipo de datos del valor expresión-serie no es un tipo de datos de serie, el valor se convierte implícitamente en VARCHAR antes de evaluarse la función. La longitud real de un valor CLOB tiene como limitación el tamaño máximo de un tipo de datos VARCHAR (SQLSTATE 22001). La longitud real de un valor BLOB está limitada al tamaño máximo de un tipo de datos VARBINARY (SQLSTATE 22001). La longitud real de un valor DBCLOB tiene como limitación el tamaño máximo de un tipo de datos VARGRAPHIC (SQLSTATE 22001).

expresión-ajuste

Una expresión que especifica los caracteres que se están eliminando del final de una expresión-serie. La expresión debe ser un valor que sea de un tipo de datos de serie de caracteres, numérico o de fecha y hora incorporado.

• Si el tipo de datos de la expresión-ajuste no es una serie, el valor se convierte implícitamente en VARCHAR antes de evaluarse la función.
• Si el tipo de datos de la expresión-ajuste es un CLOB, entonces la longitud real del valor tiene como limitación el tamaño máximo de un VARCHAR (SQLSTATE 22001).
• Si el tipo de datos de la expresión-ajuste es un DBCLOB, entonces la longitud real del valor tiene como limitación el tamaño máximo de un VARGRAPHIC (SQLSTATE 22001).
• Si el tipo de datos de la expresión-ajuste es un BLOB, entonces la longitud real del valor está limitada al tamaño máximo de un VARBINARY (SQLSTATE 22001).
• Si la expresión-serie se ha definido como FOR BIT DATA, la expresión-ajuste no puede definirse como FOR BIT DATA (SQLSTATE 42815).

Cuando no se especifica una expresión-ajuste, el tipo de datos de la expresión-serie determina el valor predeterminado utilizado:

• Un blanco de doble byte si expresión-serie es una serie gráfica de una base de datos DBCS o EUC.
• Un blanco UCS-2 si la expresión-serie es una serie gráfica de una base de datos Unicode.
• Un valor X'20' si la expresión-serie es una serie FOR BIT DATA.
• Un valor de X'00' si la expresión-serie es una serie binaria
• Un blanco de un sólo byte para todos los demás casos.

Los valores de la expresión-serie y la expresión-ajuste deben ser tipos de datos compatibles. Si uno de estos argumentos es una serie de caracteres FOR BIT DATA, el otro argumento no puede ser una serie gráfica (SQLSTATE 42846). Una combinación de argumentos de serie de caracteres y de serie gráfica sólo puede utilizarse en una base de datos Unicode (SQLSTATE 42815).