Package org.apache.sis.util
Class StringBuilders
Static methods working on 
StringBuilder instances. Some methods defined in this
 class duplicate the functionalities provided in the CharSequences class, but
 modify directly the content of the provided StringBuilder instead of creating
 new objects.
 Unicode support
Every methods defined in this class work on code points instead of characters when appropriate. Consequently, those methods should behave correctly with characters outside the Basic Multilingual Plane (BMP).- Since:
- 0.3
- See Also:
Defined in the sis-utility module
- 
Method SummaryModifier and TypeMethodDescriptionstatic voidremove(StringBuilder buffer, String toSearch) Removes every occurrences of the given string in the given buffer.static voidrepeat(StringBuilder buffer, char c, int count) Appends the given character n times.static voidrepeat(StringBuilder buffer, int offset, char c, int count) Inserts the given character n times at the given position.static voidreplace(StringBuilder buffer, char toSearch, char replaceBy) Replaces every occurrences of the given character in the given buffer.static voidreplace(StringBuilder buffer, int start, int end, char[] chars) Replaces the characters in a substring of the buffer with characters in the specified array.static voidreplace(StringBuilder buffer, String toSearch, String replaceBy) Replaces every occurrences of the given string in the given buffer.static voidtoASCII(StringBuilder buffer) Replaces some Unicode characters by ASCII characters on a "best effort basis".static voidtrimFractionalPart(StringBuilder buffer) Trims the fractional part of the given formatted number, provided that it doesn't change the value.
- 
Method Details- 
replaceReplaces every occurrences of the given character in the given buffer.- Parameters:
- buffer- the string in which to perform the replacements.
- toSearch- the character to replace.
- replaceBy- the replacement for the searched character.
- Throws:
- NullArgumentException- if the- bufferarguments is null.
- See Also:
 
- 
replaceReplaces every occurrences of the given string in the given buffer. This method invokesStringBuilder.replace(int, int, String)for each occurrence ofsearchfound in the buffer.- Parameters:
- buffer- the string in which to perform the replacements.
- toSearch- the string to replace.
- replaceBy- the replacement for the searched string.
- Throws:
- NullArgumentException- if any of the arguments is null.
- IllegalArgumentException- if the- toSearchargument is empty.
- See Also:
 
- 
replaceReplaces the characters in a substring of the buffer with characters in the specified array. The substring to be replaced begins at the specifiedstartand extends to the character at indexend - 1.- Parameters:
- buffer- the buffer in which to perform the replacement.
- start- the beginning index in the- buffer, inclusive.
- end- the ending index in the- buffer, exclusive.
- chars- the array that will replace previous contents.
- Throws:
- NullArgumentException- if the- bufferor- charsargument is null.
- See Also:
 
- 
removeRemoves every occurrences of the given string in the given buffer. This method invokesStringBuilder.delete(int, int)for each occurrence ofsearchfound in the buffer.- Parameters:
- buffer- the string in which to perform the removals.
- toSearch- the string to remove.
- Throws:
- NullPointerException- if any of the arguments is null.
- IllegalArgumentException- if the- toSearchargument is empty.
- See Also:
 
- 
repeatAppends the given character n times. This method does nothing if the givencountis zero.- Parameters:
- buffer- the buffer where to append the character.
- c- the character to repeat.
- count- number of times to repeat the given character.
- Throws:
- NullPointerException- if the given buffer is null.
- IllegalArgumentException- if the given count is negative.
- Since:
- 1.0
 
- 
repeatInserts the given character n times at the given position. This method does nothing if the givencountis zero.- Parameters:
- buffer- the buffer where to insert the character.
- offset- position where to insert the characters.
- c- the character to repeat.
- count- number of times to repeat the given character.
- Throws:
- NullPointerException- if the given buffer is null.
- IndexOutOfBoundsException- if the given index is invalid.
- IllegalArgumentException- if the given count is negative.
- Since:
- 0.8
 
- 
trimFractionalPartTrims the fractional part of the given formatted number, provided that it doesn't change the value. This method assumes that the number is formatted in the US locale, typically by theDouble.toString(double)method.More specifically if the given buffer ends with a '.'character followed by a sequence of'0'characters, then those characters are removed. Otherwise this method does nothing. This is a "all or nothing" method: either the fractional part is completely removed, or either it is left unchanged.Use caseThis method is useful after a double value has been appended to the buffer, in order to make it appears like an integer when possible.- Parameters:
- buffer- the buffer to trim if possible.
- Throws:
- NullArgumentException- if the given- bufferis null.
- See Also:
 
- 
toASCIIReplaces some Unicode characters by ASCII characters on a "best effort basis". For example, the “ é ” character is replaced by “ e ” (without accent), the “ ″ ” symbol for minutes of angle is replaced by straight double quotes “ " ”, and combined characters like ㎏, ㎎, ㎝, ㎞, ㎢, ㎦, ㎖, ㎧, ㎩, ㎐, etc. are replaced by the corresponding sequences of characters.- Parameters:
- buffer- the text to scan for Unicode characters to replace by ASCII characters.
- Throws:
- NullArgumentException- if the given- bufferis null.
- See Also:
 
 
-