StringUtils

Object
- com.net2plan.utils.StringUtils

```
public class StringUtils
extends Object
```
Provides extra functionality for String objects.

Since:

0.2.0

Author:

Pablo Pavon-Marino, Jose-Luis Izquierdo-Zaragoza

Method Summary

Methods
Modifier and Type	Method and Description
`static String[]`	`arrayOf(String... values)` Generates an `String[]` from comma-separated values.
`static int[]`	`find(String[] array, String value, Constants.SearchType searchType)` Returns the position(s) where a given value can be found into an array.
`static String`	`getLineSeparator()` Returns the line separator.
`static String`	`join(Collection<String> collection, String separator)` Joins elements from a given collection into a `String`.
`static String`	`join(String[] array, String separator)` Joins elements from a given array into a `String`.
`static String`	`mapToString(Map map)` Outputs entries from a `Map` to a `String`.
`static String`	`mapToString(Map map, String keyValueSeparator, String entrySeparator)` Outputs entries from a `Map` to a `String`.
`static void`	`saveToFile(String text, File file)` Outputs an `String` to a file.
`static void`	`saveToFile(String text, File file, boolean append)` Outputs an `String` to a file.
`static String`	`secondsToYearsDaysHoursMinutesSeconds(double seconds)` Converts a timestamp in seconds into its equivalent representation in days, hours, minutes and seconds.
`static String[]`	`select(String[] array, int[] indexes)` Returns a set of selected elements from an input array.
`static String[]`	`split(String string)` Splits a String into an array asumming items are separated by spaces.
`static String[]`	`split(String string, String separators)` Splits a String into an array according to a set of separators (i.e. ", " means that the separator can be either a comma or a space).
`static Map<String,String>`	`stringToMap(String string)` Converts an `String` to a map.
`static Map<String,String>`	`stringToMap(String string, String keyValueSeparator, String entrySeparator)` Converts an `String` to a map.
`static String[]`	`toArray(Collection list)` Converts a collection (`List`, `Set`...) of objects to a `String` array.
`static boolean[]`	`toBooleanArray(Collection<String> collection)` Converts a collection of `String` objects to a `boolean` array.
`static boolean[]`	`toBooleanArray(Collection<String> collection, boolean valueForNull)` Converts a collection of `String` objects to a `boolean` array.
`static boolean[]`	`toBooleanArray(String[] array)` Converts a `String` array to a `boolean` array.
`static boolean[]`	`toBooleanArray(String[] array, boolean valueForNull)` Converts a `String` array to a `boolean` array.
`static List<Boolean>`	`toBooleanList(String[] array)` Converts a `String` array to a `boolean` array.
`static List<Boolean>`	`toBooleanList(String[] array, boolean valueForNull)` Converts a `String` array to a `Boolean` list.
`static <A> Map<A,Boolean>`	`toBooleanMap(Map<A,String> map)` Converts a map whose values are `String` objects to another where values are `Boolean` objects.
`static <A> Map<A,Boolean>`	`toBooleanMap(Map<A,String> map, boolean valueForNull)` Converts a map whose values are `String` objects to another where values are `Boolean` objects.
`static double[]`	`toDoubleArray(Collection<String> collection)` Converts a collection of `String` objects to a `double` array.
`static double[]`	`toDoubleArray(Collection<String> collection, double valueForNull)` Converts a collection of `String` objects to a `double` array.
`static double[]`	`toDoubleArray(String[] array)` Converts a `String` array to a `double` array.
`static double[]`	`toDoubleArray(String[] array, double valueForNull)` Converts a `String` array to a `double` array.
`static List<Double>`	`toDoubleList(String[] array)` Converts a `String` array to a `double` array.
`static List<Double>`	`toDoubleList(String[] array, double valueForNull)` Converts a `String` array to a `double` array.
`static <A> Map<A,Double>`	`toDoubleMap(Map<A,String> map)` Converts a map whose values are `String` objects to another where values are `Double` objects.
`static <A> Map<A,Double>`	`toDoubleMap(Map<A,String> map, double valueForNull)` Converts a map whose values are `String` objects to another where values are `Double` objects.
`static int[]`	`toIntArray(Collection<String> collection)` Converts a collection of `String` objects to an `int` array.
`static int[]`	`toIntArray(Collection<String> collection, int valueForNull)` Converts a collection of `String` objects to an `int` array.
`static int[]`	`toIntArray(String[] array)` Converts a `String` array to an `int` array.
`static int[]`	`toIntArray(String[] array, int valueForNull)` Converts a `String` array to an `int` array.
`static <A> Map<A,Integer>`	`toIntegerMap(Map<A,String> map)` Converts a map whose values are `String` objects to another where values are `Integer` objects.
`static <A> Map<A,Integer>`	`toIntegerMap(Map<A,String> map, int valueForNull)` Converts a map whose values are `String` objects to another where values are `Integer` objects.
`static List<String>`	`toList(String[] array)` Converts from a `String` array to a list.
`static long[]`	`toLongArray(Collection<String> collection)` Converts a collection of `String` objects to a `long` array.
`static long[]`	`toLongArray(Collection<String> collection, long valueForNull)` Converts a collection of `String` objects to a `long` array.
`static long[]`	`toLongArray(String[] array)` Converts a `String` array to a `long` array.
`static long[]`	`toLongArray(String[] array, long valueForNull)` Converts a `String` array to a `long` array.
`static List<Long>`	`toLongList(String[] array)` Converts a `String` array to a `long` array.
`static List<Long>`	`toLongList(String[] array, long valueForNull)` Converts a `String` array to a `long` array.
`static <A> Map<A,Long>`	`toLongMap(Map<A,String> map)` Converts a map whose values are `String` objects to another where values are `Long` objects.
`static <A> Map<A,Long>`	`toLongMap(Map<A,String> map, long valueForNull)` Converts a map whose values are `String` objects to another where values are `Long` objects.
`static Map<String,String>`	`toMap(String string, String keyValueSeparator, String entrySeparator)` Converts to a `Map` a codified `String`.

