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 listgetat
021 */
022package lucee.runtime.functions.list;
023
024import lucee.runtime.PageContext;
025import lucee.runtime.exp.FunctionException;
026import lucee.runtime.exp.PageException;
027import lucee.runtime.functions.BIF;
028import lucee.runtime.op.Caster;
029import lucee.runtime.type.util.ListUtil;
030
031public final class ListGetAt extends BIF {
032        
033        private static final long serialVersionUID = -8227074223983816122L;
034
035        public static String call(PageContext pc , String list, double posNumber) throws PageException {
036                return call(pc,list,posNumber,",",false);
037        }
038
039        public static String call(PageContext pc , String list, double posNumber, String delimiter) throws PageException {
040                return call(pc,list,posNumber,delimiter,false);
041        }
042        
043        public static String call(PageContext pc , String list, double posNumber, String delimiter, boolean includeEmptyFields) throws PageException {
044                int pos=(int) posNumber;
045                String rtn = ListUtil.getAt(list,delimiter,pos-1,!includeEmptyFields,null);
046                if(rtn==null) throw new FunctionException(pc,"listGetAt",2,"posNumber","invalid string list index ["+pos+"]");
047                return rtn;
048        }
049    @Override
050        public Object invoke(PageContext pc, Object[] args) throws PageException {
051        if(args.length==2)
052                        return call(pc, Caster.toString(args[0]), Caster.toDoubleValue(args[1]));
053        if(args.length==3)
054                        return call(pc, Caster.toString(args[0]), Caster.toDoubleValue(args[1]), Caster.toString(args[2]));
055        if(args.length==4)
056                        return call(pc, Caster.toString(args[0]), Caster.toDoubleValue(args[1]), Caster.toString(args[2]), Caster.toBooleanValue(args[3]));
057        
058                throw new FunctionException(pc, "ListGetAt", 2, 4, args.length);
059        }
060}