Word Wrap
import java.text.BreakIterator;
import java.util.Locale;
/**
* $Revision: 10205 $
* $Date: 2008-04-11 15:48:27 -0700 (Fri, 11 Apr 2008) $
*
* Copyright (C) 2004-2008 Jive Software. All rights reserved.
*
* This software is published under the terms of the GNU Public License (GPL),
* a copy of which is included in this distribution, or a commercial license
* agreement with Jive.
*/
/**
* Utility class to peform common String manipulation algorithms.
*/
class StringUtils {
// Constants used by escapeHTMLTags
private static final char[] QUOTE_ENCODE = """.toCharArray();
private static final char[] AMP_ENCODE = "&".toCharArray();
private static final char[] LT_ENCODE = "<".toCharArray();
private static final char[] GT_ENCODE = ">".toCharArray();
private StringUtils() {
// Not instantiable.
}
/**
* Reformats a string where lines that are longer than <tt>width</tt>
* are split apart at the earliest wordbreak or at maxLength, whichever is
* sooner. If the width specified is less than 5 or greater than the input
* Strings length the string will be returned as is.
* <p/>
* Please note that this method can be lossy - trailing spaces on wrapped
* lines may be trimmed.
*
* @param input the String to reformat.
* @param width the maximum length of any one line.
* @return a new String with reformatted as needed.
*/
public static String wordWrap(String input, int width, Locale locale) {
// protect ourselves
if (input == null) {
return "";
}
else if (width < 5) {
return input;
}
else if (width >= input.length()) {
return input;
}
StringBuilder buf = new StringBuilder(input);
boolean endOfLine = false;
int lineStart = 0;
for (int i = 0; i < buf.length(); i++) {
if (buf.charAt(i) == '\n') {
lineStart = i + 1;
endOfLine = true;
}
// handle splitting at width character
if (i > lineStart + width - 1) {
if (!endOfLine) {
int limit = i - lineStart - 1;
BreakIterator breaks = BreakIterator.getLineInstance(locale);
breaks.setText(buf.substring(lineStart, i));
int end = breaks.last();
// if the last character in the search string isn't a space,
// we can't split on it (looks bad). Search for a previous
// break character
if (end == limit + 1) {
if (!Character.isWhitespace(buf.charAt(lineStart + end))) {
end = breaks.preceding(end - 1);
}
}
// if the last character is a space, replace it with a \n
if (end != BreakIterator.DONE && end == limit + 1) {
buf.replace(lineStart + end, lineStart + end + 1, "\n");
lineStart = lineStart + end;
}
// otherwise, just insert a \n
else if (end != BreakIterator.DONE && end != 0) {
buf.insert(lineStart + end, '\n');
lineStart = lineStart + end + 1;
}
else {
buf.insert(i, '\n');
lineStart = i + 1;
}
}
else {
buf.insert(i, '\n');
lineStart = i + 1;
endOfLine = false;
}
}
}
return buf.toString();
}
}
Related examples in the same category
1. | Fmt - format text (like Berkeley UNIX fmt) | | |
2. | Demonstrate some usage patterns and format-code examples of the Formatter | | |
3. | String.format(): right pad a string | | |
4. | String.format(): left pad a string | | |
5. | Format a String (JDK1.5) | | |
6. | Pass value array to String.format() | | |
7. | Format Calendar with String.format() | | |
8. | Abbreviates a String using ellipses in both sides. | | |
9. | Abbreviates a String using ellipses. | | |
10. | Abbreviate string | | |
11. | Centers a String in a larger String of size size using the space character (' '). | | |
12. | Centers a String in a larger String of size size. Uses a supplied String as the value to pad the String with. | | |
13. | Centers a String in a larger String of size size. Uses a supplied character as the value to pad the String with. | | |
14. | Capitalize the first character of the given string | | |
15. | Capitalize the first letter but leave the rest as they are. | | |
16. | Capitalizes a String changing the first letter to title case as Character.toTitleCase(char). No other letters are changed. | | |
17. | Format strings into table | | |
18. | Center the contents of the string. | | |
19. | Truncate the supplied string to be no more than the specified length. | | |
20. | Replace, remove, format strings | | |
21. | Adds spaces in suitable locations of the input string | | |
22. | Blank string: empty or white space | | |
23. | Capital and uncapital strings | | |
24. | Capitalizes the first character of the given string | | |
25. | Utilities for String formatting, manipulation, and queries | | |
26. | Fast lower case conversion | | |
27. | Format a percentage for presentation to the user | | |
28. | Left justify the contents of the string, ensuring that the supplied string begins at the first character and that the resulting string is of the desired length. | | |
29. | Transforms words to singular, plural, humanized (human readable), underscore, camel case, or ordinal form | | |
30. | Escapes all necessary characters in the String so that it can be used in SQL | | |
31. | Escapes all necessary characters in the String so that it can be used in an XML doc | | |
32. | Adds zeros to the beginning of a value so that the total length matches the given precision, otherwise trims the right digits. | | |
33. | Right justify string, ensuring that the string ends at the last character | | |
34. | Makes the first letter caps and the rest lowercase. | | |
35. | Quote a string so that it can be used as an identifier or a string literal in SQL statements. | | |
36. | Remove the hyphens from the begining of str and return the new String. | | |
37. | Swaps the case of a String changing upper and title case to lower case, and lower case to upper case. | | |
38. | Uncapitalizes a String changing the first letter to title case as per Character.toLowerCase(char). No other letters are changed. | | |
39. | Capitlize each word in a string (journal titles, etc) | | |
40. | Uncapitalize String | | |
41. | Utility inserts a space before every caps in a string | | |
42. | convert String array To Comma Delimited | | |
43. | Constructs a method name from element's bean name for a given prefix | | |
44. | break Lines | | |
45. | Limit the string to a certain number of characters, adding "..." if it was truncated | | |
46. | Capicalizes the first letter of a string | | |
47. | Add delimiters to a string. | | |
48. | Get Truncated String | | |
49. | Convert to $(Dollars) string | | |
50. | Convert string to multiline | | |
51. | Deletes all whitespace from a String. | | |
52. | Trim string from left or right | | |
53. | implode and explode string | | |
54. | To Upper Case First Char | | |
55. | Left trim and right trim | | |
56. | capitalize and uncapitalize | | |