Methods inherited from class Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - arrayOf
```
public static String[] arrayOf(String... values)
```
    Generates an String[] from comma-separated values.
    
    Parameters:
    values - Comma-separated String values
    
    Returns:
    String[]
    Since:
    
    0.3.0
  - find
```
public static int[] find(String[] array,
         String value,
         Constants.SearchType searchType)
```
    Returns the position(s) where a given value can be found into an array.
    
    Parameters:
    array - Input array
    value - Value to be searched for
    searchType - Indicates whether the first, the last, or all occurrences are returned
    
    Returns:
    Position(s) in which the given value can be found
    Since:
    
    0.3.0
  - getLineSeparator
```
public static String getLineSeparator()
```
    Returns the line separator. Each operating system uses a different one (e.g. \r\n on Microsoft Windows, \n for Unix systems...).
    
    Returns:
    The line separator
    Since:
    
    0.2.0
  - join
```
public static String join(Collection<String> collection,
          String separator)
```
    Joins elements from a given collection into a String.
    
    Parameters:
    collection - Input collection
    separator - Entry separator
    
    Returns:
    A String
    Since:
    
    0.2.0
  - join
```
public static String join(String[] array,
          String separator)
```
    Joins elements from a given array into a String.
    
    Parameters:
    array - Input array
    separator - Entry separator
    
    Returns:
    A String
    Since:
    
    0.2.0
  - mapToString
```
public static String mapToString(Map map)
```
    Outputs entries from a Map to a String. Default separator between each key and value is '=', and separator between key-value pair is ', '.
    
    Parameters:
    map - Input map
    
    Returns:
    String representing the map
    Since:
    
    0.3.0
  - mapToString
```
public static String mapToString(Map map,
                 String keyValueSeparator,
                 String entrySeparator)
```
    Outputs entries from a Map to a String.
    
    Parameters:
    map - Input map
    keyValueSeparator - Separator between keys and values
    entrySeparator - Separator between key-value pairs
    
    Returns:
    String representing the map
    Since:
    
    0.2.0
  - saveToFile
```
public static void saveToFile(String text,
              File file)
```
    Outputs an String to a file.
    
    Parameters:
    text - String to be saved
    file - File where save the contents
    Since:
    
    0.3.1
  - saveToFile
