org.apache.commons.lang.text

Provides classes for handling and manipulating text, partly as an extension to {@link java.text}. The classes in this package are, for the most part, intended to be instantiated. (ie. they are not utility classes with lots of static methods)

The main differences from StringBuffer/StringBuilder are:

• Not synchronized
• Not final
• Subclasses have direct access to character array
• Additional methods
  • appendWithSeparators - adds an array of values, with a separator
  • appendPadding - adds a length padding characters
  • appendFixedLength - adds a fixed width field to the builder
  • toCharArray/getChars - simpler ways to get a range of the character array
  • delete - delete char or string
  • replace - search and replace for a char or string
  • leftString/rightString/midString - substring without exceptions
  • contains - whether the builder contains a char or string
  • size/clear/isEmpty - collections style API methods

The aim has been to provide an API that mimics very closely what StringBuffer provides, but with additional methods.

This class takes a piece of text and substitutes all the variables within it. The default definition of a variable is ${variableName}. The prefix and suffix can be changed via constructors and set methods.

Variable values are typically resolved from a map, but could also be resolved from system properties, or by supplying a custom variable resolver.

The simplest example is to use this class to replace Java System properties.

This class can split a String into many smaller strings.