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 subserie de una serie, con caracteres de relleno opcionales.
Formato
@DTW_SUBSTR(serieEntrada1, n, longitud, relleno, serieSalida)
@DTW_SUBSTR(serieEntrada1, n, longitud, serieSalida)
@DTW_SUBSTR(serieEntrada1, n, serieSalida)
@DTW_rSUBSTR(serieEntrada1, n, longitud, relleno)
@DTW_rSUBSTR(serieEntrada1, n, longitud)
@DTW_rSUBSTR(serieEntrada1, n)
Parámetros
Tabla 103. Parámetros de DTW_SUBSTR
Tipo de datos | Parámetro | Uso | Descripción |
---|---|---|---|
serie | serieEntrada | IN | Variable o serie literal que ha de buscarse. |
entero | n | IN | La primera posición de carácter de la subserie. El valor por omisión es comenzar al principio de serieEntrada. |
entero | longitud | IN | El número de caracteres de la subserie. El valor por omisión es el resto de la serie. |
serie | relleno | IN | El carácter de relleno utilizado si n supera la longitud de serieEntrada o si longitud es mayor que serieEntrada. El valor por omisión es un blanco. |
serie | serieSalida | OUT | Variable que contiene una subserie de serieEntrada. |
Códigos de retorno
Tabla 104. Códigos de retorno de DTW_SUBSTR
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_SUBSTR("abc", "2", result)
Ejemplo 2:
@DTW_SUBSTR("abc", "2", "4", result)
Ejemplo 3:
@DTW_SUBSTR("abc", "2", "4", ".", result )
Ejemplo 4:
@DTW_rSUBSTR("abc", "2", "6", ".")