```
public static void saveToFile(String text,
              File file,
              boolean append)
```
    Outputs an String to a file.
    
    Parameters:
    text - String to be saved
    file - File where save the contents
    append - Indicates whether file must be overriden if already exists (if true), or text is append at the end (if false)
    Since:
    
    0.3.1
  - secondsToYearsDaysHoursMinutesSeconds
```
public static String secondsToYearsDaysHoursMinutesSeconds(double seconds)
```
    Converts a timestamp in seconds into its equivalent representation in days, hours, minutes and seconds.
    
    Parameters:
    seconds - Timestamp
    
    Returns:
    String representation in days, hours, minutes and seconds
    Since:
    
    0.3.0
  - select
```
public static String[] select(String[] array,
              int[] indexes)
```
    Returns a set of selected elements from an input array. It is not backed in the input array, thus changes in this array are not reflected in the input array.
    
    Parameters:
    array - Input array
    indexes - Position of elements to be selected.
    
    Returns:
    Set of elements in the order given by indexes
    Since:
    
    0.2.3
  - split
```
public static String[] split(String string)
```
    Splits a String into an array asumming items are separated by spaces.
    
    Parameters:
    string - Input string
    
    Returns:
    String array
    Since:
    
    0.2.0
  - split
```
public static String[] split(String string,
             String separators)
```
    Splits a String into an array according to a set of separators (i.e. ", " means that the separator can be either a comma or a space).
    
    Parameters:
    string - Input string
    separators - Set of separators
    
    Returns:
    String array (empty array if string = null)
    Since:
    
    0.2.0
  - stringToMap
```
public static Map<String,String> stringToMap(String string)
```
    Converts an String to a map. Default separator between each key and value is '=', and separator between key-value pair is ', '.
    
    Parameters:
    string - Input String
    
    Returns:
    String representing the map
    Since:
    
    0.3.0
  - stringToMap
```
public static Map<String,String> stringToMap(String string,
                             String keyValueSeparator,
                             String entrySeparator)
```
    Converts an String to a map.
    
    Parameters:
    string - Input String
    keyValueSeparator - Separator between keys and values
    entrySeparator - Separator between key-value pairs
    
    Returns:
    Map
    Since:
    
    0.3.0
  - toArray
```
public static String[] toArray(Collection list)
```
    Converts a collection (List, Set...) of objects to a String array. If objects are not instances of String, toString() will be used.
    
    Parameters:
    list - Input list
    
    Returns:
    String array (empty array if list = null)
    Since:
    
    0.2.0
  - toBooleanArray
```
public static boolean[] toBooleanArray(Collection<String> collection)
```
    Converts a collection of String objects to a boolean array.
    
    Parameters:
    collection - Input collection
    
    Returns:
    New boolean array
    Since:
    
    0.3.0
  - toBooleanArray
```
public static boolean[] toBooleanArray(Collection<String> collection,
                       boolean valueForNull)
```
    Converts a collection of String objects to a boolean array.
    
    Parameters:
    collection - Input collection
    valueForNull - Value for null positions
    
    Returns:
    New boolean array
    Since:
    
    0.3.0
  - toBooleanArray
```
public static boolean[] toBooleanArray(String[] array)
```
    Converts a String array to a boolean array.
    
    Parameters:
    array - Input array
    
    Returns:
    New boolean array
    Since:
    
    0.2.0
  - toBooleanArray
```
public static boolean[] toBooleanArray(String[] array,
                       boolean valueForNull)
```
    Converts a String array to a boolean array.
    
    Parameters:
    array - Input array
    valueForNull - Value for null positions
    
    Returns:
    New boolean array
    Since:
    
    0.2.0
  - toBooleanList
```
public static List<Boolean> toBooleanList(String[] array)
```
    Converts a String array to a boolean array.
    
    Parameters:
    array - Input array
    
    Returns:
    New boolean array
    Since:
    
    0.2.0
  - toBooleanList
```
public static List<Boolean> toBooleanList(String[] array,
                          boolean valueForNull)
```
    Converts a String array to a Boolean list.
    
    Parameters:
    array - Input array
    valueForNull - Value for null positions
    
    Returns:
    New boolean array
    Since:
    
    0.2.0
  - toBooleanMap
