copyStr()

La función de sistema StrLib.copyStr copia una subserie en otra.

  StrLib.copyStr(
    destino VagText inOut,
    índiceSubserieDestino INT in,
    longitudSubserieDestino INT in,
    origen VagText in,
    índiceSubserieOrigen INT in,
    longitudSubserieOrigen INT in)
destino
Serie de la que se deriva una subserie destino. Puede ser un elemento o un literal.
índiceSubserieDestino
Identifica el byte inicial de destino, suponiendo que el primer byte de destino tiene el valor 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
Serie de la que se deriva una subserie origen. Puede ser un elemento o un literal.
índiceSubserieOrigen
Identifica el byte inicial de la subserie de origen, suponiendo que el primer byte de origen tiene el valor 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.
longitudSubserieOrigen
Identifica el número de bytes de la subserie que se deriva de origen. 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.

Si el origen es más largo que el destino, el origen se trunca. Si el origen es más corto que el destino, el valor origen se rellena a la derecha con espacios.

Consideraciones de definición

En sysVar.errorCode se devuelven los siguientes valores:
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 DBCS o UNICODE es impar (las longitudes de doble byte deben ser siempre pares).

Ejemplo

  target = "120056";
  source = "34";
  StrLib.copyStr(target,3,2,source,1,2);
  // destino = "123456"

Consulta relacionada
Biblioteca StrLib de EGL

Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.