StringUtil (Nuiton Utils 3.0-rc-4 API)

java.lang.Object
- org.nuiton.util.StringUtil

```
public class StringUtil
extends Object
```
Classe contenant un ensemle de methode static utiles pour la manipulation des chaine de caractere mais qui ne sont pas defini dans la classe String de Java.
Created: 21 octobre 2003

Author:

bpoussin , tchemit $Id: StringUtil.java 2605 2013-10-11 09:14:01Z echatellier $

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`StringUtil.ToCSV<O>` Used to build csv file using `join(Iterable, ToString, String, boolean)` method.
`static interface`	`StringUtil.ToString<O>` Contract to use in `join(Iterable, ToString, String, boolean)` method.

Field Summary

Fields
Modifier and Type	Field and Description
`static String[]`	`EMPTY_STRING_ARRAY`
`protected static double[]`	`memoryFactors`
`protected static String[]`	`memoryUnites`
`protected static double[]`	`timeFactors`
`protected static String[]`	`timeUnites`

Constructor Summary

Constructors
Modifier Constructor and Description

protected StringUtil()
Constructor for the StringUtil object

Constructors
Modifier	Constructor and Description
`protected`	`StringUtil()` Constructor for the StringUtil object

Method Summary

Methods
Modifier and Type	Method and Description
`static String`	`asHex(byte[] hash)` Turns array of bytes into string representing each byte as unsigned hex number.
`static boolean`	`checkEnclosure(String txt, char opener, char closer)` Vérifie q'une chaine de caractère est valid pour les bloc openner closer, ie.
`static String`	`convert(long value, double[] factors, String[] unites)` Note: this method use the current locale (the `Locale.getDefault()`) in the method `MessageFormat.MessageFormat(String)`.
`static String`	`convertMemory(long value)` Converts an memory measure into a human readable format.
`static String`	`convertTime(long value)` Converts an time delay into a human readable format.
`static String`	`convertTime(long value, long value2)` Converts an time period into a human readable format.
`static String`	`convertToConstantName(String name)` Convertir un nom en une constante Java Les seuls caractères autorisés sont les alpha numériques, ains que l'underscore.
`static String`	`encodeMD5(String toEncode)` Convert a String to MD5.
`static String`	`encodeSHA1(String toEncode)` Convert a String to SHA1.
`static String`	`escapeCsvValue(String value, String csvSeparator)` Add quotes if needed to escape special csv chars (',', '\n', '\t', ',', ';', '"')
`static String`	`getFileSeparatorRegex()`
`static boolean`	`isEmail(String str)` Know if a string is a valid e-mail.
`static String`	`join(Iterable<?> iterable, String separator, boolean trim)` Used to concat an `iterable` of Object separated by `separator` using the toString() method of each object.
`static <O> String`	`join(Iterable<O> iterable, StringUtil.ToString<O> ts, String separator, boolean trim)` Used to concat an `iterable` of object `<O>` separated by `separator`.
`static String[]`	`split(Character[] openingChars, Character[] closingChars, String args, String separator)` Split string use 'separator' as separator.
`static String[]`	`split(String stringList)` Use to split string array representation in array according with ',' as default separator.
`static String[]`	`split(String args, String separator)` Split string use 'separator' as separator.
`static String`	`substring(String s, int begin)` substring from begin to end of s example: substring("tatetitotu", -4) => totu
`static String`	`substring(String s, int begin, int end)` substring from begin to end of s example: substring("tatetitotu", -4, -2) => to
`static boolean[]`	`toArrayBoolean(String... s)`
`static byte[]`	`toArrayByte(String... s)`
`static char[]`	`toArrayChar(String... s)`
`static double[]`	`toArrayDouble(String... s)`
`static float[]`	`toArrayFloat(String... s)`
`static int[]`	`toArrayInt(String... s)`
`static long[]`	`toArrayLong(String... s)`
`static short[]`	`toArrayShort(String... s)`
`static boolean`	`toBoolean(String s)`
`static byte`	`toByte(String s)`
`static char`	`toChar(String s)`
`static Color`	`toColor(String s)` Essai de convertir une chaine de caractere en une couleur si possible si ce n'est pas possible retourne null.
`static Date`	`toDate(String s)`
`static double`	`toDouble(String s)`
`static float`	`toFloat(String s)`
`static int`	`toInt(String s)`
`static long`	`toLong(String s)`
`static short`	`toShort(String s)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - EMPTY_STRING_ARRAY
```
public static final String[] EMPTY_STRING_ARRAY
```
  - timeFactors
```
protected static final double[] timeFactors
```
  - timeUnites
```
protected static final String[] timeUnites
```
  - memoryFactors
```
protected static final double[] memoryFactors
```
  - memoryUnites
```
protected static final String[] memoryUnites
```
- Constructor Detail
  - StringUtil
```
protected StringUtil()
```
    Constructor for the StringUtil object
- Method Detail
  - isEmail
```
public static boolean isEmail(String str)
```
    Know if a string is a valid e-mail.
    
    Parameters:
    str - a string
    
    Returns:
    true if str is syntactically a valid e-mail address
    Since:
    
    2.1
  - escapeCsvValue
```
public static String escapeCsvValue(String value,
                    String csvSeparator)