```
public static <A> Map<A,Boolean> toBooleanMap(Map<A,String> map)
```
    Converts a map whose values are String objects to another where values are Boolean objects.
    
    Type Parameters:
    A - Key type
    Parameters:
    map - Input map
    
    Returns:
    New map where values are Boolean objects
    Since:
    
    0.3.0
  - toBooleanMap
```
public static <A> Map<A,Boolean> toBooleanMap(Map<A,String> map,
                              boolean valueForNull)
```
    Converts a map whose values are String objects to another where values are Boolean objects.
    
    Type Parameters:
    A - Key type
    Parameters:
    map - Input map
    valueForNull - Value for null entries
    
    Returns:
    New map where values are Boolean objects
    Since:
    
    0.3.0
  - toDoubleArray
```
public static double[] toDoubleArray(Collection<String> collection)
```
    Converts a collection of String objects to a double array.
    
    Parameters:
    collection - Input collection
    
    Returns:
    New double array
    Since:
    
    0.3.0
  - toDoubleArray
```
public static double[] toDoubleArray(Collection<String> collection,
                     double valueForNull)
```
    Converts a collection of String objects to a double array.
    
    Parameters:
    collection - Input collection
    valueForNull - Value for null positions
    
    Returns:
    New double array
    Since:
    
    0.3.0
  - toDoubleArray
```
public static double[] toDoubleArray(String[] array)
```
    Converts a String array to a double array.
    
    Parameters:
    array - Input array
    
    Returns:
    New double array
    Since:
    
    0.2.0
  - toDoubleArray
```
public static double[] toDoubleArray(String[] array,
                     double valueForNull)
```
    Converts a String array to a double array.
    
    Parameters:
    array - Input array
    valueForNull - Value for null positions
    
    Returns:
    New double array
    Since:
    
    0.2.0
  - toDoubleList
```
public static List<Double> toDoubleList(String[] array)
```
    Converts a String array to a double array.
    
    Parameters:
    array - Input array
    
    Returns:
    New double array
    Since:
    
    0.2.0
  - toDoubleList
```
public static List<Double> toDoubleList(String[] array,
                        double valueForNull)
```
    Converts a String array to a double array.
    
    Parameters:
    array - Input array
    valueForNull - Value for null positions
    
    Returns:
    New double array
    Since:
    
    0.2.0
  - toDoubleMap
```
public static <A> Map<A,Double> toDoubleMap(Map<A,String> map)
```
    Converts a map whose values are String objects to another where values are Double objects.
    
    Type Parameters:
    A - Key type
    Parameters:
    map - Input map
    
    Returns:
    New map where values are Double objects
    Since:
    
    0.3.0
  - toDoubleMap
```
public static <A> Map<A,Double> toDoubleMap(Map<A,String> map,
                            double valueForNull)
```
    Converts a map whose values are String objects to another where values are Double objects.
    
    Type Parameters:
    A - Key type
    Parameters:
    map - Input map
    valueForNull - Value for null positions
    
    Returns:
    New map where values are Double objects
    Since:
    
    0.3.0
  - toIntArray
```
public static int[] toIntArray(Collection<String> collection)
```
    Converts a collection of String objects to an int array.
    
    Parameters:
    collection - Input collection
    
    Returns:
    New int array
    Since:
    
    0.3.0
  - toIntArray
```
public static int[] toIntArray(Collection<String> collection,
               int valueForNull)
```
    Converts a collection of String objects to an int array.
    
    Parameters:
    collection - Input collection
    valueForNull - Value for null positions
    
    Returns:
    New int array
    Since:
    
    0.3.0
  - toIntArray
```
public static int[] toIntArray(String[] array)
```
    Converts a String array to an int array.
    
    Parameters:
    array - Input array
    
    Returns:
    New int array
    Since:
    
    0.2.0
  - toIntArray
```
public static int[] toIntArray(String[] array,
               int valueForNull)
```
    Converts a String array to an int array.
    
    Parameters:
    array - Input array
    valueForNull - Value for null positions
    
    Returns:
    New int array
    Since:
    
    0.2.0
  - toIntegerMap
