TextUtil (clapper.org Utility API)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.clapper.util.text
Class TextUtil

java.lang.Object
  org.clapper.util.text.TextUtil

public final class TextUtil
extends java.lang.Object
extends java.lang.Object

Static class containing miscellaneous text utility methods.

Version:: $Revision: 6735 $
Author:: Copyright © 2004-2007 Brian M. Clapper

Field Summary
`static char[]`	`HEXADECIMAL_DIGITS` Set of digits suitable for encoding a number as a hexadecimal string.

Method Summary
`static boolean`	`booleanFromString(java.lang.String s)` Convert a boolean string to a boolean value.
`static byte[]`	`bytesForHexadecimal(java.lang.String hexString)` Takes a string of hexadecimal-encoded byte values and converts it back to an array of bytes.
`static java.lang.String`	`centerString(java.lang.String s, int width)` Center a string in a fixed-width field, using blanks for padding.
`static java.lang.String`	`centerString(java.lang.String s, int width, char c)` Center a string in a fixed-width field, using the specified character for padding.
`static java.lang.String`	`charToUnicodeEscape(char c)` Convert a character to its corresponding Unicode escape sequence.
`static java.lang.String`	`charToUnicodeEscape(char c, java.lang.StringBuilder buf)` Convert a character to its corresponding Unicode escape sequence.
`static java.lang.StringBuilder`	`encodeNumber(int num, int base, char[] digits, java.lang.StringBuilder buf)` Encode an integer in an arbitrary base; the caller specifies an array of digit characters to be used for the encoding.
`static java.lang.StringBuilder`	`encodeNumber(long num, int base, char[] digits, java.lang.StringBuilder buf)` Encode a long integer in an arbitrary base; the caller specifies an array of digit characters to be used for the encoding.
`static java.lang.StringBuilder`	`encodeNumber(short num, int base, char[] digits, java.lang.StringBuilder buf)` Encode a short integer in an arbitrary base; the caller specifies an array of digit characters to be used for the encoding.
`static java.lang.StringBuilder`	`hexadecimalForByte(byte b, java.lang.StringBuilder buf)` Encode a byte as a two-digit hexadecimal string, appending the result to a `StringBuilder`.
`static java.lang.StringBuilder`	`hexadecimalForByte(int b, java.lang.StringBuilder buf)` Encode a byte as a two-digit hexadecimal string, appending the result to a `StringBuilder`.The hexadecimal string uses lower-case digits. in lower-case.
`static java.lang.String`	`hexadecimalForBytes(byte[] bytes)` Encode an array of bytes as a hexadecimal string, returning the string.
`static java.lang.StringBuilder`	`hexadecimalForBytes(byte[] bytes, int start, int end, java.lang.StringBuilder buf)` Encode an array of bytes as a hexadecimal string, appending the result to a `StringBuilder`.
`static java.lang.StringBuilder`	`hexadecimalForBytes(int[] bytes, int start, int end, java.lang.StringBuilder buf)` Encode an array of bytes as a hexadecimal string, appending the result to a `StringBuilder`.
`static java.lang.String`	`hexadecimalForNumber(int num)` Encode an integer as a hexadecimal string, returning the hex string.
`static java.lang.StringBuilder`	`hexadecimalForNumber(int num, java.lang.StringBuilder buf)` Encode an integer as a hexadecimal string, appending the result to a `StringBuilder`.
`static java.lang.String`	`hexadecimalForNumber(long num)` Encode a long as a hexadecimal string, returning the hex string.
`static java.lang.StringBuilder`	`hexadecimalForNumber(long num, java.lang.StringBuilder buf)` Encode a long as a hexadecimal string, appending the result to a `StringBuilder`.
`static java.lang.String`	`hexadecimalForNumber(short num)` Encode a short as a hexadecimal string, returning the hex string.
`static java.lang.StringBuilder`	`hexadecimalForNumber(short num, java.lang.StringBuilder buf)` Encode a short as a hexadecimal string, appending the result to a `StringBuilder`.
`static boolean`	`isPrintable(char c)` Determine whether a character is printable.
`static java.lang.String`	`join(char delim, java.lang.String... strings)` Join a set of strings into one string, putting the specified delimiter between adjacent strings.
`static java.lang.String`	`join(java.util.Collection<? extends java.lang.Object> objects, char delim)` Join a set of strings into one string, putting the specified delimiter between adjacent strings.
`static java.lang.String`	`join(java.util.Collection<? extends java.lang.Object> objects, java.lang.String delim)` Join a set of strings into one string, putting the specified delimiter between adjacent strings.
`static java.lang.String`	`join(java.lang.String[] strings, char delim)` Join an array of strings into one string, putting the specified delimiter between adjacent strings.
`static java.lang.String`	`join(java.lang.String[] strings, int start, int end, char delim)` Join an array of strings into one string, putting the specified delimiter between adjacent strings, starting at a specified index.
`static java.lang.String`	`join(java.lang.String[] strings, int start, int end, java.lang.String delim)` Join an array of strings into one string, putting the specified delimiter between adjacent strings, starting at a specified index.
`static java.lang.String`	`join(java.lang.String[] strings, java.lang.String delim)` Join a set of strings into one string, putting the specified delimiter between adjacent strings.
`static java.lang.String`	`join(java.lang.String delim, java.lang.String... strings)` Join a set of strings into one string, putting the specified delimiter between adjacent strings.
`static java.lang.String`	`leftJustifyString(java.lang.String s, int width)` Left justify a string in a fixed-width field, using blanks for padding.
`static java.lang.String`	`leftJustifyString(java.lang.String s, int width, char c)` Left justify a string in a fixed-width field, using the specified character for padding.
`static java.lang.String`	`rightJustifyString(java.lang.String s, int width)` Right justify a string in a fixed-width field, using blanks for padding.
`static java.lang.String`	`rightJustifyString(java.lang.String s, int width, char c)` Right justify a string in a fixed-width field, using the specified character for padding.
`static java.lang.String`	`romanNumeralsForNumber(int n)` Get the (upper-case) Roman numeral string for a number.
`static java.lang.String[]`	`split(java.lang.String s)` Split a string on white space, into one or more strings.
`static java.lang.String[]`	`split(java.lang.String s, boolean preserveEmptyFields)` Split a string on white space, into one or more strings.
`static java.lang.String[]`	`split(java.lang.String s, char delim)` Split a string into one or more strings, based on a delimiter.
`static java.lang.String[]`	`split(java.lang.String s, char delim, boolean preserveEmptyFields)` Split a string into one or more strings, based on a delimiter.
`static int`	`split(java.lang.String s, char delim, java.util.Collection<java.lang.String> collection)` Split a string into one or more strings, based on a delimiter.
`static int`	`split(java.lang.String s, char delim, java.util.Collection<java.lang.String> collection, boolean preserveEmptyFields)` Split a string into one or more strings, based on a delimiter.
`static int`	`split(java.lang.String s, java.util.Collection<java.lang.String> collection)` Split a string on white space, into one or more strings.
`static int`	`split(java.lang.String s, java.util.Collection<java.lang.String> collection, boolean preserveEmptyFields)` Split a string on white space, into one or more strings.
`static java.lang.String[]`	`split(java.lang.String s, java.lang.String delimSet)` Split a string into one or more strings, based on a set of delimiter.
`static java.lang.String[]`	`split(java.lang.String s, java.lang.String delimSet, boolean preserveEmptyFields)` Split a string into one or more strings, based on a set of delimiter.
`static int`	`split(java.lang.String s, java.lang.String delimSet, java.util.Collection<java.lang.String> collection)` Split a string into one or more strings, based on a set of delimiter.
`static int`	`split(java.lang.String s, java.lang.String delimSet, java.util.Collection<java.lang.String> collection, boolean preserveEmptyFields)` Split a string into one or more strings, based on a set of delimiter.
`static boolean`	`stringIsEmpty(java.lang.String s)` Determine whether a given string is empty.

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

