Format


Format java.text

Java 1.1 cloneable serializable

This abstract class is the base class for all number, date, and string formatting classes in the java.text package. It defines the key formatting and parsing methods that are implemented by all subclasses. format( ) converts an object to a string using the formatting rules encapsulated by the Format subclass and optionally appends the resulting string to an existing StringBuffer . parseObject( ) performs the reverse operation; it parses a formatted string and returns the corresponding object. Status information for these two operations is returned in FieldPosition and ParsePosition objects.

Java 1.4 defined a variant on the format( ) method. formatToCharacterIterator( ) performs the same formating operation as format( ) but returns the result as an AtttributedCharacterIterator which uses attributes to identify the various parts (such the integer part, the decimal separtator, and the fractional part of a formatted number) of the formatted string. The attribute keys are all instances of the Format.Field inner class. Each of the Format subclasses define a Field subclass that defines a set of Field constants, (such as NumberFormat.Field.DECIMAL_SEPARATOR ) for use by the character iterator returned by this method. See ChoiceFormat , DateFormat , MessageFormat , and NumberFormat for subclasses that perform specific types of formatting.

Figure 15-11. java.text.Format

 public abstract class  Format  implements Cloneable, Serializable {  // Public Constructors  public  Format  ( );  // Nested Types   1.4  public static class  Field  extends AttributedCharacterIterator.Attribute;  // Public Instance Methods  public final String  format  (Object  obj  );        public abstract StringBuffer  format  (Object  obj  , StringBuffer  toAppendTo  ,          FieldPosition  pos  );  1.4  public AttributedCharacterIterator  formatToCharacterIterator  (Object  obj  );        public Object  parseObject  (String  source  ) throws ParseException;        public abstract Object  parseObject  (String  source  , ParsePosition  pos  );  // Public Methods Overriding Object  public Object  clone  ( );   } 

Subclasses

DateFormat , MessageFormat , NumberFormat

Passed To

MessageFormat.{setFormat( ) , setFormatByArgumentIndex( ) , setFormats( ) , setFormatsByArgumentIndex( )}

Returned By

MessageFormat.{getFormats( ) , getFormatsByArgumentIndex( )}



Java In A Nutshell
Java In A Nutshell, 5th Edition
ISBN: 0596007736
EAN: 2147483647
Year: 2004
Pages: 1220

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net