concatenate()

La función de sistema StrLib.concatenate concatena dos series.

  StrLib.concatenate(
    destino un tipo de caracteres inOut,
    origen un tipo de caracteres in.)
  returns (resultado INT)
resultado
Campo numérico que recibe uno de los siguientes valores (definido como de tipo INT o el equivalente: tipo BIN con longitud 9 y sin posiciones decimales) devueltos por la función:
-1
La serie concatenada es demasiado larga para caber en el campo destino y la serie se ha truncado, como se describe más adelante
0
La serie concatenada cabe en el campo destino
destino
Campo destino
origen
Campo origen o literal

Cuando se concatenan dos series, se produce lo siguiente:

  1. Los espacios finales o nulos se suprimen de la serie destino.
  2. La serie origen se añade a la serie generada en el paso anterior.
  3. Si la salida generada por el segundo paso es más larga que el campo de serie destino, se trunca la salida. Si la salida es más corta que el campo destino, se rellena con espacios en blanco.

Ejemplo

  phrase = "and/  "; // CHAR(7)  
  or     = "or";
  result = 
    StrLib.concatenate(phrase,or);
  if (result == 0)
    print phrase;  // phrase = "and/or "
  end

Consulta relacionada
Biblioteca StrLib de EGL

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