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", "+")