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, comenzando en la palabra n y con el número de palabras que se ha especificado por medio del valor longitud.
Formato
@DTW_SUBWORD(serieEntrada, n, longitud, serieSalida)
@DTW_SUBWORD(serieEntrada, n, serieSalida)
@DTW_rSUBWORD(serieEntrada, n, longitud)
@DTW_rSUBWORD(serieEntrada, n)
Parámetros
Tabla 111. Parámetros de DTW_SUBWORD
Tipo de datos | Parámetro | Uso | Descripción |
---|---|---|---|
serie | serieEntrada | IN | Variable o serie literal. |
entero | n | IN | La posición de texto de la primera palabra de la subserie. Se devuelve un nulo si este valor es mayor que el número de palabras de serieEntrada. |
entero | longitud | IN | El número de palabras de la subserie. Si este valor es mayor que el número de palabras desde n al final de la serieEntrada, se devuelven todas las palabras que hay hasta el final de serieEntrada. El valor por omisión es devolver todos las palabras desde n hasta el final de serieEntrada. |
serie | serieSalida | OUT | Variable que contiene una subserie de serieEntrada especificada por medio del valor de n y longitud. |
Códigos de retorno
Tabla 112. Códigos de retorno de DTW_SUBWORD
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_SUBWORD("Now is the time", "5", result)
Ejemplo 2:
@DTW_SUBWORD("Now is the time", "2", result)
Ejemplo 3:
@DTW_SUBWORD(Now is the time", "2", "2", result)
Ejemplo 4:
@DTW_rSUBWORD("Now is the time", "3")