StringUtils (HtmlUnit 2.67.0 API)

java.lang.Object
- com.gargoylesoftware.htmlunit.util.StringUtils

```
public final class StringUtils
extends Object
```
String utilities class for utility functions not covered by third party libraries.

Author:

Daniel Gredler, Ahmed Ashour, Martin Tamme, Ronald Brill

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static Color`	`asColorHexadecimal(String token)` Returns a Color parsed from the given RGB in hexadecimal notation.
`static String`	`cssCamelize(String string)` Transforms the specified string from delimiter-separated (e.g.
`static String`	`cssDeCamelize(String string)` Transforms the specified string from camel-cased (e.g.
`static String`	`escapeXmlAttributeValue(String attValue)` Escape the string to be used as attribute value.
`static String`	`escapeXmlChars(String s)` Escapes the characters '<', '>' and '&' into their XML entity equivalents.
`static Color`	`findColorHSL(String token)` Returns a Color parsed from the given hsl notation if found inside the given string.
`static Color`	`findColorRGB(String token)` Returns a Color parsed from the given rgb notation if found inside the given string.
`static Color`	`findColorRGBA(String token)` Returns a Color parsed from the given rgb notation.
`static String`	`formatColor(Color color)` Formats the specified color.
`static int`	`indexOf(String s, char searchChar, int beginIndex, int endIndex)` Returns the index within the specified string of the first occurrence of the specified search character.
`static Date`	`parseHttpDate(String s)` Parses the specified date string, assuming that it is formatted according to RFC 1123, RFC 1036 or as an ANSI C HTTP date header.
`static String`	`sanitizeForAppendReplacement(String toSanitize)` Sanitize a string for use in Matcher.appendReplacement.
`static String`	`sanitizeForFileName(String toSanitize)` Sanitizes a string for use as filename.
`static byte[]`	`toByteArray(String content, Charset charset)` Converts a string into a byte array using the specified encoding.

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

- Method Detail
  - escapeXmlChars
```
public static String escapeXmlChars(String s)
```
    Escapes the characters '<', '>' and '&' into their XML entity equivalents. Note that sometimes we have to use this method instead of StringEscapeUtils.escapeXml(String) or StringEscapeUtils.escapeHtml4(String) because those methods escape some unicode characters as well.
    
    Parameters:
    
    s - the string to escape
    
    Returns:
    
    the escaped form of the specified string
  - escapeXmlAttributeValue
```
public static String escapeXmlAttributeValue(String attValue)
```
    Escape the string to be used as attribute value. Only <, & and " have to be escaped (see http://www.w3.org/TR/REC-xml/#d0e888).
    
    Parameters:
    
    attValue - the attribute value
    
    Returns:
    
    the escaped value
  - indexOf
```
public static int indexOf(String s,
                          char searchChar,
                          int beginIndex,
                          int endIndex)
```
    Returns the index within the specified string of the first occurrence of the specified search character.
    
    Parameters:
    
    s - the string to search
    
    searchChar - the character to search for
    
    beginIndex - the index at which to start the search
    
    endIndex - the index at which to stop the search
    
    Returns:
    
    the index of the first occurrence of the character in the string or -1
  - parseHttpDate
```
public static Date parseHttpDate(String s)
```
    Parses the specified date string, assuming that it is formatted according to RFC 1123, RFC 1036 or as an ANSI C HTTP date header. This method returns null if the specified string is null or unparseable.
    
    Parameters:
    
    s - the string to parse as a date
    
    Returns:
    
    the date version of the specified string, or null
  - asColorHexadecimal
```
public static Color asColorHexadecimal(String token)
```
    Returns a Color parsed from the given RGB in hexadecimal notation.
    
    Parameters:
    
    token - the token to parse
    
    Returns:
    
    a Color whether the token is a color RGB in hexadecimal notation; otherwise null
  - findColorRGB
```
public static Color findColorRGB(String token)
```
    Returns a Color parsed from the given rgb notation if found inside the given string.
    
    Parameters:
    
    token - the token to parse
    
    Returns:
    
    a Color whether the token contains a color in RGB notation; otherwise null
  - findColorRGBA
```
public static Color findColorRGBA(String token)
```
    Returns a Color parsed from the given rgb notation.
    
    Parameters:
    
    token - the token to parse
    
    Returns:
    
    a Color whether the token is a color in RGB notation; otherwise null
  - findColorHSL
```
public static Color findColorHSL(String token)
```
    Returns a Color parsed from the given hsl notation if found inside the given string.
    
    Parameters:
    
    token - the token to parse
    
    Returns:
    
    a Color whether the token contains a color in RGB notation; otherwise null
  - formatColor
```
public static String formatColor(Color color)
```
    Formats the specified color.
    
    Parameters:
    
    color - the color to format
    
    Returns:
    
    the specified color, formatted
  - sanitizeForAppendReplacement
```
public static String sanitizeForAppendReplacement(String toSanitize)
```
    Sanitize a string for use in Matcher.appendReplacement. Replaces all \ with \\ and $ as \$ because they are used as control characters in appendReplacement.
    
    Parameters:
    
    toSanitize - the string to sanitize
    
    Returns:
    
    sanitized version of the given string
  - sanitizeForFileName
```
public static String sanitizeForFileName(String toSanitize)
```
    Sanitizes a string for use as filename. Replaces \, /, |, :, ?, *, ", <, >, control chars by _ (underscore).
    
    Parameters:
    
    toSanitize - the string to sanitize
    
    Returns:
    
    sanitized version of the given string
  - cssCamelize
```
public static String cssCamelize(String string)
```
    Transforms the specified string from delimiter-separated (e.g. font-size) to camel-cased (e.g. fontSize).
    
    Parameters:
    
    string - the string to camelize
    
    Returns:
    
    the transformed string
  - cssDeCamelize
```
public static String cssDeCamelize(String string)
```
    Transforms the specified string from camel-cased (e.g. fontSize) to delimiter-separated (e.g. font-size). to camel-cased .
    
    Parameters:
    
    string - the string to decamelize
    
    Returns:
    
    the transformed string
  - toByteArray
```
public static byte[] toByteArray(String content,
                                 Charset charset)
```
    Converts a string into a byte array using the specified encoding.
    
    Parameters:
    
    charset - the charset
    
    content - the string to convert
    
    Returns:
    
    the String as a byte[]; if the specified encoding is not supported an empty byte[] will be returned

Class StringUtils

Method Summary

Methods inherited from class java.lang.Object

Method Detail

escapeXmlChars

escapeXmlAttributeValue

indexOf

parseHttpDate

asColorHexadecimal

findColorRGB

findColorRGBA

findColorHSL

formatColor

sanitizeForAppendReplacement

sanitizeForFileName

cssCamelize

cssDeCamelize

toByteArray