railo.runtime.type.util
Class ListUtil

java.lang.Object
  extended by railo.runtime.type.util.ListUtil

public final class ListUtil
extends Object

List is not a type, only some static method to manipulate String lists


Constructor Summary
ListUtil()
           
 
Method Summary
static String arrayToList(Array array, String delimiter)
          convert Array Object to string list
static String arrayToList(Collection.Key[] array, String delimiter)
           
static String arrayToList(String[] array, String delimiter)
          convert a string array to string list
static String arrayToListTrim(String[] array, String delimiter)
          convert a string array to string list, removes empty values at begin and end of the list
static String first(String list, String delimiter)
          Deprecated. use instead first(String list, String delimiter, boolean ignoreEmpty)
static String first(String list, String delimiter, boolean ignoreEmpty)
          return first element of the list
static String getAt(String list, char delimiter, int position, boolean ignoreEmpty)
          get a elemnt at a specified position in list
static String getAt(String list, String delimiter, int position, boolean ignoreEmpty)
          gets a value from list
static String last(String list, char delimiter)
          return last element of the list
static String last(String list, String delimiter)
          Deprecated. use instead last(String list, String delimiter, boolean ignoreEmpty)
static String last(String list, String delimiter, boolean ignoreEmpty)
          return last element of the list
static int len(String list, char delimiter, boolean ignoreEmpty)
          returns count of items in the list
static int len(String list, String delimiter, boolean ignoreEmpty)
          returns count of items in the list
static int listContains(String list, String value, String delimiter)
          returns if a value of the list contains given value, case sensitive
static int listContainsIgnoreEmpty(String list, String value, String delimiter)
          returns if a value of the list contains given value, case sensitive, ignore empty positions
static int listContainsIgnoreEmptyNoCase(String list, String value, String delimiter)
          returns if a value of the list contains given value, ignore case, ignore empty values
static int listContainsNoCase(String list, String value, String delimiter)
          returns if a value of the list contains given value, ignore case
static int listFind(String list, String value)
          finds a value inside a list, case sensitive
static int listFind(String list, String value, String delimiter)
          finds a value inside a list, do not case sensitive
static int listFindForSwitch(String list, String value, String delimiter)
           
static int listFindIgnoreEmpty(String list, String value, char delimiter)
          finds a value inside a list, case sensitive, ignore empty items
static int listFindIgnoreEmpty(String list, String value, String delimiter)
          finds a value inside a list, case sensitive, ignore empty items
static int listFindNoCase(String list, String value)
          finds a value inside a list, ignore case
static int listFindNoCase(String list, String value, String delimiter)
          finds a value inside a list, do not ignore case
static int listFindNoCase(String list, String value, String delimiter, boolean trim)
          finds a value inside a list, do not ignore case
static int listFindNoCaseIgnoreEmpty(String list, String value, char delimiter)
          finds a value inside a list, ignore case, ignore empty items
static int listFindNoCaseIgnoreEmpty(String list, String value, String delimiter)
          finds a value inside a list, ignore case, ignore empty items
static String listInsertAt(String list, int pos, String value, String delimiter, boolean ignoreEmpty)
          casts a list to Array object, remove all empty items at start and end of the list and store count to info
static Array listToArray(String list, char delimiter)
          casts a list to Array object
static Array listToArray(String list, String delimiter)
          casts a list to Array object
static Array listToArray(String list, String delimiter, boolean multiCharDelim)
           
static Array listToArrayRemoveEmpty(String list, char delimiter)
          casts a list to Array object remove Empty Elements
static Array listToArrayRemoveEmpty(String list, String delimiter)
           
static Array listToArrayRemoveEmpty(String list, String delimiter, boolean multiCharDelim)
          casts a list to Array object remove Empty Elements
static Array listToArrayTrim(String list, char delimiter)
          casts a list to Array object, remove all empty items at start and end of the list
static Array listToArrayTrim(String list, char delimiter, int[] info)
          casts a list to Array object, remove all empty items at start and end of the list
static Array listToArrayTrim(String list, String delimiter)
          casts a list to Array object, remove all empty items at start and end of the list
static Array listToArrayTrim(String list, String delimiter, int[] info)
          casts a list to Array object, remove all empty items at start and end of the list and store count to info
static String listToList(List list, String delimiter)
           
static Set<String> listToSet(String list, char delimiter, boolean trim)
           
static Set<String> listToSet(String list, String delimiter, boolean trim)
           
static String[] listToStringArray(String list, char delimiter)
           
static StringList listToStringListRemoveEmpty(String list, char delimiter)
          casts a list to Array object remove Empty Elements
