| java.lang.Object
 freemarker.template.utility.StringUtil
| StringUtil | | public class StringUtil (Code) | | Some text related utilities.
version:
$Id: StringUtil.java,v 1.48 2005/06/01 22:39:08 ddekany Exp $ |
| Method Summary | |
| public static String | FTLStringLiteralDec(String s)
FTL string literal decoding.
\\, \", \', \n, \t, \r, \b and \f will be replaced according to
Java rules. | | public static String | FTLStringLiteralEnc(String s)
| | public static String | HTMLEnc(String s)
HTML encoding (does not convert line breaks). | | public static String | RTFEnc(String s)
Rich Text Format encoding (does not replace line breaks). | | public static String | URLEnc(String s, String charset)
URL encoding (like%20this). | | public static String | XMLEnc(String s)
XML Encoding. | | public static String | XMLEncNA(String s)
XML encoding without replacing apostrophes. | | public static String | XMLEncNQG(String s)
XML encoding without replacing apostrophes and quotation marks and greater-than signs. | | public static String | XMLEncQAttr(String s)
XML encoding for attributes valies quoted with " (not with '!). | | public static String | capitalize(String s)
| | public static String | chomp(String s)
Removes the line-break from the end of the string. | | public static Locale | deduceLocale(String input)
| | public static boolean | getYesNo(String s)
| | public static boolean | isXMLID(String name)
whether the name is a valid XML tagname.(This routine might only be 99% accurate. | | public static String | jQuote(String s)
Quotes string as Java Language string literal. | | public static String | javaScriptStringEnc(String s)
Escapes a String according the JavaScript string literal
escaping rules. | | public static String | javaStringEnc(String s)
Escapes the String with the escaping rules of Java language
string literals, so it is safe to insert the value into a string literal. | | public static String | leftPad(String s, int minLength)
Pads the string at the left with spaces until it reaches the desired
length. | | public static String | leftPad(String s, int minLength, char filling)
Pads the string at the left with the specified character until it reaches
the desired length. | | public static String | leftPad(String s, int minLength, String filling)
Pads the string at the left with a filling pattern until it reaches the
desired length. | | public static boolean | matchesName(String qname, String nodeName, String nsURI, Environment env)
whether the qname matches the combination of nodeName, nsURI, and environment prefix settings. | | public static Map | parseNameValuePairList(String s, String defaultValue)
Parses a name-value pair list, where the pairs are separated with comma,
and the name and value is separated with colon.
The keys and values can contain only letters, digits and _. | | public static String | replace(String text, String oldsub, String newsub, boolean caseInsensitive, boolean firstOnly)
Replaces all occurrences of a sub-string in a string.
Parameters:
text - The string where it will replace oldsub withnewsub. | | public static String | rightPad(String s, int minLength)
Pads the string at the right with spaces until it reaches the desired
length. | | public static String | rightPad(String s, int minLength, char filling)
Pads the string at the right with the specified character until it
reaches the desired length. | | public static String | rightPad(String s, int minLength, String filling)
Pads the string at the right with a filling pattern until it reaches the
desired length. | | public static String[] | split(String s, char c)
Splits a string at the specified character. | | public static String[] | split(String s, String sep, boolean caseInsensitive)
Splits a string at the specified string. |
| FTLStringLiteralDec | | public static String FTLStringLiteralDec(String s) throws ParseException(Code) | | FTL string literal decoding.
\\, \", \', \n, \t, \r, \b and \f will be replaced according to
Java rules. In additional, it knows \g, \l, \a and \{ which are
replaced with <, >, & and { respectively.
\x works as hexadecimal character code escape. The character
codes are interpreted according to UCS basic plane (Unicode).
"f\x006Fo", "f\x06Fo" and "f\x6Fo" will be "foo".
"f\x006F123" will be "foo123" as the maximum number of digits is 4.
All other \X (where X is any character not mentioned above or End-of-string)
will cause a ParseException.
Parameters:
s - String literal without the surrounding quotation marks String with all escape sequences resolved
throws:
ParseException - if there string contains illegal escapes |
| HTMLEnc | | public static String HTMLEnc(String s)(Code) | | HTML encoding (does not convert line breaks).
Replaces all '>' '<' '&' and '"' with entity reference
|
| RTFEnc | | public static String RTFEnc(String s)(Code) | | Rich Text Format encoding (does not replace line breaks).
Escapes all '\' '{' '}' and '"'
|
| XMLEnc | | public static String XMLEnc(String s)(Code) | | XML Encoding.
Replaces all '>' '<' '&', "'" and '"' with entity reference
|
| XMLEncQAttr | | public static String XMLEncQAttr(String s)(Code) | | XML encoding for attributes valies quoted with " (not with '!).
Also can be used for HTML attributes that are quoted with ".
See Also: StringUtil.XMLEnc(String) |
| chomp | | public static String chomp(String s)(Code) | | Removes the line-break from the end of the string.
|
| isXMLID | | public static boolean isXMLID(String name)(Code) | | whether the name is a valid XML tagname.(This routine might only be 99% accurate. Should maybe REVISIT) |
| jQuote | | public static String jQuote(String s)(Code) | | Quotes string as Java Language string literal.
Returns string "null" if s
is null.
|
| javaScriptStringEnc | | public static String javaScriptStringEnc(String s)(Code) | | Escapes a String according the JavaScript string literal
escaping rules. The resulting string will not be quoted.
It escapes both ' and ".
In additional it escapes > as \> (to avoid
</script>). Furthermore, all characters under UCS code point
0x20, that has no dedicated escape sequence in JavaScript language, will
be replaced with hexadecimal escape (\xXX).
|
| javaStringEnc | | public static String javaStringEnc(String s)(Code) | | Escapes the String with the escaping rules of Java language
string literals, so it is safe to insert the value into a string literal.
The resulting string will not be quoted.
In additional, all characters under UCS code point 0x20, that has no
dedicated escape sequence in Java language, will be replaced with UNICODE
escape (\uXXXX).
See Also: StringUtil.jQuote(String) |
| leftPad | | public static String leftPad(String s, int minLength)(Code) | | Pads the string at the left with spaces until it reaches the desired
length. If the string is longer than this length, then it returns the
unchanged string.
Parameters:
s - the string that will be padded.
Parameters:
minLength - the length to reach. |
| leftPad | | public static String leftPad(String s, int minLength, char filling)(Code) | | Pads the string at the left with the specified character until it reaches
the desired length. If the string is longer than this length, then it
returns the unchanged string.
Parameters:
s - the string that will be padded.
Parameters:
minLength - the length to reach.
Parameters:
filling - the filling pattern. |
| leftPad | | public static String leftPad(String s, int minLength, String filling)(Code) | | Pads the string at the left with a filling pattern until it reaches the
desired length. If the string is longer than this length, then it returns
the unchanged string. For example: leftPad('ABC', 9, '1234')
returns "123412ABC".
Parameters:
s - the string that will be padded.
Parameters:
minLength - the length to reach.
Parameters:
filling - the filling pattern. Must be at least 1 characters long.Can't be null. |
| matchesName | | public static boolean matchesName(String qname, String nodeName, String nsURI, Environment env)(Code) | | whether the qname matches the combination of nodeName, nsURI, and environment prefix settings. |
| parseNameValuePairList | | public static Map parseNameValuePairList(String s, String defaultValue) throws java.text.ParseException(Code) | | Parses a name-value pair list, where the pairs are separated with comma,
and the name and value is separated with colon.
The keys and values can contain only letters, digits and _. They
can't be quoted. White-space around the keys and values are ignored. The
value can be omitted if defaultValue is not null. When a
value is omitted, then the colon after the key must be omitted as well.
The same key can't be used for multiple times.
Parameters:
s - the string to parse.For example: "strong:100, soft:900".
Parameters:
defaultValue - the value used when the value is omitted in akey-value pair. the map that contains the name-value pairs.
throws:
java.text.ParseException - if the string is not a valid name-valuepair list. |
| replace | | public static String replace(String text, String oldsub, String newsub, boolean caseInsensitive, boolean firstOnly)(Code) | | Replaces all occurrences of a sub-string in a string.
Parameters:
text - The string where it will replace oldsub withnewsub. String The string after the replacements. |
| rightPad | | public static String rightPad(String s, int minLength)(Code) | | Pads the string at the right with spaces until it reaches the desired
length. If the string is longer than this length, then it returns the
unchanged string.
Parameters:
s - the string that will be padded.
Parameters:
minLength - the length to reach. |
| rightPad | | public static String rightPad(String s, int minLength, char filling)(Code) | | Pads the string at the right with the specified character until it
reaches the desired length. If the string is longer than this length,
then it returns the unchanged string.
Parameters:
s - the string that will be padded.
Parameters:
minLength - the length to reach.
Parameters:
filling - the filling pattern. |
| rightPad | | public static String rightPad(String s, int minLength, String filling)(Code) | | Pads the string at the right with a filling pattern until it reaches the
desired length. If the string is longer than this length, then it returns
the unchanged string. For example: rightPad('ABC', 9, '1234')
returns "ABC412341". Note that the filling pattern is
started as if you overlay "123412341" with the left-aligned
"ABC", so it starts with "4".
Parameters:
s - the string that will be padded.
Parameters:
minLength - the length to reach.
Parameters:
filling - the filling pattern. Must be at least 1 characters long.Can't be null. |
| split | | public static String[] split(String s, char c)(Code) | | Splits a string at the specified character.
|
| split | | public static String[] split(String s, String sep, boolean caseInsensitive)(Code) | | Splits a string at the specified string.
|
|
|