001/**
002 *
003 * Copyright (c) 2014, the Railo Company Ltd. All rights reserved.
004 *
005 * This library is free software; you can redistribute it and/or
006 * modify it under the terms of the GNU Lesser General Public
007 * License as published by the Free Software Foundation; either 
008 * version 2.1 of the License, or (at your option) any later version.
009 * 
010 * This library is distributed in the hope that it will be useful,
011 * but WITHOUT ANY WARRANTY; without even the implied warranty of
012 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
013 * Lesser General Public License for more details.
014 * 
015 * You should have received a copy of the GNU Lesser General Public 
016 * License along with this library.  If not, see <http://www.gnu.org/licenses/>.
017 * 
018 **/
019/**
020 * Implements the CFML Function arrayappend
021 */
022package lucee.runtime.functions.arrays;
023
024import lucee.runtime.PageContext;
025import lucee.runtime.exp.PageException;
026import lucee.runtime.functions.BIF;
027import lucee.runtime.op.Caster;
028import lucee.runtime.op.Decision;
029import lucee.runtime.type.Array;
030import lucee.runtime.type.ArrayImpl;
031
032/**
033 * implementation of the Function arrayAppend
034 */
035public final class ArrayAppend extends BIF {
036        
037        private static final long serialVersionUID = 5989673419120862625L;
038
039
040        public static boolean call(PageContext pc , Array array, Object object) throws PageException {
041                return call(pc, array, object, false);
042        }
043        
044        /**
045         * @param pc
046         * @param array
047         * @param object
048         * @return has appended
049         * @throws PageException
050         */
051        public static boolean call(PageContext pc , Array array, Object object, boolean merge) throws PageException {
052                if(merge && Decision.isCastableToArray(object)) {
053                        Object[] appends = Caster.toNativeArray(object);
054                        
055                        if (array instanceof ArrayImpl) {
056                                ((ArrayImpl)array).ensureCapacity( array.size() + appends.length );
057                        }
058                        
059                        for(int i=0;i<appends.length;i++){
060                                array.append(appends[i]);
061                        }
062                }
063                else
064                        array.append(object);
065                return true;
066        }
067        
068        @Override
069        public Object invoke(PageContext pc, Object[] args) throws PageException {
070                if(args.length==2) return call(pc,Caster.toArray(args[0]),args[1]);
071                return call(pc,Caster.toArray(args[0]),args[1],Caster.toBooleanValue(args[2]));
072        }
073}