ucar.unidata.util

Class StringUtil2

java.lang.Object

ucar.unidata.util.StringUtil2

public class StringUtil2
extends java.lang.Object

Static String and StringBuilder utilities

Since:

7/29/11

Constructor Summary

Constructors

Constructor and Description
StringUtil2()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	allow(java.lang.String x, java.lang.String allowChars, char replaceChar) Replace any char not alphanumeric or in allowChars by replaceChar.
static java.lang.String	breakText(java.lang.String text, java.lang.String insert, int lineSize) Convert the given text to html by adding <br>.
static java.lang.String	breakTextAtWords(java.lang.String text, java.lang.String insert, int lineSize) Break the given text into lines, respecting word boundaries (blank space).
static java.lang.String	cleanup(byte[] h) Delete any non-printable characters
static java.lang.String	cleanup(java.lang.String s)
static java.lang.String	collapseWhitespace(java.lang.String s) Collapse continuous whitespace into one single " ".
static java.lang.String	escape(java.lang.String x, java.lang.String okChars) Escape any char not alphanumeric or in okChars.
static java.lang.String	escape2(java.lang.String x, java.lang.String reservedChars) Escape any char in reservedChars.
static java.lang.String	filter(java.lang.String x, java.lang.String okChars) Remove any char not alphanumeric or in okChars.
static java.lang.String	filter7bits(java.lang.String s) Remove all but printable ascii
static java.util.List<java.lang.String>	getTokens(java.lang.String fullString, java.lang.String sep)
static java.lang.String	ignoreescape2(java.lang.String x, java.lang.String reservedChars)
static void	main(java.lang.String[] args)
static void	main2(java.lang.String[] args)
static void	main3()
static java.lang.String	makeValidCdmObjectName(java.lang.String name)
static int	match(java.lang.String s1, java.lang.String s2) Count number of chars that match in two strings, starting from front.
static java.lang.String	padLeft(java.lang.String s, int desiredLength) Pad the given string with spaces on the left up to the given length.
static java.lang.String	padLeft(java.lang.String s, int desiredLength, java.lang.String padString) Pad the given string with padString on the left up to the given length.
static java.lang.String	padRight(java.lang.String s, int desiredLength) Pad the given string with spaces on the right up to the given length.
static java.lang.String	padRight(java.lang.String s, int desiredLength, java.lang.String padString) Pad the given string with padString on the right up to the given length.
static java.lang.String	padZero(int value, int numDigits) Left pad the given value with zeros up to the number of digits
static java.lang.String	quoteHtmlContent(java.lang.String x) Replace special characters with entities for HTML content.
static java.lang.String	quoteXmlAttribute(java.lang.String x) Replace special characters with entities for XML attributes.
static java.lang.String	quoteXmlContent(java.lang.String x) Replace special characters with entities for XML attributes.
static void	remove(java.lang.StringBuilder sb, java.lang.String out) Remove any of the characters in out from sb
static java.lang.String	remove(java.lang.String s, int c) Remove all occurrences of the character c in the string s.
static java.lang.String	remove(java.lang.String s, java.lang.String sub) Remove all occurrences of the substring sub in the string s.
static java.lang.String	removeFromEnd(java.lang.String s, int c) Remove all occurrences of the character c at the end of s.
static java.lang.String	removeFromEnd(java.lang.String s, java.lang.String suffix)
static java.lang.String	removeWhitespace(java.lang.String inputString) Remove any whitespace (ie., Character.isWhitespace) from the input string.
static void	replace(java.lang.StringBuilder sb, char out, java.lang.String in) Replace any char "out" in sb with String "in".
static void	replace(java.lang.StringBuilder sb, java.lang.String out, java.lang.String in) Replace any of the characters from out with corresponding character from in
static java.lang.String	replace(java.lang.String x, char[] replaceChar, java.lang.String[] replaceWith) Replace all occurrences of any char in replaceChar with corresponding String in replaceWith
static java.lang.String	replace(java.lang.String s, char out, java.lang.String in) Replace any char "out" in s with "in".
static java.lang.String	replace(java.lang.String string, java.lang.String pattern, java.lang.String value) Replaces all occurrences of "pattern" in "string" with "value"
static java.lang.String[]	splitString(java.lang.String source) Split a string on one or more whitespace.
static void	substitute(java.lang.StringBuilder sbuff, java.lang.String match, java.lang.String subst) Find all occurences of the "match" in original, and substitute the "subst" string, directly into the original.
static java.lang.String	substitute(java.lang.String original, java.lang.String[] match, java.lang.String[] subst) Find all occurences of match strings in original, and substitute the corresponding subst string.
static java.lang.String	substitute(java.lang.String original, java.lang.String match, java.lang.String subst) Find all occurences of the "match" in original, and substitute the "subst" string.
static java.lang.String	trim(java.lang.String s, int bad) Remove bad char from beginning or end of string
static java.lang.String	unescape(java.lang.String x) This finds any '%xx' and converts to the equivalent char.
static java.lang.String	unquoteHtmlContent(java.lang.String x)
static java.lang.String	unquoteXmlAttribute(java.lang.String x) Reverse XML quoting to recover the original string.
static java.lang.String	unquoteXmlContent(java.lang.String x) Reverse XML quoting to recover the original string.
static void	unreplace(java.lang.StringBuilder sb, java.lang.String out, char in) Replace any String "out" in sb with char "in".
static java.lang.String	unreplace(java.lang.String x, java.lang.String[] orgReplace, char[] orgChar) Replace all occurences of orgReplace with orgChar; inverse of replace().