```
public static <A> Map<A,Integer> toIntegerMap(Map<A,String> map)
```
    Converts a map whose values are String objects to another where values are Integer objects.
    
    Type Parameters:
    A - Key type
    Parameters:
    map - Input map
    
    Returns:
    New map where values are Integer objects
    Since:
    
    0.3.0
  - toIntegerMap
```
public static <A> Map<A,Integer> toIntegerMap(Map<A,String> map,
                              int valueForNull)
```
    Converts a map whose values are String objects to another where values are Integer objects.
    
    Type Parameters:
    A - Key type
    Parameters:
    map - Input map
    valueForNull - Value for null positions
    
    Returns:
    New map where values are Integer objects
    Since:
    
    0.3.0
  - toList
```
public static List<String> toList(String[] array)
```
    Converts from a String array to a list.
    
    Parameters:
    array - Input array
    
    Returns:
    A list of String objects
    Since:
    
    0.2.0
  - toLongArray
```
public static long[] toLongArray(Collection<String> collection)
```
    Converts a collection of String objects to a long array.
    
    Parameters:
    collection - Input collection
    
    Returns:
    New long array
    Since:
    
    0.3.0
  - toLongArray
```
public static long[] toLongArray(Collection<String> collection,
                 long valueForNull)
```
    Converts a collection of String objects to a long array.
    
    Parameters:
    collection - Input collection
    valueForNull - Value for null positions
    
    Returns:
    New long array
    Since:
    
    0.3.0
  - toLongArray
```
public static long[] toLongArray(String[] array)
```
    Converts a String array to a long array.
    
    Parameters:
    array - Input array
    
    Returns:
    New long array
    Since:
    
    0.2.0
  - toLongArray
```
public static long[] toLongArray(String[] array,
                 long valueForNull)
```
    Converts a String array to a long array.
    
    Parameters:
    array - Input array
    valueForNull - Value for null positions
    
    Returns:
    New long array
    Since:
    
    0.3.0
  - toLongList
```
public static List<Long> toLongList(String[] array)
```
    Converts a String array to a long array.
    
    Parameters:
    array - Input array
    
    Returns:
    New long array
    Since:
    
    0.2.0
  - toLongList
```
public static List<Long> toLongList(String[] array,
                    long valueForNull)
```
    Converts a String array to a long array.
    
    Parameters:
    array - Input array
    valueForNull - Value for null positions
    
    Returns:
    New long array
    Since:
    
    0.3.0
  - toLongMap
```
public static <A> Map<A,Long> toLongMap(Map<A,String> map)
```
    Converts a map whose values are String objects to another where values are Long objects.
    
    Type Parameters:
    A - Key type
    Parameters:
    map - Input map
    
    Returns:
    New map where values are Long objects
    Since:
    
    0.3.0
  - toLongMap
```
public static <A> Map<A,Long> toLongMap(Map<A,String> map,
                        long valueForNull)
```
    Converts a map whose values are String objects to another where values are Long objects.
    
    Type Parameters:
    A - Key type
    Parameters:
    map - Input map
    valueForNull - Value for null positions
    
    Returns:
    New map where values are Long objects
    Since:
    
    0.3.0
  - toMap
```
public static Map<String,String> toMap(String string,
                       String keyValueSeparator,
                       String entrySeparator)
```
    Converts to a Map a codified String.
    
    Parameters:
    string - Input String
    keyValueSeparator - Separator between keys and values
    entrySeparator - Separator between key-value pairs
    
    Returns:
    Map represented by the String
    Since:
    
    0.3.0

Class StringUtils

Method Summary

Methods inherited from class Object

Method Detail

arrayOf

find

getLineSeparator

join

join

mapToString

mapToString

saveToFile

saveToFile

secondsToYearsDaysHoursMinutesSeconds

select

split

split

stringToMap

stringToMap

toArray

toBooleanArray

toBooleanArray

toBooleanArray

toBooleanArray

toBooleanList

toBooleanList

toBooleanMap

toBooleanMap

toDoubleArray

toDoubleArray

toDoubleArray

toDoubleArray

toDoubleList

toDoubleList

toDoubleMap

toDoubleMap

toIntArray

toIntArray

toIntArray

toIntArray

toIntegerMap

toIntegerMap

toList

toLongArray

toLongArray

toLongArray

toLongArray

toLongList

toLongList

toLongMap

toLongMap

toMap