Strings (Xtext Util 2.9.0.beta3 API)

java.lang.Object
- org.eclipse.xtext.util.Strings

```
public class Strings
extends Object
```
Author:

Jan Köhnlein - Initial contribution and API

Field Summary

Fields
Modifier and Type Field and Description

static String[] EMPTY_ARRAY

static char SEPARATOR

Fields
Modifier and Type	Field and Description
`static String[]`	`EMPTY_ARRAY`
`static char`	`SEPARATOR`

Constructor Summary

Constructors
Constructor and Description

Strings()

Constructors
Constructor and Description
`Strings()`

Method Summary

Methods
Modifier and Type	Method and Description
`static String`	`concat(String separator, List<String> list)`
`static String`	`concat(String separator, List<String> list, int skip)`
`static String`	`convertFromJavaString(String javaString, boolean useUnicode)` Mostly copied from `Properties.loadConvert(char[], int, int, char[])`
`static String`	`convertToJavaString(String theString)`
`static String`	`convertToJavaString(String theString, boolean useUnicode)` Mostly copied from `Properties.saveConvert(java.lang.String, boolean, boolean)`
`static int`	`countLineBreaks(CharSequence text)` Counts the number of line breaks.
`static int`	`countLineBreaks(CharSequence text, int startInclusive, int endExclusive)` Counts the number of line breaks.
`static int`	`countLines(String text)` Counts the number of lines where `separator` is assumed to be the only valid line break sequence.
`static int`	`countLines(String text, char[] separator)` Counts the number of lines where the given separator sequence is the only valid line break sequence.
`static int`	`countLines(String text, char[] separator, int startInclusive, int endExclusive)` Counts the number of lines between `startInclusive` and `endExclusive` where the given separator sequence is the only valid line break sequence.
`static String`	`emptyIfNull(String s)`
`static boolean`	`equal(String literal, String name)`
`static boolean`	`equalsIgnoreWhitespace(String left, String right)`
`static String`	`getLeadingWhiteSpace(String original)`
`static boolean`	`isEmpty(String s)`
`static String`	`lastToken(String value, String separator)`
`static String`	`newLine()`
`static String`	`notNull(Object o)`
`static String`	`pack(String[] strings)`
`static String`	`removeLeadingWhitespace(String indentationString)`
`static String`	`skipLastToken(String value, String separator)`
`static List<String>`	`split(String value, char delimiter)` Splits a string around matches of the given delimiter character.
`static List<String>`	`split(String value, String delimiter)` Splits a string around matches of the given delimiter string.
`static String`	`toFirstLower(String s)`
`static String`	`toFirstUpper(String s)`
`static char`	`toHex(int nibble)` Copied from `Properties`
`static <T> String`	`toString(Collection<T> list, com.google.common.base.Function<T,String> toString, String delim)`
`static CharSequence`	`trimTrailingLineBreak(CharSequence s)` Assumes `'\r'`, `'\n'` or `'\r\n'` to be valid line breaks.
`static String[]`	`unpack(String packed)`
`static String`	`wordWrap(String string, int maxCharsPerLine)`

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

- Field Detail
  - EMPTY_ARRAY
```
public static final String[] EMPTY_ARRAY
```
  - SEPARATOR
```
public static final char SEPARATOR
```
    See Also:
    Constant Field Values
- Constructor Detail
  - Strings
```
public Strings()
```
- Method Detail
  - equalsIgnoreWhitespace
```
public static boolean equalsIgnoreWhitespace(String left,
                             String right)
```
  - equal
```
public static boolean equal(String literal,
            String name)
```
  - notNull
```
public static String notNull(Object o)
```
  - emptyIfNull
```
public static String emptyIfNull(String s)
```
  - concat
```
public static String concat(String separator,
            List<String> list)
```
  - toString
```
public static <T> String toString(Collection<T> list,
                  com.google.common.base.Function<T,String> toString,
                  String delim)
```
  - concat
```
public static String concat(String separator,
            List<String> list,
            int skip)
```
  - skipLastToken
```
public static String skipLastToken(String value,
                   String separator)
```
  - lastToken
```
public static String lastToken(String value,
               String separator)
```
  - toFirstUpper
```
public static String toFirstUpper(String s)
```
  - isEmpty
```
public static boolean isEmpty(String s)
```
  - newLine
```
public static String newLine()
```
  - toFirstLower
```
public static String toFirstLower(String s)
```
  - convertFromJavaString