Methods inherited from class java.lang.Object

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

Constructor Detail

StringUtil2

public StringUtil2()

Method Detail

allow

public static java.lang.String allow(java.lang.String x,
                                     java.lang.String allowChars,
                                     char replaceChar)

Replace any char not alphanumeric or in allowChars by replaceChar.

Parameters:

x - operate on this string

allowChars - these are ok.

replaceChar - thar char to replace

Returns:

resulting string.

breakTextAtWords

public static java.lang.String breakTextAtWords(java.lang.String text,
                                                java.lang.String insert,
                                                int lineSize)

Break the given text into lines, respecting word boundaries (blank space).

Parameters:

text - The text to convert

insert - break to insert

lineSize - line size to insert at

Returns:

The text with added br tags.

cleanup

public static java.lang.String cleanup(byte[] h)

Delete any non-printable characters

Parameters:

h - byte array

Returns:

cleaned up string

cleanup

public static java.lang.String cleanup(java.lang.String s)

filter

public static java.lang.String filter(java.lang.String x,
                                      java.lang.String okChars)

Remove any char not alphanumeric or in okChars.

Parameters:

x - filter this string

okChars - these are ok.

Returns:

filtered string.

filter7bits

public static java.lang.String filter7bits(java.lang.String s)

Remove all but printable ascii

Parameters:

s - filter this string

Returns:

filtered string.

makeValidCdmObjectName

public static java.lang.String makeValidCdmObjectName(java.lang.String name)

match

public static int match(java.lang.String s1,
                        java.lang.String s2)

Count number of chars that match in two strings, starting from front.

Parameters:

s1 - compare this string

s2 - compare this string

Returns:

number of matching chars, starting from first char

padZero

public static java.lang.String padZero(int value,
                                       int numDigits)

Left pad the given value with zeros up to the number of digits

Parameters:

value - The value.

numDigits - number of digits

Returns:

The String represenation of the value, padded with leading "0"-s if value < 10E(numDigits-1)

padLeft

public static java.lang.String padLeft(java.lang.String s,
                                       int desiredLength)

Pad the given string with spaces on the left up to the given length.

Parameters:

s - String to pad

desiredLength - ending length

Returns:

padded String

padLeft

public static java.lang.String padLeft(java.lang.String s,
                                       int desiredLength,
                                       java.lang.String padString)

Pad the given string with padString on the left up to the given length.

Parameters:

s - String to pad

desiredLength - ending length

padString - String to pad with (e.g, " ")

Returns:

padded String

padRight

public static java.lang.String padRight(java.lang.String s,
                                        int desiredLength)

Pad the given string with spaces on the right up to the given length.