```
    Add quotes if needed to escape special csv chars (',', '\n', '\t', ',', ';', '"')
    
    Parameters:
    value - to escape
    csvSeparator - separator used for csv
    
    Returns:
    escaped if needed value
  - join
```
public static String join(Iterable<?> iterable,
          String separator,
          boolean trim)
```
    Used to concat an iterable of Object separated by separator using the toString() method of each object. You can specify if the string must be trimmed or not.
    
    Parameters:
    iterable - Iterable with objects to treate
    separator - to used
    trim - if each string must be trim
    
    Returns:
    the String chain of all elements separated by separator, never return null, will return an empty String for an empty list.
  - join
```
public static <O> String join(Iterable<O> iterable,
              StringUtil.ToString<O> ts,
              String separator,
              boolean trim)
                   throws NullPointerException
```
    Used to concat an iterable of object <O> separated by separator. This method need a ts contract to call on each object. The ToString can be null to use directly the toString() method on the object. The trim boolean is used to specify if each string object has to be trimmed. The null elements in the list will be ignored.
    
    Type Parameters:
    O - type of object in the list
    Parameters:
    iterable - Iterable with objects to treate
    ts - used to specify how the object is converted in String
    separator - to used between each object string
    trim - if trim() method need to by apply on each object string
    
    Returns:
    the String chain of all elements separated by separator, never return null, will return an empty String for an empty list.
    
    Throws:
    
    NullPointerException - if iterable is null.
  - substring
```
public static String substring(String s,
               int begin)
```
    substring from begin to end of s
    example:
  - substring("tatetitotu", -4) => totu

Parameters:: s - the string to substring; begin - if begin < 0 then begin start at end of string - begin
Returns:: the result of substring

substring

public static String substring(String s,
               int begin,
               int end)

substring from begin to end of s

example:

substring("tatetitotu", -4, -2) => to

Class StringUtil

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

EMPTY_STRING_ARRAY

timeFactors

timeUnites

memoryFactors

memoryUnites

Constructor Detail

StringUtil

Method Detail

isEmail

escapeCsvValue

join

join

substring

substring

split

split

split

toBoolean

toByte

toDouble

toFloat

toLong

toShort

toInt

toChar

toArrayBoolean

toArrayByte

toArrayDouble

toArrayFloat

toArrayLong

toArrayShort

toArrayInt

toArrayChar

asHex

toColor

toDate

convertTime

convertTime

convertMemory

convert

checkEnclosure

convertToConstantName

encodeMD5

encodeSHA1

getFileSeparatorRegex