Class StringGroovyMethods
public static String reverse(String self)
provides a reverse()
method for String
.
NOTE: While this class contains many 'public' static methods, it is primarily regarded as an internal class (its internal package name suggests this also). We value backwards compatibility of these methods when used within Groovy but value less backwards compatibility at the Java method call level. I.e. future versions of Groovy may remove or move a method call in this file but would normally aim to keep the method available from within Groovy.
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionstatic boolean
asBoolean
(CharSequence string) Coerce a string (an instance of CharSequence) to a boolean value.static boolean
Coerce a Matcher instance to a boolean value.static <T> T
Converts the GString to a File, or delegates to the defaultDefaultGroovyMethods.asType(Object, Class)
static <T> T
asType
(CharSequence self, Class<T> c) Provides a method to perform custom 'dynamic' type conversion to the given class using theas
operator.static <T> T
Provides a method to perform custom 'dynamic' type conversion to the given class using theas
operator.static Pattern
bitwiseNegate
(CharSequence self) Turns a CharSequence into a regular expression Patternstatic Pattern
bitwiseNegate
(String self) Deprecated.Use the CharSequence versionstatic String
capitalize
(CharSequence self) Convenience method to capitalize the first letter of a CharSequence (typically the first letter of a word).static String
capitalize
(String self) Deprecated.Use the CharSequence versionstatic String
center
(CharSequence self, Number numberOfChars) Pad a CharSequence to a minimum length specified by numberOfChars by adding the space character around it as many times as needed so that it remains centered.static String
center
(CharSequence self, Number numberOfChars, CharSequence padding) Pad a CharSequence to a minimum length specified by numberOfChars, appending the supplied padding CharSequence around the original as many times as needed keeping it centered.static String
Deprecated.Use the CharSequence versionstatic String
Deprecated.Use the CharSequence versionstatic String
collectReplacements
(String orig, Closure<String> transform) Iterate through this String a character at a time collecting either the original character or a transformed replacement String.static boolean
contains
(CharSequence self, CharSequence text) Provide an implementation of contains() likeCollection.contains(Object)
to make CharSequences more polymorphic.static boolean
Deprecated.Use the CharSequence versionstatic int
count
(CharSequence self, CharSequence text) Count the number of occurrences of a sub CharSequence.static int
Deprecated.Use the CharSequence versionstatic String
denormalize
(CharSequence self) Return a CharSequence with lines (separated by LF, CR/LF, or CR) terminated by the platform specific line separator.static String
denormalize
(String self) Deprecated.Use the CharSequence versionstatic String
A GString variant of the equivalent CharSequence method.static CharSequence
drop
(CharSequence self, int num) Drops the given number of chars from the head of this CharSequence if they are available.static String
A GString variant of the equivalent CharSequence method.static CharSequence
dropWhile
(CharSequence self, Closure condition) Create a suffix of the given CharSequence by dropping as many characters as possible from the front of the original CharSequence such that calling the given closure condition evaluates to true when passed each of the dropped characters.static <T> T
eachLine
(CharSequence self, int firstLine, Closure<T> closure) Iterates through this CharSequence line by line.static <T> T
eachLine
(CharSequence self, Closure<T> closure) Iterates through this CharSequence line by line.static <T> T
Deprecated.Use the CharSequence versionstatic <T> T
Deprecated.Use the CharSequence versionstatic String
Process each regex group matched substring of the given string.static String
Process each regex group matched substring of the given pattern.static <T extends CharSequence>
TeachMatch
(T self, CharSequence regex, Closure closure) Process each regex group matched substring of the given CharSequence.static <T extends CharSequence>
TProcess each regex group matched substring of the given pattern.static boolean
endsWithAny
(CharSequence self, CharSequence... suffixes) Tests if this CharSequence ends with any specified suffixes.static String
expand
(CharSequence self) Expands all tabs into spaces with tabStops of size 8.static String
expand
(CharSequence self, int tabStop) Expands all tabs into spaces.static String
Deprecated.Use the CharSequence versionstatic String
Deprecated.Use the CharSequence versionstatic String
expandLine
(CharSequence self, int tabStop) Expands all tabs into spaces.static String
expandLine
(String self, int tabStop) Deprecated.Use the CharSequence versionstatic String
find
(CharSequence self, CharSequence regex) Finds the first occurrence of a regular expression String within a String.static String
find
(CharSequence self, CharSequence regex, Closure closure) Returns the result of calling a closure with the first occurrence of a regular expression found within a CharSequence.static String
find
(CharSequence self, Pattern pattern) Finds the first occurrence of a compiled regular expression Pattern within a String.static String
find
(CharSequence self, Pattern pattern, Closure closure) Returns the result of calling a closure with the first occurrence of a compiled regular expression found within a String.static String
Deprecated.Use the CharSequence versionstatic String
Deprecated.Use the CharSequence versionstatic String
Deprecated.Use the CharSequence versionstatic String
Deprecated.Use the CharSequence versionfindAll
(CharSequence self, CharSequence regex) Returns a (possibly empty) list of all occurrences of a regular expression (provided as a CharSequence) found within a CharSequence.static <T> List<T>
findAll
(CharSequence self, CharSequence regex, Closure<T> closure) Finds all occurrences of a regular expression string within a CharSequence.findAll
(CharSequence self, Pattern pattern) Returns a (possibly empty) list of all occurrences of a regular expression (in Pattern format) found within a CharSequence.static <T> List<T>
findAll
(CharSequence self, Pattern pattern, Closure<T> closure) Finds all occurrences of a compiled regular expression Pattern within a CharSequence.Deprecated.Use the CharSequence versionstatic <T> List<T>
Deprecated.Use the CharSequence versionDeprecated.Use the CharSequence versionstatic <T> List<T>
Deprecated.Use the CharSequence versionstatic String
Support the subscript operator for GString.static String
Support the range subscript operator for GString with IntRangestatic String
Support the range subscript operator for GStringstatic CharSequence
getAt
(CharSequence text, int index) Support the subscript operator for CharSequence.static String
getAt
(CharSequence text, EmptyRange range) Support the range subscript operator for CharSequence or StringBuffer with EmptyRangestatic CharSequence
getAt
(CharSequence text, IntRange range) Support the range subscript operator for CharSequence with IntRangestatic CharSequence
getAt
(CharSequence text, Range range) Support the range subscript operator for CharSequencestatic String
getAt
(CharSequence self, Collection indices) Select a List of characters from a CharSequence using a Collection to identify the indices to be selected.static String
Support the subscript operator for String.static String
getAt
(String text, EmptyRange range) Deprecated.Use the CharSequence versionstatic String
Support the range subscript operator for String with IntRangestatic String
Support the range subscript operator for Stringstatic String
getAt
(String self, Collection indices) Deprecated.Use the CharSequence versionstatic Object
Support the subscript operator, e.g.static List
getAt
(Matcher self, Collection indices) Select a List of values from a Matcher using a Collection to identify the indices to be selected.static char[]
getChars
(CharSequence self) Converts the given CharSequence into an array of characters.static char[]
Deprecated.Use the CharSequence versionstatic int
Find the number of Strings matched to the given Matcher.static boolean
Check whether a Matcher contains a group or not.static boolean
isAllWhitespace
(CharSequence self) True if a CharSequence only contains whitespace characters.static boolean
isAllWhitespace
(String self) Deprecated.Use the CharSequence versionstatic boolean
isBigDecimal
(CharSequence self) Determine if a CharSequence can be parsed as a BigDecimal.static boolean
isBigDecimal
(String self) Deprecated.Use the CharSequence versionstatic boolean
isBigInteger
(CharSequence self) Determine if a CharSequence can be parsed as a BigInteger.static boolean
isBigInteger
(String self) Deprecated.Use the CharSequence versionstatic boolean
Deprecated.Use the CharSequence versionstatic boolean
isCase
(CharSequence caseValue, Object switchValue) 'Case' implementation for a CharSequence, which uses equals between the toString() of the caseValue and the switchValue.static boolean
Deprecated.Use the CharSequence versionstatic boolean
'Case' implementation for thePattern
class, which allows testing a String against a number of regular expressions.static boolean
isDouble
(CharSequence self) Determine if a CharSequence can be parsed as a Double.static boolean
Deprecated.Use the CharSequence versionstatic boolean
isFloat
(CharSequence self) Determine if a CharSequence can be parsed as a Float.static boolean
Deprecated.Use the CharSequence versionstatic boolean
isInteger
(CharSequence self) Determine if a CharSequence can be parsed as an Integer.static boolean
Deprecated.Use the CharSequence versionstatic boolean
isLong
(CharSequence self) Determine if a CharSequence can be parsed as a Long.static boolean
Deprecated.Use the CharSequence versionstatic boolean
isNumber
(CharSequence self) Determine if a CharSequence can be parsed as a Number.static boolean
Deprecated.Use the CharSequence versionstatic Iterator
Returns anIterator
which traverses each match.static StringBuilder
leftShift
(CharSequence self, Object value) Overloads the left shift operator to provide an easy way to append multiple objects as string representations to a CharSequence.static StringBuffer
leftShift
(StringBuffer self, Object value) Overloads the left shift operator to provide an easy way to append multiple objects as string representations to a StringBuffer.static StringBuilder
leftShift
(StringBuilder self, Object value) Overloads the left shift operator to provide syntactic sugar for appending to a StringBuilder.static StringBuffer
Overloads the left shift operator to provide an easy way to append multiple objects as string representations to a String.static boolean
matches
(CharSequence self, Pattern pattern) Tells whether or not a CharSequence matches the given compiled regular expression Pattern.static boolean
Deprecated.Use the CharSequence versionstatic boolean
matchesPartially
(Matcher matcher) Given a matcher that matches a string against a pattern, this method returns true when the string matches the pattern or if a longer string, could match the pattern.static String
minus
(CharSequence self, Object target) Remove a part of a CharSequence by replacing the first occurrence of target within self with '' and returns the result.static String
minus
(CharSequence self, Pattern pattern) Remove a part of a CharSequence.static String
Deprecated.Use the CharSequence versionstatic String
Deprecated.Use the CharSequence versionstatic String
multiply
(CharSequence self, Number factor) Repeat a CharSequence a certain number of times.static String
Deprecated.Use the CharSequence versionstatic String
next
(CharSequence self) This method is called by the ++ operator for the class CharSequence.static String
Deprecated.Use the CharSequence versionstatic String
normalize
(CharSequence self) Return a String with linefeeds and carriage returns normalized to linefeeds.static String
Deprecated.Use the CharSequence versionstatic String
padLeft
(CharSequence self, Number numberOfChars) Pad a CharSequence to a minimum length specified by numberOfChars by adding the space character to the left as many times as needed.static String
padLeft
(CharSequence self, Number numberOfChars, CharSequence padding) Pad a CharSequence to a minimum length specified by numberOfChars, adding the supplied padding CharSequence as many times as needed to the left.static String
Deprecated.Use the CharSequence versionstatic String
Deprecated.Use the CharSequence versionstatic String
padRight
(CharSequence self, Number numberOfChars) Pad a CharSequence to a minimum length specified by numberOfChars by adding the space character to the right as many times as needed.static String
padRight
(CharSequence self, Number numberOfChars, CharSequence padding) Pad a CharSequence to a minimum length specified by numberOfChars, adding the supplied padding CharSequence as many times as needed to the right.static String
Deprecated.Use the CharSequence versionstatic String
Deprecated.Use the CharSequence versionstatic String
plus
(CharSequence left, Object value) Appends the String representation of the given operand to this CharSequence.static String
Appends a String to the string representation of this number.static String
plus
(StringBuffer left, String value) Appends a String to this StringBuffer.static String
plus
(String left, CharSequence value) Appends the String representation of the given operand to this string.static String
Deprecated.Use the CharSequence versionstatic String
previous
(CharSequence self) This method is called by the -- operator for the class CharSequence.static String
Deprecated.Use the CharSequence versionstatic void
putAt
(StringBuffer self, EmptyRange range, Object value) Support the range subscript operator for StringBuffer.static void
putAt
(StringBuffer self, IntRange range, Object value) Support the range subscript operator for StringBuffer.readLines
(CharSequence self) Return the lines of a CharSequence as a List of String.Deprecated.Use the CharSequence versionstatic String
replaceAll
(CharSequence self, CharSequence regex, Closure closure) Replaces all occurrences of a captured group by the result of calling a closure on that text.static String
replaceAll
(CharSequence self, CharSequence regex, CharSequence replacement) Replaces each substring of this CharSequence that matches the given regular expression with the given replacement.static String
replaceAll
(CharSequence self, Pattern pattern, Closure closure) Replaces all occurrences of a captured group by the result of a closure call on that text.static String
replaceAll
(CharSequence self, Pattern pattern, CharSequence replacement) Replaces all substrings of a CharSequence that match the given compiled regular expression with the given replacement.static String
replaceAll
(String self, String regex, Closure closure) Deprecated.Use the CharSequence versionstatic String
replaceAll
(String self, Pattern pattern, Closure closure) Deprecated.Use the CharSequence versionstatic String
replaceAll
(String self, Pattern pattern, String replacement) Deprecated.Use the CharSequence versionstatic String
replaceFirst
(CharSequence self, CharSequence regex, Closure closure) Replaces the first occurrence of a captured group by the result of a closure call on that text.static String
replaceFirst
(CharSequence self, CharSequence regex, CharSequence replacement) Replaces the first substring of this CharSequence that matches the given regular expression with the given replacement.static String
replaceFirst
(CharSequence self, Pattern pattern, Closure closure) Replaces the first occurrence of a captured group by the result of a closure call on that text.static String
replaceFirst
(CharSequence self, Pattern pattern, CharSequence replacement) Replaces the first substring of a CharSequence that matches the given compiled regular expression with the given replacement.static String
replaceFirst
(String self, String regex, Closure closure) Deprecated.Use the CharSequence versionstatic String
replaceFirst
(String self, Pattern pattern, Closure closure) Deprecated.Use the CharSequence versionstatic String
replaceFirst
(String self, Pattern pattern, String replacement) Deprecated.Use the CharSequence versionstatic String
reverse
(CharSequence self) Creates a String which is the reverse (backwards) of this CharSequencestatic String
Deprecated.Use the CharSequence versionstatic void
Set the position of the given Matcher to the given index.static int
size
(CharSequence text) Provide the standard Groovysize()
method forCharSequence
.static int
Provide the standard Groovysize()
method forString
.static int
size
(StringBuffer buffer) Provide the standard Groovysize()
method forStringBuffer
.static long
Provide the standard Groovysize()
method forMatcher
.static String[]
Deprecated.Use the CharSequence versionstatic String[]
split
(CharSequence self) Convenience method to split a CharSequence (with whitespace as delimiter).static String[]
Deprecated.Use the CharSequence versionstatic <T> T
splitEachLine
(CharSequence self, CharSequence regex, Closure<T> closure) Iterates through the given CharSequence line by line, splitting each line using the given regex delimiter.static <T> T
splitEachLine
(CharSequence self, Pattern pattern, Closure<T> closure) Iterates through the given CharSequence line by line, splitting each line using the given separator Pattern.static <T> T
splitEachLine
(String self, String regex, Closure<T> closure) Deprecated.Use the CharSequence versionstatic <T> T
splitEachLine
(String self, Pattern pattern, Closure<T> closure) Deprecated.Use the CharSequence versionstatic boolean
startsWithAny
(CharSequence self, CharSequence... prefixes) Tests if this CharSequence starts with any specified prefixes.static String
stripIndent
(CharSequence self) Strip leading spaces from every line in a CharSequence.static String
stripIndent
(CharSequence self, int numChars) Strip numChar leading characters from every line in a CharSequence.static String
stripIndent
(String self) Deprecated.Use the CharSequence versionstatic String
stripIndent
(String self, int numChars) Deprecated.Use the CharSequence versionstatic String
stripMargin
(CharSequence self) Strip leading whitespace/control characters followed by '|' from every line in a CharSequence.static String
stripMargin
(CharSequence self, char marginChar) Strip leading whitespace/control characters followed by marginChar from every line in a CharSequence.static String
stripMargin
(CharSequence self, CharSequence marginChar) Strip leading whitespace/control characters followed by marginChar from every line in a CharSequence.static String
stripMargin
(String self) Deprecated.Use the CharSequence versionstatic String
stripMargin
(String self, char marginChar) Deprecated.Use the CharSequence versionstatic String
stripMargin
(String self, String marginChar) Deprecated.Use the CharSequence versionstatic String
A GString variant of the equivalent CharSequence method.static CharSequence
take
(CharSequence self, int num) Returns the firstnum
elements from this CharSequence.static String
A GString variant of the equivalent GString method.static CharSequence
takeWhile
(CharSequence self, Closure condition) Returns the longest prefix of this CharSequence where each element passed to the given closure evaluates to true.static BigDecimal
toBigDecimal
(CharSequence self) Parse a CharSequence into a BigDecimalstatic BigDecimal
toBigDecimal
(String self) Deprecated.Use the CharSequence versionstatic BigInteger
toBigInteger
(CharSequence self) Parse a CharSequence into a BigIntegerstatic BigInteger
toBigInteger
(String self) Deprecated.Use the CharSequence versionstatic Boolean
Converts the given string into a Boolean object.static Character
toCharacter
(String self) Converts the given string into a Character object using the first character in the string.static Double
toDouble
(CharSequence self) Parse a CharSequence into a Doublestatic Double
Deprecated.Use the CharSequence versionstatic Float
toFloat
(CharSequence self) Parse a CharSequence into a Floatstatic Float
Deprecated.Use the CharSequence versionstatic Integer
toInteger
(CharSequence self) Parse a CharSequence into an Integerstatic Integer
Deprecated.Use the CharSequence versiontokenize
(CharSequence self) Tokenize a CharSequence (with a whitespace as the delimiter).tokenize
(CharSequence self, Character delimiter) Tokenize a CharSequence based on the given character delimiter.tokenize
(CharSequence self, CharSequence delimiters) Tokenize a CharSequence based on the given CharSequence.Deprecated.Use the CharSequence versionDeprecated.Use the CharSequence versionDeprecated.Use the CharSequence versiontoList
(CharSequence self) Converts the given CharSequence into a List of Strings of one character.Deprecated.Use the CharSequence versionstatic Long
toLong
(CharSequence self) Parse a CharSequence into a Longstatic Long
Deprecated.Use the CharSequence versiontoSet
(CharSequence self) Converts the given CharSequence into a Set of unique Strings of one character.Deprecated.Use the CharSequence versionstatic Short
toShort
(CharSequence self) Parse a CharSequence into a Shortstatic Short
Deprecated.Use the CharSequence versionstatic String
tr
(CharSequence self, CharSequence sourceSet, CharSequence replacementSet) Translates a CharSequence by replacing characters from the sourceSet with characters from replacementSet.static String
Deprecated.Use the CharSequence versionstatic String
uncapitalize
(CharSequence self) Convenience method to uncapitalize the first letter of a CharSequence (typically the first letter of a word).static String
unexpand
(CharSequence self) Replaces sequences of whitespaces with tabs using tabStops of size 8.static String
unexpand
(CharSequence self, int tabStop) Replaces sequences of whitespaces with tabs.static String
Deprecated.Use the CharSequence versionstatic String
Deprecated.Use the CharSequence versionstatic String
unexpandLine
(CharSequence self, int tabStop) Replaces sequences of whitespaces with tabs within a line.static String
unexpandLine
(String self, int tabStop) Deprecated.Use the CharSequence versionMethods inherited from class org.codehaus.groovy.runtime.DefaultGroovyMethodsSupport
cloneSimilarCollection, cloneSimilarMap, closeQuietly, closeWithWarning, createSimilarArray, createSimilarCollection, createSimilarCollection, createSimilarCollection, createSimilarList, createSimilarMap, createSimilarOrDefaultCollection, createSimilarSet, normaliseIndex, sameType, subListBorders, subListBorders
-
Constructor Details
-
StringGroovyMethods
public StringGroovyMethods()
-
-
Method Details
-
asBoolean
Coerce a string (an instance of CharSequence) to a boolean value. A string is coerced to false if it is of length 0, and to true otherwise.- Parameters:
string
- the character sequence- Returns:
- the boolean value
- Since:
- 1.7.0
-
asBoolean
Coerce a Matcher instance to a boolean value.- Parameters:
matcher
- the matcher- Returns:
- the boolean value
- Since:
- 1.7.0
-
asType
Provides a method to perform custom 'dynamic' type conversion to the given class using the
as
operator.- Parameters:
self
- a CharSequencec
- the desired class- Returns:
- the converted object
- Since:
- 1.8.2
- See Also:
-
asType
Converts the GString to a File, or delegates to the defaultDefaultGroovyMethods.asType(Object, Class)
- Parameters:
self
- a GStringc
- the desired class- Returns:
- the converted object
- Since:
- 1.5.0
-
asType
Provides a method to perform custom 'dynamic' type conversion to the given class using theas
operator. Example:'123' as Double
By default, the following types are supported:
- List
- BigDecimal
- BigInteger
- Long
- Integer
- Short
- Byte
- Character
- Double
- Float
- File
- Subclasses of Enum
DefaultGroovyMethods.asType(Object, Class)
.- Parameters:
self
- a Stringc
- the desired class- Returns:
- the converted object
- Since:
- 1.0
-
bitwiseNegate
Turns a CharSequence into a regular expression Pattern- Parameters:
self
- a String to convert into a regular expression- Returns:
- the regular expression pattern
- Since:
- 1.8.2
-
bitwiseNegate
Deprecated.Use the CharSequence version- See Also:
-
uncapitalize
Convenience method to uncapitalize the first letter of a CharSequence (typically the first letter of a word). Example usage:assert 'H'.uncapitalize() == 'h' assert 'Hello'.uncapitalize() == 'hello' assert 'Hello world'.uncapitalize() == 'hello world' assert 'Hello World'.uncapitalize() == 'hello World' assert 'hello world' == 'Hello World'.split(' ').collect{ it.uncapitalize() }.join(' ')
- Parameters:
self
- The CharSequence to uncapitalize- Returns:
- A String containing the uncapitalized toString() of the CharSequence
- Since:
- 2.4.8
-
capitalize
Convenience method to capitalize the first letter of a CharSequence (typically the first letter of a word). Example usage:assert 'h'.capitalize() == 'H' assert 'hello'.capitalize() == 'Hello' assert 'hello world'.capitalize() == 'Hello world' assert 'Hello World' == 'hello world'.split(' ').collect{ it.capitalize() }.join(' ')
- Parameters:
self
- The CharSequence to capitalize- Returns:
- A String containing the capitalized toString() of the CharSequence
- Since:
- 1.8.2
- See Also:
-
capitalize
Deprecated.Use the CharSequence version- See Also:
-
center
Pad a CharSequence to a minimum length specified by numberOfChars by adding the space character around it as many times as needed so that it remains centered. If the String is already the same size or bigger than the target numberOfChars, then the original String is returned. An example:['A', 'BB', 'CCC', 'DDDD'].each{ println '|' + it.center(6) + '|' }
will produce output like:| A | | BB | | CCC | | DDDD |
- Parameters:
self
- a CharSequence objectnumberOfChars
- the total minimum number of characters of the result- Returns:
- the centered toString() of this CharSequence with padded characters around it
- Since:
- 1.8.2
- See Also:
-
center
Pad a CharSequence to a minimum length specified by numberOfChars, appending the supplied padding CharSequence around the original as many times as needed keeping it centered. If the String is already the same size or bigger than the target numberOfChars, then the original String is returned. An example:['A', 'BB', 'CCC', 'DDDD'].each{ println '|' + it.center(6, '+') + '|' }
will produce output like:|++A+++| |++BB++| |+CCC++| |+DDDD+|
- Parameters:
self
- a CharSequence objectnumberOfChars
- the total minimum number of characters of the resulting CharSequencepadding
- the characters used for padding- Returns:
- the centered toString() of this CharSequence with padded characters around it
- Since:
- 1.8.2
- See Also:
-
center
Deprecated.Use the CharSequence version- See Also:
-
center
Deprecated.Use the CharSequence version -
contains
Provide an implementation of contains() likeCollection.contains(Object)
to make CharSequences more polymorphic.- Parameters:
self
- a CharSequencetext
- the CharSequence to look for- Returns:
- true if this CharSequence contains the given text
- Since:
- 1.8.2
- See Also:
-
contains
Deprecated.Use the CharSequence version- See Also:
-
count
Count the number of occurrences of a sub CharSequence.- Parameters:
self
- a CharSequencetext
- a sub CharSequence- Returns:
- the number of occurrences of the given CharSequence inside this CharSequence
- Since:
- 1.8.2
- See Also:
-
count
Deprecated.Use the CharSequence version- See Also:
-
denormalize
Return a CharSequence with lines (separated by LF, CR/LF, or CR) terminated by the platform specific line separator.- Parameters:
self
- a CharSequence object- Returns:
- the denormalized toString() of this CharSequence
- Since:
- 1.8.2
- See Also:
-
denormalize
Deprecated.Use the CharSequence version- See Also:
-
drop
Drops the given number of chars from the head of this CharSequence if they are available.def text = "Groovy" assert text.drop( 0 ) == 'Groovy' assert text.drop( 2 ) == 'oovy' assert text.drop( 7 ) == ''
- Parameters:
self
- the original CharSequencenum
- the number of characters to drop from this iterator- Returns:
- a CharSequence consisting of all characters except the first
num
ones, or else an empty String, if this CharSequence has less thannum
characters. - Since:
- 1.8.1
-
drop
A GString variant of the equivalent CharSequence method.- Parameters:
self
- the original GStringnum
- the number of characters to drop from this iterator- Returns:
- a String consisting of all characters except the first
num
ones, or else an empty String, if the toString() of this GString has less thannum
characters. - Since:
- 2.3.7
- See Also:
-
dropWhile
Create a suffix of the given CharSequence by dropping as many characters as possible from the front of the original CharSequence such that calling the given closure condition evaluates to true when passed each of the dropped characters.def text = "Groovy" assert text.dropWhile{ false } == 'Groovy' assert text.dropWhile{ true } == '' assert text.dropWhile{ it < 'Z' } == 'roovy' assert text.dropWhile{ it != 'v' } == 'vy'
- Parameters:
self
- the original CharSequencecondition
- the closure that while continuously evaluating to true will cause us to drop elements from the front of the original CharSequence- Returns:
- the shortest suffix of the given CharSequence such that the given closure condition evaluates to true for each element dropped from the front of the CharSequence
- Since:
- 2.0.0
-
dropWhile
A GString variant of the equivalent CharSequence method.- Parameters:
self
- the original GStringcondition
- the closure that while continuously evaluating to true will cause us to drop elements from the front of the original GString- Returns:
- the shortest suffix of the given GString such that the given closure condition evaluates to true for each element dropped from the front of the CharSequence
- Since:
- 2.3.7
- See Also:
-
eachLine
Iterates through this CharSequence line by line. Each line is passed to the given 1 or 2 arg closure. If a 2 arg closure is found the line count is passed as the second argument.- Parameters:
self
- a CharSequenceclosure
- a closure- Returns:
- the last value returned by the closure
- Throws:
IOException
- if an error occurs- Since:
- 1.8.2
- See Also:
-
eachLine
public static <T> T eachLine(CharSequence self, int firstLine, Closure<T> closure) throws IOException Iterates through this CharSequence line by line. Each line is passed to the given 1 or 2 arg closure. If a 2 arg closure is found the line count is passed as the second argument.- Parameters:
self
- a CharSequencefirstLine
- the line number value used for the first line (default is 1, set to 0 to start counting from 0)closure
- a closure (arg 1 is line, optional arg 2 is line number)- Returns:
- the last value returned by the closure
- Throws:
IOException
- if an error occurs- Since:
- 1.8.2
-
eachLine
Deprecated.Use the CharSequence version- Throws:
IOException
- See Also:
-
eachLine
@Deprecated public static <T> T eachLine(String self, int firstLine, Closure<T> closure) throws IOException Deprecated.Use the CharSequence version- Throws:
IOException
- See Also:
-
collectReplacements
Iterate through this String a character at a time collecting either the original character or a transformed replacement String. Thetransform
Closure should returnnull
to indicate that no transformation is required for the given character.assert "Groovy".collectReplacements{ it == 'o' ? '_O_' : null } == 'Gr_O__O_vy' assert "B&W".collectReplacements{ it == '&' ? '&' : null } == 'B&W'
- Parameters:
orig
- the original String- Returns:
- A new string in which all characters that require escaping
have been replaced with the corresponding replacements
as determined by the
transform
Closure.
-
eachMatch
Process each regex group matched substring of the given CharSequence. If the closure parameter takes one argument, an array with all match groups is passed to it. If the closure takes as many arguments as there are match groups, then each parameter will be one match group.- Parameters:
self
- the source CharSequenceregex
- a Regex CharSequenceclosure
- a closure with one parameter or as much parameters as groups- Returns:
- the source CharSequence
- Since:
- 1.8.2
- See Also:
-
eachMatch
Process each regex group matched substring of the given pattern. If the closure parameter takes one argument, an array with all match groups is passed to it. If the closure takes as many arguments as there are match groups, then each parameter will be one match group.- Parameters:
self
- the source CharSequencepattern
- a regex Patternclosure
- a closure with one parameter or as much parameters as groups- Returns:
- the source CharSequence
- Since:
- 1.8.2
- See Also:
-
eachMatch
Process each regex group matched substring of the given pattern. If the closure parameter takes one argument, an array with all match groups is passed to it. If the closure takes as many arguments as there are match groups, then each parameter will be one match group.- Parameters:
self
- the source stringpattern
- a regex Patternclosure
- a closure with one parameter or as much parameters as groups- Returns:
- the source string
- Since:
- 1.6.1
-
eachMatch
Process each regex group matched substring of the given string. If the closure parameter takes one argument, an array with all match groups is passed to it. If the closure takes as many arguments as there are match groups, then each parameter will be one match group.- Parameters:
self
- the source stringregex
- a Regex stringclosure
- a closure with one parameter or as much parameters as groups- Returns:
- the source string
- Since:
- 1.6.0
-
expand
Expands all tabs into spaces with tabStops of size 8.- Parameters:
self
- A CharSequence to expand- Returns:
- The expanded toString() of this CharSequence
- Since:
- 1.8.2
- See Also:
-
expand
Expands all tabs into spaces. If the CharSequence has multiple lines, expand each line - restarting tab stops at the start of each line.- Parameters:
self
- A CharSequence to expandtabStop
- The number of spaces a tab represents- Returns:
- The expanded toString() of this CharSequence
- Since:
- 1.8.2
- See Also:
-
expand
Deprecated.Use the CharSequence version- See Also:
-
expand
Deprecated.Use the CharSequence version- See Also:
-
expandLine
Expands all tabs into spaces. Assumes the CharSequence represents a single line of text.- Parameters:
self
- A line to expandtabStop
- The number of spaces a tab represents- Returns:
- The expanded toString() of this CharSequence
- Since:
- 1.8.2
- See Also:
-
expandLine
Deprecated.Use the CharSequence version- See Also:
-
find
Finds the first occurrence of a regular expression String within a String. If the regex doesn't match, null will be returned.For example, if the regex doesn't match the result is null:
assert "New York, NY".find(/\d{5}/) == null
If it does match, we get the matching string back:assert "New York, NY 10292-0098".find(/\d{5}/) == "10292"
If we have capture groups in our expression, we still get back the full matchassert "New York, NY 10292-0098".find(/(\d{5})-?(\d{4})/) == "10292-0098"
- Parameters:
self
- a CharSequenceregex
- the capturing regex- Returns:
- a String containing the matched portion, or null if the regex doesn't match
- Since:
- 1.8.2
- See Also:
-
find
Returns the result of calling a closure with the first occurrence of a regular expression found within a CharSequence. If the regex doesn't match, the closure will not be called and find will return null.- Parameters:
self
- a CharSequenceregex
- the capturing regex CharSequenceclosure
- the closure that will be passed the full match, plus each of the capturing groups (if any)- Returns:
- a String containing the result of calling the closure (calling toString() if needed), or null if the regex pattern doesn't match
- Since:
- 1.8.2
- See Also:
-
find
Finds the first occurrence of a compiled regular expression Pattern within a String. If the pattern doesn't match, null will be returned.For example, if the pattern doesn't match the result is null:
assert "New York, NY".find(~/\d{5}/) == null
If it does match, we get the matching string back:assert "New York, NY 10292-0098".find(~/\d{5}/) == "10292"
If we have capture groups in our expression, the groups are ignored and we get back the full match:assert "New York, NY 10292-0098".find(~/(\d{5})-?(\d{4})/) == "10292-0098"
If you need to work with capture groups, then use the closure version of this method or use Groovy's matcher operators or use eachMatch.- Parameters:
self
- a CharSequencepattern
- the compiled regex Pattern- Returns:
- a String containing the matched portion, or null if the regex pattern doesn't match
- Since:
- 1.8.2
- See Also:
-
find
Returns the result of calling a closure with the first occurrence of a compiled regular expression found within a String. If the regex doesn't match, the closure will not be called and find will return null.For example, if the pattern doesn't match, the result is null:
assert "New York, NY".find(~/\d{5}/) { match -> return "-$match-"} == null
If it does match and we don't have any capture groups in our regex, there is a single parameter on the closure that the match gets passed to:assert "New York, NY 10292-0098".find(~/\d{5}/) { match -> return "-$match-"} == "-10292-"
If we have capture groups in our expression, our closure has one parameter for the match, followed by one for each of the capture groups:assert "New York, NY 10292-0098".find(~/(\d{5})-?(\d{4})/) { match, zip, plusFour -> assert match == "10292-0098" assert zip == "10292" assert plusFour == "0098" return zip } == "10292"
If we have capture groups in our expression, and our closure has one parameter, the closure will be passed an array with the first element corresponding to the whole match, followed by an element for each of the capture groups:assert "New York, NY 10292-0098".find(~/(\d{5})-?(\d{4})/) { array -> assert array[0] == "10292-0098" assert array[1] == "10292" assert array[2] == "0098" return array[1] } == "10292"
If a capture group is optional, and doesn't match, then the corresponding value for that capture group passed to the closure will be null as illustrated here:assert "adsf 233-9999 adsf".find(~/(\d{3})?-?(\d{3})-(\d{4})/) { match, areaCode, exchange, stationNumber -> assert "233-9999" == match assert null == areaCode assert "233" == exchange assert "9999" == stationNumber return "$exchange$stationNumber" } == "2339999"
- Parameters:
self
- a CharSequencepattern
- the compiled regex Patternclosure
- the closure that will be passed the full match, plus each of the capturing groups (if any)- Returns:
- a String containing the result of calling the closure (calling toString() if needed), or null if the regex pattern doesn't match
- Since:
- 1.8.2
- See Also:
-
find
Deprecated.Use the CharSequence version -
find
Deprecated.Use the CharSequence version -
find
Deprecated.Use the CharSequence version- See Also:
-
find
Deprecated.Use the CharSequence version -
findAll
Returns a (possibly empty) list of all occurrences of a regular expression (provided as a CharSequence) found within a CharSequence.For example, if the regex doesn't match, it returns an empty list:
assert "foo".findAll(/(\w*) Fish/) == []
Any regular expression matches are returned in a list, and all regex capture groupings are ignored, only the full match is returned:def expected = ["One Fish", "Two Fish", "Red Fish", "Blue Fish"] assert "One Fish, Two Fish, Red Fish, Blue Fish".findAll(/(\w*) Fish/) == expected
If you need to work with capture groups, then use the closure version of this method or use Groovy's matcher operators or use eachMatch.- Parameters:
self
- a CharSequenceregex
- the capturing regex CharSequence- Returns:
- a List containing all full matches of the regex within the CharSequence, an empty list will be returned if there are no matches
- Since:
- 1.8.2
- See Also:
-
findAll
Finds all occurrences of a regular expression string within a CharSequence. Any matches are passed to the specified closure. The closure is expected to have the full match in the first parameter. If there are any capture groups, they will be placed in subsequent parameters.If there are no matches, the closure will not be called, and an empty List will be returned.
For example, if the regex doesn't match, it returns an empty list:
assert "foo".findAll(/(\w*) Fish/) { match, firstWord -> return firstWord } == []
Any regular expression matches are passed to the closure, if there are no capture groups, there will be one parameter for the match:assert "I could not, would not, with a fox.".findAll(/.ould/) { match -> "${match}n't"} == ["couldn't", "wouldn't"]
If there are capture groups, the first parameter will be the match followed by one parameter for each capture group:def orig = "There's a Wocket in my Pocket" assert orig.findAll(/(.)ocket/) { match, firstLetter -> "$firstLetter > $match" } == ["W > Wocket", "P > Pocket"]
- Parameters:
self
- a CharSequenceregex
- the capturing regex CharSequenceclosure
- will be passed the full match plus each of the capturing groups (if any)- Returns:
- a List containing all results from calling the closure with each full match (and potentially capturing groups) of the regex within the CharSequence, an empty list will be returned if there are no matches
- Since:
- 1.8.2
- See Also:
-
findAll
Returns a (possibly empty) list of all occurrences of a regular expression (in Pattern format) found within a CharSequence.For example, if the pattern doesn't match, it returns an empty list:
assert "foo".findAll(~/(\w*) Fish/) == []
Any regular expression matches are returned in a list, and all regex capture groupings are ignored, only the full match is returned:def expected = ["One Fish", "Two Fish", "Red Fish", "Blue Fish"] assert "One Fish, Two Fish, Red Fish, Blue Fish".findAll(~/(\w*) Fish/) == expected
- Parameters:
self
- a CharSequencepattern
- the compiled regex Pattern- Returns:
- a List containing all full matches of the Pattern within the CharSequence, an empty list will be returned if there are no matches
- Since:
- 1.8.2
- See Also:
-
findAll
Finds all occurrences of a compiled regular expression Pattern within a CharSequence. Any matches are passed to the specified closure. The closure is expected to have the full match in the first parameter. If there are any capture groups, they will be placed in subsequent parameters.If there are no matches, the closure will not be called, and an empty List will be returned.
For example, if the pattern doesn't match, it returns an empty list:
assert "foo".findAll(~/(\w*) Fish/) { match, firstWord -> return firstWord } == []
Any regular expression matches are passed to the closure, if there are no capture groups, there will be one parameter for the match:assert "I could not, would not, with a fox.".findAll(~/.ould/) { match -> "${match}n't"} == ["couldn't", "wouldn't"]
If there are capture groups, the first parameter will be the match followed by one parameter for each capture group:def orig = "There's a Wocket in my Pocket" assert orig.findAll(~/(.)ocket/) { match, firstLetter -> "$firstLetter > $match" } == ["W > Wocket", "P > Pocket"]
- Parameters:
self
- a CharSequencepattern
- the compiled regex Patternclosure
- will be passed the full match plus each of the capturing groups (if any)- Returns:
- a List containing all results from calling the closure with each full match (and potentially capturing groups) of the regex pattern within the CharSequence, an empty list will be returned if there are no matches
- Since:
- 1.8.2
- See Also:
-
findAll
Deprecated.Use the CharSequence version -
findAll
Deprecated.Use the CharSequence version -
findAll
Deprecated.Use the CharSequence version- See Also:
-
findAll
Deprecated.Use the CharSequence version -
getAt
Select a List of characters from a CharSequence using a Collection to identify the indices to be selected.- Parameters:
self
- a CharSequenceindices
- a Collection of indices- Returns:
- a String consisting of the characters at the given indices
- Since:
- 1.0
-
getAt
Support the range subscript operator for CharSequence or StringBuffer with EmptyRange- Parameters:
text
- a CharSequencerange
- an EmptyRange- Returns:
- the empty String
- Since:
- 1.5.0
-
getAt
Support the subscript operator for CharSequence.- Parameters:
text
- a CharSequenceindex
- the index of the Character to get- Returns:
- the Character at the given index
- Since:
- 1.0
-
getAt
Support the subscript operator for GString.- Parameters:
text
- a GStringindex
- the index of the Character to get- Returns:
- the Character at the given index
- Since:
- 2.3.7
-
getAt
Support the range subscript operator for CharSequence with IntRange- Parameters:
text
- a CharSequencerange
- an IntRange- Returns:
- the subsequence CharSequence
- Since:
- 1.0
-
getAt
Support the range subscript operator for GString with IntRange- Parameters:
text
- a GStringrange
- an IntRange- Returns:
- the String of characters corresponding to the provided range
- Since:
- 2.3.7
-
getAt
Support the range subscript operator for CharSequence- Parameters:
text
- a CharSequencerange
- a Range- Returns:
- the subsequence CharSequence
- Since:
- 1.0
-
getAt
Support the range subscript operator for GString- Parameters:
text
- a GStringrange
- a Range- Returns:
- the String of characters corresponding to the provided range
- Since:
- 2.3.7
-
getAt
Select a List of values from a Matcher using a Collection to identify the indices to be selected.- Parameters:
self
- a Matcherindices
- a Collection of indices- Returns:
- a String of the values at the given indices
- Since:
- 1.6.0
-
getAt
Support the subscript operator, e.g. matcher[index], for a regex Matcher.For an example using no group match,
def p = /ab[d|f]/ def m = "abcabdabeabf" =~ p assert 2 == m.count assert 2 == m.size() // synonym for m.getCount() assert ! m.hasGroup() assert 0 == m.groupCount() def matches = ["abd", "abf"] for (i in 0..<m.count) { assert m[i] == matches[i] }
For an example using group matches,
def p = /(?:ab([c|d|e|f]))/ def m = "abcabdabeabf" =~ p assert 4 == m.count assert m.hasGroup() assert 1 == m.groupCount() def matches = [["abc", "c"], ["abd", "d"], ["abe", "e"], ["abf", "f"]] for (i in 0..<m.count) { assert m[i] == matches[i] }
For another example using group matches,
def m = "abcabdabeabfabxyzabx" =~ /(?:ab([d|x-z]+))/ assert 3 == m.count assert m.hasGroup() assert 1 == m.groupCount() def matches = [["abd", "d"], ["abxyz", "xyz"], ["abx", "x"]] for (i in 0..<m.count) { assert m[i] == matches[i] }
- Parameters:
matcher
- a Matcheridx
- an index- Returns:
- object a matched String if no groups matched, list of matched groups otherwise.
- Since:
- 1.0
-
matchesPartially
Given a matcher that matches a string against a pattern, this method returns true when the string matches the pattern or if a longer string, could match the pattern. For example:def emailPattern = /\w+@\w+\.\w{2,}/ def matcher = "john@doe" =~ emailPattern assert matcher.matchesPartially() matcher = "john@doe.com" =~ emailPattern assert matcher.matchesPartially() matcher = "john@@" =~ emailPattern assert !matcher.matchesPartially()
- Parameters:
matcher
- the Matcher- Returns:
- true if more input to the String could make the matcher match the associated pattern, false otherwise.
- Since:
- 2.0.0
-
getAt
Deprecated.Use the CharSequence version -
getAt
Deprecated.Use the CharSequence version -
getAt
Support the subscript operator for String.- Parameters:
text
- a Stringindex
- the index of the Character to get- Returns:
- the Character at the given index
- Since:
- 1.0
-
getAt
Support the range subscript operator for String with IntRange- Parameters:
text
- a Stringrange
- an IntRange- Returns:
- the resulting String
- Since:
- 1.0
-
getAt
Support the range subscript operator for String- Parameters:
text
- a Stringrange
- a Range- Returns:
- a substring corresponding to the Range
- Since:
- 1.0
-
getChars
Converts the given CharSequence into an array of characters.- Parameters:
self
- a CharSequence- Returns:
- an array of characters
- Since:
- 1.8.2
- See Also:
-
getChars
Deprecated.Use the CharSequence version- See Also:
-
getCount
Find the number of Strings matched to the given Matcher.- Parameters:
matcher
- a Matcher- Returns:
- int the number of Strings matched to the given matcher.
- Since:
- 1.0
-
hasGroup
Check whether a Matcher contains a group or not.- Parameters:
matcher
- a Matcher- Returns:
- boolean
true
if matcher contains at least one group. - Since:
- 1.0
-
isAllWhitespace
True if a CharSequence only contains whitespace characters.- Parameters:
self
- The CharSequence to check the characters in- Returns:
- true If all characters are whitespace characters
- Since:
- 1.8.2
- See Also:
-
isAllWhitespace
Deprecated.Use the CharSequence version- See Also:
-
isBigDecimal
Determine if a CharSequence can be parsed as a BigDecimal.- Parameters:
self
- a CharSequence- Returns:
- true if the CharSequence can be parsed
- Since:
- 1.8.2
- See Also:
-
isBigDecimal
Deprecated.Use the CharSequence version- See Also:
-
isBigInteger
Determine if a CharSequence can be parsed as a BigInteger.- Parameters:
self
- a CharSequence- Returns:
- true if the CharSequence can be parsed
- Since:
- 1.8.2
- See Also:
-
isBigInteger
Deprecated.Use the CharSequence version- See Also:
-
isCase
'Case' implementation for a CharSequence, which uses equals between the toString() of the caseValue and the switchValue. This allows CharSequence values to be used in switch statements. For example:switch( str ) { case 'one' : // etc... }
Note that this returnstrue
for the case where both the 'switch' and 'case' operand isnull
.- Parameters:
caseValue
- the case valueswitchValue
- the switch value- Returns:
- true if the switchValue's toString() equals the caseValue
- Since:
- 1.8.2
-
isCase
Deprecated.Use the CharSequence version- See Also:
-
isCase
'Case' implementation for thePattern
class, which allows testing a String against a number of regular expressions. For example:switch( str ) { case ~/one/ : // the regex 'one' matches the value of str }
Note that this returns true for the case where both the pattern and the 'switch' values arenull
.- Parameters:
caseValue
- the case valueswitchValue
- the switch value- Returns:
- true if the switchValue is deemed to match the caseValue
- Since:
- 1.0
-
isCase
Deprecated.Use the CharSequence version- See Also:
-
isDouble
Determine if a CharSequence can be parsed as a Double.- Parameters:
self
- a CharSequence- Returns:
- true if the CharSequence can be parsed
- Since:
- 1.8.2
- See Also:
-
isDouble
Deprecated.Use the CharSequence version- See Also:
-
isFloat
Determine if a CharSequence can be parsed as a Float.- Parameters:
self
- a CharSequence- Returns:
- true if the CharSequence can be parsed
- Since:
- 1.8.2
- See Also:
-
isFloat
Deprecated.Use the CharSequence version- See Also:
-
isInteger
Determine if a CharSequence can be parsed as an Integer.- Parameters:
self
- a CharSequence- Returns:
- true if the CharSequence can be parsed
- Since:
- 1.8.2
- See Also:
-
isInteger
Deprecated.Use the CharSequence version- See Also:
-
isLong
Determine if a CharSequence can be parsed as a Long.- Parameters:
self
- a CharSequence- Returns:
- true if the CharSequence can be parsed
- Since:
- 1.8.2
- See Also:
-
isLong
Deprecated.Use the CharSequence version- See Also:
-
isNumber
Determine if a CharSequence can be parsed as a Number. Synonym for 'isBigDecimal()'.- Parameters:
self
- a CharSequence- Returns:
- true if the CharSequence can be parsed
- Since:
- 1.8.2
- See Also:
-
isNumber
Deprecated.Use the CharSequence version- See Also:
-
iterator
Returns anIterator
which traverses each match.- Parameters:
matcher
- a Matcher object- Returns:
- an Iterator for a Matcher
- Since:
- 1.0
- See Also:
-
leftShift
Overloads the left shift operator to provide an easy way to append multiple objects as string representations to a CharSequence.- Parameters:
self
- a CharSequencevalue
- an Object- Returns:
- a StringBuilder built from this CharSequence
- Since:
- 1.8.2
-
leftShift
Overloads the left shift operator to provide an easy way to append multiple objects as string representations to a String.- Parameters:
self
- a Stringvalue
- an Object- Returns:
- a StringBuffer built from this string
- Since:
- 1.0
-
leftShift
Overloads the left shift operator to provide an easy way to append multiple objects as string representations to a StringBuffer.- Parameters:
self
- a StringBuffervalue
- a value to append- Returns:
- the StringBuffer on which this operation was invoked
- Since:
- 1.0
-
leftShift
Overloads the left shift operator to provide syntactic sugar for appending to a StringBuilder.- Parameters:
self
- a StringBuildervalue
- an Object- Returns:
- the original StringBuilder
- Since:
- 1.8.2
-
matches
Tells whether or not a CharSequence matches the given compiled regular expression Pattern.- Parameters:
self
- the CharSequence that is to be matchedpattern
- the regex Pattern to which the string of interest is to be matched- Returns:
- true if the CharSequence matches
- Since:
- 1.8.2
- See Also:
-
matches
Deprecated.Use the CharSequence version- See Also:
-
minus
Remove a part of a CharSequence by replacing the first occurrence of target within self with '' and returns the result.- Parameters:
self
- a CharSequencetarget
- an object representing the part to remove- Returns:
- a String containing the original minus the part to be removed
- Since:
- 1.8.2
- See Also:
-
minus
Remove a part of a CharSequence. This replaces the first occurrence of the pattern within self with '' and returns the result.- Parameters:
self
- a Stringpattern
- a Pattern representing the part to remove- Returns:
- a String minus the part to be removed
- Since:
- 2.2.0
-
minus
Deprecated.Use the CharSequence version -
minus
Deprecated.Use the CharSequence version- See Also:
-
multiply
Repeat a CharSequence a certain number of times.- Parameters:
self
- a CharSequence to be repeatedfactor
- the number of times the CharSequence should be repeated- Returns:
- a String composed of a repetition
- Throws:
IllegalArgumentException
- if the number of repetitions is < 0- Since:
- 1.8.2
-
multiply
Deprecated.Use the CharSequence version- See Also:
-
next
This method is called by the ++ operator for the class CharSequence. It increments the last character in the given CharSequence. If the last character in the CharSequence is Character.MAX_VALUE a Character.MIN_VALUE will be appended. The empty CharSequence is incremented to a string consisting of the character Character.MIN_VALUE.- Parameters:
self
- a CharSequence- Returns:
- a value obtained by incrementing the toString() of the CharSequence
- Since:
- 1.8.2
-
next
Deprecated.Use the CharSequence version- See Also:
-
normalize
Return a String with linefeeds and carriage returns normalized to linefeeds.- Parameters:
self
- a CharSequence object- Returns:
- the normalized toString() for the CharSequence
- Since:
- 1.8.2
- See Also:
-
normalize
Deprecated.Use the CharSequence version- See Also:
-
padLeft
Pad a CharSequence to a minimum length specified by numberOfChars by adding the space character to the left as many times as needed. If the String is already the same size or bigger than the target numberOfChars, then the original String is returned. An example:println 'Numbers:' [1, 10, 100, 1000].each{ println it.toString().padLeft(5) }
will produce output like:Numbers: 1 10 100 1000
- Parameters:
self
- a CharSequence objectnumberOfChars
- the total minimum number of characters of the resulting CharSequence- Returns:
- the CharSequence padded to the left as a String
- Since:
- 1.8.2
- See Also:
-
padLeft
Pad a CharSequence to a minimum length specified by numberOfChars, adding the supplied padding CharSequence as many times as needed to the left. If the CharSequence is already the same size or bigger than the target numberOfChars, then the toString() of the original CharSequence is returned. An example:println 'Numbers:' [1, 10, 100, 1000].each{ println it.toString().padLeft(5, '*') } [2, 20, 200, 2000].each{ println it.toString().padLeft(5, '*_') }
will produce output like:Numbers: ****1 ***10 **100 *1000 *_*_2 *_*20 *_200 *2000
- Parameters:
self
- a CharSequence objectnumberOfChars
- the total minimum number of characters of the resulting CharSequencepadding
- the characters used for padding- Returns:
- the CharSequence padded to the left as a String
- Since:
- 1.8.2
- See Also:
-
padLeft
Deprecated.Use the CharSequence version- See Also:
-
padLeft
Deprecated.Use the CharSequence version -
padRight
Pad a CharSequence to a minimum length specified by numberOfChars by adding the space character to the right as many times as needed. If the CharSequence is already the same size or bigger than the target numberOfChars, then the toString() of the original CharSequence is returned. An example:['A', 'BB', 'CCC', 'DDDD'].each{ println it.padRight(5) + it.size() }
will produce output like:A 1 BB 2 CCC 3 DDDD 4
- Parameters:
self
- a CharSequence objectnumberOfChars
- the total minimum number of characters of the resulting string- Returns:
- the CharSequence padded to the right as a String
- Since:
- 1.8.2
- See Also:
-
padRight
Pad a CharSequence to a minimum length specified by numberOfChars, adding the supplied padding CharSequence as many times as needed to the right. If the CharSequence is already the same size or bigger than the target numberOfChars, then the toString() of the original CharSequence is returned. An example:['A', 'BB', 'CCC', 'DDDD'].each{ println it.padRight(5, '#') + it.size() }
will produce output like:A####1 BB###2 CCC##3 DDDD#4
- Parameters:
self
- a CharSequence objectnumberOfChars
- the total minimum number of characters of the resulting CharSequencepadding
- the characters used for padding- Returns:
- the CharSequence padded to the right as a String
- Since:
- 1.8.2
-
padRight
Deprecated.Use the CharSequence version- See Also:
-
padRight
Deprecated.Use the CharSequence version -
plus
Appends the String representation of the given operand to this CharSequence.- Parameters:
left
- a CharSequencevalue
- any Object- Returns:
- the original toString() of the CharSequence with the object appended
- Since:
- 1.8.2
-
plus
Appends a String to the string representation of this number.- Parameters:
value
- a Numberright
- a String- Returns:
- a String
- Since:
- 1.0
-
plus
Deprecated.Use the CharSequence version- See Also:
-
plus
Appends the String representation of the given operand to this string.- Parameters:
left
- a Stringvalue
- any CharSequence- Returns:
- the new string with the object appended
- Since:
- 2.2
-
plus
Appends a String to this StringBuffer.- Parameters:
left
- a StringBuffervalue
- a String- Returns:
- a String
- Since:
- 1.0
-
previous
This method is called by the -- operator for the class CharSequence. It decrements the last character in the given CharSequence. If the last character in the CharSequence is Character.MIN_VALUE it will be deleted. The empty CharSequence can't be decremented.- Parameters:
self
- a CharSequence- Returns:
- a String with a decremented character at the end
- Since:
- 1.8.2
- See Also:
-
previous
Deprecated.Use the CharSequence version- See Also:
-
putAt
Support the range subscript operator for StringBuffer.- Parameters:
self
- a StringBufferrange
- a Rangevalue
- the object that's toString() will be inserted- Since:
- 1.0
-
putAt
Support the range subscript operator for StringBuffer. Index values are treated as characters within the buffer.- Parameters:
self
- a StringBufferrange
- a Rangevalue
- the object that's toString() will be inserted- Since:
- 1.0
-
readLines
Return the lines of a CharSequence as a List of String.- Parameters:
self
- a CharSequence object- Returns:
- a list of lines
- Since:
- 1.8.2
-
readLines
Deprecated.Use the CharSequence version- See Also:
-
replaceAll
Replaces each substring of this CharSequence that matches the given regular expression with the given replacement.- Parameters:
self
- a CharSequenceregex
- the capturing regexreplacement
- the string to be substituted for each match- Returns:
- the toString() of the CharSequence with content replaced
- Throws:
PatternSyntaxException
- if the regular expression's syntax is invalid- Since:
- 1.8.2
- See Also:
-
replaceAll
Replaces all occurrences of a captured group by the result of calling a closure on that text.Examples:
assert "hello world".replaceAll("(o)") { it[0].toUpperCase() } == "hellO wOrld" assert "foobar-FooBar-".replaceAll("(([fF][oO]{2})[bB]ar)", { Object[] it -> it[0].toUpperCase() }) == "FOOBAR-FOOBAR-" // Here, // it[0] is the global string of the matched group // it[1] is the first string in the matched group // it[2] is the second string in the matched group assert "foobar-FooBar-".replaceAll("(([fF][oO]{2})[bB]ar)", { x, y, z -> z.toUpperCase() }) == "FOO-FOO-" // Here, // x is the global string of the matched group // y is the first string in the matched group // z is the second string in the matched group
Note that unlike String.replaceAll(String regex, String replacement), where the replacement string treats '$' and '\' specially (for group substitution), the result of the closure is converted to a string and that value is used literally for the replacement.- Parameters:
self
- a CharSequenceregex
- the capturing regexclosure
- the closure to apply on each captured group- Returns:
- the toString() of the CharSequence with content replaced
- Throws:
PatternSyntaxException
- if the regular expression's syntax is invalid- Since:
- 1.8.2
- See Also:
-
replaceAll
Replaces all substrings of a CharSequence that match the given compiled regular expression with the given replacement.Note that backslashes (\) and dollar signs ($) in the replacement string may cause the results to be different than if it were being treated as a literal replacement string; see
Matcher.replaceAll(java.lang.String)
. UseMatcher.quoteReplacement(java.lang.String)
to suppress the special meaning of these characters, if desired.assert "foo".replaceAll('o', 'X') == 'fXX'
- Parameters:
self
- the CharSequence that is to be matchedpattern
- the regex Pattern to which the CharSequence of interest is to be matchedreplacement
- the CharSequence to be substituted for the first match- Returns:
- The resulting String
- Since:
- 1.8.2
- See Also:
-
replaceAll
Replaces all occurrences of a captured group by the result of a closure call on that text.For examples,
assert "hello world".replaceAll(~"(o)") { it[0].toUpperCase() } == "hellO wOrld" assert "foobar-FooBar-".replaceAll(~"(([fF][oO]{2})[bB]ar)", { it[0].toUpperCase() }) == "FOOBAR-FOOBAR-" // Here, // it[0] is the global string of the matched group // it[1] is the first string in the matched group // it[2] is the second string in the matched group assert "foobar-FooBar-".replaceAll(~"(([fF][oO]{2})[bB]ar)", { Object[] it -> it[0].toUpperCase() }) == "FOOBAR-FOOBAR-" // Here, // it[0] is the global string of the matched group // it[1] is the first string in the matched group // it[2] is the second string in the matched group assert "foobar-FooBar-".replaceAll("(([fF][oO]{2})[bB]ar)", { x, y, z -> z.toUpperCase() }) == "FOO-FOO-" // Here, // x is the global string of the matched group // y is the first string in the matched group // z is the second string in the matched group
Note that unlike String.replaceAll(String regex, String replacement), where the replacement string treats '$' and '\' specially (for group substitution), the result of the closure is converted to a string and that value is used literally for the replacement.- Parameters:
self
- a CharSequencepattern
- the capturing regex Patternclosure
- the closure to apply on each captured group- Returns:
- the toString() of the CharSequence with replaced content
- Since:
- 1.8.2
- See Also:
-
replaceAll
Deprecated.Use the CharSequence version -
replaceAll
Deprecated.Use the CharSequence version -
replaceAll
Deprecated.Use the CharSequence version -
replaceFirst
Replaces the first substring of this CharSequence that matches the given regular expression with the given replacement.- Parameters:
self
- a CharSequenceregex
- the capturing regexreplacement
- the CharSequence to be substituted for each match- Returns:
- a CharSequence with replaced content
- Throws:
PatternSyntaxException
- if the regular expression's syntax is invalid- Since:
- 1.8.2
- See Also:
-
replaceFirst
Replaces the first occurrence of a captured group by the result of a closure call on that text.For example (with some replaceAll variants thrown in for comparison purposes),
assert "hello world".replaceFirst("(o)") { it[0].toUpperCase() } == "hellO world" // first match assert "hello world".replaceAll("(o)") { it[0].toUpperCase() } == "hellO wOrld" // all matches assert "one fish, two fish".replaceFirst(/([a-z]{3})\s([a-z]{4})/) { [one:1, two:2][it[1]] + '-' + it[2].toUpperCase() } == '1-FISH, two fish' assert "one fish, two fish".replaceAll(/([a-z]{3})\s([a-z]{4})/) { [one:1, two:2][it[1]] + '-' + it[2].toUpperCase() } == '1-FISH, 2-FISH'
- Parameters:
self
- a CharSequenceregex
- the capturing regexclosure
- the closure to apply on the first captured group- Returns:
- a CharSequence with replaced content
- Throws:
PatternSyntaxException
- if the regular expression's syntax is invalid- Since:
- 1.8.2
- See Also:
-
replaceFirst
Replaces the first substring of a CharSequence that matches the given compiled regular expression with the given replacement.Note that backslashes (\) and dollar signs ($) in the replacement string may cause the results to be different than if it were being treated as a literal replacement string; see
Matcher.replaceFirst(java.lang.String)
. UseMatcher.quoteReplacement(java.lang.String)
to suppress the special meaning of these characters, if desired.assert "foo".replaceFirst('o', 'X') == 'fXo'
- Parameters:
self
- the CharSequence that is to be matchedpattern
- the regex Pattern to which the CharSequence of interest is to be matchedreplacement
- the CharSequence to be substituted for the first match- Returns:
- The resulting String
- Since:
- 1.8.2
- See Also:
-
replaceFirst
Replaces the first occurrence of a captured group by the result of a closure call on that text.For example (with some replaceAll variants thrown in for comparison purposes),
assert "hellO world" == "hello world".replaceFirst(~"(o)") { it[0].toUpperCase() } // first match assert "hellO wOrld" == "hello world".replaceAll(~"(o)") { it[0].toUpperCase() } // all matches assert '1-FISH, two fish' == "one fish, two fish".replaceFirst(~/([a-z]{3})\s([a-z]{4})/) { [one:1, two:2][it[1]] + '-' + it[2].toUpperCase() } assert '1-FISH, 2-FISH' == "one fish, two fish".replaceAll(~/([a-z]{3})\s([a-z]{4})/) { [one:1, two:2][it[1]] + '-' + it[2].toUpperCase() }
- Parameters:
self
- a CharSequencepattern
- the capturing regex Patternclosure
- the closure to apply on the first captured group- Returns:
- a CharSequence with replaced content
- Since:
- 1.8.2
-
replaceFirst
Deprecated.Use the CharSequence version -
replaceFirst
Deprecated.Use the CharSequence version -
replaceFirst
Deprecated.Use the CharSequence version -
reverse
Creates a String which is the reverse (backwards) of this CharSequence- Parameters:
self
- a CharSequence- Returns:
- a new String with all the characters reversed.
- Since:
- 1.8.2
- See Also:
-
reverse
Deprecated.Use the CharSequence version- See Also:
-
setIndex
Set the position of the given Matcher to the given index.- Parameters:
matcher
- a Matcheridx
- the index number- Since:
- 1.0
-
size
Provide the standard Groovysize()
method forCharSequence
.- Parameters:
text
- a CharSequence- Returns:
- the length of the CharSequence
- Since:
- 1.8.2
-
size
Provide the standard Groovysize()
method forMatcher
.- Parameters:
self
- a matcher object- Returns:
- the matcher's size (count)
- Since:
- 1.5.0
-
size
Provide the standard Groovysize()
method forString
.- Parameters:
text
- a String- Returns:
- the length of the String
- Since:
- 1.0
-
size
Provide the standard Groovysize()
method forStringBuffer
.- Parameters:
buffer
- a StringBuffer- Returns:
- the length of the StringBuffer
- Since:
- 1.0
-
split
Convenience method to split a CharSequence (with whitespace as delimiter). Similar to tokenize, but returns an Array of String instead of a List.- Parameters:
self
- the CharSequence to split- Returns:
- String[] result of split
- Since:
- 1.8.2
- See Also:
-
split
Deprecated.Use the CharSequence version- See Also:
-
split
Deprecated.Use the CharSequence version- See Also:
-
splitEachLine
public static <T> T splitEachLine(CharSequence self, CharSequence regex, Closure<T> closure) throws IOException Iterates through the given CharSequence line by line, splitting each line using the given regex delimiter. The list of tokens for each line is then passed to the given closure.- Parameters:
self
- a CharSequenceregex
- the delimiting regular expressionclosure
- a closure- Returns:
- the last value returned by the closure
- Throws:
IOException
- if an error occursPatternSyntaxException
- if the regular expression's syntax is invalid- Since:
- 1.8.2
- See Also:
-
splitEachLine
Iterates through the given CharSequence line by line, splitting each line using the given separator Pattern. The list of tokens for each line is then passed to the given closure.- Parameters:
self
- a CharSequencepattern
- the regular expression Pattern for the delimiterclosure
- a closure- Returns:
- the last value returned by the closure
- Since:
- 1.8.2
-
splitEachLine
@Deprecated public static <T> T splitEachLine(String self, Pattern pattern, Closure<T> closure) throws IOException Deprecated.Use the CharSequence version -
splitEachLine
@Deprecated public static <T> T splitEachLine(String self, String regex, Closure<T> closure) throws IOException Deprecated.Use the CharSequence version -
stripIndent
Strip leading spaces from every line in a CharSequence. The line with the least number of leading spaces determines the number to remove. Lines only containing whitespace are ignored when calculating the number of leading spaces to strip.assert ' A\n B\nC' == ' A\n B\n C'.stripIndent()
- Parameters:
self
- The CharSequence to strip the leading spaces from- Returns:
- the stripped toString() of the CharSequence
- Since:
- 1.8.2
- See Also:
-
stripIndent
Strip numChar leading characters from every line in a CharSequence.assert 'DEF\n456' == '''ABCDEF\n123456'''.stripIndent(3)
- Parameters:
self
- The CharSequence to strip the characters fromnumChars
- The number of characters to strip- Returns:
- the stripped String
- Since:
- 1.8.2
-
stripIndent
Deprecated.Use the CharSequence version- See Also:
-
stripIndent
Deprecated.Use the CharSequence version- See Also:
-
stripMargin
Strip leading whitespace/control characters followed by '|' from every line in a CharSequence.assert 'ABC\n123\n456' == '''ABC |123 |456'''.stripMargin()
- Parameters:
self
- The CharSequence to strip the margin from- Returns:
- the stripped String
- Since:
- 1.8.2
- See Also:
-
stripMargin
Strip leading whitespace/control characters followed by marginChar from every line in a CharSequence.assert 'ABC\n123\n456' == '''ABC *123 *456'''.stripMargin('*')
- Parameters:
self
- The CharSequence to strip the margin frommarginChar
- Any character that serves as margin delimiter- Returns:
- the stripped String
- Since:
- 1.8.2
- See Also:
-
stripMargin
Strip leading whitespace/control characters followed by marginChar from every line in a CharSequence.- Parameters:
self
- The CharSequence to strip the margin frommarginChar
- Any character that serves as margin delimiter- Returns:
- the stripped CharSequence
- Since:
- 1.8.2
- See Also:
-
stripMargin
Deprecated.Use the CharSequence version- See Also:
-
stripMargin
Deprecated.Use the CharSequence version- See Also:
-
stripMargin
Deprecated.Use the CharSequence version- See Also:
-
take
Returns the firstnum
elements from this CharSequence.def text = "Groovy" assert text.take( 0 ) == '' assert text.take( 2 ) == 'Gr' assert text.take( 7 ) == 'Groovy'
- Parameters:
self
- the original CharSequencenum
- the number of chars to take from this CharSequence- Returns:
- a CharSequence consisting of the first
num
chars, or else the whole CharSequence if it has less thennum
elements. - Since:
- 1.8.1
-
take
A GString variant of the equivalent CharSequence method.- Parameters:
self
- the original GStringnum
- the number of chars to take from this GString- Returns:
- a String consisting of the first
num
chars, or else the whole GString if it has less thennum
elements. - Since:
- 2.3.7
-
takeWhile
Returns the longest prefix of this CharSequence where each element passed to the given closure evaluates to true.def text = "Groovy" assert text.takeWhile{ it < 'A' } == '' assert text.takeWhile{ it < 'Z' } == 'G' assert text.takeWhile{ it != 'v' } == 'Groo' assert text.takeWhile{ it < 'z' } == 'Groovy'
- Parameters:
self
- the original CharSequencecondition
- the closure that must evaluate to true to continue taking elements- Returns:
- a prefix of elements in the CharSequence where each element passed to the given closure evaluates to true
- Since:
- 2.0.0
-
takeWhile
A GString variant of the equivalent GString method.- Parameters:
self
- the original GStringcondition
- the closure that must evaluate to true to continue taking elements- Returns:
- a prefix of elements in the GString where each element passed to the given closure evaluates to true
- Since:
- 2.3.7
-
toBigDecimal
Parse a CharSequence into a BigDecimal- Parameters:
self
- a CharSequence- Returns:
- a BigDecimal
- Since:
- 1.8.2
- See Also:
-
toBigDecimal
Deprecated.Use the CharSequence version- See Also:
-
toBigInteger
Parse a CharSequence into a BigInteger- Parameters:
self
- a CharSequence- Returns:
- a BigInteger
- Since:
- 1.8.2
- See Also:
-
toBigInteger
Deprecated.Use the CharSequence version- See Also:
-
toBoolean
Converts the given string into a Boolean object. If the trimmed string is "true", "y" or "1" (ignoring case) then the result is true otherwise it is false.- Parameters:
self
- a String- Returns:
- The Boolean value
- Since:
- 1.0
-
toCharacter
Converts the given string into a Character object using the first character in the string.- Parameters:
self
- a String- Returns:
- the first Character
- Since:
- 1.0
-
toDouble
Parse a CharSequence into a Double- Parameters:
self
- a CharSequence- Returns:
- a Double
- Since:
- 1.8.2
- See Also:
-
toDouble
Deprecated.Use the CharSequence version- See Also:
-
toFloat
Parse a CharSequence into a Float- Parameters:
self
- a CharSequence- Returns:
- a Float
- Since:
- 1.8.2
- See Also:
-
toFloat
Deprecated.Use the CharSequence version- See Also:
-
toInteger
Parse a CharSequence into an Integer- Parameters:
self
- a CharSequence- Returns:
- an Integer
- Since:
- 1.8.2
-
toInteger
Deprecated.Use the CharSequence version- See Also:
-
tokenize
Tokenize a CharSequence (with a whitespace as the delimiter).- Parameters:
self
- a CharSequence- Returns:
- a List of tokens
- Since:
- 1.8.2
- See Also:
-
tokenize
Tokenize a CharSequence based on the given character delimiter. For example:char pathSep = ':' assert "/tmp:/usr".tokenize(pathSep) == ["/tmp", "/usr"]
- Parameters:
self
- a CharSequencedelimiter
- the delimiter- Returns:
- a List of tokens
- Since:
- 1.8.2
- See Also:
-
tokenize
Tokenize a CharSequence based on the given CharSequence. Each character in the CharSequence is a separate delimiter.- Parameters:
self
- a CharSequencedelimiters
- the delimiters- Returns:
- a List of tokens
- Since:
- 1.8.2
- See Also:
-
tokenize
Deprecated.Use the CharSequence version- See Also:
-
tokenize
Deprecated.Use the CharSequence version- See Also:
-
tokenize
Deprecated.Use the CharSequence version- See Also:
-
toList
Converts the given CharSequence into a List of Strings of one character.- Parameters:
self
- a CharSequence- Returns:
- a List of characters (a 1-character String)
- Since:
- 1.8.2
- See Also:
-
toList
Deprecated.Use the CharSequence version- See Also:
-
toLong
Parse a CharSequence into a Long- Parameters:
self
- a CharSequence- Returns:
- a Long
- Since:
- 1.8.2
- See Also:
-
toLong
Deprecated.Use the CharSequence version- See Also:
-
toSet
Converts the given CharSequence into a Set of unique Strings of one character.- Parameters:
self
- a CharSequence- Returns:
- a Set of unique characters (each a 1-character String)
- Since:
- 1.8.2
- See Also:
-
toSet
Deprecated.Use the CharSequence version- See Also:
-
toShort
Parse a CharSequence into a Short- Parameters:
self
- a CharSequence- Returns:
- a Short
- Since:
- 1.8.2
-
toShort
Deprecated.Use the CharSequence version- See Also:
-
tr
public static String tr(CharSequence self, CharSequence sourceSet, CharSequence replacementSet) throws ClassNotFoundException Translates a CharSequence by replacing characters from the sourceSet with characters from replacementSet. If the first character from sourceSet appears in the CharSequence, it will be replaced with the first character from replacementSet. If the second character from sourceSet appears in the CharSequence, it will be replaced with the second character from replacementSet. and so on for all provided replacement characters.Here is an example which converts the vowels in a word from lower to uppercase:
assert 'hello'.tr('aeiou', 'AEIOU') == 'hEllO'
A character range using regex-style syntax can also be used, e.g. here is an example which converts a word from lower to uppercase:assert 'hello'.tr('a-z', 'A-Z') == 'HELLO'
Hyphens at the start or end of sourceSet or replacementSet are treated as normal hyphens and are not considered to be part of a range specification. Similarly, a hyphen immediately after an earlier range is treated as a normal hyphen. So, '-x', 'x-' have no ranges while 'a-c-e' has the range 'a-c' plus the '-' character plus the 'e' character.Unlike the unix tr command, Groovy's tr command supports reverse ranges, e.g.:
assert 'hello'.tr('z-a', 'Z-A') == 'HELLO'
If replacementSet is smaller than sourceSet, then the last character from replacementSet is used as the replacement for all remaining source characters as shown here:assert 'Hello World!'.tr('a-z', 'A') == 'HAAAA WAAAA!'
If sourceSet contains repeated characters, the last specified replacement is used as shown here:assert 'Hello World!'.tr('lloo', '1234') == 'He224 W4r2d!'
The functionality provided by tr can be achieved using regular expressions but tr provides a much more compact notation and efficient implementation for certain scenarios.- Parameters:
self
- the CharSequence that is to be translatedsourceSet
- the set of characters to translate fromreplacementSet
- the set of replacement characters- Returns:
- The resulting translated String
- Throws:
ClassNotFoundException
- Since:
- 1.8.2
- See Also:
-
StringUtil.tr(String, String, String)
-
tr
@Deprecated public static String tr(String self, String sourceSet, String replacementSet) throws ClassNotFoundException Deprecated.Use the CharSequence version- Throws:
ClassNotFoundException
- See Also:
-
unexpand
Replaces sequences of whitespaces with tabs using tabStops of size 8.- Parameters:
self
- A CharSequence to unexpand- Returns:
- an unexpanded String
- Since:
- 1.8.2
- See Also:
-
unexpand
Replaces sequences of whitespaces with tabs.- Parameters:
self
- A CharSequence to unexpandtabStop
- The number of spaces a tab represents- Returns:
- an unexpanded String
- Since:
- 1.8.2
-
unexpand
Deprecated.Use the CharSequence version- See Also:
-
unexpand
Deprecated.Use the CharSequence version- See Also:
-
unexpandLine
Replaces sequences of whitespaces with tabs within a line.- Parameters:
self
- A line to unexpandtabStop
- The number of spaces a tab represents- Returns:
- an unexpanded String
- Since:
- 1.8.2
-
unexpandLine
Deprecated.Use the CharSequence version- See Also:
-
startsWithAny
Tests if this CharSequence starts with any specified prefixes.- Parameters:
prefixes
- the prefixes.- Returns:
true
if this CharSequence starts with any specified prefixes.- Since:
- 2.4.14
-
endsWithAny
Tests if this CharSequence ends with any specified suffixes.- Parameters:
suffixes
- the suffixes.- Returns:
true
if this CharSequence ends with any specified suffixes- Since:
- 2.4.14
-