org.melati.poem.util
Class StringUtils

java.lang.Object
  org.melati.poem.util.StringUtils

public class StringUtils
extends java.lang.Object

An assortment of useful operations on Strings.

Should be a final class, but it is extended in org.melati.util.

Constructor Summary

protected

StringUtils()

Method Summary

static void	appendEscaped(java.lang.StringBuffer b, java.lang.String s, char character)
static void	appendEscaped(java.lang.StringBuffer b, java.lang.String s, char character, char escapeChar) Append a String to a StringBuffer, and escaping any occurances of the char in the String.
static void	appendQuoted(java.lang.StringBuffer b, java.lang.String s, char q) Append a String to a StringBuffer, first quoting it with a quote character and escaping any occurances of the quote char in the String.
static java.lang.String	capitalised(java.lang.String name) Captialise the first character of the input string.
static java.lang.String	concatenated(java.lang.String sep, java.lang.String[] xs) Concatenate an array of Strings with a separator.
static byte	hexDecoding(char c) Decode a hex char to a byte.
static byte[]	hexDecoding(java.lang.String digits) Decode a hex String into a byte Array.
static java.lang.String	hexEncoding(byte[] bytes) Hex encode an Array of bytes.
static boolean	isQuoted(java.lang.String in) Determine whether a String is quoted, with either quoting character.
static java.lang.String	nulled(java.lang.String s) Turn an empty String into a null.
static java.lang.String	quoted(java.lang.String i, char q) Surround a string in quotes.
static java.lang.String	randomString(int length) Generate a random String.
static java.lang.String[]	split(java.lang.String s, char c) As Perl, create an Array from a String by using a character as the Array delimiter.
static java.lang.String	tr(java.lang.String s, char from, char to) As Perl tr; swap any occurances of the from character in the input string with the corresponding the to character.
static java.lang.String	tr(java.lang.String s, java.lang.String from, java.lang.String to) As Perl tr; swap any occurances of any characters in the from string in the input string with the corresponding character from the to string.
static java.lang.String	uncapitalised(java.lang.String name) Uncaptialise the first character of the input string.
static java.lang.String	unNulled(java.lang.String in) Turn a null into an empty String.

Methods inherited from class java.lang.Object

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

Constructor Detail

StringUtils

protected StringUtils()

Method Detail

split

public static java.lang.String[] split(java.lang.String s,
                                       char c)

As Perl, create an Array from a String by using a character as the Array delimiter.

Parameters:

s - the String to split

c - the Array delimiter

Returns:

an Array

appendEscaped

public static void appendEscaped(java.lang.StringBuffer b,
                                 java.lang.String s,
                                 char character)

Parameters:

b - the buffer to append to

s - the String to append

character - the character to escape

appendEscaped

public static void appendEscaped(java.lang.StringBuffer b,
                                 java.lang.String s,
                                 char character,
                                 char escapeChar)

Append a String to a StringBuffer, and escaping any occurances of the char in the String.

Parameters:

b - the buffer to append to

s - the String to append

character - the character to escape

escapeChar - the character to escape with

appendQuoted

public static void appendQuoted(java.lang.StringBuffer b,
                                java.lang.String s,
                                char q)

Append a String to a StringBuffer, first quoting it with a quote character and escaping any occurances of the quote char in the String.

Parameters:

b - the buffer to append to

s - the String to append

q - the quote character

quoted

public static java.lang.String quoted(java.lang.String i,
                                      char q)

Surround a string in quotes.

Parameters:

i - the string to quote

q - The quote character to use

Returns:

the quoted string

capitalised

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

Captialise the first character of the input string.

Parameters:

name - String to capitalise

Returns:

the capitalised string

uncapitalised

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

Uncaptialise the first character of the input string.

Parameters:

name - String to uncapitalise

Returns:

the uncapitalised string

tr

public static java.lang.String tr(java.lang.String s,
                                  java.lang.String from,
                                  java.lang.String to)

As Perl tr; swap any occurances of any characters in the from string in the input string with the corresponding character from the to string. tr("melati", "ait", "osn").equals("melons")

Parameters:

s - String to act upon

from - String containing characters to swap from

to - String containing characters to swap to

Returns:

the transformed input String

tr

public static java.lang.String tr(java.lang.String s,
                                  char from,
                                  char to)

As Perl tr; swap any occurances of the from character in the input string with the corresponding the to character. tr("melati", 'i', 'o').equals("melato")

Parameters:

s - String to act upon

from - character to swap from

to - character to swap to

Returns:

the transformed input String

concatenated

public static java.lang.String concatenated(java.lang.String sep,
                                            java.lang.String[] xs)

Concatenate an array of Strings with a separator.

Parameters:

sep - The separator String to use, may be null.

xs - An array of Strings to concatenate.

Returns:

the concatenated String.

randomString

public static java.lang.String randomString(int length)

Generate a random String.

Parameters:

length - the required length of the String returned

Returns:

a random String of upper and lowercase letters and digits

nulled

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

Turn an empty String into a null.

Parameters:

s - input String, possibly of zero length or null

Returns:

null if input is empty, input otherwise

unNulled

public static java.lang.String unNulled(java.lang.String in)

Turn a null into an empty String.

Parameters:

in - input String, possibly null

Returns:

empty String if input is null, input otherwise

hexEncoding

public static java.lang.String hexEncoding(byte[] bytes)

Hex encode an Array of bytes.

Parameters:

bytes - the byte Array

Returns:

the hex representation

hexDecoding

public static byte hexDecoding(char c)

Decode a hex char to a byte.

Parameters:

c - the char

Returns:

a byte

hexDecoding

public static byte[] hexDecoding(java.lang.String digits)

Decode a hex String into a byte Array.

Parameters:

digits - the hex String

Returns:

a byte Array

isQuoted

public static boolean isQuoted(java.lang.String in)

Determine whether a String is quoted, with either quoting character.

Parameters:

in - String to examine

Returns:

whether String is quoted