strLib.concatenateWithSeparator

La función de sistema strLib.concatenateWithSeparator concatena dos series, insertando una serie separadora entre ellas. Si la longitud inicial de la serie destino es cero (sin contar los blancos finales y los nulos), el separador se omite y la serie origen se copia en la serie destino.


Diagrama de sintaxis de strLib.concatenateWithSeparator
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
0
La serie concatenada cabe en el elemento destino.
-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
destino
Elemento destino.
origen
Literal o elemento origen.
separador
Literal o elemento separador.

Los espacios y nulos finales se truncan en el destino; a continuación, las series separador y origen se añaden al final del valor truncado. Si la concatenación es más larga de lo que permite el destino, se produce un truncamiento. Si la concatenación es más corta de lo que permite el destino, el valor concatenado se rellena con espacios.

Ejemplo

  phrase = "and";   // CHAR(7)
  or     = "or";
  result = 
    strLib.concatenateWithSeparator(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.