Parameters:

s - String to pad

desiredLength - ending length

Returns:

padded String

padRight

public static java.lang.String padRight(java.lang.String s,
                                        int desiredLength,
                                        java.lang.String padString)

Pad the given string with padString on the right up to the given length.

Parameters:

s - String to pad

desiredLength - ending length

padString - String to pad with (e.g, " ")

Returns:

padded String

quoteHtmlContent

public static java.lang.String quoteHtmlContent(java.lang.String x)

Replace special characters with entities for HTML content. special: '&', '"', '\'', '<', '>', '\n'

Parameters:

x - string to quote

Returns:

equivilent string using entities for any special chars

unquoteHtmlContent

public static java.lang.String unquoteHtmlContent(java.lang.String x)

quoteXmlContent

public static java.lang.String quoteXmlContent(java.lang.String x)

Replace special characters with entities for XML attributes. special: '&', '<', '>', '\'', '"', '\r', '\n'

Parameters:

x - string to quote

Returns:

equivilent string using entities for any special chars

unquoteXmlContent

public static java.lang.String unquoteXmlContent(java.lang.String x)

Reverse XML quoting to recover the original string.

Parameters:

x - string to quote

Returns:

equivilent string

quoteXmlAttribute

public static java.lang.String quoteXmlAttribute(java.lang.String x)

Replace special characters with entities for XML attributes. special: '&', '<', '>', '\'', '"', '\r', '\n'

Parameters:

x - string to quote

Returns:

equivilent string using entities for any special chars

unquoteXmlAttribute

public static java.lang.String unquoteXmlAttribute(java.lang.String x)

Reverse XML quoting to recover the original string.

Parameters:

x - string to quote

Returns:

equivilent string

remove

public static java.lang.String remove(java.lang.String s,
                                      java.lang.String sub)

Remove all occurrences of the substring sub in the string s.

Parameters:

s - operate on this string

sub - remove all occurrences of this substring.

Returns:

result with substrings removed

remove

public static java.lang.String remove(java.lang.String s,
                                      int c)

Remove all occurrences of the character c in the string s.

Parameters:

s - operate on this string

c - remove all occurrences of this character.

Returns:

result with any character c removed

removeFromEnd

public static java.lang.String removeFromEnd(java.lang.String s,
                                             int c)

Remove all occurrences of the character c at the end of s.

Parameters:

s - operate on this string

c - remove all occurrences of this character that are at the end of the string.

Returns:

result with any character c removed

removeFromEnd

public static java.lang.String removeFromEnd(java.lang.String s,
                                             java.lang.String suffix)

removeWhitespace

public static java.lang.String removeWhitespace(java.lang.String inputString)

Remove any whitespace (ie., Character.isWhitespace) from the input string.

Parameters:

inputString - The string to remove the whitespace.

Returns:

The whitespaceless result.

collapseWhitespace

public static java.lang.String collapseWhitespace(java.lang.String s)

Collapse continuous whitespace into one single " ".

Parameters:

s - operate on this string

Returns:

result with collapsed whitespace

replace

public static java.lang.String replace(java.lang.String s,
                                       char out,
                                       java.lang.String in)

Replace any char "out" in s with "in".

Parameters:

s - string to replace

out - replace this character

in - with this string

Returns:

modified string if needed

replace

public static java.lang.String replace(java.lang.String x,
                                       char[] replaceChar,
                                       java.lang.String[] replaceWith)

Replace all occurrences of any char in replaceChar with corresponding String in replaceWith

Parameters:

x - operate on this string

replaceChar - get rid of these

replaceWith - replace with these

Returns:

resulting string

replace

public static java.lang.String replace(java.lang.String string,
                                       java.lang.String pattern,
                                       java.lang.String value)

Replaces all occurrences of "pattern" in "string" with "value"

Parameters:

string - string to munge

pattern - pattern to replace

value - replacement value

Returns:

munged string

unreplace

public static java.lang.String unreplace(java.lang.String x,
                                         java.lang.String[] orgReplace,
                                         char[] orgChar)

Replace all occurences of orgReplace with orgChar; inverse of replace().