static Array listWithQuotesToArray(String list, String delimiter, String quotes)
          casts a list to Array object, the list can be have quoted (",') arguments and delimter in this arguments are ignored.
static String rest(String list, String delimiter, boolean ignoreEmpty)
          casts a list to Array object remove Empty Elements
static String sort(String list, String sortType, String sortOrder, String delimiter)
          sorts a string list
static String sortIgnoreEmpty(String list, String sortType, String sortOrder, String delimiter)
          sorts a string list
static StringList toList(String list, char delimiter)
           
static StringList toListTrim(String list, char delimiter)
           
static Set<String> toSet(String[] arr)
           
static String[] toStringArray(Array array)
          cast a Object Array to a String Array
static String[] toStringArray(Array array, String defaultValue)
          cast a Object Array to a String Array
static String[] toStringArrayEL(Array array)
          cast a Object Array to a String Array
static String[] toStringArrayTrim(Array array)
          cast a Object Array to a String Array and trim all values
static StringList toWordList(String list)
           
static String[] trim(String[] array)
          trims a string array, removes all empty array positions at the start and the end of the array
static String trim(String list, String delimiter)
          trims a string list, remove all empty delimiter at start and the end
static String trim(String list, String delimiter, int[] removeInfo)
          trims a string list, remove all empty delimiter at start and the end
static Array trimItems(Array arr)
          trim every single item of the array
static String[] trimItems(String[] arr)
          trim every single item of the array
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ListUtil

public ListUtil()
Method Detail

listWithQuotesToArray

public static Array listWithQuotesToArray(String list,
                                          String delimiter,
                                          String quotes)
casts a list to Array object, the list can be have quoted (",') arguments and delimter in this arguments are ignored. quotes are not removed example: listWithQuotesToArray("aab,a'a,b',a\"a,b\"",",","\"'") will be translated to ["aab","a'a,b'","a\"a,b\""]

Parameters:
list - list to cast
delimiter - delimter of the list
quotes - quotes of the list
Returns:
Array Object

listToArray

public static Array listToArray(String list,
                                String delimiter)
casts a list to Array object

Parameters:
list - list to cast
delimiter - delimter of the list
Returns:
Array Object

listToArray

public static Array listToArray(String list,
                                String delimiter,
                                boolean multiCharDelim)

listToArray

public static Array listToArray(String list,
                                char delimiter)
casts a list to Array object

Parameters:
list - list to cast
delimiter - delimter of the list
Returns:
Array Object

listToArrayRemoveEmpty

public static Array listToArrayRemoveEmpty(String list,
                                           String delimiter,
                                           boolean multiCharDelim)
casts a list to Array object remove Empty Elements

Parameters:
list - list to cast
delimiter - delimter of the list
Returns:
Array Object

listToArrayRemoveEmpty

public static Array listToArrayRemoveEmpty(String list,
                                           String delimiter)

listToArrayRemoveEmpty

public static Array listToArrayRemoveEmpty(String list,
                                           char delimiter)
casts a list to Array object remove Empty Elements

Parameters:
list - list to cast
delimiter - delimter of the list
Returns:
Array Object

rest

public static String rest(String list,
                          String delimiter,
                          boolean ignoreEmpty)
casts a list to Array object remove Empty Elements

Parameters:
list - list to cast
delimiter - delimter of the list
Returns:
Array Object

listToStringListRemoveEmpty

public static StringList listToStringListRemoveEmpty(String list,
                                                     char delimiter)
casts a list to Array object remove Empty Elements

Parameters:
list - list to cast
delimiter - delimter of the list
Returns:
Array Object

listToArrayTrim

public static Array listToArrayTrim(String list,
                                    String delimiter)
casts a list to Array object, remove all empty items at start and end of the list

Parameters:
list - list to cast
delimiter - delimter of the list
Returns:
Array Object

listToArrayTrim

public static Array listToArrayTrim(String list,
                                    String delimiter,
                                    int[] info)
casts a list to Array object, remove all empty items at start and end of the list and store count to info

Parameters:
list - list to cast
delimiter - delimter of the list
info -
Returns:
Array Object

listInsertAt

public static String listInsertAt(String list,
                                  int pos,
                                  String value,
                                  String delimiter,
                                  boolean ignoreEmpty)
                           throws ExpressionException
casts a list to Array object, remove all empty items at start and end of the list and store count to info

Parameters:
list - list to cast
delimiter - delimter of the list
info -
Returns:
Array Object
Throws:
ExpressionException

listToArrayTrim

public static Array listToArrayTrim(String list,
                                    char delimiter)
casts a list to Array object, remove all empty items at start and end of the list

Parameters:
list - list to cast
delimiter - delimter of the list
Returns:
Array Object

toListTrim

public static StringList toListTrim(String list,
                                    char delimiter)
Parameters:
list -
delimiter -
Returns:
trimmed list

toList

public static StringList toList(String list,
                                char delimiter)
Parameters:
list -
delimiter -
Returns:
list

toWordList

public static StringList toWordList(String list)

listToArrayTrim

public static Array listToArrayTrim(String list,
                                    char delimiter,
                                    int[] info)
casts a list to Array object, remove all empty items at start and end of the list

Parameters:
list - list to cast
delimiter - delimter of the list
info -
Returns:
Array Object

listFindNoCase

public static int listFindNoCase(String list,
                                 String value)
finds a value inside a list, ignore case

Parameters:
list - list to search
value - value to find
Returns:
position in list (0-n) or -1

listFindNoCase

public static int listFindNoCase(String list,
                                 String value,
                                 String delimiter)
finds a value inside a list, do not ignore case

Parameters:
list - list to search
value - value to find
delimiter - delimiter of the list
Returns:
position in list (0-n) or -1

listFindNoCase

public static int listFindNoCase(String list,
                                 String value,
                                 String delimiter,
                                 boolean trim)
finds a value inside a list, do not ignore case

Parameters:
list - list to search
value - value to find
delimiter - delimiter of the list
trim - trim the list or not
Returns:
position in list (0-n) or -1

listFindForSwitch

public static int listFindForSwitch(String list,
                                    String value,
                                    String delimiter)

listFindNoCaseIgnoreEmpty

public static int listFindNoCaseIgnoreEmpty(String list,
                                            String value,
                                            String delimiter)
finds a value inside a list, ignore case, ignore empty items

Parameters:
list - list to search
value - value to find
delimiter - delimiter of the list
Returns:
position in list or 0

listFindNoCaseIgnoreEmpty

public static int listFindNoCaseIgnoreEmpty(String list,
                                            String value,
                                            char delimiter)
finds a value inside a list, ignore case, ignore empty items

Parameters:
list - list to search
value - value to find
delimiter - delimiter of the list
Returns:
position in list or 0

listFind

public static int listFind(String list,
                           String value)
finds a value inside a list, case sensitive

Parameters:
list - list to search
value - value to find
Returns:
position in list or 0

listFind

public static int listFind(String list,
                           String value,
                           String delimiter)
finds a value inside a list, do not case sensitive

Parameters:
list - list to search
value - value to find
delimiter - delimiter of the list
Returns:
position in list or 0

listFindIgnoreEmpty

public static int listFindIgnoreEmpty(String list,
                                      String value,
                                      String delimiter)
finds a value inside a list, case sensitive, ignore empty items

Parameters:
list - list to search
value - value to find
delimiter - delimiter of the list
Returns:
position in list or 0

listFindIgnoreEmpty

public static int listFindIgnoreEmpty(String list,
                                      String value,
                                      char delimiter)
finds a value inside a list, case sensitive, ignore empty items

Parameters:
list - list to search
value - value to find
delimiter - delimiter of the list
Returns:
position in list or 0

listContainsNoCase

public static int listContainsNoCase(String list,
                                     String value,
                                     String delimiter)
returns if a value of the list contains given value, ignore case

Parameters:
list - list to search in
value - value to serach
delimiter - delimiter of the list
Returns:
position in list or 0

listContainsIgnoreEmptyNoCase

public static int listContainsIgnoreEmptyNoCase(String list,
                                                String value,
                                                String delimiter)
returns if a value of the list contains given value, ignore case, ignore empty values

Parameters:
list - list to search in
value - value to serach
delimiter - delimiter of the list
Returns:
position in list or 0

listContains

public static int listContains(String list,
                               String value,
                               String delimiter)
returns if a value of the list contains given value, case sensitive

Parameters:
list - list to search in
value - value to serach
delimiter - delimiter of the list
Returns:
position in list or 0

listContainsIgnoreEmpty

public static int listContainsIgnoreEmpty(String list,
                                          String value,
                                          String delimiter)
returns if a value of the list contains given value, case sensitive, ignore empty positions

Parameters:
list - list to search in
value - value to serach
delimiter - delimiter of the list
Returns:
position in list or 0

arrayToListTrim

public static String arrayToListTrim(String[] array,
                                     String delimiter)
convert a string array to string list, removes empty values at begin and end of the list

Parameters:
array - array to convert
delimiter - delimiter for the new list
Returns:
list generated from string array

arrayToList

public static String arrayToList(String[] array,
                                 String delimiter)
convert a string array to string list

Parameters:
array - array to convert
delimiter - delimiter for the new list
Returns:
list generated from string array

arrayToList

public static String arrayToList(Collection.Key[] array,
                                 String delimiter)

arrayToList

public static String arrayToList(Array array,
                                 String delimiter)
                          throws PageException
convert Array Object to string list

Parameters:
array - array to convert
delimiter - delimiter for the new list
Returns:
list generated from string array
Throws:
PageException

listToList

public static String listToList(List list,
                                String delimiter)
                         throws PageException
Throws:
PageException

trim

public static String[] trim(String[] array)
trims a string array, removes all empty array positions at the start and the end of the array

Parameters:
array - array to remove elements
Returns:
cleared array

trim

public static String trim(String list,
                          String delimiter)
trims a string list, remove all empty delimiter at start and the end

Parameters:
list - list to trim
delimiter - delimiter of the list
Returns:
trimed list

trim

public static String trim(String list,
                          String delimiter,
                          int[] removeInfo)
trims a string list, remove all empty delimiter at start and the end

Parameters:
list - list to trim
delimiter - delimiter of the list
removeInfo - int array contain count of removed values (removeInfo[0]=at the begin;removeInfo[1]=at the end)
Returns:
trimed list

sortIgnoreEmpty

public static String sortIgnoreEmpty(String list,
                                     String sortType,
                                     String sortOrder,
                                     String delimiter)
                              throws PageException
sorts a string list

Parameters:
list - list to sort
sortType - sort type (numeric,text,textnocase)
sortOrder - sort order (asc,desc)
delimiter - list delimiter
Returns:
sorted list
Throws:
PageException

sort

public static String sort(String list,
                          String sortType,
                          String sortOrder,
                          String delimiter)
                   throws PageException
sorts a string list

Parameters:
list - list to sort
sortType - sort type (numeric,text,textnocase)
sortOrder - sort order (asc,desc)
delimiter - list delimiter
Returns:
sorted list
Throws:
PageException

toStringArrayEL

public static String[] toStringArrayEL(Array array)
cast a Object Array to a String Array

Parameters:
array -
Returns:
String Array

toStringArray

public static String[] toStringArray(Array array)
                              throws PageException
cast a Object Array to a String Array

Parameters:
array -
Returns:
String Array
Throws:
PageException

toStringArray

public static String[] toStringArray(Array array,
                                     String defaultValue)
cast a Object Array to a String Array

Parameters:
array -
defaultValue -
Returns:
String Array

toStringArrayTrim

public static String[] toStringArrayTrim(Array array)
                                  throws PageException
cast a Object Array to a String Array and trim all values

Parameters:
array -
Returns:
String Array
Throws:
PageException

first

public static String first(String list,
                           String delimiter)
Deprecated. use instead first(String list, String delimiter, boolean ignoreEmpty)

return first element of the list

Parameters:
list -
delimiter -
Returns:
returns the first element of the list

first

public static String first(String list,
                           String delimiter,
                           boolean ignoreEmpty)
return first element of the list

Parameters:
list -
delimiter -
ignoreEmpty -
Returns:
returns the first element of the list

last

public static String last(String list,
                          String delimiter)
Deprecated. use instead last(String list, String delimiter, boolean ignoreEmpty)

return last element of the list

Parameters:
list -
delimiter -
Returns:
returns the last Element of a list

last

public static String last(String list,
                          String delimiter,
                          boolean ignoreEmpty)
return last element of the list

Parameters:
list -
delimiter -
ignoreEmpty -
Returns:
returns the last Element of a list

last

public static String last(String list,
                          char delimiter)
return last element of the list

Parameters:
list -
delimiter -
Returns:
returns the last Element of a list

len

public static int len(String list,
                      char delimiter,
                      boolean ignoreEmpty)
returns count of items in the list

Parameters:
list -
delimiter -
Returns:
list len

len

public static int len(String list,
                      String delimiter,
                      boolean ignoreEmpty)
returns count of items in the list

Parameters:
list -
delimiter -
Returns:
list len

getAt

public static String getAt(String list,
                           String delimiter,
                           int position,
                           boolean ignoreEmpty)
gets a value from list

Parameters:
list - list to cast
delimiter - delimter of the list
position -
Returns:
Array Object

getAt

public static String getAt(String list,
                           char delimiter,
                           int position,
                           boolean ignoreEmpty)
get a elemnt at a specified position in list

Parameters:
list - list to cast
delimiter - delimter of the list
position -
Returns:
Array Object

listToStringArray

public static String[] listToStringArray(String list,
                                         char delimiter)

trimItems

public static String[] trimItems(String[] arr)
trim every single item of the array

Parameters:
arr -
Returns:

trimItems

public static Array trimItems(Array arr)
                       throws PageException
trim every single item of the array

Parameters:
arr -
Returns:
Throws:
PageException

listToSet

public static Set<String> listToSet(String list,
                                    String delimiter,
                                    boolean trim)

listToSet

public static Set<String> listToSet(String list,
                                    char delimiter,
                                    boolean trim)

toSet

public static Set<String> toSet(String[] arr)


Copyright © 2012 Railo