Manual de consulta

DTW_INSERT


AIX HP-UX Linux OS/2 OS/390 OS/400 PTX SUN Win NT
X X X X X X X X X

Finalidad

Inserta una serie en otra serie comenzando después del carácter enésimo.

Formato

@DTW_INSERT(serieEntrada1, serieEntrada2, n, longitud, relleno, serieSalida)

@DTW_INSERT(serieEntrada1, serieEntrada2, n, longitud, serieSalida)

@DTW_INSERT(serieEntrada1, serieEntrada2, n, serieSalida)

@DTW_INSERT(serieEntrada1, serieEntrada2, serieSalida)

@DTW_rINSERT(serieEntrada1, serieEntrada2, n, longitud, relleno)

@DTW_rINSERT(serieEntrada1, serieEntrada2, n, longitud)

@DTW_rINSERT(serieEntrada1, serieEntrada2, n)

@DTW_rINSERT(serieEntrada1, serieEntrada2)

Parámetros

Tabla 87. Parámetros de DTW_INSERT
Tipo de datos Parámetro Uso Descripción
serie serieEntrada1 IN Variable o serie literal que ha de insertarse en serieEntrada2.
serie serieEntrada2 IN Variable o serie literal.
entero n IN La posición de carácter de serieEntrada2 después de la cual se inserta serieEntrada1. Si n supera la longitud de serieEntrada2, se rellena con el carácter de relleno, relleno, hasta que tenga caracteres suficientes. El valor por omisión es insertar al principio de serieEntrada2.
entero longitud IN El número de caracteres de serieEntrada1 a insertar. La serie se rellena con el carácter de relleno, relleno, si este parámetro supera la longitud de serieEntrada1. El valor por omisión es la longitud de serieEntrada1.
entero relleno IN El carácter de relleno, tal como se describe para n y longitud. El valor de relleno por omisión es un blanco.
serie serieSalida OUT Variable que contiene serieEntrada2 que se modifica insertando serieEntrada1 o parte de la misma.

Códigos de retorno

Tabla 88. Códigos de retorno de DTW_INSERT
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.

Ejemplos

Ejemplo 1:

@DTW_INSERT("123", "abc",
result)

Ejemplo 2:

@DTW_INSERT("123", "abc",
"5", result)

Ejemplo 3:

@DTW_INSERT("123", "abc",
"5", "6", result)

Ejemplo 4:

@DTW_INSERT("123", "abc",
"5", "6", "/", result)

Ejemplo 5:

@DTW_rINSERT("123", "abc",
"5", "6", "+")


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