concatenateBytes()

La función de sistema VGLib.concatenateBytes concatena dos campos.

Como vale para StrLib.concatenate, el origen y el destino pueden ser de tipo carácter. En la función actual, el origen también puede ser cualquiera de los tipos siguientes:
  StrLib.concatenateBytes(
    destino un tipo de caracteres inOut,
    origen BIN, DECIMAL, NUM, NUMC, PACF o un tipo de carácter 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 salida concatenada es demasiado larga para caber en el campo destino y la salida se ha truncado, como se describe más adelante
0
La salida concatenada cabe en el campo destino
destino
Campo destino.
origen
Campo origen o literal.

Cuando se concatenan dos valores, se produce lo siguiente:

  1. Los espacios finales o nulos se suprimen del valor destino.
  2. El valor origen se añade al valor generado en el paso anterior
  3. Si la salida generada por el segundo paso es más larga que el campo destino, se trunca la salida. Si la salida es más corta que el campo destino, se rellena con espacios en blanco, incluso aunque la salida sea un número.

Ejemplo

  phrase = "and/  "; // CHAR(7)  
  or     = "or";
  result = 
    VGLib.concatenateBytes(phrase,or);
  if (result == 0)
    print phrase;  // phrase = "and/or "
  end
Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.