Manual de consulta

DTW_TRANSLATE


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

  1. Si tablaI, tablaO y el carácter valor por omisión no están en la lista de parámetros, el parámetro serieEntrada se convierte a mayúsculas.
  2. Si tablaI y tablaO están en la lista, se busca tablaI en cada uno de los caracteres de la serie de entrada y se convierte en tablaO. Si un carácter de tablaI no tiene un carácter correspondiente en tablaO, en su lugar se utiliza el carácter valor por omisió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", "", "", "")


[ Principio de página | Página anterior | Página siguiente | Contenido | Índice ]