setSubStr()

La función de sistema StrLib.setSubStr sustituye cada carácter de una subserie por un carácter especificado.

  StrLib.setSubStr(
    destino VagText inOut,
    índiceSubserieDestino INT in,
    longitudSubserieDestino INT in,
    origen)
destino
Elemento que se cambia.
índiceSubserieDestino
Identifica el byte inicial de la subserie de destino, suponiendo que el primer byte de destino tenga el valor de índice 1. Este índice puede ser un literal entero. Como alternativa, este índice puede ser un elemento definido como de tipo INT o el siguiente equivalente: tipo BIN con longitud 9 y sin posiciones decimales.
longitudSubserieDestino
Identifica el número de bytes de la subserie que se deriva de destino. La longitud puede ser un literal entero. Como alternativa, la longitud puede ser un elemento definido como de tipo INT o el siguiente equivalente: tipo BIN con longitud 9 y sin posiciones decimales.
origen
Si el elemento destino es CHAR, MBCHAR o HEX, el elemento origen debe ser un elemento CHAR, MBCHAR o HEX de un byte o un literal CHAR. Si el destino es un elemento DBCHAR o UNICODE, el origen debe ser un elemento DBCHAR o UNICODE de un solo carácter.

Consideraciones de definición

Se devuelven los siguientes valores en SysVar.errorCode:
8
El índice es menor que 1 o mayor que la longitud de la serie
12
La longitud es menor que 1
20
Índice de doble byte no válido. El índice de una serie DBCHAR o UNICODE señala a la mitad del carácter de doble byte
24
Longitud de doble byte no válida. La longitud en bytes de una serie DBCHAR o UNICODE es impar (las longitudes de doble byte deben ser siempre pares)

Ejemplo

  StrLib.setSubStr(target,12,5," ");

Consulta relacionada
Biblioteca StrLib de EGL

Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.