StringUtils (net2plan-javadoc 0.6.0.1 API)

java.lang.Object
- com.net2plan.utils.StringUtils

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

Author:

Pablo Pavon-Marino, Jose-Luis Izquierdo-Zaragoza

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static String[]`	`arrayOf(String... values)` Generates an `String[]` from comma-separated values.
`static String`	`collectionToString(Collection list)` Outputs entries from a `Collection` to a `String`.
`static String`	`collectionToString(Collection list, String entrySeparator)` Outputs entries from a `Collection` to a `String`.
`static String`	`createEscapedString_asStringList(Collection<String> vals)`
`static String`	`escapedStringToWrite(String s)`
`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 List<String>`	`readEscapedString_asStringList(String val, List<String> defaultValue)`
`static IntMatrix2D`	`readIntMatrix(String s)` Reads a matrix `IntMatrix2D` from a `String`, where rows are separated by ";" and columns by spaces
`static DoubleMatrix2D`	`readMatrix(String s)` Reads a matrix `DoubleMatrix2D` from a `String`, where rows are separated by ";" and columns by spaces
`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.
`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`.
`static String`	`unescapedStringRead(String s)`
`static String`	`writeMatrix(DoubleMatrix1D mat)` Generates an `String` from a vector of `DoubleMatrix1D` where elements are separated by spaces
`static String`	`writeMatrix(DoubleMatrix2D mat)` Generates an `String` from a matrix, where rows are separated by ";" and columns by spaces
`static String`	`writeMatrix(IntMatrix1D mat)` Generates an `String` from a vector of `IntMatrix1D` where elements are separated by spaces
`static String`	`writeMatrix(IntMatrix2D mat)` Generates an `String` from a matrix, where rows are separated by ";" and columns by spaces

Methods inherited from class java.lang.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[]
  - collectionToString
```
public static String collectionToString(Collection list)
```
    Outputs entries from a Collection to a String. Default separator between list entries is ', '.
    
    Parameters:
    
    list - Input list
    
    Returns:
    
    String representing the list.
  - collectionToString
```
public static String collectionToString(Collection list,
                                        String entrySeparator)
```
    Outputs entries from a Collection to a String.
    
    Parameters:
    
    list - Input list
    
    entrySeparator - Separator between list entries.
    
    Returns:
    
    String representing the list.
  - createEscapedString_asStringList
```
public static String createEscapedString_asStringList(Collection<String> vals)
```
  - escapedStringToWrite
```
public static String escapedStringToWrite(String s)
```
  - 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
  - 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
  - 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
  - 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
  - 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
  - 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
  - readEscapedString_asStringList
```
public static List<String> readEscapedString_asStringList(String val,
                                                          List<String> defaultValue)
```
  - readIntMatrix
```
public static IntMatrix2D readIntMatrix(String s)
```
    Reads a matrix IntMatrix2D from a String, where rows are separated by ";" and columns by spaces
    
    Parameters:
    
    s - String
    
    Returns:
    
    the matrix
  - readMatrix
```
public static DoubleMatrix2D readMatrix(String s)
```
    Reads a matrix DoubleMatrix2D from a String, where rows are separated by ";" and columns by spaces
    
    Parameters:
    
    s - String
    
    Returns:
    
    the matrix
  - 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
  - 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)
  - 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
  - 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
  - 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
  - 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)
  - 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
  - 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
  - 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)
  - 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
  - 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
  - toBooleanArray
```
public static boolean[] toBooleanArray(String[] array)
```
    Converts a String array to a boolean array.
    
    Parameters:
    
    array - Input array
    
    Returns:
    
    New boolean array
  - 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
  - toBooleanList
```
public static List<Boolean> toBooleanList(String[] array)
```
    Converts a String array to a boolean array.
    
    Parameters:
    
    array - Input array
    
    Returns:
    
    New boolean array
  - 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
  - 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
  - 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
  - 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
  - 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
  - toDoubleArray
```
public static double[] toDoubleArray(String[] array)
```
    Converts a String array to a double array.
    
    Parameters:
    
    array - Input array
    
    Returns:
    
    New double array
  - 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
  - toDoubleList
```
public static List<Double> toDoubleList(String[] array)
```
    Converts a String array to a double array.
    
    Parameters:
    
    array - Input array
    
    Returns:
    
    New double array
  - 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
  - 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
  - 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
  - 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
  - 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
  - toIntArray
```
public static int[] toIntArray(String[] array)
```
    Converts a String array to an int array.
    
    Parameters:
    
    array - Input array
    
    Returns:
    
    New int array
  - 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
  - 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
  - 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
  - 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
  - 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
  - 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
  - toLongArray
```
public static long[] toLongArray(String[] array)
```
    Converts a String array to a long array.
    
    Parameters:
    
    array - Input array
    
    Returns:
    
    New long array
  - 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
  - toLongList
```
public static List<Long> toLongList(String[] array)
```
    Converts a String array to a long array.
    
    Parameters:
    
    array - Input array
    
    Returns:
    
    New long array
  - 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
  - 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
  - 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
  - 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
  - unescapedStringRead
```
public static String unescapedStringRead(String s)
```
  - writeMatrix
```
public static String writeMatrix(DoubleMatrix1D mat)
```
    Generates an String from a vector of DoubleMatrix1D where elements are separated by spaces
    
    Parameters:
    
    mat - a vector
    
    Returns:
    
    the String
  - writeMatrix
```
public static String writeMatrix(DoubleMatrix2D mat)
```
    Generates an String from a matrix, where rows are separated by ";" and columns by spaces
    
    Parameters:
    
    mat - a matrix
    
    Returns:
    
    the String
  - writeMatrix
```
public static String writeMatrix(IntMatrix1D mat)
```
    Generates an String from a vector of IntMatrix1D where elements are separated by spaces
    
    Parameters:
    
    mat - a vector
    
    Returns:
    
    the String
  - writeMatrix
```
public static String writeMatrix(IntMatrix2D mat)
```
    Generates an String from a matrix, where rows are separated by ";" and columns by spaces
    
    Parameters:
    
    mat - a matrix
    
    Returns:
    
    the String

Class StringUtils

Method Summary

Methods inherited from class java.lang.Object

Method Detail

arrayOf

collectionToString

collectionToString

createEscapedString_asStringList

escapedStringToWrite

find

getLineSeparator

join

join

mapToString

mapToString

readEscapedString_asStringList

readIntMatrix

readMatrix

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

unescapedStringRead

writeMatrix

writeMatrix

writeMatrix

writeMatrix