public abstract class Format extends Object implements Serializable, Cloneable
Strings
. It is guaranteed that any
String
produced by a concrete subclass of Format
will be parseable by that same subclass.
In addition to implementing the abstract methods in this class, subclasses
should provide static factory methods of the form
getInstance()
and getInstance(Locale)
if the
subclass loads different formatting/parsing schemes based on locale.
These subclasses should also implement a static method called
getAvailableLocales()
which returns an array of
available locales in the current runtime environment.
Modifier and Type | Class and Description |
---|---|
static class |
Format.Field |
Modifier | Constructor and Description |
---|---|
protected |
Format()
This method initializes a new instance of
Format . |
Modifier and Type | Method and Description |
---|---|
Object |
clone()
Creates a copy of this object.
|
String |
format(Object obj)
This method formats an
Object into a String . |
abstract StringBuffer |
format(Object obj,
StringBuffer sb,
FieldPosition pos)
This method formats an
Object into a String and
appends the String to a StringBuffer . |
AttributedCharacterIterator |
formatToCharacterIterator(Object obj) |
Object |
parseObject(String str)
This method parses a
String and converts the parsed
contents into an Object . |
abstract Object |
parseObject(String str,
ParsePosition pos)
This method parses a
String and converts the parsed
contents into an Object . |
protected Format()
Format
.
It performs no actions, but acts as a default constructor for
subclasses.public final String format(Object obj) throws IllegalArgumentException
Object
into a String
.obj
- The Object
to format.String
.IllegalArgumentException
- If the Object
cannot be formatted.public abstract StringBuffer format(Object obj, StringBuffer sb, FieldPosition pos) throws IllegalArgumentException
Object
into a String
and
appends the String
to a StringBuffer
.obj
- The Object
to format.sb
- The StringBuffer
to append to.pos
- The desired FieldPosition
, which is also
updated by this call.StringBuffer
.IllegalArgumentException
- If the Object
cannot be formatted.public Object parseObject(String str) throws ParseException
String
and converts the parsed
contents into an Object
.str
- The String
to parse.Object
.ParseException
- If the String
cannot be parsed.public abstract Object parseObject(String str, ParsePosition pos)
String
and converts the parsed
contents into an Object
.str
- The String
to parse.pos
- The starting parse index on input, the ending parse
index on output.Object
, or null
in
case of error.public AttributedCharacterIterator formatToCharacterIterator(Object obj)