Parameters:

x - operate on this string

orgReplace - get rid of these

orgChar - replace with these

Returns:

resulting string

substitute

public static java.lang.String substitute(java.lang.String original,
                                          java.lang.String match,
                                          java.lang.String subst)

Find all occurences of the "match" in original, and substitute the "subst" string.

Parameters:

original - starting string

match - string to match

subst - string to substitute

Returns:

a new string with substitutions

escape

public static java.lang.String escape(java.lang.String x,
                                      java.lang.String okChars)

Escape any char not alphanumeric or in okChars. Escape by replacing char with %xx (hex).

Parameters:

x - escape this string

okChars - these are ok.

Returns:

equivilent escaped string.

unescape

public static java.lang.String unescape(java.lang.String x)

This finds any '%xx' and converts to the equivalent char. Inverse of escape().

Parameters:

x - operate on this String

Returns:

original String.

splitString

public static java.lang.String[] splitString(java.lang.String source)

Split a string on one or more whitespace. Cover for String.split, because who can remember regexp?

Parameters:

source - split this string

Returns:

tokens that were seperated by whitespace

substitute

public static java.lang.String substitute(java.lang.String original,
                                          java.lang.String[] match,
                                          java.lang.String[] subst)

Find all occurences of match strings in original, and substitute the corresponding subst string.

Parameters:

original - starting string

match - array of strings to match

subst - array of strings to substitute

Returns:

a new string with substitutions

getTokens

public static java.util.List<java.lang.String> getTokens(java.lang.String fullString,
                                                         java.lang.String sep)
                                                  throws java.lang.Exception

Throws:

java.lang.Exception

remove

public static void remove(java.lang.StringBuilder sb,
                          java.lang.String out)

Remove any of the characters in out from sb

Parameters:

sb - the StringBuilder

out - get rid of any of these characters

replace

public static void replace(java.lang.StringBuilder sb,
                           char out,
                           java.lang.String in)

Replace any char "out" in sb with String "in".

Parameters:

sb - StringBuilder to replace

out - repalce this character

in - with this string

unreplace

public static void unreplace(java.lang.StringBuilder sb,
                             java.lang.String out,
                             char in)

Replace any String "out" in sb with char "in".

Parameters:

sb - StringBuilder to replace

out - repalce this String

in - with this char

replace

public static void replace(java.lang.StringBuilder sb,
                           java.lang.String out,
                           java.lang.String in)

Replace any of the characters from out with corresponding character from in

Parameters:

sb - the StringBuilder

out - get rid of any of these characters

in - replacing with the character at same index

substitute

public static void substitute(java.lang.StringBuilder sbuff,
                              java.lang.String match,
                              java.lang.String subst)

Find all occurences of the "match" in original, and substitute the "subst" string, directly into the original.

Parameters:

sbuff - starting string buffer

match - string to match

subst - string to substitute

trim

public static java.lang.String trim(java.lang.String s,
                                    int bad)

Remove bad char from beginning or end of string

Parameters:

s - operate on this

Returns:

trimmed string

main2

public static void main2(java.lang.String[] args)

main3

public static void main3()

main

public static void main(java.lang.String[] args)
                 throws java.io.UnsupportedEncodingException

Throws:

java.io.UnsupportedEncodingException

escape2

public static java.lang.String escape2(java.lang.String x,
                                       java.lang.String reservedChars)

Escape any char in reservedChars. Escape by replacing char with %xx (hex). LOOK: need to check for %, replace with %%

Parameters:

x - escape this string

reservedChars - these must be replaced

Returns:

equivilent escaped string.

ignoreescape2

public static java.lang.String ignoreescape2(java.lang.String x,
                                             java.lang.String reservedChars)

breakText

public static java.lang.String breakText(java.lang.String text,
                                         java.lang.String insert,
                                         int lineSize)

Convert the given text to html by adding <br>. If there are new lines then we replace them with a space. Then we break the lines into 50 character (or so) chunks, adding br tags.

Parameters:

text - The text to convert

insert - string to insert

lineSize - line size to insert at

Returns:

The text with added br tags.