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 listfirst
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 ListFirst extends BIF {
032        
033        private static final long serialVersionUID = 1098339742182832847L;
034        
035        public static String call(PageContext pc, String list) {
036                return ListUtil.first(list, ",", true, 1);
037        }
038        
039        public static String call(PageContext pc, String list, String delimiter) {
040                return ListUtil.first(list, delimiter, true, 1);
041        }
042        
043        public static String call(PageContext pc, String list, String delimiter, boolean includeEmptyFields) {
044                return ListUtil.first(list, delimiter, !includeEmptyFields, 1);
045        }
046
047        public static String call(PageContext pc, String list, String delimiter, boolean includeEmptyFields, double count) throws FunctionException {
048
049                if (count < 1)
050                        throw new FunctionException(pc, "ListFirst", 4, "count", "Argument count must be a positive value greater than 0");
051
052                return ListUtil.first(list, delimiter, !includeEmptyFields, (int)count);
053        }
054
055    @Override
056        public Object invoke(PageContext pc, Object[] args) throws PageException {
057        if(args.length==1)
058                        return call(pc, Caster.toString(args[0]));
059        if(args.length==2)
060                        return call(pc, Caster.toString(args[0]), Caster.toString(args[1]));
061        if(args.length==3)
062                        return call(pc, Caster.toString(args[0]), Caster.toString(args[1]), Caster.toBooleanValue(args[2]));
063        
064                throw new FunctionException(pc, "ListFirst", 1, 3, args.length);
065        }
066}