AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | PTX | SUN | Win NT |
X | X | X | X | X | X | X | X | X |
Finalidad
Devuelve una serie en la que cada uno de los caracteres se ha convertido en otro carácter o sin modificar.
Formato
@DTW_TRANSLATE(serieEntrada, tablaO, tablaI, valor por omisión, serieSalida)
@DTW_TRANSLATE(serieEntrada, tablaO, tablaI, serieSalida)
@DTW_TRANSLATE(serieEntrada, tablaO, serieSalida)
@DTW_TRANSLATE(serieEntrada, serieSalida)
@DTW_rTRANSLATE(serieEntrada, tablaO, tablaI, valor por omisión)
@DTW_rTRANSLATE(serieEntrada, tablaO, tablaI)
@DTW_rTRANSLATE(serieEntrada, tablaO)
@DTW_rTRANSLATE(serieEntrada)
Parámetros
Tabla 105. Parámetros de DTW_TRANSLATE
Tipo de datos | Parámetro | Uso | Descripción |
---|---|---|---|
serie | serieEntrada | IN | Variable o serie literal. |
serie | tablaO | IN | Variable o serie literal utilizada como tabla de conversión. Utilice nulo ("") para especificar tablaI o valor por omisión; en caso contrario este parámetro es opcional. |
serie | tablaI | IN | Variable o serie literal en que se busca serieEntrada. Utilice nulo ("") para especificar valor por omisión; en caso contrario este parámetro es opcional. |
serie | valor por omisión | IN | El carácter por omisión a utilizar. El valor por omisión es un blanco. |
serie | serieSalida | OUT | Variable que contiene el resultado convertido de serieEntrada. |
Códigos de retorno
Tabla 106. Códigos de retorno de DTW_TRANSLATE
Código de retorno | Explicación |
---|---|
-1001 | El servidor no ha podido procesar una petición de Net.Data para asignar memoria. |
1001 | Un parámetro de entrada contenía un valor NULL. |
1003 | Se ha transmitido un número incorrecto de parámetros en una llamada de función. |
1005 | Se ha transmitido un parámetro en una llamada de función que debería haber sido una variable de serie, pero era de un tipo de variable diferente. |
1006 | Se ha transmitido una serie literal en una llamada de función para un parámetro que debería haber sido un parámetro de salida. |
1007 | Un parámetro contiene un valor que no es válido. |
Notas de utilización
Ejemplos
Ejemplo 1:
@DTW_TRANSLATE("abbc", result)
Ejemplo 2:
@DTW_TRANSLATE("abbc", "R", "bc", result)
Ejemplo 3:
@DTW_rTRANSLATE("abcdef", "12", "abcd", ".")
Ejemplo 4:
@DTW_rTRANSLATE("abbc", "", "", "")