Package com.gargoylesoftware.htmlunit.util

Class StringUtils

java.lang.Object

com.gargoylesoftware.htmlunit.util.StringUtils

public final class StringUtils
extends java.lang.Object

String utilities class for utility functions not covered by third party libraries.

Method Summary

Modifier and Type	Method	Description
static java.awt.Color	asColorHexadecimal(java.lang.String token)	Returns a Color parsed from the given RGB in hexadecimal notation.
static java.lang.String	escapeXmlAttributeValue(java.lang.String attValue)	Escape the string to be used as attribute value.
static java.lang.String	escapeXmlChars(java.lang.String s)	Escapes the characters '<', '>' and '&' into their XML entity equivalents.
static java.awt.Color	findColorHSL(java.lang.String token)	Returns a Color parsed from the given hsl notation if found inside the given string.
static java.awt.Color	findColorRGB(java.lang.String token)	Returns a Color parsed from the given rgb notation if found inside the given string.
static java.awt.Color	findColorRGBA(java.lang.String token)	Returns a Color parsed from the given rgb notation.
static java.lang.String	formatColor(java.awt.Color aColor)	Formats the specified color.
static int	indexOf(java.lang.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 java.util.Date	parseHttpDate(java.lang.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 java.lang.String	sanitizeForAppendReplacement(java.lang.String toSanitize)	Sanitize a string for use in Matcher.appendReplacement.
static java.lang.String	sanitizeForFileName(java.lang.String toSanitize)	Sanitizes a string for use as filename.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

escapeXmlChars

public static java.lang.String escapeXmlChars(java.lang.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 java.lang.String escapeXmlAttributeValue(java.lang.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(java.lang.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 java.util.Date parseHttpDate(java.lang.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 java.awt.Color asColorHexadecimal(java.lang.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 java.awt.Color findColorRGB(java.lang.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 java.awt.Color findColorRGBA(java.lang.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 java.awt.Color findColorHSL(java.lang.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 java.lang.String formatColor(java.awt.Color aColor)

Formats the specified color.

Parameters:

aColor - the color to format

Returns:

the specified color, formatted

sanitizeForAppendReplacement

public static java.lang.String sanitizeForAppendReplacement(java.lang.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 java.lang.String sanitizeForFileName(java.lang.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