Field Detail

HEXADECIMAL_DIGITS

public static final char[] HEXADECIMAL_DIGITS

Set of digits suitable for encoding a number as a hexadecimal string.

See Also:: hexadecimalForNumber(int,StringBuilder), hexadecimalForNumber(short,StringBuilder), hexadecimalForNumber(long,StringBuilder), hexadecimalForByte(byte,StringBuilder), hexadecimalForByte(int,StringBuilder), hexadecimalForBytes(byte[],int,int,StringBuilder), hexadecimalForBytes(int[],int,int,StringBuilder), encodeNumber(long,int,char[],StringBuilder), encodeNumber(int,int,char[],StringBuilder), encodeNumber(short,int,char[],StringBuilder)

Method Detail

booleanFromString

public static boolean booleanFromString(java.lang.String s)
                                 throws java.lang.IllegalArgumentException

Convert a boolean string to a boolean value. This method is more generous than java.lang.Boolean.booleanValue(). The following strings (in upper or lower case) are recognized as true: "1", "true", "yes", "y". The following strings (in upper or lower case) are recognized as false: "0", "false", "no", "n".

Parameters:: s - string to convert
Returns:: true or false
Throws:: java.lang.IllegalArgumentException - string isn't a boolean

split

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

Split a string on white space, into one or more strings. This method is intended to be reminiscent of the corresponding perl or awk split() function, though without regular expression support. This version of split() does not preserve empty strings. That is, the string "a:b::c", when split with a ":" delimiter, yields three fields ("a", "b", "c"), since the two adjacent ":" characters are treated as one delimiter. To preserve empty strings, pass true as the preserveEmptyFields parameter to the split(String,boolean) method.