```
public static String convertFromJavaString(String javaString,
                           boolean useUnicode)
```
    Mostly copied from Properties.loadConvert(char[], int, int, char[])
  - convertToJavaString
```
public static String convertToJavaString(String theString)
```
  - convertToJavaString
```
public static String convertToJavaString(String theString,
                         boolean useUnicode)
```
    Mostly copied from Properties.saveConvert(java.lang.String, boolean, boolean)
  - toHex
```
public static char toHex(int nibble)
```
    Copied from Properties
  - split
```
public static List<String> split(String value,
                 String delimiter)
```
    Splits a string around matches of the given delimiter string.
    This method works similar to String.split(String) but does not treat the delimiter as a regular expression. This makes it perform better in most cases where this feature is not necessary. Furthermore this implies that trailing empty segments will not be part of the result.
    For delimiters of length 1 it is preferred to use split(String, char) instead.
    
    Parameters:
    value - the string to split
    delimiter - the delimiting string (e.g. "::")
    
    Returns:
    the list of strings computed by splitting the string around matches of the given delimiter without trailing empty segments. Never null and the list does not contain any null values.
    
    Throws:
    
    NullPointerException - If the value or delimiter is null
  - split
```
public static List<String> split(String value,
                 char delimiter)
```
    Splits a string around matches of the given delimiter character.
    This method works similar to String.split(String) but does not treat the delimiter as a regular expression. This makes it perform better in most cases where this feature is not necessary. Furthermore this implies that trailing empty segments will not be part of the result.
    
    Parameters:
    value - the string to split
    delimiter - the delimiting character (e.g. '.' or ':')
    
    Returns:
    the list of strings computed by splitting the string around matches of the given delimiter without trailing empty segments. Never null and the list does not contain any null values.
    
    Throws:
    
    NullPointerException - If the value is null
    Since:
    
    2.3
    
    See Also:
    String.split(String)
  - pack
```
public static String pack(String[] strings)
```
    Parameters:
    strings - array of strings, may not be null and may not contain any null values.
    
    Throws:
    
    NullPointerException - if the array of strings or any element in the array is null
  - unpack
```
public static String[] unpack(String packed)
```
  - removeLeadingWhitespace
```
public static String removeLeadingWhitespace(String indentationString)
```
  - countLineBreaks
```
public static int countLineBreaks(CharSequence text)
```
    Counts the number of line breaks. Assumes '\r', '\n' or '\r\n' to be valid line breaks. This follows the semantics of the LineNumberReader.
    
    Since:
    
    2.3
  - countLineBreaks
```
public static int countLineBreaks(CharSequence text,
                  int startInclusive,
                  int endExclusive)
```
    Counts the number of line breaks. Assumes '\r', '\n' or '\r\n' to be valid line breaks. This follows the semantics of the LineNumberReader.
    
    Since:
    
    2.9
  - trimTrailingLineBreak
```
public static CharSequence trimTrailingLineBreak(CharSequence s)
```
    Assumes '\r', '\n' or '\r\n' to be valid line breaks.
    
    Since:
    
    2.6
  - countLines
```
public static int countLines(String text)
```
    Counts the number of lines where separator is assumed to be the only valid line break sequence. A string without any line separators returns 0 as the number of lines.
  - countLines
```
public static int countLines(String text,
             char[] separator)
```
    Counts the number of lines where the given separator sequence is the only valid line break sequence. A string without any line separators returns 0 as the number of lines.
  - countLines
```
public static int countLines(String text,
             char[] separator,
             int startInclusive,
             int endExclusive)
```
    Counts the number of lines between startInclusive and endExclusive where the given separator sequence is the only valid line break sequence. A string without any line separators in that range returns 0 as the number of lines.
    
    Since:
    
    2.9
  - getLeadingWhiteSpace
```
public static String getLeadingWhiteSpace(String original)
```
  - wordWrap
```
public static String wordWrap(String string,
              int maxCharsPerLine)
```
    Since:
    
    2.1

Class Strings

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

EMPTY_ARRAY

SEPARATOR

Constructor Detail

Strings

Method Detail

equalsIgnoreWhitespace

equal

notNull

emptyIfNull

concat

toString

concat

skipLastToken

lastToken

toFirstUpper

isEmpty

newLine

toFirstLower

convertFromJavaString

convertToJavaString

convertToJavaString

toHex

split

split

pack

unpack

removeLeadingWhitespace

countLineBreaks

countLineBreaks

trimTrailingLineBreak

countLines

countLines

countLines

getLeadingWhiteSpace

wordWrap