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 la posición de la primera ocurrencia de una serie en otra serie, utilizando una patrón de búsqueda hacia adelante.
Formato
@DTW_POS(serieEntrada1, serieEntrada2, n, nSalida)
@DTW_POS(serieEntrada1, serieEntrada2, nSalida)
@DTW_rPOS(serieEntrada1, serieEntrada2, n)
@DTW_rPOS(serieEntrada1, serieEntrada2)
Parámetros
Tabla 95. Parámetros de DTW_POS
Tipo de datos | Parámetro | Uso | Descripción |
---|---|---|---|
serie | serieEntrada1 | IN | Variable o serie literal que ha de buscarse. |
serie | serieEntrada2 | IN | Variable o serie literal donde buscar. |
entero | n | IN | La posición de carácter de serieEntrada2 en la que ha de comenzar la búsqueda. El valor por omisión es el de comenzar la búsqueda en el primer carácter de serieEntrada2. |
entero | nSalida | OUT | Variable que contiene la posición de la primera ocurrencia de serieEntrada1 en serieEntrada2. Si no se encuentra ninguna ocurrencia, se devuelve un 0. |
Códigos de retorno
Tabla 96. Códigos de retorno de DTW_POS
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. |
1002 | Un parámetro de entrada contenía un valor de serie que consistía en el carácter de terminación nulo. |
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_POS("day", "Saturday", result)
Ejemplo 2:
@DTW_POS("a", "Saturday", "3", result)
Ejemplo 3:
@DTW_rPOS(" ", "abc def ghi", "5")