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}