concatenate()

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

  StrLib.concatenate(
    destino VagText inOut,
    origen VagText in)
  returns (resultado INT)
resultado
Elemento 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 elemento destino y la serie se ha truncado, como se describe más adelante
0
La serie concatenada cabe en el elemento destino
destino
Elemento destino
origen
Literal o elemento origen

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 1.
  3. Si la serie generada en el paso 2 es más larga que el elemento de serie destino, la serie se trunca. Si es más corta que el elemento 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

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