stanford.cs106.util

Class StringUtils

java.lang.Object

stanford.cs106.util.StringUtils

public class StringUtils
extends Object

This class contains utility code related to Strings and text processing.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_TAB_WIDTH
static String	TAB_STRING

Method Summary

Modifier and Type	Method and Description
static boolean	equalsIgnoreWhitespace(String s1, String s2)
static boolean	equalsIgnoreWhitespace(String s1, String s2, boolean ignoreCase)
static String	escape(String s)
static String	fitToBox(String value, int width, int height)
static String	fitToBox(String value, int width, int height, boolean html)
static String	fitToHeight(String value, int height)
static String	fitToWidth(String value, int width)
static String	formatDoubleLikeCpp(double value) Tries to format double the C++ iostream way, with up to 6 digits shown after the decimal point.
static int	getHeight(String value)
static int	getWidth(String value)
static String	htmlDecode(String value)
static String	htmlDecode(String value, boolean replaceSpecialChars)
static String	htmlEncode(boolean value)
static String	htmlEncode(char value)
static String	htmlEncode(double value)
static String	htmlEncode(int value)
static String	htmlEncode(long value)
static String	htmlEncode(Object value)
static String	htmlEncode(String value)
static String	htmlEncode(String value, boolean replaceSpecialChars)
static String	htmlEncode(String value, boolean replaceSpecialChars, boolean nbsp)
static boolean	isFalsey(String value)
static boolean	isTruthy(String value)
static String	join(Iterable<String> tokens, String delimiter)
static String	join(String[] tokens, String delimiter)
static String	join(String[] tokens, String delimiter, int limit)
static String	join(String[] tokens, String delimiter, int startIndex, int limit)
static int	levenshtein(String s1, String s2) Returns the Levenshtein edit distance between the two given strings; the number of characters that must be added, removed, or modified to turn the one string into the other.
static String	nCopies(String s, int n) Returns a string that contains s repeated n times.
static String	numberLines(String s)
static String	padL(int s, int width)
static String	padL(String s, int width)
static String	padNumber(int n, int length)
static String	padNumber(int n, int length, boolean html)
static String	padR(int s, int width)
static String	padR(String s, int width)
static boolean[]	parseBooleanArray(String s)
static char[]	parseCharArray(String s)
static double[]	parseDoubleArray(String s)
static int[]	parseIntArray(String s)
static int[][]	parseIntArray2D(String s)
static Point	parsePoint(String value)
static String[]	parseStringArray(String s)
static String	plural(int n)
static String	removeWhitespace(String s)
static String	sortChars(String s)
static boolean	stringIsBoolean(String text)
static boolean	stringIsDouble(String text)
static boolean	stringIsInteger(String text)
static boolean	stringIsInteger(String text, int radix)
static boolean	stringIsReal(String text)
static String	toAsciiDump(String s)
static String	toPrintableChar(char c)
static String	toString(Point p)
static String	trimBlankLines(String s) Removes any blank lines (just \n or spaces/tabs followed by \n) from the start/end of s.
static String	trimEnd(String s)
static String	trimEndsOfLines(String s)
static String	trimLines(String s) Trims out any leading/trailing whitespace from all lines of string s.
static String	trimR(String s)
static String	truncate(String s, int length) Trims the given string to be at most the given number of characters in length.
static String	truncate(String s, int length, String suffix) Trims the given string to be at most the given number of characters in length.
static String	unindent(String s) Looks at all lines of the given string, figuring out how 'indented' each line is; then removes the longest common indentation prefix string that occurs in all lines.
static String	untabify(String s) Replaces tabs with a string of spaces of a default width.
static String	untabify(String s, int tabWidth) Replaces tabs with a string of spaces of the given width.
static String	urlDecode(String s)
static String	urlEncode(String s)
static String	wrapLines(String s, int length)

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_TAB_WIDTH

public static final int DEFAULT_TAB_WIDTH

See Also:

Constant Field Values

TAB_STRING

public static final String TAB_STRING

See Also:

Constant Field Values

Method Detail

escape

public static String escape(String s)

fitToWidth

public static String fitToWidth(String value,
                                int width)

fitToHeight

public static String fitToHeight(String value,
                                 int height)

fitToBox

public static String fitToBox(String value,
                              int width,
                              int height)

fitToBox

public static String fitToBox(String value,
                              int width,
                              int height,
                              boolean html)

formatDoubleLikeCpp

public static String formatDoubleLikeCpp(double value)

Tries to format double the C++ iostream way, with up to 6 digits shown after the decimal point.

getWidth

public static int getWidth(String value)

getHeight

public static int getHeight(String value)

htmlDecode

public static String htmlDecode(String value)

htmlDecode

public static String htmlDecode(String value,
                                boolean replaceSpecialChars)

