railo.runtime.type
Class List

java.lang.Object
  extended by railo.runtime.type.List

public final class List
extends Object

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


Constructor Summary
List()
           
 
Method Summary
static String arrayToList(Array array, String delimeter)
          convert Array Object to string list
static String arrayToList(Collection.Key[] array, String delimeter)
           
static String arrayToList(String[] array, String delimeter)
          convert a string array to string list
static String arrayToListTrim(String[] array, String delimeter)
          convert a string array to string list, removes empty values at begin and end of the list
static String first(String list, String delimeter)
          Deprecated. use instead first(String list, String delimeter, boolean ignoreEmpty)
static String first(String list, String delimeter, boolean ignoreEmpty)
          return first element of the list
static String getAt(String list, char delimeter, int position, boolean ignoreEmpty)
          get a elemnt at a specified position in list
static String getAt(String list, String delimeter, int position, boolean ignoreEmpty)
          gets a value from list
static String last(String list, char delimeter)
          return last element of the list
static String last(String list, String delimeter)
          Deprecated. use instead last(String list, String delimeter, boolean ignoreEmpty)
static String last(String list, String delimeter, boolean ignoreEmpty)
          return last element of the list
static int len(String list, char delimeter, boolean ignoreEmpty)
          returns count of items in the list
static int len(String list, String delimeter, boolean ignoreEmpty)
          returns count of items in the list
static int listContains(String list, String value, String delimeter)
          returns if a value of the list contains given value, case sensitive
static int listContainsIgnoreEmpty(String list, String value, String delimeter)
          returns if a value of the list contains given value, case sensitive, ignore empty positions
static int listContainsIgnoreEmptyNoCase(String list, String value, String delimeter)
          returns if a value of the list contains given value, ignore case, ignore empty values
static int listContainsNoCase(String list, String value, String delimeter)
          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 delimeter)
          finds a value inside a list, do not case sensitive
static int listFindForSwitch(String list, String value, String delimeter)
           
static int listFindIgnoreEmpty(String list, String value, char delimeter)
          finds a value inside a list, case sensitive, ignore empty items
static int listFindIgnoreEmpty(String list, String value, String delimeter)
          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 delimeter)
          finds a value inside a list, do not ignore case
static int listFindNoCase(String list, String value, String delimeter, boolean trim)
          finds a value inside a list, do not ignore case
static int listFindNoCaseIgnoreEmpty(String list, String value, char delimeter)
          finds a value inside a list, ignore case, ignore empty items
static int listFindNoCaseIgnoreEmpty(String list, String value, String delimeter)
          finds a value inside a list, ignore case, ignore empty items
static String listInsertAt(String list, int pos, String value, String delimeter, 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 delimeter)
          casts a list to Array object
static Array listToArray(String list, String delimeter)
          casts a list to Array object
static Array listToArray(String list, String delimeter, boolean multiCharDelim)
           
static Array listToArrayRemoveEmpty(String list, char delimeter)
          casts a list to Array object remove Empty Elements
static Array listToArrayRemoveEmpty(String list, String delimeter)
           
static Array listToArrayRemoveEmpty(String list, String delimeter, boolean multiCharDelim)
          casts a list to Array object remove Empty Elements
static Array listToArrayTrim(String list, char delimeter)
          casts a list to Array object, remove all empty items at start and end of the list
static Array listToArrayTrim(String list, char delimeter, 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 delimeter)
          casts a list to Array object, remove all empty items at start and end of the list
static Array listToArrayTrim(String list, String delimeter, 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 delimeter)
           
static Set<String> listToSet(String list, char delimeter, boolean trim)
           
static Set<String> listToSet(String list, String delimeter, boolean trim)
           
static String[] listToStringArray(String list, char delimeter)
           
static StringList listToStringListRemoveEmpty(String list, char delimeter)
          casts a list to Array object remove Empty Elements
static Array listWithQuotesToArray(String list, String delimeter, 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 delimeter, 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 delimeter)
           
static StringList toListTrim(String list, char delimeter)
           
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 delimeter)
          trims a string list, remove all empty delimeter at start and the end
static String trim(String list, String delimeter, int[] removeInfo)
          trims a string list, remove all empty delimeter 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

List

public List()
Method Detail

listWithQuotesToArray

public static Array listWithQuotesToArray(String list,
                                          String delimeter,
                                          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
delimeter - delimter of the list
quotes - quotes of the list
Returns:
Array Object

listToArray

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

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

listToArray

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

listToArray

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

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

listToArrayRemoveEmpty

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

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

listToArrayRemoveEmpty

public static Array listToArrayRemoveEmpty(String list,
                                           String delimeter)

listToArrayRemoveEmpty

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

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

rest

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

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

listToStringListRemoveEmpty

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

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

listToArrayTrim

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

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

listToArrayTrim

public static Array listToArrayTrim(String list,
                                    String delimeter,
                                    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
delimeter - delimter of the list
info -
Returns:
Array Object

listInsertAt

public static String listInsertAt(String list,
                                  int pos,
                                  String value,
                                  String delimeter,
                                  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
delimeter - delimter of the list
info -
Returns:
Array Object
Throws:
ExpressionException

listToArrayTrim

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

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

toListTrim

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

toList

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

toWordList

public static StringList toWordList(String list)

listToArrayTrim

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

Parameters:
list - list to cast
delimeter - 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 delimeter)
finds a value inside a list, do not ignore case

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

listFindNoCase

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

Parameters:
list - list to search
value - value to find
delimeter - delimeter 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 delimeter)

listFindNoCaseIgnoreEmpty

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

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

listFindNoCaseIgnoreEmpty

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

Parameters:
list - list to search
value - value to find
delimeter - delimeter 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 delimeter)
finds a value inside a list, do not case sensitive

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

listFindIgnoreEmpty

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

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

listFindIgnoreEmpty

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

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

listContainsNoCase

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

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

listContainsIgnoreEmptyNoCase

public static int listContainsIgnoreEmptyNoCase(String list,
                                                String value,
                                                String delimeter)
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
delimeter - delimeter of the list
Returns:
position in list or 0

listContains

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

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

listContainsIgnoreEmpty

public static int listContainsIgnoreEmpty(String list,
                                          String value,
                                          String delimeter)
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
delimeter - delimeter of the list
Returns:
position in list or 0

arrayToListTrim

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

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

arrayToList

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

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

arrayToList

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

arrayToList

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

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

listToList

public static String listToList(List list,
                                String delimeter)
                         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 delimeter)
trims a string list, remove all empty delimeter at start and the end

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

trim

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

Parameters:
list - list to trim
delimeter - delimeter 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 delimeter
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 delimeter
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 delimeter)
Deprecated. use instead first(String list, String delimeter, boolean ignoreEmpty)

return first element of the list

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

first

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

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

last

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

return last element of the list

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

last

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

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

last

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

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

len

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

Parameters:
list -
delimeter -
Returns:
list len

len

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

Parameters:
list -
delimeter -
Returns:
list len

getAt

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

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

getAt

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

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

listToStringArray

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

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 delimeter,
                                    boolean trim)

listToSet

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

toSet

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


Copyright © 2012 Railo