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:
- BIN (o los equivalentes de entero BIGINT, INT y SMALLINT)
- DECIMAL
- NUM
- NUMC
- PACF
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:
- Los espacios finales o nulos se suprimen del valor destino.
- El valor origen se añade al valor generado en el paso anterior
- 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.