htmlEncode

public static String htmlEncode(String value)

htmlEncode

public static String htmlEncode(String value,
                                boolean replaceSpecialChars)

htmlEncode

public static String htmlEncode(String value,
                                boolean replaceSpecialChars,
                                boolean nbsp)

htmlEncode

public static String htmlEncode(int value)

htmlEncode

public static String htmlEncode(double value)

htmlEncode

public static String htmlEncode(char value)

htmlEncode

public static String htmlEncode(boolean value)

htmlEncode

public static String htmlEncode(long value)

htmlEncode

public static String htmlEncode(Object value)

isFalsey

public static boolean isFalsey(String value)

isTruthy

public static boolean isTruthy(String value)

join

public static String join(String[] tokens,
                          String delimiter)

join

public static String join(String[] tokens,
                          String delimiter,
                          int limit)

join

public static String join(String[] tokens,
                          String delimiter,
                          int startIndex,
                          int limit)

join

public static String join(Iterable<String> tokens,
                          String delimiter)

levenshtein

public static int levenshtein(String s1,
                              String s2)

Returns the Levenshtein edit distance between the two given strings; the number of characters that must be added, removed, or modified to turn the one string into the other. Case-insensitive.

See Also:

http://en.wikipedia.org/wiki/Levenshtein_distance

nCopies

public static String nCopies(String s,
                             int n)

Returns a string that contains s repeated n times.

Parameters:

s - string to repeat. if s is null, returns null.

n - number of repetitions. if <= 0, returns "".

Returns:

the repeated string

numberLines

public static String numberLines(String s)

padL

public static String padL(int s,
                          int width)

padL

public static String padL(String s,
                          int width)

padR

public static String padR(int s,
                          int width)

padR

public static String padR(String s,
                          int width)

padNumber

public static String padNumber(int n,
                               int length)

padNumber

public static String padNumber(int n,
                               int length,
                               boolean html)

parseBooleanArray

public static boolean[] parseBooleanArray(String s)

parseCharArray

public static char[] parseCharArray(String s)

parseDoubleArray

public static double[] parseDoubleArray(String s)

parseIntArray

public static int[] parseIntArray(String s)

parseIntArray2D

public static int[][] parseIntArray2D(String s)

parseStringArray

public static String[] parseStringArray(String s)

parsePoint

public static Point parsePoint(String value)

plural

public static String plural(int n)

equalsIgnoreWhitespace

public static boolean equalsIgnoreWhitespace(String s1,
                                             String s2)

equalsIgnoreWhitespace

public static boolean equalsIgnoreWhitespace(String s1,
                                             String s2,
                                             boolean ignoreCase)

removeWhitespace

public static String removeWhitespace(String s)

sortChars

public static String sortChars(String s)

stringIsBoolean

public static boolean stringIsBoolean(String text)

stringIsDouble

public static boolean stringIsDouble(String text)

stringIsInteger

public static boolean stringIsInteger(String text)

stringIsInteger

public static boolean stringIsInteger(String text,
                                      int radix)

stringIsReal

public static boolean stringIsReal(String text)

toAsciiDump

public static String toAsciiDump(String s)

toPrintableChar

public static String toPrintableChar(char c)

toString

public static String toString(Point p)

trimBlankLines

public static String trimBlankLines(String s)

Removes any blank lines (just \n or spaces/tabs followed by \n) from the start/end of s.

trimEnd

public static String trimEnd(String s)

trimR

public static String trimR(String s)

trimLines

public static String trimLines(String s)

Trims out any leading/trailing whitespace from all lines of string s.

Returns:

null if s == null

trimEndsOfLines

public static String trimEndsOfLines(String s)

truncate

public static String truncate(String s,
                              int length)

Trims the given string to be at most the given number of characters in length. Similar to fitToWidth, but doesn't put ... at end.

truncate

public static String truncate(String s,
                              int length,
                              String suffix)

Trims the given string to be at most the given number of characters in length. Similar to fitToWidth, but doesn't put ... at end.

unindent

public static String unindent(String s)

Looks at all lines of the given string, figuring out how 'indented' each line is; then removes the longest common indentation prefix string that occurs in all lines. For example, if some lines are indented 8 spaces, some 16, and some 12, then each line starts with at least 8 spaces; so those 8 are stripped from each line to yield a string where some lines are indented 0 spaces, some 8, and some 4.

Returns:

null if s == null

untabify

public static String untabify(String s)

Replaces tabs with a string of spaces of a default width.

untabify

public static String untabify(String s,
                              int tabWidth)

Replaces tabs with a string of spaces of the given width.

urlEncode

public static String urlEncode(String s)

urlDecode

public static String urlDecode(String s)

wrapLines

public static String wrapLines(String s,
                               int length)